Struct bus_mapping::state_db::StateDB

pub struct StateDB { /* private fields */ }

In-memory key-value database that represents the Ethereum State Trie.

Implementations

impl StateDB

pub fn new() -> Self

Create an empty Self

pub fn set_account(&mut self, addr: &Address, acc: Account)

Set an Account at addr in the StateDB.

pub fn get_account(&self, addr: &Address) -> (bool, &Account)

Get a reference to the Account at addr. Returns false and a zero Account when the Account wasn’t found in the state.

pub fn get_account_mut(&mut self, addr: &Address) -> (bool, &mut Account)

Get a mutable reference to the Account at addr. If the Account is not found in the state, a zero one will be inserted and returned along with false.

pub fn get_storage(&self, addr: &Address, key: &Word) -> (bool, &Word)

Get a reference to the storage value from Account at addr, at key. Returns false and a zero Word when the Account or key wasn’t found in the state. Returns dirty storage state, which includes writes in current tx

pub fn get_transient_storage(&self, addr: &Address, key: &Word) -> (bool, &Word)

Get a reference to the transient storage value from Account at addr, at key. Returns false and a zero Word when the Account or key wasn’t found in the state. Returns transient storage value, which is cleared after current tx

pub fn get_committed_storage(&self, addr: &Address, key: &Word) -> (bool, &Word)

Get a reference to the storage value from Account at addr, at key. Returns false and a zero Word when the Account or key wasn’t found in the state. Returns committed storage, which is storage state before current tx

pub fn get_storage_mut( &mut self, addr: &Address, key: &Word ) -> (bool, &mut Word)

Get a mutable reference to the storage value from Account at addr, at key. Returns false when the Account or key wasn’t found in the state and it is created. If the Account or key is not found in the state, a zero Account will be inserted, a zero value will be inserted at key in its storage, and the value will be returned along with false.

pub fn set_storage(&mut self, addr: &Address, key: &Word, value: &Word)

Set storage value at addr and key. Writes into dirty_storage during transaction execution. After transaction execution, dirty_storage is committed into storage in commit_tx method.

pub fn set_transient_storage( &mut self, addr: &Address, key: &Word, value: &Word )

Set transient storage value at addr and key. Transient storage is cleared after transaction execution.

pub fn get_nonce(&self, addr: &Address) -> u64

Get nonce of account with addr.

pub fn get_balance(&self, addr: &Address) -> Word

Get balance of account with the given address.

pub fn increase_nonce(&mut self, addr: &Address) -> u64

Increase nonce of account with addr and return the previous value.

pub fn check_account_in_access_list(&self, addr: &Address) -> bool

Check whether addr exists in account access list.

pub fn add_account_to_access_list(&mut self, addr: Address) -> bool

Add addr into account access list. Returns true if it’s not in the access list before.

pub fn remove_account_from_access_list(&mut self, addr: &Address)

Remove addr from account access list.

pub fn check_account_storage_in_access_list( &self, pair: &(Address, Word) ) -> bool

Check whether (addr, key) exists in account storage access list.

pub fn add_account_storage_to_access_list( &mut self, (addr, key): (Address, Word) ) -> bool

Add (addr, key) into account storage access list. Returns true if it’s not in the access list before.

pub fn remove_account_storage_from_access_list( &mut self, pair: &(Address, Word) )

Remove (addr, key) from account storage access list.

pub fn destruct_account(&mut self, addr: Address)

Set account as self destructed.

pub fn refund(&self) -> u64

Retrieve refund.

pub fn set_refund(&mut self, value: u64)

Set refund

pub fn commit_tx(&mut self)

Clear access list and refund, and commit dirty storage. It should be invoked before processing with new transaction with the same StateDB.

pub fn clear_transient_storage(&mut self)

Clear transient storage.

Trait Implementations

impl Clone for StateDB

fn clone(&self) -> StateDB

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for StateDB

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

Formats the value using the given formatter.

impl Default for StateDB

fn default() -> StateDB

Returns the “default value” for a type.