Struct NativeExecutor 

pub struct NativeExecutor { /* private fields */ }

Executor of contracts compiled natively for the host.

It trusts contracts and data they forward (like transaction payloads): methods are called through pointers to arguments as provided by callers, without checking them against method metadata, which keeps execution as cheap as possible. Arguments whose sizes, capacities or alignment don’t match metadata of the called method are undefined behavior rather than an error, which running tests under Miri can detect. For #[input] and #[output] arguments, debug assertions of the called method also catch such mismatches in debug builds. Contents of #[input] and #[output] arguments are parsed by the called method itself, which returns ContractError::BadInput for invalid ones. Executors of untrusted contracts must check sizes, capacities and alignment of arguments against method metadata, like the RISC-V VM does.

Implementations

impl NativeExecutor

pub fn new_storage_slots(&self) -> Result<Slots, ContractError>

Create a new [Slots] instance with system contracts already deployed

pub fn builder(shard_index: ShardIndex) -> NativeExecutorBuilder

Builder of native executor for specified shard index

pub fn transaction_verify( &self, transaction: Transaction<'_>, slots: &Slots, ) -> Result<(), ContractError>

Verify the provided transaction.

Self::transaction_execute() can be used for transaction execution if needed. Self::transaction_verify_execute() can be used to verify and execute a transaction with a single call, primarily for testing purposes.

pub fn transaction_execute( &self, transaction: Transaction<'_>, slots: &mut Slots, ) -> Result<(), ContractError>

Execute the previously verified transaction.

Self::transaction_verify() must be used for verification. Self::transaction_verify_execute() can be used to verify and execute a transaction with a single call, primarily for testing purposes.

pub fn transaction_verify_execute( &self, transaction: Transaction<'_>, slots: &mut Slots, ) -> Result<(), ContractError>

Verify and execute the provided transaction, primarily for testing purposes.

A slightly more efficient shortcut for Self::transaction_verify() + Self::transaction_execute() compared to calling them separately.

pub fn transaction_emulate<Calls, T>( &self, contract: Address, slots: &mut Slots, calls: Calls, ) -> T

where Calls: FnOnce(&mut Env<'_>) -> T,

Emulate a transaction submitted by contract with method calls happening inside calls without going through TxHandler.

NOTE: This is primarily useful for testing environment, usually changes are done in the transaction execution using Self::transaction_execute().

Returns None if the read-only [Slots] instance was given.

pub fn with_env_ro<Callback, T>(&self, slots: &Slots, callback: Callback) -> T

where Callback: FnOnce(&Env<'_>) -> T,

Get a read-only Env instance for calling #[view] methods on it directly.

For stateful methods, execute a transaction using Self::transaction_execute() or emulate one with Self::transaction_emulate().

Trait Implementations

impl Debug for NativeExecutor

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

Formats the value using the given formatter.