Struct BaseEvm

pub struct BaseEvm { /* private fields */ }

EVM that supports both in-memory and forked storage.

Implementations

impl BaseEvm

pub fn new(fork: Option<CreateFork>) -> Self

Create an instance of the EVM. If fork is None it will use the in-memory database. Otherwise it will create a forked database.

pub fn new_from_snapshot(snap: SnapShot) -> Self

Create an instance of the EVM and load it’s state from the SnapShot. This will use the in-memory database.

pub fn create_account( &mut self, user: Address, amount: Option<U256>, ) -> Result<()>

Create an account for the given user with an optional balance (amount). This will overwrite an account if it already exists.

pub fn get_balance(&mut self, caller: Address) -> Result<U256>

Return the balance for the caller’s account.

pub fn set_balance( &mut self, address: Address, amount: U256, ) -> Result<&mut Self>

Set the balance for the given address with the given amount

pub fn create_snapshot(&self) -> Result<SnapShot>

Create a snapshot of the current database. This can be used to reload state.

pub fn deploy( &mut self, caller: Address, data: Vec<u8>, value: U256, ) -> Result<Address>

Deploy a contract returning the contract’s address. If value is specified, the constructor must be payable.

pub fn transfer( &mut self, caller: Address, to: Address, value: U256, ) -> Result<()>

Transfer value from caller -> to

pub fn transact_commit_sol<T: SolCall>( &mut self, caller: Address, to: Address, args: T, value: U256, ) -> Result<<T as SolCall>::Return>

Same as transact_commit, but supports alloy’s sol types.

pub fn transact_commit( &mut self, caller: Address, to: Address, data: Vec<u8>, value: U256, ) -> Result<CallResult>

Write call to a contact. Send a transaction where any state changes are persisted to the underlying database.

pub fn transact_call_sol<T: SolCall>( &mut self, to: Address, args: T, value: U256, ) -> Result<<T as SolCall>::Return>

Same as transact_call but supports alloy’s sol types.

pub fn transact_call( &mut self, to: Address, data: Vec<u8>, value: U256, ) -> Result<CallResult>

Read call to a contract. Send a transaction but any state changes are NOT persisted to the database.

pub fn simulate( &mut self, caller: Address, to: Address, data: Vec<u8>, value: U256, ) -> Result<CallResult>

Simulate a transact_commit without actually committing/changing state.

pub fn update_block(&mut self, interval: u64)

Advance block.number and block.timestamp. Set interval to the amount of time in seconds you want to advance the timestamp. Block number will be automatically incremented.

Must be manually called.

Trait Implementations

impl Default for BaseEvm

Create an EVM with the in-memory database

fn default() -> Self

Returns the “default value” for a type.