Struct Journal

Source
pub struct Journal<DB, ENTRY = JournalEntry>
where ENTRY: JournalEntryTr,
{ pub database: DB, pub inner: JournalInner<ENTRY>, }
Expand description

A journal of state changes internal to the EVM

On each additional call, the depth of the journaled state is increased (depth) and a new journal is added.

The journal contains every state change that happens within that call, making it possible to revert changes made in a specific call.

Fields§

§database: DB

Database

§inner: JournalInner<ENTRY>

Inner journal state.

Implementations§

Source§

impl<DB, ENTRY: JournalEntryTr> Journal<DB, ENTRY>

Source

pub fn new_with_inner(database: DB, inner: JournalInner<ENTRY>) -> Self

Creates a new JournaledState by copying state data from a JournalInit and provided database. This allows reusing the state, logs, and other data from a previous execution context while connecting it to a different database backend.

Source

pub fn into_init(self) -> JournalInner<ENTRY>

Consumes the Journal and returns JournalInner.

If you need to preserve the original journal, use Self::to_inner instead which clones the state.

Source§

impl<DB, ENTRY: JournalEntryTr + Clone> Journal<DB, ENTRY>

Source

pub fn to_inner(&self) -> JournalInner<ENTRY>

Creates a new JournalInner by cloning all internal state data (state, storage, logs, etc) This allows creating a new journaled state with the same state data but without carrying over the original database.

This is useful when you want to reuse the current state for a new transaction or execution context, but want to start with a fresh database.

Methods from Deref<Target = JournalInner<ENTRY>>§

Source

pub fn clear_and_take_output(&mut self) -> JournalOutput

Take the JournalOutput and clears the journal by resetting it to initial state.

Note: Precompile addresses and spec are preserved and initial state of warm_preloaded_addresses will contain precompiles addresses. Precompile addresses

Source

pub fn state(&mut self) -> &mut EvmState

Return reference to state.

Source

pub fn set_spec_id(&mut self, spec: SpecId)

Sets SpecId.

Source

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

Mark account as touched as only touched accounts will be added to state. This is especially important for state clear where touched empty accounts needs to be removed from state.

Source

pub fn account(&self, address: Address) -> &Account

Returns the loaded [Account] for the given address.

This assumes that the account has already been loaded.

§Panics

Panics if the account has not been loaded and is missing from the state set.

Source

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

Set code and its hash to the account.

Note: Assume account is warm and that hash is calculated from code.

Source

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

Use it only if you know that acc is warm.

Assume account is warm.

Source

pub fn inc_nonce(&mut self, address: Address) -> Option<u64>

Source

pub fn transfer<DB: Database>( &mut self, db: &mut DB, from: Address, to: Address, balance: U256, ) -> Result<Option<TransferError>, DB::Error>

Transfers balance from two accounts. Returns error if sender balance is not enough.

Source

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

Creates account or returns false if collision is detected.

There are few steps done:

  1. Make created account warm loaded (AccessList) and this should be done before subroutine checkpoint is created.
  2. Check if there is collision of newly created account with existing one.
  3. Mark created account as created.
  4. Add fund to created account
  5. Increment nonce of created account if SpuriousDragon is active
  6. Decrease balance of caller account.
§Panics

Panics if the caller is not loaded inside the EVM state. This should have been done inside create_inner.

Source

pub fn checkpoint(&mut self) -> JournalCheckpoint

Makes a checkpoint that in case of Revert can bring back state to this point.

Source

pub fn checkpoint_commit(&mut self)

Commits the checkpoint.

Source

pub fn checkpoint_revert(&mut self, checkpoint: JournalCheckpoint)

Reverts all changes to state until given checkpoint.

Source

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

Performs selfdestruct action. Transfers balance from address to target. Check if target exist/is_cold

Note: Balance will be lost if address and target are the same BUT when current spec enables Cancun, this happens only when the account associated to address is created in the same tx

§References:
Source

pub fn initial_account_load<DB: Database>( &mut self, db: &mut DB, address: Address, storage_keys: impl IntoIterator<Item = U256>, ) -> Result<&mut Account, DB::Error>

Initial load of account. This load will not be tracked inside journal

Source

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

Loads account into memory. return if it is cold or warm accessed

Source

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

Source

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

Source

pub fn load_account_optional<DB: Database>( &mut self, db: &mut DB, address: Address, load_code: bool, ) -> Result<StateLoad<&mut Account>, DB::Error>

Loads code

Source

pub fn sload<DB: Database>( &mut self, db: &mut DB, address: Address, key: U256, ) -> Result<StateLoad<U256>, DB::Error>

Loads storage slot.

§Panics

Panics if the account is not present in the state.

Source

pub fn sstore<DB: Database>( &mut self, db: &mut DB, address: Address, key: U256, new: U256, ) -> Result<StateLoad<SStoreResult>, DB::Error>

Stores storage slot.

And returns (original,present,new) slot value.

Note: Account should already be present in our state.

Source

pub fn tload(&mut self, address: Address, key: U256) -> U256

Read transient storage tied to the account.

EIP-1153: Transient storage opcodes

Source

pub fn tstore(&mut self, address: Address, key: U256, new: U256)

Store transient storage tied to the account.

If values is different add entry to the journal so that old state can be reverted if that action is needed.

EIP-1153: Transient storage opcodes

Source

pub fn log(&mut self, log: Log)

Pushes log into subroutine.

Trait Implementations§

Source§

impl<DB: Clone, ENTRY> Clone for Journal<DB, ENTRY>
where ENTRY: JournalEntryTr + Clone,

Source§

fn clone(&self) -> Journal<DB, ENTRY>

Returns a copy of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<DB: Debug, ENTRY> Debug for Journal<DB, ENTRY>
where ENTRY: JournalEntryTr + Debug,

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<DB, ENTRY> Deref for Journal<DB, ENTRY>
where ENTRY: JournalEntryTr,

Source§

type Target = JournalInner<ENTRY>

The resulting type after dereferencing.
Source§

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

Dereferences the value.
Source§

impl<DB, ENTRY> DerefMut for Journal<DB, ENTRY>
where ENTRY: JournalEntryTr,

Source§

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

Mutably dereferences the value.
Source§

impl<'de, DB, ENTRY> Deserialize<'de> for Journal<DB, ENTRY>
where ENTRY: JournalEntryTr + Deserialize<'de>, DB: Deserialize<'de>,

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl<DB: Database, ENTRY: JournalEntryTr> JournalTr for Journal<DB, ENTRY>

Source§

fn depth(&self) -> usize

Returns call depth.

Source§

type Database = DB

Source§

type FinalOutput = JournalOutput

Source§

fn new(database: DB) -> Journal<DB, ENTRY>

Creates new Journaled state. Read more
Source§

fn db_ref(&self) -> &Self::Database

Returns the database.
Source§

fn db(&mut self) -> &mut Self::Database

Returns the mutable database.
Source§

fn sload( &mut self, address: Address, key: U256, ) -> Result<StateLoad<U256>, <Self::Database as Database>::Error>

Returns the storage value from Journal state. Read more
Source§

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.
Source§

fn tload(&mut self, address: Address, key: U256) -> U256

Loads transient storage value.
Source§

fn tstore(&mut self, address: Address, key: U256, value: U256)

Stores transient storage value.
Source§

fn log(&mut self, log: Log)

Logs the log in Journal state.
Source§

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

Marks the account for selfdestruction and transfers all the balance to the target.
Source§

fn warm_account(&mut self, address: Address)

Warms the account.
Source§

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

Warms the precompiles.
Source§

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

Returns the addresses of the precompiles.
Source§

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.
Source§

fn set_spec_id(&mut self, spec_id: SpecId)

Sets the spec id.
Source§

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

Transfers the balance from one account to another.
Source§

fn touch_account(&mut self, address: Address)

Touches the account.
Source§

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

Increments the nonce of the account.
Source§

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

Loads the account.
Source§

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

Loads the account code.
Source§

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

Loads the account delegated.
Source§

fn checkpoint(&mut self) -> JournalCheckpoint

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

fn checkpoint_commit(&mut self)

Commits the changes made since the last checkpoint.
Source§

fn checkpoint_revert(&mut self, checkpoint: JournalCheckpoint)

Reverts the changes made since the last checkpoint.
Source§

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

Sets bytecode with hash. Assume that account is warm.
Source§

fn clear(&mut self)

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

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.
Source§

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

Does cleanup and returns modified state. Read more
§

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

Sets bytecode and calculates hash. Read more
§

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

Returns account code bytes and if address is cold loaded. Read more
§

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

Gets code hash of account. Read more
Source§

impl<DB: PartialEq, ENTRY> PartialEq for Journal<DB, ENTRY>
where ENTRY: JournalEntryTr + PartialEq,

Source§

fn eq(&self, other: &Journal<DB, ENTRY>) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl<DB, ENTRY> Serialize for Journal<DB, ENTRY>
where ENTRY: JournalEntryTr + Serialize, DB: Serialize,

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl<DB: Eq, ENTRY> Eq for Journal<DB, ENTRY>
where ENTRY: JournalEntryTr + Eq,

Source§

impl<DB, ENTRY> StructuralPartialEq for Journal<DB, ENTRY>
where ENTRY: JournalEntryTr,

Auto Trait Implementations§

§

impl<DB, ENTRY> Freeze for Journal<DB, ENTRY>
where DB: Freeze,

§

impl<DB, ENTRY> RefUnwindSafe for Journal<DB, ENTRY>
where DB: RefUnwindSafe, ENTRY: RefUnwindSafe,

§

impl<DB, ENTRY> Send for Journal<DB, ENTRY>
where DB: Send, ENTRY: Send,

§

impl<DB, ENTRY> Sync for Journal<DB, ENTRY>
where DB: Sync, ENTRY: Sync,

§

impl<DB, ENTRY> Unpin for Journal<DB, ENTRY>
where DB: Unpin, ENTRY: Unpin,

§

impl<DB, ENTRY> UnwindSafe for Journal<DB, ENTRY>
where DB: UnwindSafe, ENTRY: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
§

impl<T> Conv for T

§

fn conv<T>(self) -> T
where Self: Into<T>,

Converts self into T using Into<T>. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
§

impl<T> FmtForward for T

§

fn fmt_binary(self) -> FmtBinary<Self>
where Self: Binary,

Causes self to use its Binary implementation when Debug-formatted.
§

fn fmt_display(self) -> FmtDisplay<Self>
where Self: Display,

Causes self to use its Display implementation when Debug-formatted.
§

fn fmt_lower_exp(self) -> FmtLowerExp<Self>
where Self: LowerExp,

Causes self to use its LowerExp implementation when Debug-formatted.
§

fn fmt_lower_hex(self) -> FmtLowerHex<Self>
where Self: LowerHex,

Causes self to use its LowerHex implementation when Debug-formatted.
§

fn fmt_octal(self) -> FmtOctal<Self>
where Self: Octal,

Causes self to use its Octal implementation when Debug-formatted.
§

fn fmt_pointer(self) -> FmtPointer<Self>
where Self: Pointer,

Causes self to use its Pointer implementation when Debug-formatted.
§

fn fmt_upper_exp(self) -> FmtUpperExp<Self>
where Self: UpperExp,

Causes self to use its UpperExp implementation when Debug-formatted.
§

fn fmt_upper_hex(self) -> FmtUpperHex<Self>
where Self: UpperHex,

Causes self to use its UpperHex implementation when Debug-formatted.
§

fn fmt_list(self) -> FmtList<Self>
where &'a Self: for<'a> IntoIterator,

Formats each item in a sequence. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Pipe for T
where T: ?Sized,

§

fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> R
where Self: Sized,

Pipes by value. This is generally the method you want to use. Read more
§

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R
where R: 'a,

Borrows self and passes that borrow into the pipe function. Read more
§

fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R
where R: 'a,

Mutably borrows self and passes that borrow into the pipe function. Read more
§

fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
where Self: Borrow<B>, B: 'a + ?Sized, R: 'a,

Borrows self, then passes self.borrow() into the pipe function. Read more
§

fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
where Self: BorrowMut<B>, B: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
§

fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
where Self: AsRef<U>, U: 'a + ?Sized, R: 'a,

Borrows self, then passes self.as_ref() into the pipe function.
§

fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
where Self: AsMut<U>, U: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.as_mut() into the pipe function.
§

fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
where Self: Deref<Target = T>, T: 'a + ?Sized, R: 'a,

Borrows self, then passes self.deref() into the pipe function.
§

fn pipe_deref_mut<'a, T, R>( &'a mut self, func: impl FnOnce(&'a mut T) -> R, ) -> R
where Self: DerefMut<Target = T> + Deref, T: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.deref_mut() into the pipe function.
Source§

impl<P, T> Receiver for P
where P: Deref<Target = T> + ?Sized, T: ?Sized,

Source§

type Target = T

🔬This is a nightly-only experimental API. (arbitrary_self_types)
The target type on which the method may be called.
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
§

impl<T> Tap for T

§

fn tap(self, func: impl FnOnce(&Self)) -> Self

Immutable access to a value. Read more
§

fn tap_mut(self, func: impl FnOnce(&mut Self)) -> Self

Mutable access to a value. Read more
§

fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Immutable access to the Borrow<B> of a value. Read more
§

fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Mutable access to the BorrowMut<B> of a value. Read more
§

fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Immutable access to the AsRef<R> view of a value. Read more
§

fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Mutable access to the AsMut<R> view of a value. Read more
§

fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Immutable access to the Deref::Target of a value. Read more
§

fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Mutable access to the Deref::Target of a value. Read more
§

fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self

Calls .tap() only in debug builds, and is erased in release builds.
§

fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self

Calls .tap_mut() only in debug builds, and is erased in release builds.
§

fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Calls .tap_borrow() only in debug builds, and is erased in release builds.
§

fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Calls .tap_borrow_mut() only in debug builds, and is erased in release builds.
§

fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Calls .tap_ref() only in debug builds, and is erased in release builds.
§

fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Calls .tap_ref_mut() only in debug builds, and is erased in release builds.
§

fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Calls .tap_deref() only in debug builds, and is erased in release builds.
§

fn tap_deref_mut_dbg<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Calls .tap_deref_mut() only in debug builds, and is erased in release builds.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
§

impl<T> TryConv for T

§

fn try_conv<T>(self) -> Result<T, Self::Error>
where Self: TryInto<T>,

Attempts to convert self into T using TryInto<T>. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,