Struct evm_state::StackExecutor

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

Stack-based executor.

Implementations

impl<'config, 'precompile, S> StackExecutor<'config, 'precompile, S> where
    S: StackState<'config>, 

pub fn new(
    state: S,
    config: &'config Config
) -> StackExecutor<'config, 'precompile, S>

Create a new stack-based executor.

pub fn new_with_precompile(
    state: S,
    config: &'config Config,
    precompile: &'precompile mut (dyn FnMut(H160, &[u8], Option<u64>, &Context) + 'precompile)
) -> StackExecutor<'config, 'precompile, S>

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, Global>,
    gas_limit: u64
) -> ExitReason

Execute a CREATE transaction.

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

Execute a CREATE2 transaction.

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

Execute a CALL transaction.

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.

Trait Implementations

impl<'config, 'precompile, S> Handler for StackExecutor<'config, 'precompile, S> where
    S: StackState<'config>, 

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.

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

Get balance of address.

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

Get code size of address.

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

Get code hash of address.

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

Get code of address.

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

Get storage value of address at index.

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

Get original storage value of address at index.

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

Check whether an address exists.

pub fn gas_left(&self) -> U256

Get the gas left value.

pub fn gas_price(&self) -> U256

Get the gas price value.

pub fn origin(&self) -> H160

Get execution origin.

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

Get environmental block hash.

pub fn block_number(&self) -> U256

Get environmental block number.

pub fn block_coinbase(&self) -> H160

Get environmental coinbase.

pub fn block_timestamp(&self) -> U256

Get environmental block timestamp.

pub fn block_difficulty(&self) -> U256

Get environmental block difficulty.

pub fn block_gas_limit(&self) -> U256

Get environmental gas limit.

pub fn chain_id(&self) -> U256

Get environmental chain ID.

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

Check whether an address has already been deleted.

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

Set storage value of address at index.

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

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

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

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

pub fn create(
    &mut self,
    caller: H160,
    scheme: CreateScheme,
    value: U256,
    init_code: Vec<u8, Global>,
    target_gas: Option<u64>
) -> Capture<(ExitReason, Option<H160>, Vec<u8, Global>), <StackExecutor<'config, 'precompile, S> as Handler>::CreateInterrupt>

Invoke a create operation.

pub fn call(
    &mut self,
    code_address: H160,
    transfer: Option<Transfer>,
    input: Vec<u8, Global>,
    target_gas: Option<u64>,
    is_static: bool,
    context: Context
) -> Capture<(ExitReason, Vec<u8, Global>), <StackExecutor<'config, 'precompile, S> as Handler>::CallInterrupt>

Invoke a call operation.

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

Pre-validation step for the runtime.

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

Feed in create feedback.

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

Feed in call feedback.

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

Handle other unknown external opcodes.