Struct SystemCaller

pub struct SystemCaller<Spec> { /* private fields */ }

An ephemeral helper type for executing system calls.

This can be used to chain system transaction calls.

Implementations

impl<Spec> SystemCaller<Spec>

pub const fn new(spec: Spec) -> Self

Create a new system caller with the given EVM config, database, and chain spec, and creates the EVM with the given initialized config and block environment.

pub fn with_state_hook( &mut self, hook: Option<Box<dyn OnStateHook>>, ) -> &mut Self

Installs a custom hook to be called after each state change.

impl<Spec> SystemCaller<Spec>

where Spec: EthereumHardforks,

pub fn apply_pre_execution_changes( &mut self, header: impl BlockHeader, evm: &mut impl Evm<DB: DatabaseCommit>, ) -> Result<(), BlockExecutionError>

Apply pre execution changes.

pub fn apply_post_execution_changes( &mut self, evm: &mut impl Evm<DB: DatabaseCommit>, ) -> Result<Requests, BlockExecutionError>

Apply post execution changes.

pub fn apply_blockhashes_contract_call( &mut self, parent_block_hash: B256, evm: &mut impl Evm<DB: DatabaseCommit>, ) -> Result<(), BlockExecutionError>

Applies the pre-block call to the EIP-2935 blockhashes contract.

pub fn apply_beacon_root_contract_call( &mut self, parent_beacon_block_root: Option<B256>, evm: &mut impl Evm<DB: DatabaseCommit>, ) -> Result<(), BlockExecutionError>

Applies the pre-block call to the EIP-4788 beacon root contract.

pub fn apply_withdrawal_requests_contract_call( &mut self, evm: &mut impl Evm<DB: DatabaseCommit>, ) -> Result<Bytes, BlockExecutionError>

Applies the post-block call to the EIP-7002 withdrawal request contract.

pub fn apply_consolidation_requests_contract_call( &mut self, evm: &mut impl Evm<DB: DatabaseCommit>, ) -> Result<Bytes, BlockExecutionError>

Applies the post-block call to the EIP-7251 consolidation requests contract.

pub fn on_state(&mut self, source: StateChangeSource, state: &EvmState)

Delegate to stored OnStateHook, noop if hook is None.

pub fn try_on_state_with<'a, F, E>(&mut self, f: F) -> Result<(), E>

where F: FnOnce() -> Result<(StateChangeSource, Cow<'a, EvmState>), E>,

Invokes the state hook with the outcome of the given closure, forwards error if any.

pub fn on_state_with<'a, F>(&mut self, f: F)

where F: FnOnce() -> (StateChangeSource, Cow<'a, EvmState>),

Invokes the state hook with the outcome of the given closure.

pub fn invoke_hook_with<F, R>(&mut self, f: F) -> Option<R>

where F: FnOnce(&mut Box<dyn OnStateHook>) -> R,

Invokes the given closure with the configured state hook if any.

Trait Implementations

impl<Spec> Debug for SystemCaller<Spec>

where Spec: Debug,

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

Formats the value using the given formatter.