Struct fuel_vm::transactor::Transactor

pub struct Transactor<'a, S> { /* private fields */ }

State machine to execute transactions and provide runtime entities on demand.

Builder pattern for Interpreter. Follows the recommended Non-consuming builder.

Based on https://doc.rust-lang.org/1.5.0/style/ownership/builders.html#non-consuming-builders-preferred

Implementations

impl<'a, S> Transactor<'a, S>

pub fn new(storage: S) -> Self

Transactor constructor

pub const fn state_transition(&self) -> Option<&StateTransitionRef<'a>>

State transition representation after the execution of a transaction.

Will be None if the last transaction resulted in a VM panic, or if no transaction was executed.

pub fn receipts(&self) -> Option<&[Receipt]>

Receipts after the execution of a transaction.

Follows the same criteria as Self::state_transition to return None.

pub const fn error(&self) -> Option<&InterpreterError>

Interpreter error representation after the execution of a transaction.

Follows the same criteria as Self::state_transition to return None.

Will be None if the last transaction resulted successful, or if no transaction was executed.

pub fn backtrace(&self) -> Option<Backtrace>

Generate a backtrace when at least one receipt of ScriptResult was found.

pub const fn is_success(&self) -> bool

Returns true if last transaction execution was successful

pub const fn is_error(&self) -> bool

Returns true if last transaction execution was erroneous

pub fn result(&self) -> Result<&StateTransitionRef<'a>, &InterpreterError>

Result representation of the last executed transaction.

Will return None if no transaction was executed.

pub fn interpreter(self) -> Interpreter<S>

Convert this transaction into the underlying VM instance.

This isn’t a two-way operation since if you convert this instance into the raw VM, then you lose the transactor state.

impl<S> Transactor<'_, S> where
    S: InterpreterStorage, 

pub fn transact(&mut self, tx: Transaction) -> &mut Self

Execute a transaction, and return the new state of the transactor

Trait Implementations

impl<S> AsMut<S> for Transactor<'_, S>

fn as_mut(&mut self) -> &mut S

Performs the conversion.

impl<S> AsRef<Interpreter<S>> for Transactor<'_, S>

fn as_ref(&self) -> &Interpreter<S>

Performs the conversion.

impl<S> AsRef<S> for Transactor<'_, S>

fn as_ref(&self) -> &S

Performs the conversion.

impl<'a, S: Debug> Debug for Transactor<'a, S>

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

Formats the value using the given formatter.

impl<S> Default for Transactor<'_, S> where
    S: Default, 

fn default() -> Self

Returns the “default value” for a type.

impl<S> From<Interpreter<S>> for Transactor<'_, S>

fn from(interpreter: Interpreter<S>) -> Self

Performs the conversion.

impl<S> From<Transactor<'_, S>> for Interpreter<S>

fn from(transactor: Transactor<'_, S>) -> Self

Performs the conversion.