Struct Erc20Contract 

pub struct Erc20Contract { /* private fields */ }

Interface for interacting with ERC20 token contracts on a blockchain.

This struct provides methods to fetch token metadata (name, symbol, decimals). From ERC20-compliant tokens on any EVM-compatible blockchain.

Implementations

impl Erc20Contract

pub fn new( client: Arc<BlockchainHttpRpcClient>, enforce_token_fields: bool, ) -> Self

Creates a new ERC20 contract interface with the specified RPC client.

pub async fn fetch_token_info( &self, token_address: &Address, ) -> Result<TokenInfo, TokenInfoError>

Fetches complete token information (name, symbol, decimals) from an ERC20 contract.

Errors

Returns an error if any of the contract calls fail.

• BlockchainRpcClientError::ClientError if an RPC call fails.
• BlockchainRpcClientError::AbiDecodingError if ABI decoding fails.

pub async fn batch_fetch_token_info( &self, token_addresses: &[Address], ) -> Result<HashMap<Address, Result<TokenInfo, TokenInfoError>>, BlockchainRpcClientError>

Fetches token information for multiple tokens in a single multicall.

If the multicall fails (typically due to expired/broken contracts causing RPC “out of gas”), automatically falls back to individual token fetches to isolate problematic contracts.

Errors

Returns an error only if the operation cannot proceed. Multicall failures trigger automatic fallback to individual fetches. Individual token failures are captured in the Result values of the returned HashMap.

pub async fn balance_of( &self, token_address: &Address, account: &Address, ) -> Result<U256, BlockchainRpcClientError>

Fetches the balance of a specific account for this ERC20 token.

Errors

Returns an error if the contract call fails.

• BlockchainRpcClientError::ClientError if an RPC call fails.
• BlockchainRpcClientError::AbiDecodingError if ABI decoding fails.

Trait Implementations

impl Debug for Erc20Contract

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

Formats the value using the given formatter.