Struct EthereumClient 

pub struct EthereumClient { /* private fields */ }

Ethereum and EVM-compatible chain client.

Uses block explorer APIs (Etherscan, etc.) or JSON-RPC for data retrieval. Supports multiple networks through configuration.

Implementations

impl EthereumClient

pub fn new(config: &ChainsConfig) -> Result<Self>

Creates a new Ethereum client with the given configuration.

Arguments

• config - Chain configuration containing API keys and endpoints

Returns

Returns a configured EthereumClient instance.

Examples

use scope::chains::EthereumClient;
use scope::config::ChainsConfig;

let config = ChainsConfig::default();
let client = EthereumClient::new(&config).unwrap();

pub fn with_base_url(base_url: &str) -> Self

Creates a client with a custom base URL (for testing or alternative networks).

Arguments

• base_url - The base URL for the block explorer API

pub fn for_chain(chain: &str, config: &ChainsConfig) -> Result<Self>

Creates a client for a specific EVM chain.

Arguments

• chain - Chain identifier (ethereum, polygon, arbitrum, optimism, base, bsc, aegis)
• config - Chain configuration

Supported Chains

• ethereum - Ethereum mainnet via Etherscan
• polygon - Polygon via PolygonScan
• arbitrum - Arbitrum One via Arbiscan
• optimism - Optimism via Etherscan
• base - Base via Basescan
• bsc - BNB Smart Chain (BSC) via BscScan
• aegis - Aegis/Wraith chain (EVM-compatible, uses JSON-RPC directly)

API Version

Uses Etherscan V2 API format which requires an API key for most endpoints. Get a free API key at https://etherscan.io/apis

pub fn chain_name(&self) -> &str

Returns the chain name.

pub fn native_token_symbol(&self) -> &str

Returns the native token symbol.

pub async fn get_balance(&self, address: &str) -> Result<Balance>

Fetches the native token balance for an address.

Arguments

• address - The Ethereum address to query

Returns

Returns a Balance struct with the balance in multiple formats.

Errors

Returns ScopeError::InvalidAddress if the address format is invalid. Returns ScopeError::Request if the API request fails.

pub async fn enrich_balance_usd(&self, balance: &mut Balance)

Enriches a balance with a USD value using DexScreener price lookup.

pub async fn get_transaction(&self, hash: &str) -> Result<Transaction>

Fetches transaction details by hash.

Arguments

• hash - The transaction hash

Returns

Returns Transaction details.

pub async fn get_transactions( &self, address: &str, limit: u32, ) -> Result<Vec<Transaction>>

Fetches recent transactions for an address.

Arguments

• address - The address to query
• limit - Maximum number of transactions

Returns

Returns a vector of Transaction objects.

pub async fn get_block_number(&self) -> Result<u64>

Fetches the current block number.

pub async fn get_erc20_balances( &self, address: &str, ) -> Result<Vec<TokenBalance>>

Fetches ERC-20 token balances for an address.

Uses Etherscan’s tokentx endpoint to find unique tokens the address has interacted with, then fetches current balances for each.

pub async fn get_token_info(&self, token_address: &str) -> Result<Token>

Fetches token information for a contract address.

Arguments

• token_address - The token contract address

Returns

Returns Token information including name, symbol, and decimals.

pub async fn get_token_holders( &self, token_address: &str, limit: u32, ) -> Result<Vec<TokenHolder>>

Fetches the top token holders for a given token.

Arguments

• token_address - The token contract address
• limit - Maximum number of holders to return (max 1000 for most APIs)

Returns

Returns a vector of TokenHolder objects sorted by balance.

Note

This requires an Etherscan Pro API key for most networks.

pub async fn get_token_holder_count(&self, token_address: &str) -> Result<u64>

Gets the total holder count for a token.

Uses Etherscan token holder list endpoint to estimate the count. If the API returns a full page at the max limit, the count is approximate.

Trait Implementations

impl ChainClient for EthereumClient

fn chain_name(&self) -> &str

Returns the name of the blockchain network.

fn native_token_symbol(&self) -> &str

Returns the native token symbol (e.g., “ETH”, “MATIC”).

fn get_balance<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Balance>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches the native token balance for an address.

fn enrich_balance_usd<'life0, 'life1, 'async_trait>( &'life0 self, balance: &'life1 mut Balance, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Enriches a balance with USD valuation via DexScreener.

fn get_transaction<'life0, 'life1, 'async_trait>( &'life0 self, hash: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Transaction>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches transaction details by hash.

fn get_transactions<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, limit: u32, ) -> Pin<Box<dyn Future<Output = Result<Vec<Transaction>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches recent transactions for an address.

fn get_block_number<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<u64>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Fetches the current block number.

fn get_token_balances<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<TokenBalance>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches token balances for an address.

fn get_token_info<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Token>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches token information for a contract address.

fn get_token_holders<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, limit: u32, ) -> Pin<Box<dyn Future<Output = Result<Vec<TokenHolder>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches top token holders for a contract address.

fn get_token_holder_count<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<u64>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches total token holder count for a contract address.

impl Clone for EthereumClient

fn clone(&self) -> EthereumClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EthereumClient

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

Formats the value using the given formatter.

impl Default for EthereumClient

fn default() -> Self

Returns the “default value” for a type.