Struct IERC20Instance

pub struct IERC20Instance<T, P, N = Ethereum> {
    address: Address,
    provider: P,
    _network_transport: PhantomData<(N, T)>,
}

A IERC20 instance.

Contains type-safe methods for interacting with an on-chain instance of the IERC20 contract located at a given address, using a given provider P.

If the contract bytecode is available (see the sol! documentation on how to provide it), the deploy and deploy_builder methods can be used to deploy a new instance of the contract.

See the module-level documentation for all the available methods.

Fields

address: Address

provider: P

_network_transport: PhantomData<(N, T)>

Implementations

impl<T: Transport + Clone, P: Provider<T, N>, N: Network> IERC20Instance<T, P, N>

Instantiation and getters/setters.

pub const fn new(address: Address, provider: P) -> Self

Creates a new wrapper around an on-chain IERC20 contract instance.

See the wrapper’s documentation for more details.

pub const fn address(&self) -> &Address

Returns a reference to the address.

pub fn set_address(&mut self, address: Address)

Sets the address.

pub fn at(self, address: Address) -> Self

Sets the address and returns self.

pub const fn provider(&self) -> &P

Returns a reference to the provider.

impl<T, P: Clone, N> IERC20Instance<T, &P, N>

pub fn with_cloned_provider(self) -> IERC20Instance<T, P, N>

Clones the provider and returns a new instance with the cloned provider.

impl<T: Transport + Clone, P: Provider<T, N>, N: Network> IERC20Instance<T, P, N>

Function calls.

pub fn call_builder<C: SolCall>(&self, call: &C) -> SolCallBuilder<T, &P, C, N>

Creates a new call builder using this contract instance’s provider and address.

Note that the call can be any function call, not just those defined in this contract. Prefer using the other methods for building type-safe contract calls.

pub fn decimals(&self) -> SolCallBuilder<T, &P, decimalsCall, N>

Creates a new call builder for the [decimals] function.

pub fn totalSupply(&self) -> SolCallBuilder<T, &P, totalSupplyCall, N>

Creates a new call builder for the [totalSupply] function.

pub fn balanceOf( &self, account: Address, ) -> SolCallBuilder<T, &P, balanceOfCall, N>

Creates a new call builder for the [balanceOf] function.

pub fn transfer( &self, to: Address, amount: U256, ) -> SolCallBuilder<T, &P, transferCall, N>

Creates a new call builder for the [transfer] function.

pub fn allowance( &self, owner: Address, spender: Address, ) -> SolCallBuilder<T, &P, allowanceCall, N>

Creates a new call builder for the [allowance] function.

pub fn approve( &self, spender: Address, amount: U256, ) -> SolCallBuilder<T, &P, approveCall, N>

Creates a new call builder for the [approve] function.

pub fn transferFrom( &self, from: Address, to: Address, amount: U256, ) -> SolCallBuilder<T, &P, transferFromCall, N>

Creates a new call builder for the [transferFrom] function.

impl<T: Transport + Clone, P: Provider<T, N>, N: Network> IERC20Instance<T, P, N>

Event filters.

pub fn event_filter<E: SolEvent>(&self) -> Event<T, &P, E, N>

Creates a new event filter using this contract instance’s provider and address.

Note that the type can be any event, not just those defined in this contract. Prefer using the other methods for building type-safe event filters.

pub fn Transfer_filter(&self) -> Event<T, &P, Transfer, N>

Creates a new event filter for the Transfer event.

pub fn Approval_filter(&self) -> Event<T, &P, Approval, N>

Creates a new event filter for the Approval event.

Trait Implementations

impl<T: Clone, P: Clone, N: Clone> Clone for IERC20Instance<T, P, N>

fn clone(&self) -> IERC20Instance<T, P, N>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T, P, N> Debug for IERC20Instance<T, P, N>

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

Formats the value using the given formatter.

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.