Struct concordium_smart_contract_testing::ContractInvokeError

pub struct ContractInvokeError {
    pub energy_used: Energy,
    pub transaction_fee: Amount,
    pub trace_elements: Vec<DebugTraceElement>,
    pub kind: ContractInvokeErrorKind,
}

An error that occurred during a Chain::contract_update or Chain::contract_invoke.

Fields

energy_used: Energy

The energy used.

transaction_fee: Amount

The transaction fee. For Chain::contract_update, this is the amount charged to the invoker account.

trace_elements: Vec<DebugTraceElement>

Trace elements that occurred before the contract failed.

kind: ContractInvokeErrorKind

The specific reason for why the invocation failed.

Implementations

impl ContractInvokeError

pub fn return_value(&self) -> Option<&[u8]>

Try to extract the value returned.

This only returns Some if the contract rejected on its own. As opposed to when it runs out of energy, traps, or similar, in which case there won’t be a return value.

pub fn reject_code(&self) -> Option<i32>

If the contract execution rejected the transaction, this returns the code the contract used to signal the rejection.

pub fn parse_return_value<T: Deserial>(&self) -> ParseResult<T>

Try to extract and parse the value returned into a type that implements Deserial.

Returns an error if the return value:

• isn’t present
  • see Self::return_value for details about when this happens
• is present
  • but could not be parsed into T
  • could parse into T, but there were leftover bytes

Trait Implementations

impl Debug for ContractInvokeError

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

Formats the value using the given formatter.

impl DebugInfoExt for ContractInvokeError

fn debug_events(&self) -> Box<dyn Iterator<Item = DebugItem<'_>> + '_>

Get an iterator over all the debug traces emitted by the execution.

fn print_debug(self, level: DebugOutputKind) -> Self

Print the desired level of debug information that was recorded. This function is meant to be used in a method-chaining style.

fn print_emitted_events(self) -> Self

Print (to stderr) all the events generated by concordium_dbg! statements.

fn host_calls(&self) -> Box<dyn Iterator<Item = HostCallInfo<'_>> + '_>

Get an iterator over all host calls that have occurred, both in the remaining trace and in the rolled back part.

fn emitted_debug_prints( &self ) -> Box<dyn Iterator<Item = (ContractAddress, &EmittedDebugStatement)> + '_>

Get an iterator over all the emitted concordium_dbg! events.

fn host_calls_summary( &self ) -> BTreeMap<ContractAddress, BTreeMap<HostFunctionV1, (usize, InterpreterEnergy)>>

Get host function calls grouped by contract address that generated them. The value at each address and host function is the pair of the number of times the host function was called, and the total amount of interpreter energy that was used by all the calls.

fn host_calls_summary_per_entrypoint( &self ) -> BTreeMap<(ContractAddress, EntrypointName<'_>), BTreeMap<HostFunctionV1, (usize, InterpreterEnergy)>>

Get host function calls grouped by contract address and entrypoint that generated them. The value at each address and host function is the pair of the number of times the host function was called, and the total amount of interpreter energy that was used by all the calls.

impl Display for ContractInvokeError

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

Formats the value using the given formatter.

impl Error for ContractInvokeError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type based access to context intended for error reports.