Struct pallet_contracts_primitives::ContractResult

pub struct ContractResult<R, Balance> {
    pub gas_consumed: Weight,
    pub gas_required: Weight,
    pub storage_deposit: StorageDeposit<Balance>,
    pub debug_message: Vec<u8>,
    pub result: R,
}

Result type of a bare_call or bare_instantiate call.

It contains the execution result together with some auxiliary information.

Fields

gas_consumed: Weight

How much weight was consumed during execution.

gas_required: Weight

How much weight is required as gas 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 different from Self::gas_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 gas_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.

debug_message: Vec<u8>

An optional debug message. This message is only filled when explicitly requested by the code that calls into the contract. Otherwise it is empty.

The contained bytes are valid UTF-8. This is not declared as String because this type is not allowed within the runtime.

Clients should not make any assumptions about the format of the buffer. They should just display it as-is. It is not only a collection of log lines provided by a contract but a formatted buffer with different sections.

Note

The debug message is never generated during on-chain execution. It is reserved for RPC calls.

result: R

The execution result of the wasm code.

Trait Implementations

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,
    StorageDeposit<Balance>: Decode,
    R: Decode,
    R: Decode,

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

Attempt to deserialise the value from input.

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, Balance> Encode for ContractResult<R, Balance>where
    StorageDeposit<Balance>: Encode,
    StorageDeposit<Balance>: Encode,
    R: Encode,
    R: Encode,

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

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

fn size_hint(&self) -> usize

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

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

Convert self to an owned vector.

fn using_encoded<R, F>(&self, f: F) -> Rwhere
    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<ContractResult<R, Balance>> for ContractResult<R, Balance>

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

This method tests for self and other values to be equal, and is used by ==.

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

This method 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,
    R: TypeInfo + 'static,
    R: TypeInfo + 'static,
    Balance: 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<ContractResult<R, Balance>> for ContractResult<R, Balance>where
    StorageDeposit<Balance>: Encode,
    StorageDeposit<Balance>: Encode,
    R: Encode,
    R: Encode,

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

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

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