Struct Backend

pub(crate) struct Backend {
    pub(crate) journaled_state: JournaledState<InMemoryDB>,
    pub(crate) method_with_inspector_counter: usize,
    pub(crate) method_without_inspector_counter: usize,
}

Backend for cheatcodes. The problematic cheatcodes are only supported in fork mode, so we’ll omit the non-fork behavior of the Foundry Backend.

Fields

journaled_state: JournaledState<InMemoryDB>

In fork mode, Foundry stores (JournaledState, Database) pairs for each fork.

method_with_inspector_counter: usize

Counters to be able to assert that we mutated the object that we expected to mutate.

method_without_inspector_counter: usize

Implementations

impl Backend

pub(crate) fn new(spec: SpecId, db: InMemoryDB) -> Self

Trait Implementations

impl Clone for Backend

fn clone(&self) -> Backend

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl DatabaseExt for Backend

fn method_that_takes_inspector_as_argument<InspectorT, BlockT, TxT, CfgT, PrecompileT>( &mut self, env: Env<BlockT, TxT, CfgT>, inspector: InspectorT, ) -> Result<()>

where InspectorT: Inspector<Context<BlockT, TxT, CfgT, InMemoryDB, Backend>, EthInterpreter> + GetInspector<Context<BlockT, TxT, CfgT, InMemoryDB, Backend>, EthInterpreter>, BlockT: Block, TxT: Transaction, CfgT: Cfg, PrecompileT: PrecompileProvider<Context = InspectorContext<InspectorT, InMemoryDB, Context<BlockT, TxT, CfgT, InMemoryDB, Backend>>, Output = InterpreterResult, Error = EVMError<Infallible, InvalidTransaction>>,

Mimics DatabaseExt::transact See commit_transaction for the generics

fn method_that_constructs_inspector<BlockT, TxT, CfgT>( &mut self, env: Env<BlockT, TxT, CfgT>, ) -> Result<()>

where BlockT: Block, TxT: Transaction, CfgT: Cfg,

Mimics DatabaseExt::roll_fork_to_transaction

impl Debug for Backend

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

Formats the value using the given formatter.

impl Journal for Backend

fn depth(&self) -> usize

Returns call depth.

type Database = CacheDB<EmptyDBTyped<Infallible>>

type FinalOutput = (HashMap<Address, Account>, Vec<Log>)

fn new(database: InMemoryDB) -> Self

Creates new Journaled state.

fn db_ref(&self) -> &Self::Database

Returns the database.

fn db(&mut self) -> &mut Self::Database

Returns the mutable database.

fn sload( &mut self, address: Address, key: U256, ) -> Result<StateLoad<U256>, <Self::Database as Database>::Error>

Returns the storage value from Journal state.

fn sstore( &mut self, address: Address, key: U256, value: U256, ) -> Result<StateLoad<SStoreResult>, <Self::Database as Database>::Error>

Stores the storage value in Journal state.

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

Loads transient storage value.

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

Stores transient storage value.

fn log(&mut self, log: Log)

Logs the log in Journal state.

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

Marks the account for selfdestruction and transfers all the balance to the target.

fn warm_account_and_storage( &mut self, address: Address, storage_keys: impl IntoIterator<Item = U256>, ) -> Result<(), <Self::Database as Database>::Error>

fn warm_account(&mut self, address: Address)

fn warm_precompiles(&mut self, addresses: HashSet<Address>)

fn precompile_addresses(&self) -> &HashSet<Address>

fn set_spec_id(&mut self, spec_id: SpecId)

fn touch_account(&mut self, address: Address)

fn transfer( &mut self, from: &Address, to: &Address, balance: U256, ) -> Result<Option<TransferError>, Infallible>

fn inc_account_nonce( &mut self, address: Address, ) -> Result<Option<u64>, Infallible>

fn load_account( &mut self, address: Address, ) -> Result<StateLoad<&mut Account>, Infallible>

fn load_account_code( &mut self, address: Address, ) -> Result<StateLoad<&mut Account>, Infallible>

fn load_account_delegated( &mut self, address: Address, ) -> Result<StateLoad<AccountLoad>, Infallible>

fn set_code_with_hash(&mut self, address: Address, code: Bytecode, hash: B256)

Sets bytecode with hash. Assume that account is warm.

fn clear(&mut self)

Called at the end of the transaction to clean all residue data from journal.

fn checkpoint(&mut self) -> JournalCheckpoint

fn checkpoint_commit(&mut self)

fn checkpoint_revert(&mut self, checkpoint: JournalCheckpoint)

fn create_account_checkpoint( &mut self, caller: Address, address: Address, balance: U256, spec_id: SpecId, ) -> Result<JournalCheckpoint, TransferError>

fn finalize( &mut self, ) -> Result<Self::FinalOutput, <Self::Database as Database>::Error>

Does cleanup and returns modified state.

fn set_code(&mut self, address: Address, code: Bytecode)

Sets bytecode and calculates hash.

impl JournalExt for Backend

fn logs(&self) -> &[Log]

fn last_journal(&self) -> &[JournalEntry]

fn evm_state(&self) -> &EvmState

fn evm_state_mut(&mut self) -> &mut EvmState