Struct ethcontract::contract::ViewMethodBuilder

#[must_use = "view methods do nothing unless you `.call()` them"]
pub struct ViewMethodBuilder<T: Transport, R: Tokenize> {
    pub m: MethodBuilder<T, R>,
    pub block: Option<BlockId>,
}

Data used for building a contract method call. The view method builder can’t directly send transactions and is for read only method calls.

Fields

m: MethodBuilder<T, R>

method parameters

block: Option<BlockId>

optional block number

Implementations

impl<T: Transport, R: Tokenize> ViewMethodBuilder<T, R>

pub fn from_method(method: MethodBuilder<T, R>) -> Self

Create a new ViewMethodBuilder by demoting a MethodBuilder.

pub fn with_defaults(self, defaults: &MethodDefaults) -> Self

Apply method defaults to this builder.

pub fn from(self, value: Address) -> Self

Specify the account the transaction is being sent from.

pub fn gas(self, value: U256) -> Self

Secify amount of gas to use, if not specified then a gas estimate will be used.

pub fn gas_price(self, value: GasPrice) -> Self

Specify the gas price to use, if not specified then the estimated gas price will be used.

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

Specify what how much ETH to transfer with the transaction, if not specified then no ETH will be sent.

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

Specify the nonce for the transation, if not specified will use the current transaction count for the signing account.

impl<T: Transport, R: Tokenize> ViewMethodBuilder<T, R>

pub async fn call(self) -> Result<R, MethodError>

Call a contract method. Contract calls do not modify the blockchain and as such do not require gas or signing.

pub fn batch_call<B: BatchTransport>(
    self,
    batch: &mut CallBatch<B>
) -> impl Future<Output = Result<R, MethodError>>

Adds this view method to a batch. Allows execution with other contract calls in one roundtrip The returned future only resolve once batch is resolved. Panics, if batch is dropped before executing

Trait Implementations

impl<T: Clone + Transport, R: Clone + Tokenize> Clone for ViewMethodBuilder<T, R>

fn clone(&self) -> ViewMethodBuilder<T, R>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Transport, R: Debug + Tokenize> Debug for ViewMethodBuilder<T, R>

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

Formats the value using the given formatter.