Struct sp_trie::recorder::Recorder

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

The trie recorder.

It can be used to record accesses to the trie and then to convert them into a StorageProof.

Implementations

impl<H: Hasher> Recorder<H>

pub fn as_trie_recorder( &self, storage_root: H::Out ) -> impl TrieRecorder<H::Out> + '_

Returns the recorder as TrieRecorder compatible type.

• storage_root: The storage root of the trie for which accesses are recorded. This is important when recording access to different tries at once (like top and child tries).

NOTE: This locks a mutex that stays locked until the return value is dropped.

pub fn drain_storage_proof(self) -> StorageProof

Drain the recording into a StorageProof.

While a recorder can be cloned, all share the same internal state. After calling this function, all other instances will have their internal state reset as well.

If you don’t want to drain the recorded state, use Self::to_storage_proof.

Returns the StorageProof.

pub fn to_storage_proof(&self) -> StorageProof

Convert the recording to a StorageProof.

In contrast to Self::drain_storage_proof this doesn’t consumes and doesn’t clears the recordings.

Returns the StorageProof.

pub fn estimate_encoded_size(&self) -> usize

Returns the estimated encoded size of the proof.

The estimation is based on all the nodes that were accessed until now while accessing the trie.

pub fn reset(&self)

Reset the state.

This discards all recorded data.

pub fn start_transaction(&self)

Start a new transaction.

pub fn rollback_transaction(&self) -> Result<(), ()>

Rollback the latest transaction.

Returns an error if there wasn’t any active transaction.

pub fn commit_transaction(&self) -> Result<(), ()>

Commit the latest transaction.

Returns an error if there wasn’t any active transaction.

Trait Implementations

impl<H: Hasher> Clone for Recorder<H>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<H: Hasher> Default for Recorder<H>

fn default() -> Self

Returns the “default value” for a type.