Struct TxResult 

pub struct TxResult {
    pub result_status: ReturnCode,
    pub result_message: String,
    pub result_values: Vec<Vec<u8>>,
    pub esdt_transfer_log: Option<TxLog>,
    pub result_logs: Vec<TxLog>,
    pub gas_used: GasUsed,
    pub error_trace: Vec<TxErrorTrace>,
    pub pending_calls: TxResultCalls,
    pub all_calls: Vec<AsyncCallTxData>,
}

Fields

result_status: ReturnCode

result_message: String

result_values: Vec<Vec<u8>>

esdt_transfer_log: Option<TxLog>

Contains a log generated by ESDT transfer builtin functions, like MultiESDTNFTTransfer or ESDTTransfer.

There is at most one such log per transaction, hence Option, not Vec.

It is kept separately, because, unlike regular logs, it is not erased in case of tx failure (e.g. via sync call fallbile).

It also appears in front of the regular logs, it is easier to merge this way.

It does get merged into the regular logs when merging results after a sync call.

result_logs: Vec<TxLog>

Logs created during the transaction execution.

gas_used: GasUsed

error_trace: Vec<TxErrorTrace>

Accumulates errors when they occur.

It mimics the behavior of the Go VM, and they contribute to the the internalVMErrors event log.

Of course, the data field of the internalVMErrors log is implementation-dependent, so a 1:1 match is impossible.

pending_calls: TxResultCalls

Calls that need to be executed.

Structure is emptied as soon as async calls are executed.

all_calls: Vec<AsyncCallTxData>

All async calls launched from the tx (legacy async, promises, transfer-execute).

Is never cleared of its contents.

Implementations

impl TxResult

pub fn empty() -> TxResult

pub fn print(&self)

pub fn from_panic_obj(panic_obj: &TxPanic) -> TxResult

pub fn from_panic_string(s: &str) -> TxResult

pub fn from_unknown_panic() -> TxResult

pub fn from_error<S>(return_code: ReturnCode, result_message: S) -> TxResult

where S: Into<String>,

pub fn from_vm_error<S>(result_message: S) -> TxResult

where S: Into<String>,

pub fn from_function_not_found() -> TxResult

pub fn all_logs(&self) -> Vec<&TxLog>

Retrieves all logs, including the ESDT transfer log if present.

pub fn append_all_logs(&mut self, source: &mut TxResult)

Just like Vec::append, consumes the source TxResult logs.

pub fn merge_after_sync_call(&mut self, sync_call_result: &TxResult)

pub fn merge_error(&mut self, error_tx_result: TxResult)

Clears all TxResult fields, and replaces the error status and message fields.

It also concatenates the error traces. In practice, the error_tx_result contains no error trace.

Implementation note: this is done via std::mem::replace to ensure that all fields are cleared, except the ones related to errors.

pub fn assert_ok(&self)

pub fn assert_error(&self, expected_status: u64, expected_message: &str)

pub fn assert_user_error(&self, expected_message: &str)

impl TxResult

pub fn result_values_to_string(&self) -> String

impl TxResult

pub fn append_internal_vm_errors_event_log(&mut self, input: &TxInput)

Trait Implementations

impl Clone for TxResult

fn clone(&self) -> TxResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TxResult

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

Formats the value using the given formatter.

impl Default for TxResult

fn default() -> TxResult

Returns the “default value” for a type.

impl Display for TxResult

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

Formats the value using the given formatter.