Struct fuels_accounts::provider::Provider

pub struct Provider {
    pub client: FuelClient,
    pub consensus_parameters: ConsensusParameters,
}

Encapsulates common client operations in the SDK. Note that you may also use client, which is an instance of FuelClient, directly, which provides a broader API.

Fields

client: FuelClient

consensus_parameters: ConsensusParameters

Implementations

impl Provider

pub fn new( client: FuelClient, consensus_parameters: ConsensusParameters ) -> Self

pub async fn send_transaction<T: Transaction>(&self, tx: T) -> Result<TxId>

Sends a transaction to the underlying Provider’s client.

pub async fn get_receipts(&self, tx_id: &TxId) -> Result<Vec<Receipt>>

pub async fn connect(url: impl AsRef<str>) -> Result<Provider>

Connects to an existing node at the given address.

pub async fn chain_info(&self) -> Result<ChainInfo, ProviderError>

pub fn consensus_parameters(&self) -> ConsensusParameters

pub fn chain_id(&self) -> ChainId

pub async fn node_info(&self) -> Result<NodeInfo, ProviderError>

pub async fn checked_dry_run<T: Transaction>( &self, tx: T ) -> Result<Vec<Receipt>>

pub async fn dry_run<T: Transaction>(&self, tx: T) -> Result<Vec<Receipt>>

pub async fn dry_run_no_validation<T: Transaction>( &self, tx: T ) -> Result<Vec<Receipt>>

pub async fn get_coins( &self, from: &Bech32Address, asset_id: AssetId ) -> Result<Vec<Coin>, ProviderError>

Gets all unspent coins owned by address from, with asset ID asset_id.

pub async fn get_spendable_resources( &self, filter: ResourceFilter ) -> Result<Vec<CoinType>, ProviderError>

Get some spendable coins of asset asset_id for address from that add up at least to amount amount. The returned coins (UTXOs) are actual coins that can be spent. The number of coins (UXTOs) is optimized to prevent dust accumulation.

pub async fn get_asset_balance( &self, address: &Bech32Address, asset_id: AssetId ) -> Result<u64, ProviderError>

Get the balance of all spendable coins asset_id for address address. This is different from getting coins because we are just returning a number (the sum of UTXOs amount) instead of the UTXOs.

pub async fn get_contract_asset_balance( &self, contract_id: &Bech32ContractId, asset_id: AssetId ) -> Result<u64, ProviderError>

Get the balance of all spendable coins asset_id for contract with id contract_id.

pub async fn get_balances( &self, address: &Bech32Address ) -> Result<HashMap<String, u64>, ProviderError>

Get all the spendable balances of all assets for address address. This is different from getting the coins because we are only returning the numbers (the sum of UTXOs coins amount for each asset id) and not the UTXOs coins themselves

pub async fn get_contract_balances( &self, contract_id: &Bech32ContractId ) -> Result<HashMap<AssetId, u64>, ProviderError>

Get all balances of all assets for the contract with id contract_id.

pub async fn get_transaction_by_id( &self, tx_id: &TxId ) -> Result<Option<TransactionResponse>, ProviderError>

pub async fn get_transactions( &self, request: PaginationRequest<String> ) -> Result<PaginatedResult<TransactionResponse, String>, ProviderError>

pub async fn get_transactions_by_owner( &self, owner: &Bech32Address, request: PaginationRequest<String> ) -> Result<PaginatedResult<TransactionResponse, String>, ProviderError>

pub async fn latest_block_height(&self) -> Result<u32, ProviderError>

pub async fn latest_block_time( &self ) -> Result<Option<DateTime<Utc>>, ProviderError>

pub async fn produce_blocks( &self, blocks_to_produce: u64, start_time: Option<DateTime<Utc>> ) -> Result<u32>

pub async fn block( &self, block_id: &Bytes32 ) -> Result<Option<Block>, ProviderError>

Get block by id.

pub async fn get_blocks( &self, request: PaginationRequest<String> ) -> Result<PaginatedResult<Block, String>, ProviderError>

pub async fn estimate_transaction_cost<T: Transaction>( &self, tx: T, tolerance: Option<f64> ) -> Result<TransactionCost>

pub async fn get_messages( &self, from: &Bech32Address ) -> Result<Vec<Message>, ProviderError>

pub async fn get_message_proof( &self, tx_id: &TxId, message_id: &MessageId, commit_block_id: Option<&Bytes32>, commit_block_height: Option<u32> ) -> Result<Option<MessageProof>, ProviderError>

Trait Implementations

impl Clone for Provider

fn clone(&self) -> Provider

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Provider

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.