Trait Host

pub trait Host {
    type BLOCK: Block;
    type TX: Transaction;
    type CFG: Cfg;

    // Required methods
    fn tx(&self) -> &Self::TX;
    fn block(&self) -> &Self::BLOCK;
    fn cfg(&self) -> &Self::CFG;
    fn load_account_delegated(
        &mut self,
        address: Address,
    ) -> Option<AccountLoad>;
    fn block_hash(&mut self, number: u64) -> Option<B256>;
    fn balance(&mut self, address: Address) -> Option<StateLoad<U256>>;
    fn code(&mut self, address: Address) -> Option<Eip7702CodeLoad<Bytes>>;
    fn code_hash(&mut self, address: Address) -> Option<Eip7702CodeLoad<B256>>;
    fn sload(
        &mut self,
        address: Address,
        index: U256,
    ) -> Option<StateLoad<U256>>;
    fn sstore(
        &mut self,
        address: Address,
        index: U256,
        value: U256,
    ) -> Option<StateLoad<SStoreResult>>;
    fn tload(&mut self, address: Address, index: U256) -> U256;
    fn tstore(&mut self, address: Address, index: U256, value: U256);
    fn log(&mut self, log: Log);
    fn selfdestruct(
        &mut self,
        address: Address,
        target: Address,
    ) -> Option<StateLoad<SelfDestructResult>>;
}

EVM context host. TODO move to context-interface

Required Associated Types

type BLOCK: Block

Chain specification.

type TX: Transaction

type CFG: Cfg

Required Methods

fn tx(&self) -> &Self::TX

Returns a reference to the environment.

fn block(&self) -> &Self::BLOCK

Returns a mutable reference to the environment.

fn cfg(&self) -> &Self::CFG

TODO make it generic in future

fn load_account_delegated(&mut self, address: Address) -> Option<AccountLoad>

Load an account code.

fn block_hash(&mut self, number: u64) -> Option<B256>

Get the block hash of the given block number.

fn balance(&mut self, address: Address) -> Option<StateLoad<U256>>

Get balance of address and if the account is cold.

fn code(&mut self, address: Address) -> Option<Eip7702CodeLoad<Bytes>>

Get code of address and if the account is cold.

fn code_hash(&mut self, address: Address) -> Option<Eip7702CodeLoad<B256>>

Get code hash of address and if the account is cold.

fn sload(&mut self, address: Address, index: U256) -> Option<StateLoad<U256>>

Get storage value of address at index and if the account is cold.

fn sstore( &mut self, address: Address, index: U256, value: U256, ) -> Option<StateLoad<SStoreResult>>

Set storage value of account address at index.

Returns StateLoad with SStoreResult that contains original/new/old storage value.

fn tload(&mut self, address: Address, index: U256) -> U256

Get the transient storage value of address at index.

fn tstore(&mut self, address: Address, index: U256, value: U256)

Set the transient storage value of address at index.

fn log(&mut self, log: Log)

Emit a log owned by address with given LogData.

fn selfdestruct( &mut self, address: Address, target: Address, ) -> Option<StateLoad<SelfDestructResult>>

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

Implementors

impl<TX: Transaction, BLOCK: Block, CFG: Cfg> Host for DummyHost<BLOCK, TX, CFG>

type TX = TX

type BLOCK = BLOCK

type CFG = CFG