Struct BlockchainHttpRpcClient 

pub struct BlockchainHttpRpcClient { /* private fields */ }

Client for making HTTP-based RPC requests to blockchain nodes.

This client is designed to interact with Ethereum-compatible blockchain networks, providing methods to execute RPC calls and handle responses in a type-safe manner.

Implementations

impl BlockchainHttpRpcClient

pub fn new(http_rpc_url: String, rpc_request_per_second: Option<u32>) -> Self

Creates a new HTTP RPC client with the given endpoint URL and optional rate limit.

Panics

Panics if rpc_request_per_second is Some(0), since a zero rate limit is invalid.

pub async fn execute_rpc_call<T: DeserializeOwned>( &self, rpc_request: Value, ) -> Result<T>

Executes an Ethereum JSON-RPC call and deserializes the response into the specified type T.

Errors

Returns an error if the HTTP RPC request fails or the response cannot be parsed.

pub fn construct_eth_call( &self, to: &str, call_data: &[u8], block: Option<u64>, ) -> Value

Creates a properly formatted eth_call JSON-RPC request object targeting a specific contract address with encoded function data.

pub async fn get_balance( &self, address: &Address, block: Option<u64>, ) -> Result<U256>

Retrieves the balance of the specified Ethereum address at the given block.

Errors

Returns an error if the RPC call fails or if the returned balance string cannot be parsed as a valid U256.

pub async fn get_logs( &self, address: Option<&Address>, topics: Option<Vec<Option<String>>>, from_block: u64, to_block: u64, ) -> Result<Vec<RpcLog>>

Retrieves logs matching the given filter criteria.

This method calls the eth_getLogs RPC method to fetch event logs from the blockchain. It’s commonly used for querying historical events like token transfers, swaps, etc.

Errors

Returns an error if the RPC call fails or the response cannot be parsed.

Trait Implementations

impl Debug for BlockchainHttpRpcClient

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

Formats the value using the given formatter.