Struct EthCall

pub struct EthCall<N, Resp, Output = Resp, Map = fn(Resp) -> Output>
where
    N: Network,
    Resp: RpcRecv,
    Map: Fn(Resp) -> Output,
{ /* private fields */ }

A builder for an "eth_call" request. This type is returned by the Provider::call method.

Implementations

impl<N, Resp> EthCall<N, Resp>

where N: Network, Resp: RpcRecv,

pub fn new( caller: impl Caller<N, Resp> + 'static, method: &'static str, data: N::TransactionRequest, ) -> Self

Create a new EthCall.

pub fn call( caller: impl Caller<N, Resp> + 'static, data: N::TransactionRequest, ) -> Self

Create a new EthCall with method set to "eth_call".

pub fn gas_estimate( caller: impl Caller<N, Resp> + 'static, data: N::TransactionRequest, ) -> Self

Create a new EthCall with method set to "eth_estimateGas".

impl<N, Resp, Output, Map> EthCall<N, Resp, Output, Map>

where N: Network, Resp: RpcRecv, Map: Fn(Resp) -> Output,

pub fn map_resp<NewOutput, NewMap>( self, map: NewMap, ) -> EthCall<N, Resp, NewOutput, NewMap>

where NewMap: Fn(Resp) -> NewOutput,

Map the response to a different type. This is usable for converting the response to a more usable type, e.g. changing U64 to u64.

Note

Carefully review the rust documentation on fn pointers before passing them to this function. Unless the pointer is specifically coerced to a fn(_) -> _, the NewMap will be inferred as that function’s unique type. This can lead to confusing error messages.

pub fn overrides(self, overrides: impl Into<StateOverride>) -> Self

Set the state overrides for this call.

pub fn overrides_opt(self, overrides: Option<StateOverride>) -> Self

Set the state overrides for this call, if any.

pub fn account_override( self, address: Address, account_override: AccountOverride, ) -> Self

Appends a single AccountOverride to the state override.

Creates a new StateOverride if none has been set yet.

pub fn account_overrides( self, overrides: impl IntoIterator<Item = (Address, AccountOverride)>, ) -> Self

Extends the given AccountOverride to the state override.

Creates a new StateOverride if none has been set yet.

pub fn with_block_overrides(self, overrides: BlockOverrides) -> Self

Sets the block overrides for this call.

pub fn with_block_overrides_opt(self, overrides: Option<BlockOverrides>) -> Self

Sets the block overrides for this call, if any.

pub const fn block(self, block: BlockId) -> Self

Set the block to use for this call.

pub const fn pending(self) -> Self

Set the block id to “pending”.

pub const fn latest(self) -> Self

Set the block id to “latest”.

pub const fn earliest(self) -> Self

Set the block id to “earliest”.

pub const fn finalized(self) -> Self

Set the block id to “finalized”.

pub const fn safe(self) -> Self

Set the block id to “safe”.

pub const fn number(self, number: u64) -> Self

Set the block id to a specific height.

pub const fn hash(self, hash: B256) -> Self

Set the block id to a specific hash, without requiring the hash be part of the canonical chain.

pub const fn hash_canonical(self, hash: B256) -> Self

Set the block id to a specific hash and require the hash be part of the canonical chain.

impl<N> EthCall<N, Bytes>

where N: Network,

pub fn decode_resp<S: SolCall>(self) -> EthCall<N, Bytes, Result<S::Return>>

Decode the Bytes returned by an "eth_call" into a SolCall::Return type.

Note

The result of the eth_call will be alloy_sol_types::Result with the Ok variant containing the decoded SolCall::Return type.

Examples

let call = EthCall::call(provider, data).decode_resp::<MySolCall>().await?.unwrap();

assert!(matches!(call.return_value, MySolCall::MyStruct { .. }));

Trait Implementations

impl<N, Resp, Output: Clone, Map> Clone for EthCall<N, Resp, Output, Map>

where N: Network + Clone, Resp: RpcRecv + Clone, Map: Fn(Resp) -> Output + Clone,

fn clone(&self) -> EthCall<N, Resp, Output, Map>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<N, Resp> Debug for EthCall<N, Resp>

where N: Network, Resp: RpcRecv,

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

Formats the value using the given formatter.

impl<N, Resp, Output, Map> IntoFuture for EthCall<N, Resp, Output, Map>

where N: Network, Resp: RpcRecv, Output: 'static, Map: Fn(Resp) -> Output,

type Output = Result<Output, RpcError<TransportErrorKind>>

The output that the future will produce on completion.

type IntoFuture = EthCallFut<N, Resp, Output, Map>

Which kind of future are we turning this into?

fn into_future(self) -> Self::IntoFuture

Creates a future from a value.