Struct evm::executor::stack::StackExecutor

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

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

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

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, 'precompiles, S: StackState<'config>, P: PrecompileSet> Handler for StackExecutor<'config, 'precompiles, S, P>

type CreateInterrupt = Infallible

Type of CREATE interrupt.

type CreateFeedback = Infallible

Feedback value for CREATE interrupt.

type CallInterrupt = Infallible

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 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(&self, address: H160, maybe_index: Option<H256>) -> bool

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_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 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 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.