Struct ethers_contract::builders::ContractCall

#[must_use = "contract calls do nothing unless you `send` or `call` them"]pub struct ContractCall<'a, P, S, D> {
    pub tx: TransactionRequest,
    pub function: Function,
    pub block: Option<BlockNumber>,
    // some fields omitted
}

Helper for managing a transaction before submitting it to a node

Fields

tx: TransactionRequest

The raw transaction object

function: Function

The ABI of the function being called

block: Option<BlockNumber>

Optional block number to be used when calculating the transaction's gas and nonce

Implementations

impl<'a, P, S, D: Detokenize> ContractCall<'a, P, S, D>

pub fn from<T: Into<Address>>(self, from: T) -> Self

Sets the from field in the transaction to the provided value

pub fn gas<T: Into<U256>>(self, gas: T) -> Self

Sets the gas field in the transaction to the provided value

pub fn gas_price<T: Into<U256>>(self, gas_price: T) -> Self

Sets the gas_price field in the transaction to the provided value

pub fn value<T: Into<U256>>(self, value: T) -> Self

Sets the value field in the transaction to the provided value

pub fn block<T: Into<BlockNumber>>(self, block: T) -> Self

Sets the block field for sending the tx to the chain

impl<'a, P, S, D> ContractCall<'a, P, S, D> where
    S: Signer,
    P: JsonRpcClient,
    D: Detokenize, 

pub async fn call<'_>(&'_ self) -> Result<D, ContractError>

Queries the blockchain via an eth_call for the provided transaction.

If executed on a non-state mutating smart contract function (i.e. view, pure) then it will return the raw data from the chain.

If executed on a mutating smart contract function, it will do a "dry run" of the call and return the return type of the transaction without mutating the state

Note: this function does not send a transaction from your account

pub async fn send(self) -> Result<PendingTransaction<'a, P>, ContractError>

Signs and broadcasts the provided transaction

Trait Implementations

impl<'a, P: Clone, S: Clone, D: Clone> Clone for ContractCall<'a, P, S, D>

fn clone(&self) -> ContractCall<'a, P, S, D>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, P: Debug, S: Debug, D: Debug> Debug for ContractCall<'a, P, S, D>

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

Formats the value using the given formatter.