Struct StackExecutor

pub struct StackExecutor<'config, 'precompiles, S, P> { /* private fields */ }

Stack-based executor.

Implementations

impl<'config, 'precompiles, S: StackState<'config>, P: PrecompileSet> StackExecutor<'config, 'precompiles, S, P>

pub fn config(&self) -> &'config Config

Return a reference of the Config.

pub fn precompiles(&self) -> &'precompiles P

Return a reference to the precompile set.

pub fn new_with_precompiles( state: S, config: &'config Config, precompile_set: &'precompiles P, ) -> Self

Create a new stack-based executor with given precompiles.

pub fn state(&self) -> &S

pub fn state_mut(&mut self) -> &mut S

pub fn into_state(self) -> S

pub fn enter_substate(&mut self, gas_limit: u64, is_static: bool)

Create a substate executor from the current executor.

pub fn exit_substate(&mut self, kind: StackExitKind) -> Result<(), ExitError>

Exit a substate. Panic if it results an empty substate stack.

pub fn execute(&mut self, runtime: &mut Runtime) -> ExitReason

Execute the runtime until it returns.

pub fn gas(&self) -> u64

Get remaining gas.

pub fn transact_create( &mut self, caller: H160, value: U256, init_code: Vec<u8>, gas_limit: u64, access_list: Vec<(H160, Vec<H256>)>, ) -> (ExitReason, Vec<u8>)

Execute a CREATE transaction.

pub fn transact_create2( &mut self, caller: H160, value: U256, init_code: Vec<u8>, salt: H256, gas_limit: u64, access_list: Vec<(H160, Vec<H256>)>, ) -> (ExitReason, Vec<u8>)

Execute a CREATE2 transaction.

pub fn transact_call( &mut self, caller: H160, address: H160, value: U256, data: Vec<u8>, gas_limit: u64, access_list: Vec<(H160, Vec<H256>)>, ) -> (ExitReason, Vec<u8>)

Execute a CALL transaction with a given caller, address, value and gas limit and data.

Takes in an additional access_list parameter for EIP-2930 which was introduced in the Ethereum Berlin hard fork. If you do not wish to use this functionality, just pass in an empty vector.

pub fn used_gas(&self) -> u64

Get used gas for the current executor, given the price.

pub fn fee(&self, price: U256) -> U256

Get fee needed for the current executor, given the price.

pub fn nonce(&self, address: H160) -> U256

Get account nonce.

pub fn create_address(&self, scheme: CreateScheme) -> H160

Get the create address from given scheme.

pub fn initialize_with_access_list( &mut self, access_list: Vec<(H160, Vec<H256>)>, )

Trait Implementations

impl<'config, S: StackState<'config>, P: PrecompileSet> Handler for StackExecutor<'config, '_, S, P>

type CreateInterrupt = StackExecutorCreateInterrupt<'static>

Type of CREATE interrupt.

type CreateFeedback = Infallible

Feedback value for CREATE interrupt.

type CallInterrupt = StackExecutorCallInterrupt<'static>

Type of CALL interrupt.

type CallFeedback = Infallible

Feedback value of CALL interrupt.

fn balance(&self, address: H160) -> U256

Get balance of address.

fn code_size(&self, address: H160) -> U256

Get code size of address.

fn code_hash(&self, address: H160) -> H256

Get code hash of address.

fn code(&self, address: H160) -> Vec<u8>

Get code of address.

fn storage(&self, address: H160, index: H256) -> H256

Get storage value of address at index.

fn transient_storage(&self, address: H160, index: H256) -> H256

Get transient storage value of address at index.

fn original_storage(&self, address: H160, index: H256) -> H256

Get original storage value of address at index.

fn exists(&self, address: H160) -> bool

Check whether an address exists.

fn is_cold( &mut self, address: H160, maybe_index: Option<H256>, ) -> Result<bool, ExitError>

Checks if the address or (address, index) pair has been previously accessed (or set in accessed_addresses / accessed_storage_keys via an access list transaction). References:

fn gas_left(&self) -> U256

Get the gas left value.

fn gas_price(&self) -> U256

Get the gas price value.

fn origin(&self) -> H160

Get execution origin.

fn block_hash(&self, number: U256) -> H256

Get environmental block hash.

fn block_number(&self) -> U256

Get environmental block number.

fn block_coinbase(&self) -> H160

Get environmental coinbase.

fn block_timestamp(&self) -> U256

Get environmental block timestamp.

fn block_difficulty(&self) -> U256

Get environmental block difficulty.

fn block_randomness(&self) -> Option<H256>

Get environmental block randomness.

fn block_gas_limit(&self) -> U256

Get environmental gas limit.

fn block_base_fee_per_gas(&self) -> U256

Environmental block base fee.

fn chain_id(&self) -> U256

Get environmental chain ID.

fn deleted(&self, address: H160) -> bool

Check whether an address has already been deleted.

fn set_storage( &mut self, address: H160, index: H256, value: H256, ) -> Result<(), ExitError>

Set storage value of address at index.

fn set_transient_storage(&mut self, address: H160, index: H256, value: H256)

Set transient storage value of address at index, transient storage gets discarded after every transaction. (see EIP-1153)

fn log( &mut self, address: H160, topics: Vec<H256>, data: Vec<u8>, ) -> Result<(), ExitError>

Create a log owned by address with given topics and data.

fn mark_delete(&mut self, address: H160, target: H160) -> Result<(), ExitError>

Mark an address to be deleted, with funds transferred to target.

fn create( &mut self, caller: H160, scheme: CreateScheme, value: U256, init_code: Vec<u8>, target_gas: Option<u64>, ) -> Capture<(ExitReason, Option<H160>, Vec<u8>), Self::CreateInterrupt>

Invoke a create operation.

fn call( &mut self, code_address: H160, transfer: Option<Transfer>, input: Vec<u8>, target_gas: Option<u64>, is_static: bool, context: Context, ) -> Capture<(ExitReason, Vec<u8>), Self::CallInterrupt>

Invoke a call operation.

fn pre_validate( &mut self, context: &Context, opcode: Opcode, stack: &Stack, ) -> Result<(), ExitError>

Pre-validation step for the runtime.

fn record_external_operation( &mut self, op: ExternalOperation, ) -> Result<(), ExitError>

Records some associated ExternalOperation.

fn create_feedback( &mut self, _feedback: Self::CreateFeedback, ) -> Result<(), ExitError>

Feed in create feedback.

fn call_feedback( &mut self, _feedback: Self::CallFeedback, ) -> Result<(), ExitError>

Feed in call feedback.

fn other( &mut self, opcode: Opcode, _stack: &mut Machine, ) -> Result<(), ExitError>

Handle other unknown external opcodes.