Struct ethers_etherscan::Client

pub struct Client { /* fields omitted */ }

The Etherscan.io API client.

Implementations

impl Client

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 contract_abi(
    &self,
    address: Address
) -> Result<Abi, EtherscanError>

Returns the contract ABI of a verified contract

    let client = Client::new(Chain::Mainnet, "API_KEY").unwrap();
    let abi = client
        .contract_abi("0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413".parse().unwrap())
        .await.unwrap();

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

Get Contract Source Code for Verified Contract Source Codes

    let client = Client::new(Chain::Mainnet, "API_KEY").unwrap();
    let meta = client
        .contract_source_code("0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413".parse().unwrap())
        .await.unwrap();
    let code = meta.source_code();

impl Client

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

impl Client

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

impl Client

pub fn new(
    chain: Chain,
    api_key: impl Into<String>
) -> Result<Self, EtherscanError>

Create a new client with the correct endpoints based on the chain and provided API key

pub fn new_from_env(chain: Chain) -> Result<Self, EtherscanError>

Create a new client with the correct endpoints based on the chain and API key from ETHERSCAN_API_KEY environment variable

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: Address) -> String

Return the URL for the given address

pub fn transaction_url(&self, tx_hash: impl AsRef<str>) -> String

Return the URL for the given transaction hash

pub fn token_url(&self, token_hash: impl AsRef<str>) -> String

Return the URL for the given token hash

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.