Struct RevmWrite 

pub struct RevmWrite<U>
where
    U: HotKvWrite,
{ /* private fields */ }

Read-write REVM database adapter. This adapter allows committing changes. Despite the naming of TryDatabaseCommit::try_commit, the changes are only persisted when Self::persist is called. This is because of a mismatch in semantics between the two systems.

Implementations

impl<U> RevmWrite<U>

where U: HotKvWrite,

pub const fn new(writer: U) -> RevmWrite<U>

Create a new write adapter

pub fn persist(self) -> Result<(), <U as HotKvRead>::Error>

Persist the changes made in this write transaction.

Trait Implementations

impl<T> Database for RevmWrite<T>

where T: HotKvWrite, <T as HotKvRead>::Error: DBErrorMarker,

type Error = <T as HotKvRead>::Error

The database error type.

fn basic( &mut self, address: Address, ) -> Result<Option<AccountInfo>, <RevmWrite<T> as Database>::Error>

Gets basic account information.

fn code_by_hash( &mut self, code_hash: FixedBytes<32>, ) -> Result<Bytecode, <RevmWrite<T> as Database>::Error>

Gets account code by its hash.

fn storage( &mut self, address: Address, index: Uint<256, 4>, ) -> Result<Uint<256, 4>, <RevmWrite<T> as Database>::Error>

Gets storage value of address at index.

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

Gets block hash by block number.

fn storage_by_account_id( &mut self, address: Address, account_id: usize, storage_key: Uint<256, 4>, ) -> Result<Uint<256, 4>, Self::Error>

Gets storage value of account by its id. By default call Database::storage method.

impl<T> DatabaseRef for RevmWrite<T>

where T: HotKvWrite, <T as HotKvRead>::Error: DBErrorMarker,

type Error = <T as HotKvRead>::Error

The database error type.

fn basic_ref( &self, address: Address, ) -> Result<Option<AccountInfo>, <RevmWrite<T> as DatabaseRef>::Error>

Gets basic account information.

fn code_by_hash_ref( &self, code_hash: FixedBytes<32>, ) -> Result<Bytecode, <RevmWrite<T> as DatabaseRef>::Error>

Gets account code by its hash.

fn storage_ref( &self, address: Address, index: Uint<256, 4>, ) -> Result<Uint<256, 4>, <RevmWrite<T> as DatabaseRef>::Error>

Gets storage value of address at index.

fn block_hash_ref( &self, number: u64, ) -> Result<FixedBytes<32>, <RevmWrite<T> as DatabaseRef>::Error>

Gets block hash by block number.

fn storage_by_account_id_ref( &self, address: Address, account_id: usize, storage_key: Uint<256, 4>, ) -> Result<Uint<256, 4>, Self::Error>

Gets storage value of account by its id.

impl<U> Debug for RevmWrite<U>

where U: HotKvWrite,

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

Formats the value using the given formatter.

impl<U> HotKvRead for RevmWrite<U>

where U: HotKvWrite,

type Error = <U as HotKvRead>::Error

Error type for read operations.

type Traverse<'a> = <U as HotKvRead>::Traverse<'a> where U: 'a

The cursor type for traversing key-value pairs.

fn raw_traverse<'a>( &'a self, table: &'static str, ) -> Result<<RevmWrite<U> as HotKvRead>::Traverse<'a>, <RevmWrite<U> as HotKvRead>::Error>

Get a raw cursor to traverse the database.

fn raw_get<'a>( &'a self, table: &'static str, key: &[u8], ) -> Result<Option<Cow<'a, [u8]>>, <RevmWrite<U> as HotKvRead>::Error>

Get a raw value from a specific table.

fn raw_get_dual<'a>( &'a self, table: &'static str, key1: &[u8], key2: &[u8], ) -> Result<Option<Cow<'a, [u8]>>, <RevmWrite<U> as HotKvRead>::Error>

Get a raw value from a specific table with dual keys.

fn get<T>( &self, key: &<T as Table>::Key, ) -> Result<Option<<T as Table>::Value>, <RevmWrite<U> as HotKvRead>::Error>

where T: SingleKey,

Get a value from a specific table.

fn get_dual<T>( &self, key1: &<T as Table>::Key, key2: &<T as DualKey>::Key2, ) -> Result<Option<<T as Table>::Value>, <RevmWrite<U> as HotKvRead>::Error>

where T: DualKey,

Get a value from a specific dual-keyed table.

fn traverse<'a, T>( &'a self, ) -> Result<TableCursor<Self::Traverse<'a>, T, Self::Error>, Self::Error>

where T: SingleKey,

Traverse a specific table. Returns a typed cursor wrapper.

fn traverse_dual<'a, T>( &'a self, ) -> Result<DualTableCursor<Self::Traverse<'a>, T, Self::Error>, Self::Error>

where T: DualKey,

Traverse a specific dual-keyed table. Returns a typed dual-keyed cursor wrapper.

impl<U> HotKvWrite for RevmWrite<U>

where U: HotKvWrite,

type TraverseMut<'a> = <U as HotKvWrite>::TraverseMut<'a> where U: 'a

The mutable cursor type for traversing key-value pairs.

fn raw_traverse_mut<'a>( &'a self, table: &'static str, ) -> Result<<RevmWrite<U> as HotKvWrite>::TraverseMut<'a>, <RevmWrite<U> as HotKvRead>::Error>

Get a raw mutable cursor to traverse the database.

fn queue_raw_put( &self, table: &'static str, key: &[u8], value: &[u8], ) -> Result<(), <RevmWrite<U> as HotKvRead>::Error>

Queue a raw put operation.

fn queue_raw_put_dual( &self, table: &'static str, key1: &[u8], key2: &[u8], value: &[u8], ) -> Result<(), <RevmWrite<U> as HotKvRead>::Error>

Queue a raw put operation for a dual-keyed table. The key1 and key2 buf must be <= MAX_KEY_SIZE bytes. Implementations are allowed to panic if this is not the case.

fn queue_raw_delete( &self, table: &'static str, key: &[u8], ) -> Result<(), <RevmWrite<U> as HotKvRead>::Error>

Queue a raw delete operation.

fn queue_raw_delete_dual( &self, table: &'static str, key1: &[u8], key2: &[u8], ) -> Result<(), <RevmWrite<U> as HotKvRead>::Error>

Queue a raw delete operation for a dual-keyed table.

fn queue_raw_clear( &self, table: &'static str, ) -> Result<(), <RevmWrite<U> as HotKvRead>::Error>

Queue a raw clear operation for a specific table.

fn queue_raw_create( &self, table: &'static str, dual_key: Option<usize>, dual_fixed: Option<usize>, ) -> Result<(), <RevmWrite<U> as HotKvRead>::Error>

Queue a raw create operation for a specific table.

fn raw_commit(self) -> Result<(), <RevmWrite<U> as HotKvRead>::Error>

Commit the queued operations.

fn queue_put<T>( &self, key: &<T as Table>::Key, value: &<T as Table>::Value, ) -> Result<(), <RevmWrite<U> as HotKvRead>::Error>

where T: SingleKey,

Queue a put operation for a specific table.

fn queue_put_dual<T>( &self, key1: &<T as Table>::Key, key2: &<T as DualKey>::Key2, value: &<T as Table>::Value, ) -> Result<(), <RevmWrite<U> as HotKvRead>::Error>

where T: DualKey,

Queue a put operation for a specific dual-keyed table.

fn queue_delete<T>( &self, key: &<T as Table>::Key, ) -> Result<(), <RevmWrite<U> as HotKvRead>::Error>

where T: SingleKey,

Queue a delete operation for a specific table.

fn queue_create<T>(&self) -> Result<(), <RevmWrite<U> as HotKvRead>::Error>

where T: Table,

Queue creation of a specific table.

fn queue_clear<T>(&self) -> Result<(), <RevmWrite<U> as HotKvRead>::Error>

where T: Table,

Queue clearing all entries in a specific table.

fn traverse_mut<'a, T>( &'a self, ) -> Result<TableCursor<Self::TraverseMut<'a>, T, Self::Error>, Self::Error>

where T: SingleKey,

Traverse a specific table. Returns a mutable typed cursor wrapper. If invoked for a dual-keyed table, it will traverse the primary keys only, and the return value may be implementation-defined.

fn traverse_dual_mut<'a, T>( &'a self, ) -> Result<DualTableCursor<Self::TraverseMut<'a>, T, Self::Error>, Self::Error>

where T: DualKey,

Traverse a specific dual-keyed table. Returns a mutable typed dual-keyed cursor wrapper.

fn queue_append<T>( &self, key: &<T as Table>::Key, value: &<T as Table>::Value, ) -> Result<(), Self::Error>

where T: SingleKey,

Append a key-value pair. Key must be > all existing keys.

fn queue_append_dual<T>( &self, k1: &<T as Table>::Key, k2: &<T as DualKey>::Key2, value: &<T as Table>::Value, ) -> Result<(), Self::Error>

where T: DualKey,

Append a dual-key entry. k2 must be > all existing k2s for k1.

fn queue_delete_dual<T>( &self, key1: &<T as Table>::Key, key2: &<T as DualKey>::Key2, ) -> Result<(), Self::Error>

where T: DualKey,

Queue a delete operation for a specific dual-keyed table.

fn queue_db_init(&self) -> Result<(), Self::Error>

Queue creation of all standard hot storage tables.

fn clear_k1_for<T>(&self, key1: &<T as Table>::Key) -> Result<(), Self::Error>

where T: DualKey,

Clear all K2 entries for a specific K1 in a dual-keyed table.

impl<T> TryDatabaseCommit for RevmWrite<T>

where T: HotKvWrite, <T as HotKvRead>::Error: DBErrorMarker,

type Error = <T as HotKvRead>::Error

Error type for when TryDatabaseCommit::try_commit fails.

fn try_commit( &mut self, changes: HashMap<Address, Account, DefaultHashBuilder>, ) -> Result<(), <RevmWrite<T> as TryDatabaseCommit>::Error>

Attempt to commit changes to the database.