Struct fuel_vm::transactor::Transactor

source · [−]

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

Expand description

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

source

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

source

pub fn new(storage: S, params: ConsensusParameters) -> Self

Transactor constructor

source

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.

source

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

Receipts after the execution of a transaction.

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

source

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.

source

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

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

source

pub const fn is_success(&self) -> bool

Returns true if last transaction execution was successful

source

pub const fn is_error(&self) -> bool

Returns true if last transaction execution was erroneous

source

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

Result representation of the last executed transaction.

Will return None if no transaction was executed.

source

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.

source

pub const fn params(&self) -> &ConsensusParameters

Consensus parameters

source

pub const fn tx_offset(&self) -> usize

Tx memory offset

source

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

source

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

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

Trait Implementations

source

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

source

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

Converts this type into a mutable reference of the (usually inferred) input type.

source

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

source

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

Converts this type into a shared reference of the (usually inferred) input type.

source

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

source

fn as_ref(&self) -> &S

Converts this type into a shared reference of the (usually inferred) input type.

source

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

source

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

Formats the value using the given formatter. Read more

source

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

source

fn default() -> Self

Returns the “default value” for a type. Read more

source

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

source

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

Converts to this type from the input type.

source

impl<'a> From<MemoryClient<'a>> for Transactor<'a, MemoryStorage>

source

fn from(client: MemoryClient<'a>) -> Self

Converts to this type from the input type.

source

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

source

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

Converts to this type from the input type.

Auto Trait Implementations

impl<'a, S> !RefUnwindSafe for Transactor<'a, S>

impl<'a, S> Send for Transactor<'a, S> where
S: Send,

impl<'a, S> Sync for Transactor<'a, S> where
S: Sync,

impl<'a, S> Unpin for Transactor<'a, S> where
S: Unpin,

impl<'a, S> !UnwindSafe for Transactor<'a, S>

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Base32Len for T where
T: AsRef<[u8]>,

fn base32_len(&self) -> usize

Calculate the base32 serialized length

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<'f, T> CheckBase32<Vec<u5, Global>> for T where
T: AsRef<[u8]>,

type Err = Error

Error type if conversion fails

fn check_base32(
self
) -> Result<Vec<u5, Global>, <T as CheckBase32<Vec<u5, Global>>>::Err>

Check if all values are in range and return array-like struct of u5 values

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T> Same<T> for T

type Output = T

Should always be Self

impl<T> ToBase32 for T where
T: AsRef<[u8]>,

fn write_base32<W>(&self, writer: &mut W) -> Result<(), <W as WriteBase32>::Err> where
W: WriteBase32,

Encode as base32 and write it to the supplied writer Implementations shouldn’t allocate. Read more

fn to_base32(&self) -> Vec<u5, Global>

Convert Self to base32 vector

source

impl<T> ToHex for T where
T: AsRef<[u8]>,

source

fn encode_hex(&self) -> U where
U: FromIterator<char>,

Encode the hex strict representing self into the result. Lower case letters are used (e.g. f9b4ca) Read more

source

fn encode_hex_upper(&self) -> U where
U: FromIterator<char>,

Encode the hex strict representing self into the result. Upper case letters are used (e.g. F9B4CA) Read more

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

Struct fuel_vm::transactor::Transactor

Implementations

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

pub fn new(storage: S, params: ConsensusParameters) -> Self

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

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

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

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

pub const fn is_success(&self) -> bool

pub const fn is_error(&self) -> bool

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

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

pub const fn params(&self) -> &ConsensusParameters

pub const fn tx_offset(&self) -> usize

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

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

Trait Implementations

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

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

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

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

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

fn as_ref(&self) -> &S

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

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

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

fn default() -> Self

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

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

impl<'a> From<MemoryClient<'a>> for Transactor<'a, MemoryStorage>

fn from(client: MemoryClient<'a>) -> Self

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

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

Auto Trait Implementations

impl<'a, S> !RefUnwindSafe for Transactor<'a, S>

impl<'a, S> Send for Transactor<'a, S> where S: Send,

impl<'a, S> Sync for Transactor<'a, S> where S: Sync,

impl<'a, S> Unpin for Transactor<'a, S> where S: Unpin,

impl<'a, S> !UnwindSafe for Transactor<'a, S>

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Base32Len for T where T: AsRef<[u8]>,

fn base32_len(&self) -> usize

impl<T> Borrow<T> for T where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<'f, T> CheckBase32<Vec<u5, Global>> for T where T: AsRef<[u8]>,

type Err = Error

fn check_base32( self) -> Result<Vec<u5, Global>, <T as CheckBase32<Vec<u5, Global>>>::Err>

impl<T> From<T> for T

fn from(t: T) -> T

impl<T, U> Into<U> for T where U: From<T>,

fn into(self) -> U

impl<T> Same<T> for T

type Output = T

impl<T> ToBase32 for T where T: AsRef<[u8]>,

fn write_base32<W>(&self, writer: &mut W) -> Result<(), <W as WriteBase32>::Err> where W: WriteBase32,

fn to_base32(&self) -> Vec<u5, Global>

impl<T> ToHex for T where T: AsRef<[u8]>,

fn encode_hex<U>(&self) -> U where U: FromIterator<char>,

fn encode_hex_upper<U>(&self) -> U where U: FromIterator<char>,

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<V, T> VZip<V> for T where V: MultiLane<T>,

fn vzip(self) -> V

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

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

impl<'a, S> Send for Transactor<'a, S> where
S: Send,

impl<'a, S> Sync for Transactor<'a, S> where
S: Sync,

impl<'a, S> Unpin for Transactor<'a, S> where
S: Unpin,

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Base32Len for T where
T: AsRef<[u8]>,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<'f, T> CheckBase32<Vec<u5, Global>> for T where
T: AsRef<[u8]>,

fn check_base32(
self
) -> Result<Vec<u5, Global>, <T as CheckBase32<Vec<u5, Global>>>::Err>

impl<T, U> Into<U> for T where
U: From<T>,

impl<T> ToBase32 for T where
T: AsRef<[u8]>,

fn write_base32<W>(&self, writer: &mut W) -> Result<(), <W as WriteBase32>::Err> where
W: WriteBase32,

impl<T> ToHex for T where
T: AsRef<[u8]>,

fn encode_hex<U>(&self) -> U where
U: FromIterator<char>,

fn encode_hex_upper<U>(&self) -> U where
U: FromIterator<char>,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

impl<V, T> VZip<V> for T where
V: MultiLane<T>,