Struct LeafSet

pub struct LeafSet<H, N> { /* private fields */ }

list of leaf hashes ordered by number (descending). stored in memory for fast access. this allows very fast checking and modification of active leaves.

Implementations

impl<H, N> LeafSet<H, N>

where H: Clone + PartialEq + Decode + Encode, N: Debug + Copy + AtLeast32Bit + Decode + Encode,

pub fn new() -> Self

Construct a new, blank leaf set.

pub fn read_from_db( db: &dyn Database<H256>, column: u32, prefix: &[u8], ) -> Result<Self>

Read the leaf list from the DB, using given prefix for keys.

pub fn import( &mut self, hash: H, number: N, parent_hash: H, ) -> ImportOutcome<H, N>

Update the leaf list on import.

pub fn remove( &mut self, hash: H, number: N, parent_hash: Option<H>, ) -> Option<RemoveOutcome<H, N>>

Update the leaf list on removal.

Note that the leaves set structure doesn’t have the information to decide if the leaf we’re removing is the last children of the parent. Follows that this method requires the caller to check this condition and optionally pass the parent_hash if hash is its last child.

Returns None if no modifications are applied.

pub fn remove_displaced_leaves<I>( &mut self, displaced_leaves: FinalizationOutcome<I, H, N>, )

where I: Iterator<Item = (N, H)>,

Remove all leaves displaced by the last block finalization.

pub fn undo(&mut self) -> Undo<'_, H, N>

Undo all pending operations.

This returns an Undo struct, where any Displaced objects that have returned by previous method calls should be passed to via the appropriate methods. Otherwise, the on-disk state may get out of sync with in-memory state.

pub fn revert( &mut self, best_hash: H, best_number: N, ) -> impl Iterator<Item = (H, N)>

Revert to the given block height by dropping all leaves in the leaf set with a block number higher than the target.

Returns the removed leaves.

pub fn hashes(&self) -> Vec<H>

Returns an iterator over all hashes in the leaf set ordered by their block number descending.

pub fn count(&self) -> usize

Number of known leaves.

pub fn prepare_transaction( &mut self, tx: &mut Transaction<H256>, column: u32, prefix: &[u8], )

Write the leaf list to the database transaction.

pub fn contains(&self, number: N, hash: H) -> bool

Check if given block is a leaf.

pub fn highest_leaf(&self) -> Option<(N, &[H])>

Returns the highest leaf and all hashes associated to it.

Trait Implementations

impl<H: Clone, N: Clone> Clone for LeafSet<H, N>

fn clone(&self) -> LeafSet<H, N>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<H: Debug, N: Debug> Debug for LeafSet<H, N>

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

Formats the value using the given formatter.

impl<H: PartialEq, N: PartialEq> PartialEq for LeafSet<H, N>

fn eq(&self, other: &LeafSet<H, N>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<H: Eq, N: Eq> Eq for LeafSet<H, N>

impl<H, N> StructuralPartialEq for LeafSet<H, N>