Struct Rpc 

pub struct Rpc { /* private fields */ }

A connection to an Ethereum JSON-RPC endpoint over HTTP, with optional basic authentication and local method overrides.

Implementations

impl Rpc

pub fn new(host: impl Into<String>) -> Rpc

Returns a new RPC client targeting the given endpoint. Pass an empty host to build an override-only handler.

pub fn set_override<F>(&mut self, method: impl Into<String>, f: F)

where F: Fn(&[Value]) -> Result<Value> + Send + Sync + 'static,

Redirects calls to method to a local function instead of the remote node. The function receives the call’s positional parameters.

pub fn set_host(&mut self, host: impl Into<String>)

Sets the host for subsequent requests.

pub fn host(&self) -> &str

Returns the configured host.

pub fn set_basic_auth( &mut self, username: impl Into<String>, password: impl Into<String>, )

Sets HTTP basic auth credentials for subsequent requests.

pub fn lag(&self) -> Duration

Returns how long this endpoint took to answer eth_blockNumber during evaluate, or zero if it was never probed.

pub fn block(&self) -> u64

Returns the latest block number observed during evaluate, or zero if it was never probed.

pub async fn call(&self, method: &str, params: Vec<Value>) -> Result<Value>

Performs a request using positional arguments.

pub async fn call_named( &self, method: &str, params: Map<String, Value>, ) -> Result<Value>

Performs a request using named arguments.

pub async fn call_as<T: DeserializeOwned>( &self, method: &str, params: Vec<Value>, ) -> Result<T>

Performs a request and deserializes the result into T via serde.

pub async fn send(&self, req: &Request) -> Result<Value>

Sends a raw Request to the endpoint and returns the raw result value.

impl Rpc

pub async fn forward( &self, req: &Request, opts: &ForwardOptions, ) -> ForwardResponse

Builds the response for a JSON-RPC request suitable for proxying back to an HTTP client. Overridden methods are executed locally; otherwise the request is forwarded to the node and its response relayed (with hop-by-hop headers stripped). The returned ForwardResponse is framework-agnostic — write its status, headers, and body to your response object.

Trait Implementations

impl Clone for Rpc

fn clone(&self) -> Rpc

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Rpc

fn default() -> Rpc

Returns the “default value” for a type.

impl Handler for Rpc

fn call<'life0, 'life1, 'async_trait>( &'life0 self, method: &'life1 str, params: Vec<Value>, ) -> Pin<Box<dyn Future<Output = Result<Value>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Performs a JSON-RPC call with positional parameters.