Struct JournaledAccount 

pub struct JournaledAccount<'a, DB, ENTRY: JournalEntryTr = JournalEntry> { /* private fields */ }

Journaled account contains both mutable account and journal entries.

Useful to encapsulate account and journal entries together. So when account gets changed, we can add a journal entry for it.

Implementations

impl<'a, DB: Database, ENTRY: JournalEntryTr> JournaledAccount<'a, DB, ENTRY>

pub fn new( address: Address, account: &'a mut Account, journal_entries: &'a mut Vec<ENTRY>, db: &'a mut DB, access_list: &'a HashMap<Address, HashSet<StorageKey>>, transaction_id: usize, ) -> Self

Creates new JournaledAccount

pub fn sload_concrete_error( &mut self, key: StorageKey, skip_cold_load: bool, ) -> Result<StateLoad<&mut EvmStorageSlot>, JournalLoadError<DB::Error>>

Loads the storage slot.

If storage is cold and skip_cold_load is true, it will return JournalLoadError::ColdLoadSkipped error.

Does not erase the db error.

pub fn sstore_concrete_error( &mut self, key: StorageKey, new: StorageValue, skip_cold_load: bool, ) -> Result<StateLoad<SStoreResult>, JournalLoadError<DB::Error>>

Stores the storage slot.

If storage is cold and skip_cold_load is true, it will return JournalLoadError::ColdLoadSkipped error.

Does not erase the db error.

pub fn load_code_preserve_error( &mut self, ) -> Result<&Bytecode, JournalLoadError<DB::Error>>

Loads the code of the account. and returns it as reference.

Does not erase the db error.

pub fn into_account(self) -> &'a Account

Consumes the journaled account and returns the account.

Trait Implementations

impl<'a, DB: Debug, ENTRY: Debug + JournalEntryTr> Debug for JournaledAccount<'a, DB, ENTRY>

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

Formats the value using the given formatter.

impl<'a, DB: Database, ENTRY: JournalEntryTr> JournaledAccountTr for JournaledAccount<'a, DB, ENTRY>

fn account(&self) -> &Account

Returns the account.

fn balance(&self) -> &U256

Returns the balance of the account.

fn nonce(&self) -> u64

Returns the nonce of the account.

fn code_hash(&self) -> &B256

Returns the code hash of the account.

fn code(&self) -> Option<&Bytecode>

Returns the code of the account.

fn touch(&mut self)

Touches the account.

fn unsafe_mark_cold(&mut self)

Marks the account as cold without making a journal entry.

Changing account without journal entry can be a footgun as reverting of the state change would not happen without entry. It is the reason why this function has an unsafe prefix.

If account is in access list, it would still be marked as warm if account get accessed again.

fn set_balance(&mut self, balance: U256)

Sets the balance of the account.

If balance is the same, we don’t add a journal entry.

Touches the account in all cases.

fn incr_balance(&mut self, balance: U256) -> bool

Increments the balance of the account.

Touches the account in all cases.

fn decr_balance(&mut self, balance: U256) -> bool

Decrements the balance of the account.

Touches the account in all cases.

fn bump_nonce(&mut self) -> bool

Bumps the nonce of the account.

Touches the account in all cases.

Returns true if nonce was bumped, false if nonce is at the max value.

fn set_nonce(&mut self, nonce: u64)

Set the nonce of the account and create a journal entry.

Touches the account in all cases.

fn unsafe_set_nonce(&mut self, nonce: u64)

Set the nonce of the account without creating a journal entry.

Changing account without journal entry can be a footgun as reverting of the state change would not happen without entry. It is the reason why this function has an unsafe prefix.

fn set_code(&mut self, code_hash: B256, code: Bytecode)

Sets the code of the account.

Touches the account in all cases.

fn set_code_and_hash_slow(&mut self, code: Bytecode)

Sets the code of the account. Calculates hash of the code.

Touches the account in all cases.

fn delegate(&mut self, address: Address)

Delegates the account to another address (EIP-7702).

This touches the account, sets the code to the delegation designation, and bumps the nonce.

fn sload( &mut self, key: StorageKey, skip_cold_load: bool, ) -> Result<StateLoad<&mut EvmStorageSlot>, JournalLoadErasedError>

Loads the storage slot.

fn sstore( &mut self, key: StorageKey, new: StorageValue, skip_cold_load: bool, ) -> Result<StateLoad<SStoreResult>, JournalLoadErasedError>

Stores the storage slot.

fn load_code(&mut self) -> Result<&Bytecode, JournalLoadErasedError>

Loads the code of the account. and returns it as reference.

impl<'a, DB: PartialEq, ENTRY: PartialEq + JournalEntryTr> PartialEq for JournaledAccount<'a, DB, ENTRY>

fn eq(&self, other: &JournaledAccount<'a, DB, ENTRY>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a, DB: Eq, ENTRY: Eq + JournalEntryTr> Eq for JournaledAccount<'a, DB, ENTRY>

impl<'a, DB, ENTRY: JournalEntryTr> StructuralPartialEq for JournaledAccount<'a, DB, ENTRY>