Struct ContractResult 

pub struct ContractResult<R, Balance> {
    pub weight_consumed: Weight,
    pub weight_required: Weight,
    pub storage_deposit: StorageDeposit<Balance>,
    pub max_storage_deposit: StorageDeposit<Balance>,
    pub gas_consumed: Balance,
    pub result: Result<R, DispatchError>,
}

Result type of a bare_call or bare_instantiate call as well as ContractsApi::call and ContractsApi::instantiate.

It contains the execution result together with some auxiliary information.

#Note

It has been extended to include events at the end of the struct while not bumping the ContractsApi version. Therefore when SCALE decoding a ContractResult its trailing data should be ignored to avoid any potential compatibility issues.

Fields

weight_consumed: Weight

How much weight was consumed during execution.

weight_required: Weight

How much weight is required as weight limit in order to execute this call.

This value should be used to determine the weight limit for on-chain execution.

Note

This can only be different from Self::weight_consumed when weight pre charging is used. Currently, only seal_call_runtime makes use of pre charging. Additionally, any seal_call or seal_instantiate makes use of pre-charging when a non-zero weight_limit argument is supplied.

storage_deposit: StorageDeposit<Balance>

How much balance was paid by the origin into the contract’s deposit account in order to pay for storage.

The storage deposit is never actually charged from the origin in case of Self::result is Err. This is because on error all storage changes are rolled back including the payment of the deposit.

max_storage_deposit: StorageDeposit<Balance>

The maximal storage deposit amount that occured at any time during the execution. This can be higher than the final storage_deposit due to refunds This is always a StorageDeposit::Charge(..)

gas_consumed: Balance

The amount of Ethereum gas that has been consumed during execution.

result: Result<R, DispatchError>

The execution result of the vm binary code.

Implementations

impl<T, Balance> ContractResult<T, Balance>

pub fn map_result<V>( self, map_fn: impl FnOnce(T) -> V, ) -> ContractResult<V, Balance>

Trait Implementations

impl<R: Clone, Balance: Clone> Clone for ContractResult<R, Balance>

fn clone(&self) -> ContractResult<R, Balance>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<R, Balance> Debug for ContractResult<R, Balance>

where R: Debug, Balance: Debug,

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

Formats the value using the given formatter.

impl<R, Balance> Decode for ContractResult<R, Balance>

where StorageDeposit<Balance>: Decode, Balance: Decode, Result<R, DispatchError>: Decode,

fn decode<__CodecInputEdqy: Input>( __codec_input_edqy: &mut __CodecInputEdqy, ) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn decode_into<I>( input: &mut I, dst: &mut MaybeUninit<Self>, ) -> Result<DecodeFinished, Error>

where I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

fn skip<I>(input: &mut I) -> Result<(), Error>

where I: Input,

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl<R: Default, B: Balance> Default for ContractResult<R, B>

fn default() -> Self

Returns the “default value” for a type.

impl<R, Balance> Encode for ContractResult<R, Balance>

where StorageDeposit<Balance>: Encode, Balance: Encode, Result<R, DispatchError>: Encode,

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

fn encode_to<__CodecOutputEdqy: Output + ?Sized>( &self, __codec_dest_edqy: &mut __CodecOutputEdqy, )

Convert self to a slice and append it to the destination.

fn encode(&self) -> Vec<u8>

Convert self to an owned vector.

fn using_encoded<R, F>(&self, f: F) -> R

where F: FnOnce(&[u8]) -> R,

Convert self to a slice and then invoke the given closure with it.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl<R: PartialEq, Balance: PartialEq> PartialEq for ContractResult<R, Balance>

fn eq(&self, other: &ContractResult<R, Balance>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<R, Balance> TypeInfo for ContractResult<R, Balance>

where StorageDeposit<Balance>: TypeInfo + 'static, Balance: TypeInfo + 'static, Result<R, DispatchError>: TypeInfo + 'static, R: TypeInfo + 'static,

type Identity = ContractResult<R, Balance>

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.

impl<R, Balance> EncodeLike for ContractResult<R, Balance>

where StorageDeposit<Balance>: Encode, Balance: Encode, Result<R, DispatchError>: Encode,

impl<R: Eq, Balance: Eq> Eq for ContractResult<R, Balance>

impl<R, Balance> StructuralPartialEq for ContractResult<R, Balance>