#ethereum #crypto #etherscan #ethers #web3

foundry-block-explorers

Bindings for Etherscan.io and other block explorer APIs

24 releases (8 breaking)

new 0.9.0 Nov 18, 2024
0.7.3 Sep 19, 2024
0.5.1 Jul 19, 2024
0.2.4 Mar 29, 2024
0.1.1 Nov 23, 2023

#3 in #ethers

Download history 2657/week @ 2024-07-29 4782/week @ 2024-08-05 3342/week @ 2024-08-12 3237/week @ 2024-08-19 4177/week @ 2024-08-26 5528/week @ 2024-09-02 3335/week @ 2024-09-09 3044/week @ 2024-09-16 2326/week @ 2024-09-23 2810/week @ 2024-09-30 2401/week @ 2024-10-07 3251/week @ 2024-10-14 1750/week @ 2024-10-21 1504/week @ 2024-10-28 2019/week @ 2024-11-04 2516/week @ 2024-11-11

7,949 downloads per month
Used in 8 crates (3 directly)

MIT/Apache

130KB
2.5K SLoC

foundry-block-explorers

Bindings for Etherscan.io and other block explorer APIs.

Originally part of ethers-rs as ethers-etherscan.

Build Status Telegram chat

Examples

use alloy_chains::Chain;
use foundry_block_explorers::Client;

async fn foo() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new(Chain::mainnet(), "<your_api_key>")?;
    // Or using environment variables
    let client = Client::new_from_env(Chain::mainnet())?;

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

Supported Rust Versions

Foundry will keep a rolling MSRV (minimum supported rust version) policy of at least 6 months. When increasing the MSRV, the new Rust version must have been released at least six months ago. The current MSRV is 1.65.0.

Note that the MSRV is not increased automatically, and only as part of a minor release.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in these crates by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~19–34MB
~573K SLoC