Struct ExecutionResult

#[non_exhaustive]
pub struct ExecutionResult<T> {
    pub total_gas_burnt: NearGas,
    pub value: T,
    pub details: ExecutionDetails,
}

The result after evaluating the status of an execution. This can be ExecutionSuccess for successful executions or a [ExecutionFailure] for failed ones.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

total_gas_burnt: NearGas

Total gas burnt by the execution

value: T

Value returned from an execution. This is a base64 encoded str for a successful execution or a TxExecutionError if a failed one.

details: ExecutionDetails

Additional details related to the execution.

Implementations

impl ExecutionResult<Value>

pub fn json<T: DeserializeOwned>(&self) -> Result<T>

Deserialize an instance of type T from bytes of JSON text sourced from the execution result of this call. This conversion can fail if the structure of the internal state does not meet up with serde::de::DeserializeOwned’s requirements.

pub fn borsh<T: BorshDeserialize>(&self) -> Result<T>

Deserialize an instance of type T from bytes sourced from the execution result. This conversion can fail if the structure of the internal state does not meet up with borsh::BorshDeserialize’s requirements.

pub fn raw_bytes(&self) -> Result<Vec<u8>>

Grab the underlying raw bytes returned from calling into a contract’s function. If we want to deserialize these bytes into a rust datatype, use ExecutionResult::json or ExecutionResult::borsh instead.

impl<T> ExecutionResult<T>

pub fn outcome(&self) -> &ExecutionOutcomeWithIdView

Returns just the transaction outcome.

pub fn outcomes(&self) -> Vec<&ExecutionOutcomeWithIdView>

Grab all outcomes after the execution of the transaction. This includes outcomes from the transaction and all the receipts it generated.

pub fn receipt_outcomes(&self) -> &[ExecutionOutcomeWithIdView]

Grab all outcomes after the execution of the transaction. This includes outcomes only from receipts generated by this transaction.

pub fn failures(&self) -> Vec<&ExecutionOutcomeWithIdView>

Grab all outcomes that did not succeed the execution of this transaction. This will also include the failures from receipts as well.

pub fn receipt_failures(&self) -> Vec<&ExecutionOutcomeWithIdView>

Just like failures, grab only failed receipt outcomes.

pub fn logs(&self) -> Vec<&str>

Grab all logs from both the transaction and receipt outcomes.

Trait Implementations

impl<T: Clone> Clone for ExecutionResult<T>

fn clone(&self) -> ExecutionResult<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for ExecutionResult<T>

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

Formats the value using the given formatter.

impl<T: PartialEq> PartialEq for ExecutionResult<T>

fn eq(&self, other: &ExecutionResult<T>) -> 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<T: Eq> Eq for ExecutionResult<T>

impl<T> StructuralPartialEq for ExecutionResult<T>