Struct era_test_node::deps::storage_view::StorageView

pub struct StorageView<S> {
    pub storage_handle: S,
    pub modified_storage_keys: HashMap<StorageKey, StorageValue>,
    /* private fields */
}

StorageView is a buffer for StorageLogs between storage and transaction execution code. In order to commit transactions logs should be submitted to the underlying storage after a transaction is executed.

When executing transactions as a part of miniblock / L1 batch creation, a single StorageView is used for the entire L1 batch. One StorageView must not be used for multiple L1 batches; otherwise, Self::is_write_initial() will return incorrect values because of the caching.

When executing transactions in the API sandbox, a dedicated view is used for each transaction; the only shared part is the read storage keys cache.

Fields

storage_handle: S

modified_storage_keys: HashMap<StorageKey, StorageValue>

Implementations

impl<S: ReadStorage + Debug> StorageView<S>

pub fn new(storage_handle: S) -> Self

Creates a new storage view based on the underlying storage.

pub fn clean_cache(&mut self)

pub fn into_rc_ptr(self) -> Rc<RefCell<Self>>

Make a Rc RefCell ptr to the storage

Trait Implementations

impl<S: Debug> Debug for StorageView<S>

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

Formats the value using the given formatter.

impl<S: ReadStorage + Debug> ReadStorage for StorageView<S>

fn is_write_initial(&mut self, key: &StorageKey) -> bool

Only keys contained in the underlying storage will return false. If a key was inserted using Self::set_value(), it will still return true.

fn read_value(&mut self, key: &StorageKey) -> StorageValue

Read value of the key.

fn load_factory_dep(&mut self, hash: H256) -> Option<Vec<u8>>

Load the factory dependency code by its hash.

fn get_enumeration_index(&mut self, key: &StorageKey) -> Option<u64>

Retrieves the enumeration index for a given key.

fn is_bytecode_known(&mut self, bytecode_hash: &H256) -> bool

Returns whether a bytecode hash is “known” to the system.

impl<S: ReadStorage + Debug> WriteStorage for StorageView<S>

fn set_value(&mut self, key: StorageKey, value: StorageValue) -> StorageValue

Sets the new value under a given key and returns the previous value.

fn read_storage_keys(&self) -> &HashMap<StorageKey, StorageValue>

Returns the map with the key–value pairs read by this batch.

fn modified_storage_keys(&self) -> &HashMap<StorageKey, StorageValue>

Returns a map with the key–value pairs updated by this batch.

fn missed_storage_invocations(&self) -> usize

Returns the number of read / write ops for which the value was read from the underlying storage.