Struct Etherscan

pub struct Etherscan { /* private fields */ }

A client over HTTP for the Etherscan gas tracker API that implements the GasOracle trait

Implementations

impl Etherscan

pub fn new(client: Client) -> Etherscan

Creates a new Etherscan gas price oracle.

pub fn category(self, gas_category: GasCategory) -> Etherscan

Sets the gas price category to be used when fetching the gas price.

pub async fn query(&self) -> Result<GasOracle, GasOracleError>

Perform a request to the gas price API and deserialize the response.

Methods from Deref<Target = Client>

pub async fn get_ether_balance_single( &self, address: &H160, tag: Option<Tag>, ) -> Result<AccountBalance, EtherscanError>

Returns the Ether balance of a given address.

Examples

let address = "0x58eB28A67731c570Ef827C365c89B5751F9E6b0a".parse()?;
let balance = client.get_ether_balance_single(&address, None).await?;

pub async fn get_ether_balance_multi( &self, addresses: &[H160], tag: Option<Tag>, ) -> Result<Vec<AccountBalance>, EtherscanError>

Returns the balance of the accounts from a list of addresses.

Examples

let addresses = [
    "0x3E3c00494d0b306a0739E480DBB5DB91FFb5d4CB".parse::<Address>()?,
    "0x7e9996ef050a9Fa7A01248e63271F69086aaFc9D".parse::<Address>()?,
];
let balances = client.get_ether_balance_multi(&addresses, None).await?;
assert_eq!(addresses.len(), balances.len());

pub async fn get_transactions( &self, address: &H160, params: Option<TxListParams>, ) -> Result<Vec<NormalTransaction>, EtherscanError>

Returns the list of transactions performed by an address, with optional pagination.

Examples

let address = "0x1f162cf730564efD2Bb96eb27486A2801d76AFB6".parse()?;
let transactions = client.get_transactions(&address, None).await?;

pub async fn get_internal_transactions( &self, tx_query_option: InternalTxQueryOption, params: Option<TxListParams>, ) -> Result<Vec<InternalTransaction>, EtherscanError>

Returns the list of internal transactions performed by an address or within a transaction, with optional pagination.

Examples

use ethers_etherscan::account::InternalTxQueryOption;

let address = "0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3".parse()?;
let query = InternalTxQueryOption::ByAddress(address);
let internal_transactions = client.get_internal_transactions(query, None).await?;

pub async fn get_erc20_token_transfer_events( &self, event_query_option: TokenQueryOption, params: Option<TxListParams>, ) -> Result<Vec<ERC20TokenTransferEvent>, EtherscanError>

Returns the list of ERC-20 tokens transferred by an address, with optional filtering by token contract.

Examples

use ethers_etherscan::account::TokenQueryOption;

let address = "0x4e83362442b8d1bec281594cea3050c8eb01311c".parse()?;
let query = TokenQueryOption::ByAddress(address);
let events = client.get_erc20_token_transfer_events(query, None).await?;

pub async fn get_erc721_token_transfer_events( &self, event_query_option: TokenQueryOption, params: Option<TxListParams>, ) -> Result<Vec<ERC721TokenTransferEvent>, EtherscanError>

Returns the list of ERC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract.

Examples

use ethers_etherscan::account::TokenQueryOption;

let contract = "0x06012c8cf97bead5deae237070f9587f8e7a266d".parse()?;
let query = TokenQueryOption::ByContract(contract);
let events = client.get_erc721_token_transfer_events(query, None).await?;

pub async fn get_erc1155_token_transfer_events( &self, event_query_option: TokenQueryOption, params: Option<TxListParams>, ) -> Result<Vec<ERC1155TokenTransferEvent>, EtherscanError>

Returns the list of ERC-1155 ( NFT ) tokens transferred by an address, with optional filtering by token contract.

Examples

use ethers_etherscan::account::TokenQueryOption;

let address = "0x216CD350a4044e7016f14936663e2880Dd2A39d7".parse()?;
let contract = "0x495f947276749ce646f68ac8c248420045cb7b5e".parse()?;
let query = TokenQueryOption::ByAddressAndContract(address, contract);
let events = client.get_erc1155_token_transfer_events(query, None).await?;

pub async fn get_mined_blocks( &self, address: &H160, block_type: Option<BlockType>, page_and_offset: Option<(u64, u64)>, ) -> Result<Vec<MinedBlock>, EtherscanError>

Returns the list of blocks mined by an address.

Examples

let address = "0x9dd134d14d1e65f84b706d6f205cd5b1cd03a46b".parse()?;
let blocks = client.get_mined_blocks(&address, None, None).await?;

pub async fn get_beacon_withdrawal_transactions( &self, address: &H160, params: Option<TxListParams>, ) -> Result<Vec<BeaconWithdrawalTransaction>, EtherscanError>

Returns the list of beacon withdrawal transactions performed by an address, with optional pagination.

Examples

let address = "0xB9D7934878B5FB9610B3fE8A5e441e8fad7E293f".parse()?;
let beacon_withdrawal_transactions = client.get_beacon_withdrawal_transactions(&address, None).await?;

pub async fn get_block_by_timestamp( &self, timestamp: u64, closest: &str, ) -> Result<BlockNumberByTimestamp, EtherscanError>

Returns either (1) the oldest block since a particular timestamp occurred or (2) the newest block that occurred prior to that timestamp

Examples

// The newest block that occurred prior to 1 January 2020
let block_number_before = client.get_block_by_timestamp(1577836800, "before");
// The oldest block that occurred after 1 January 2020
let block_number_after = client.get_block_by_timestamp(1577836800, "after");

pub async fn contract_abi( &self, address: H160, ) -> Result<Contract, EtherscanError>

Fetches a verified contract’s ABI.

Example

let address = "0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413".parse()?;
let abi = client.contract_abi(address).await?;

pub async fn contract_source_code( &self, address: H160, ) -> Result<ContractMetadata, EtherscanError>

Fetches a contract’s verified source code and its metadata.

Example

let address = "0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413".parse()?;
let metadata = client.contract_source_code(address).await?;
assert_eq!(metadata.items[0].contract_name, "DAO");

pub async fn gas_estimate(&self, gas_price: U256) -> Result<u32, EtherscanError>

Returns the estimated time, in seconds, for a transaction to be confirmed on the blockchain for the specified gas price

pub async fn gas_oracle(&self) -> Result<GasOracle, EtherscanError>

Returns the current Safe, Proposed and Fast gas prices Post EIP-1559 changes:

• Safe/Proposed/Fast gas price recommendations are now modeled as Priority Fees.
• New field suggestBaseFee, the baseFee of the next pending block
• New field gasUsedRatio, to estimate how busy the network is

pub async fn eth_supply(&self) -> Result<u128, EtherscanError>

Returns the current amount of Ether in circulation excluding ETH2 Staking rewards and EIP1559 burnt fees.

pub async fn eth_supply2(&self) -> Result<EthSupply2, EtherscanError>

Returns the current amount of Ether in circulation, ETH2 Staking rewards, EIP1559 burnt fees, and total withdrawn ETH from the beacon chain.

pub async fn eth_price(&self) -> Result<EthPrice, EtherscanError>

Returns the latest price of 1 ETH.

pub async fn node_count(&self) -> Result<NodeCount, EtherscanError>

Returns the total number of discoverable Ethereum nodes.

pub async fn check_contract_execution_status( &self, tx_hash: impl AsRef<str>, ) -> Result<(), EtherscanError>

Returns the status of a contract execution

pub async fn check_transaction_receipt_status( &self, tx_hash: impl AsRef<str>, ) -> Result<(), EtherscanError>

Returns the status of a transaction execution: false for failed and true for successful

pub async fn submit_contract_verification( &self, contract: &VerifyContract, ) -> Result<Response<String>, EtherscanError>

Submit Source Code for Verification

pub async fn check_contract_verification_status( &self, guid: impl AsRef<str>, ) -> Result<Response<String>, EtherscanError>

Check Source Code Verification Status with receipt received from [Self::submit_contract_verification]

pub async fn submit_proxy_contract_verification( &self, contract: &VerifyProxyContract, ) -> Result<Response<String>, EtherscanError>

Submit Proxy Contract for Verification

pub async fn check_proxy_contract_verification_status( &self, guid: impl AsRef<str>, ) -> Result<Response<String>, EtherscanError>

Check Proxy Contract Verification Status with receipt received from [Self::submit_proxy_contract_verification]

pub fn set_cache( &mut self, root: impl Into<PathBuf>, ttl: Duration, ) -> &mut Client

Sets the root to the cache dir and the ttl to use

pub fn etherscan_api_url(&self) -> &Url

pub fn etherscan_url(&self) -> &Url

pub fn block_url(&self, block: u64) -> String

Return the URL for the given block number

pub fn address_url(&self, address: H160) -> String

Return the URL for the given address

pub fn transaction_url(&self, tx_hash: H256) -> String

Return the URL for the given transaction hash

pub fn token_url(&self, token_hash: H160) -> String

Return the URL for the given token hash

Trait Implementations

impl Clone for Etherscan

fn clone(&self) -> Etherscan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Etherscan

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

Formats the value using the given formatter.

impl DerefMut for Etherscan

fn deref_mut(&mut self) -> &mut <Etherscan as Deref>::Target

Mutably dereferences the value.

impl GasOracle for Etherscan

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

where 'life0: 'async_trait, Etherscan: 'async_trait,

Makes an asynchronous HTTP query to the underlying GasOracle to fetch the current gas price estimate.

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

where 'life0: 'async_trait, Etherscan: 'async_trait,

Makes an asynchronous HTTP query to the underlying GasOracle to fetch the current max gas fee and priority gas fee estimates.

impl Deref for Etherscan

type Target = Client

The resulting type after dereferencing.

fn deref(&self) -> &<Etherscan as Deref>::Target

Dereferences the value.