Struct Client

pub struct Client { /* private fields */ }

Client for Blobscan API

See also Blobscan API Documentation

Implementations

impl Client

pub fn new(baseurl: impl Into<String>) -> Self

Create a new client.

baseurl is the base URL provided to the internal reqwest::Client

pub fn new_chain(chain: Chain) -> Option<Self>

Create a new client instance for blobscan.com with the correct endpoint based on the chain.

At this time, only the following chains are supported by Blobscan:

• Ethereum Mainnet: https://api.blobscan.com/
• Sepolia Testnet: https://api.sepolia.blobscan.com/
• Holesky Testnet: https://api.holesky.blobscan.com/

For other chains this will return None

pub fn new_chain_with_client(chain: Chain, client: Client) -> Option<Self>

Create a new client instance for blobscan.com with the given reqwest::Client and the correct endpoint based on the chain.

At this time, only the following chains are supported by Blobscan:

• Ethereum Mainnet: https://api.blobscan.com/
• Sepolia Testnet: https://api.sepolia.blobscan.com/
• Holesky Testnet: https://api.holesky.blobscan.com/

For other chains this will return None

pub fn mainnet() -> Self

Creates a new client instance for the Ethereum Mainnet with the correct endpoint: https://api.blobscan.com/

pub fn sepolia() -> Self

Creates a new client instance for the sepolia Testnet with the correct endpoint: https://api.sepolia.blobscan.com/

pub fn holesky() -> Self

Creates a new client instance for the holesky Testnet with the correct endpoint: https://api.holesky.blobscan.com/

pub fn mainnet_with_client(client: Client) -> Self

Creates a new client instance for the Ethereum Mainnet with the given reqwest::Client and the correct endpoint: https://api.blobscan.com/

pub fn sepolia_with_client(client: Client) -> Self

Creates a new client instance for the sepolia Testnet with the given reqwest::Client and the correct endpoint: https://api.sepolia.blobscan.com/

pub fn holesky_with_client(client: Client) -> Self

Creates a new client instance for the holesky Testnet with the given reqwest::Client and the correct endpoint: https://api.holesky.blobscan.com/

pub fn new_with_client(baseurl: impl Into<String>, client: Client) -> Self

Construct a new client with an existing reqwest::Client allowing more control over its configuration.

baseurl is the base URL provided to the internal

pub fn baseurl(&self) -> &str

Get the base URL to which requests are made.

pub fn client(&self) -> &Client

Get the internal reqwest::Client used to make requests.

pub async fn transaction(&self, tx_hash: B256) -> Result<TransactionDetails>

Retrieves the full transaction details for given block transaction hash.

Sends a GET request to /transactions/{hash}

Example

use alloy_primitives::b256;
use foundry_blob_explorers::Client;
let client = Client::holesky();
let tx = client
    .transaction(b256!("d4f136048a56b9b62c9cdca0ce0dbb224295fd0e0170dbbc78891d132f639d60"))
    .await
    .unwrap();
println!("[{}] blob: {:?}", tx.hash, tx.blob_sidecar());

pub async fn transaction_with_query( &self, tx_hash: B256, query: GetTransactionQuery, ) -> Result<TransactionDetails>

Retrieves the specific transaction details for given transaction hash.

Sends a GET request to /transactions/{hash}

pub async fn block( &self, block: BlockHashOrNumber, ) -> Result<BlockResponse<FullTransactionDetails>>

Retrieves the full block details for given block number or hash.

Sends a GET request to /blocks/{id}

Example

use foundry_blob_explorers::Client;
let client = Client::holesky();
let block = client
    .block(
        "0xc3a0113f60107614d1bba950799903dadbc2116256a40b1fefb37e9d409f1866".parse().unwrap(),
    )
    .await
    .unwrap();
for (tx, sidecar) in block.blob_sidecars() {
    println!("[{}] blob: {:?}", tx, sidecar);
}

pub async fn block_with_query( &self, block: BlockHashOrNumber, query: GetBlockQuery, ) -> Result<BlockResponse<SelectedTransactionDetails>>

Retrieves the specific block details for given block number or hash.

Sends a GET request to /blocks/{id}

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.