Struct CheatsCtxt

pub struct CheatsCtxt<'cheats, 'evm, 'db, 'db2> {
    pub(crate) state: &'cheats mut Cheatcodes,
    pub(crate) ecx: &'evm mut InnerEvmContext<&'db mut (dyn DatabaseExt + 'db2)>,
    pub(crate) precompiles: &'evm mut ContextPrecompiles<&'db mut (dyn DatabaseExt + 'db2)>,
    pub(crate) caller: Address,
    pub(crate) gas_limit: u64,
}

The cheatcode context, used in Cheatcode.

Fields

state: &'cheats mut Cheatcodes

The cheatcodes inspector state.

ecx: &'evm mut InnerEvmContext<&'db mut (dyn DatabaseExt + 'db2)>

The EVM data.

precompiles: &'evm mut ContextPrecompiles<&'db mut (dyn DatabaseExt + 'db2)>

The precompiles context.

caller: Address

The original msg.sender.

gas_limit: u64

Gas limit of the current cheatcode call.

Implementations

impl CheatsCtxt<'_, '_, '_, '_>

pub(crate) fn is_precompile(&self, address: &Address) -> bool

Methods from Deref<Target = InnerEvmContext<&'db mut (dyn DatabaseExt + 'db2)>>

pub fn spec_id(&self) -> SpecId

Returns the configured EVM spec ID.

pub fn load_access_list( &mut self, ) -> Result<(), EVMError<<DB as Database>::Error>>

Load access list for berlin hard fork.

Loading of accounts/storages is needed to make them warm.

pub fn env(&mut self) -> &mut Env

Return environment.

pub fn cfg(&self) -> &CfgEnv

Returns reference to [CfgEnv].

pub fn take_error(&mut self) -> Result<(), EVMError<<DB as Database>::Error>>

Returns the error by replacing it with Ok(()), if any.

pub fn block_hash( &mut self, number: u64, ) -> Result<FixedBytes<32>, EVMError<<DB as Database>::Error>>

Fetch block hash from database.

pub fn touch(&mut self, address: &Address)

Mark account as touched as only touched accounts will be added to state.

pub fn load_account( &mut self, address: Address, ) -> Result<StateLoad<&mut Account>, EVMError<<DB as Database>::Error>>

Loads an account into memory. Returns true if it is cold accessed.

pub fn load_account_delegated( &mut self, address: Address, ) -> Result<AccountLoad, EVMError<<DB as Database>::Error>>

Load account from database to JournaledState.

Return boolean pair where first is is_cold second bool exists.

pub fn balance( &mut self, address: Address, ) -> Result<StateLoad<Uint<256, 4>>, EVMError<<DB as Database>::Error>>

Return account balance and is_cold flag.

pub fn code( &mut self, address: Address, ) -> Result<Eip7702CodeLoad<Bytes>, EVMError<<DB as Database>::Error>>

Return account code bytes and if address is cold loaded.

In case of EOF account it will return EOF_MAGIC (0xEF00) as code.

pub fn code_hash( &mut self, address: Address, ) -> Result<Eip7702CodeLoad<FixedBytes<32>>, EVMError<<DB as Database>::Error>>

Get code hash of address.

In case of EOF account it will return EOF_MAGIC_HASH (the hash of 0xEF00).

pub fn sload( &mut self, address: Address, index: Uint<256, 4>, ) -> Result<StateLoad<Uint<256, 4>>, EVMError<<DB as Database>::Error>>

Load storage slot, if storage is not present inside the account then it will be loaded from database.

pub fn sstore( &mut self, address: Address, index: Uint<256, 4>, value: Uint<256, 4>, ) -> Result<StateLoad<SStoreResult>, EVMError<<DB as Database>::Error>>

Storage change of storage slot, before storing sload will be called for that slot.

pub fn tload(&mut self, address: Address, index: Uint<256, 4>) -> Uint<256, 4>

Returns transient storage value.

pub fn tstore( &mut self, address: Address, index: Uint<256, 4>, value: Uint<256, 4>, )

Stores transient storage value.

pub fn selfdestruct( &mut self, address: Address, target: Address, ) -> Result<StateLoad<SelfDestructResult>, EVMError<<DB as Database>::Error>>

Selfdestructs the account.

pub fn eofcreate_return<SPEC>( &mut self, interpreter_result: &mut InterpreterResult, address: Address, journal_checkpoint: JournalCheckpoint, )

where SPEC: Spec,

If error is present revert changes, otherwise save EOF bytecode.

pub fn call_return( &mut self, interpreter_result: &InterpreterResult, journal_checkpoint: JournalCheckpoint, )

Handles call return.

pub fn create_return<SPEC>( &mut self, interpreter_result: &mut InterpreterResult, address: Address, journal_checkpoint: JournalCheckpoint, )

where SPEC: Spec,

Handles create return.

Trait Implementations

impl<'db, 'db2> Deref for CheatsCtxt<'_, '_, 'db, 'db2>

type Target = InnerEvmContext<&'db mut (dyn DatabaseExt<Error = DatabaseError> + 'db2)>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for CheatsCtxt<'_, '_, '_, '_>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 56 bytes