pub struct Provider {
    pub client: FuelClient,
}
Expand description

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

Implementations§

source§

impl Provider

source

pub fn new(client: FuelClient) -> Self

source

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

Sends a transaction to the underlying Provider’s client.

source

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

Connects to an existing node at the given address.

source

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

source

pub async fn consensus_parameters( &self ) -> Result<ConsensusParameters, ProviderError>

source

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

source

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

source

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

source

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.

source

pub async fn get_spendable_resources( &self, filter: ResourceFilter ) -> Result<Vec<Resource>, 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.

source

pub async fn get_asset_inputs( &self, filter: ResourceFilter, witness_index: u8 ) -> Result<Vec<Input>>

Returns a vector consisting of Input::Coins and Input::Messages for the given ResourceFilter. The witness_index is the position of the witness (signature) in the transaction’s list of witnesses. In the validation process, the node will use the witness at this index to validate the coins returned by this method.

source

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.

source

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.

source

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

source

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

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

source

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

source

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

source

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

source

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

source

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

source

pub async fn produce_blocks( &self, amount: u64, time: Option<TimeParameters> ) -> Result<u64>

source

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

Get block by id.

source

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

source

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

source

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

source

pub async fn get_message_proof( &self, tx_id: &str, message_id: &str ) -> Result<Option<MessageProof>, ProviderError>

Trait Implementations§

source§

impl Clone for Provider

source§

fn clone(&self) -> Provider

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for Provider

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> AnyDebug for Twhere T: Any + Debug,

source§

fn as_any_ref(&self) -> &(dyn Any + 'static)

Returns a reference to the underlying type as Any.
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

const: unstable · source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

const: unstable · source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

const: unstable · source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

const: unstable · source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> Same<T> for T

§

type Output = T

Should always be Self
§

impl<T> StorageAsMut for T

§

fn storage<Type>(&mut self) -> StorageMut<'_, Self, Type>where Type: Mappable,

§

fn storage_as_mut<Type>(&mut self) -> StorageMut<'_, Self, Type>where Type: Mappable,

§

impl<T> StorageAsRef for T

§

fn storage<Type>(&self) -> StorageRef<'_, Self, Type>where Type: Mappable,

§

fn storage_as_ref<Type>(&self) -> StorageRef<'_, Self, Type>where Type: Mappable,

source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
const: unstable · source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
const: unstable · source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for Twhere V: MultiLane<T>,

§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
§

impl<T> IsFieldType<T> for T