Struct sp_trie::cache::LocalTrieCache

pub struct LocalTrieCache<H: Hasher> { /* private fields */ }

The local trie cache.

This cache should be used per state instance created by the backend. One state instance is referring to the state of one block. It will cache all the accesses that are done to the state which could not be fulfilled by the SharedTrieCache. These locally cached items are merged back to the shared trie cache when this instance is dropped.

When using Self::as_trie_db_cache or Self::as_trie_db_mut_cache, it will lock Mutexes. So, it is important that these methods are not called multiple times, because they otherwise deadlock.

Implementations

impl<H: Hasher> LocalTrieCache<H>

pub fn as_trie_db_cache(&self, storage_root: H::Out) -> TrieCache<'_, H>

Return self as a TrieDB compatible cache.

The given storage_root needs to be the storage root of the trie this cache is used for.

pub fn as_trie_db_mut_cache(&self) -> TrieCache<'_, H>

Return self as TrieDBMut compatible cache.

After finishing all operations with TrieDBMut and having obtained the new storage root, TrieCache::merge_into should be called to update this local cache instance. If the function is not called, cached data is just thrown away and not propagated to the shared cache. So, accessing these new items will be slower, but nothing would break because of this.

Trait Implementations

impl<H: Hasher> Drop for LocalTrieCache<H>

fn drop(&mut self)

Executes the destructor for this type.