Struct Backend

pub(crate) struct Backend {
    pub(crate) journaled_state: Journal<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: Journal<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, InstructionProviderT, PrecompileT>( &mut self, env: Env<BlockT, TxT, CfgT>, inspector: InspectorT, ) -> Result<()>

where InspectorT: Inspector<Context<BlockT, TxT, CfgT, InMemoryDB, Backend>, EthInterpreter>, BlockT: Block, TxT: Transaction, CfgT: Cfg, InstructionProviderT: InstructionProvider<Context = Context<BlockT, TxT, CfgT, InMemoryDB, Backend>, InterpreterTypes = EthInterpreter> + Default, PrecompileT: PrecompileProvider<Context<BlockT, TxT, CfgT, InMemoryDB, Backend>, Output = InterpreterResult> + Default,

Mimics DatabaseExt::transact See commit_transaction for the generics

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

where BlockT: Block, TxT: Transaction, CfgT: Cfg, InstructionProviderT: InstructionProvider<Context = Context<BlockT, TxT, CfgT, InMemoryDB, Backend>, InterpreterTypes = EthInterpreter> + Default, PrecompileT: PrecompileProvider<Context<BlockT, TxT, CfgT, InMemoryDB, Backend>, Output = InterpreterResult> + Default,

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 JournalExt for Backend

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

Get all logs from the journal.

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

Get the journal entries that are created from last checkpoint. new checkpoint is created when sub call is made.

fn evm_state(&self) -> &EvmState

Return the current Journaled state.

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

Return the mutable current Journaled state.

impl JournalTr for Backend

fn depth(&self) -> usize

Returns call depth.

type Database = CacheDB<EmptyDBTyped<Infallible>>

type FinalOutput = JournalOutput

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>

Warms the account and storage.

fn warm_account(&mut self, address: Address)

Warms the account.

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

Warms the precompiles.

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

Returns the addresses of the precompiles.

fn set_spec_id(&mut self, spec_id: SpecId)

Sets the spec id.

fn touch_account(&mut self, address: Address)

Touches the account.

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

Transfers the balance from one account to another.

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

Increments the nonce of the account.

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

Loads the account.

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

Loads the account code.

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

Loads the account delegated.

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

Sets bytecode with hash. Assume that account is warm.

fn code( &mut self, address: Address, ) -> Result<StateLoad<Bytes>, <Self::Database as Database>::Error>

Returns account code bytes and if address is cold loaded.

fn code_hash( &mut self, address: Address, ) -> Result<StateLoad<B256>, <Self::Database as Database>::Error>

Gets code hash of account.

fn clear(&mut self)

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

fn checkpoint(&mut self) -> JournalCheckpoint

Creates a checkpoint of the current state. State can be revert to this point if needed.

fn checkpoint_commit(&mut self)

Commits the changes made since the last checkpoint.

fn checkpoint_revert(&mut self, checkpoint: JournalCheckpoint)

Reverts the changes made since the last checkpoint.

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

Creates a checkpoint of the account creation.

fn finalize(&mut self) -> Self::FinalOutput

Does cleanup and returns modified state.

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

Sets bytecode and calculates hash.