Struct TxContextRef

pub struct TxContextRef(/* private fields */);

The VM API implementation based on a blockchain mock written in Rust. Implemented as a smart pointer to a TxContext structure, which tracks a blockchain transaction.

Implementations

impl TxContextRef

pub fn new(tx_context_arc: Arc<TxContext>) -> Self

pub fn new_from_static() -> Self

pub fn dummy() -> Self

pub fn into_blockchain_updates(self) -> BlockchainUpdate

pub fn into_tx_result(self) -> TxResult

Consumes the current API and returns the contained output. Should be called at the end of a tx execution. Will fail if any other references to the tx context survive, this must be the last.

pub fn replace_tx_result_with_error(self, tx_panic: TxPanic)

The current method for signalling that the current execution is failed, and with what error.

Note: does not terminate execution or panic, that is handled separately.

Methods from Deref<Target = TxContext>

pub fn input_ref(&self) -> &TxInput

pub fn blockchain_cache(&self) -> &TxCache

pub fn blockchain_cache_arc(&self) -> Arc<TxCache>

pub fn blockchain_ref(&self) -> &BlockchainState

pub fn with_account<R, F>(&self, address: &VMAddress, f: F) -> R

where F: FnOnce(&AccountData) -> R,

pub fn with_account_or_else<R, F, Else>( &self, address: &VMAddress, f: F, or_else: Else, ) -> R

where F: FnOnce(&AccountData) -> R, Else: FnOnce() -> R,

pub fn with_contract_account<R, F>(&self, f: F) -> R

where F: FnOnce(&AccountData) -> R,

pub fn with_account_mut<R, F>(&self, address: &VMAddress, f: F) -> R

where F: FnOnce(&mut AccountData) -> R,

pub fn with_contract_account_mut<R, F>(&self, f: F) -> R

where F: FnOnce(&mut AccountData) -> R,

pub fn m_types_lock(&self) -> MutexGuard<'_, TxManagedTypes>

pub fn back_transfers_lock(&self) -> MutexGuard<'_, BackTransfers>

pub fn result_lock(&self) -> MutexGuard<'_, TxResult>

pub fn extract_result(&self) -> TxResult

pub fn rng_lock(&self) -> MutexGuard<'_, BlockchainRng>

pub fn create_new_contract( &self, new_address: &VMAddress, contract_path: Vec<u8>, code_metadata: VMCodeMetadata, contract_owner: VMAddress, )

Trait Implementations

impl Clone for TxContextRef

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TxContextRef

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

Formats the value using the given formatter.

impl Deref for TxContextRef

type Target = TxContext

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.