Struct CallBuilder

pub struct CallBuilder<'a, E, Args, RetType, B, Abi>
where
    E: Environment,
    Args: AbiEncodeWith<Abi> + Clone,
    RetType: Send + AbiDecodeWith<Abi>,
    B: BuilderClient<E>,
    Abi: Clone,
{ /* private fields */ }

Allows to build an end-to-end call using a builder pattern.

Implementations

impl<'a, E, Args, RetType, B, Abi> CallBuilder<'a, E, Args, RetType, B, Abi>

where E: Environment, Args: Sync + AbiEncodeWith<Abi> + Clone, RetType: Send + AbiDecodeWith<Abi>, B: BuilderClient<E>, Abi: Sync + Clone,

pub fn new( client: &'a mut B, caller: &'a Keypair, message: &'a CallBuilderFinal<E, Args, RetType, Abi>, ) -> CallBuilder<'a, E, Args, RetType, B, Abi>

where E::Balance: From<u32>,

Initialize a call builder with defaults values.

pub fn value(&mut self, value: E::Balance) -> &mut Self

Provide value with a call

pub fn extra_gas_portion(&mut self, per_cent: u64) -> &mut Self

Increases the gas limit marginally by a specified percent. Useful when the message’s gas usage depends on the runtime state and the dry run does not produce an accurate gas estimate.

Example

With dry run gas estimate of 100 units and 5% extra gas portion specified, the set gas limit becomes 105 units

pub fn gas_limit(&mut self, limit: Weight) -> &mut Self

Specifies the raw gas limit as part of the call.

Notes

Overwrites any values specified for extra_gas_portion. The gas estimate from the dry-run will be ignored.

pub fn storage_deposit_limit( &mut self, storage_deposit_limit: E::Balance, ) -> &mut Self

Specify the max amount of funds that can be charged for storage.

pub async fn submit( &mut self, ) -> Result<CallResult<E, RetType, B::EventLog>, B::Error>

where CallBuilderFinal<E, Args, RetType, Abi>: Clone,

Submit the call for the on-chain execution.

This will automatically run a dry-run call, and use extra_gas_portion to add a margin to the gas limit.

pub async fn dry_run( &mut self, ) -> Result<CallDryRunResult<E, RetType>, B::Error>

where CallBuilderFinal<E, Args, RetType, Abi>: Clone,

Dry run the call.