Struct UtilityCallApi

pub struct UtilityCallApi<'api> { /* private fields */ }

Implementations

impl<'api> UtilityCallApi<'api>

pub fn batch(&self, calls: Vec<RuntimeCall>) -> Result<WrappedCall>

Send a batch of dispatch calls.

May be called from any origin except None.

• calls: The calls to be dispatched from the same origin. The number of call must not exceed the constant: batched_calls_limit (available in constant metadata).

If origin is root then the calls are dispatched without checking origin filter. (This includes bypassing frame_system::Config::BaseCallFilter).

Complexity

• O(C) where C is the number of calls to be batched.

This will return Ok in all circumstances. To determine the success of the batch, an event is deposited. If a call failed and the batch was interrupted, then the BatchInterrupted event is deposited, along with the number of successful calls made and the error of the failed call. If all were successful, then the BatchCompleted event is deposited.

pub fn relay_tx( &self, target: AccountId, signature: MultiSignature, call: UniqueCall<RuntimeCall>, ) -> Result<WrappedCall>

Relay a call for a target from an origin

Relaying in this context refers to the ability of origin to make a call on behalf of target.

Fees are charged to origin

Parameters

• target: Account to be relayed
• signature: Signature from target authorizing the relay
• call: Call to be relayed on behalf of target

POLYMESH: added.

pub fn batch_all(&self, calls: Vec<RuntimeCall>) -> Result<WrappedCall>

Send a batch of dispatch calls and atomically execute them. The whole transaction will rollback and fail if any of the calls failed.

May be called from any origin except None.

• calls: The calls to be dispatched from the same origin. The number of call must not exceed the constant: batched_calls_limit (available in constant metadata).

If origin is root then the calls are dispatched without checking origin filter. (This includes bypassing frame_system::Config::BaseCallFilter).

Complexity

• O(C) where C is the number of calls to be batched.

pub fn dispatch_as( &self, as_origin: OriginCaller, call: RuntimeCall, ) -> Result<WrappedCall>

Dispatches a function call with a provided origin.

The dispatch origin for this call must be Root.

Complexity

• O(1).

pub fn force_batch(&self, calls: Vec<RuntimeCall>) -> Result<WrappedCall>

Send a batch of dispatch calls. Unlike batch, it allows errors and won’t interrupt.

May be called from any origin except None.

• calls: The calls to be dispatched from the same origin. The number of call must not exceed the constant: batched_calls_limit (available in constant metadata).

If origin is root then the calls are dispatch without checking origin filter. (This includes bypassing frame_system::Config::BaseCallFilter).

Complexity

• O(C) where C is the number of calls to be batched.

pub fn with_weight( &self, call: RuntimeCall, weight: Weight, ) -> Result<WrappedCall>

Dispatch a function call with a specified weight.

This function does not check the weight of the call, and instead allows the Root origin to specify the weight of the call.

The dispatch origin for this call must be Root.

pub fn as_derivative( &self, index: u16, call: RuntimeCall, ) -> Result<WrappedCall>

Send a call through an indexed pseudonym of the sender.

Filter from origin are passed along. The call will be dispatched with an origin which use the same filter as the origin of this call.

The dispatch origin for this call must be Signed.

Trait Implementations

impl<'api> Clone for UtilityCallApi<'api>

fn clone(&self) -> UtilityCallApi<'api>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'api> From<&'api Api> for UtilityCallApi<'api>

fn from(api: &'api Api) -> Self

Converts to this type from the input type.