Struct SegmentHeadersStore

pub struct SegmentHeadersStore { /* private fields */ }

Persistent storage of segment headers.

It maintains all known segment headers. During sync from DSN it is possible that this data structure contains segment headers that from the point of view of the tip of the current chain are “in the future”. This is expected and must be accounted for in the archiver and other places.

Segment headers are stored in batches (which is more efficient to store and retrieve). Each next batch contains distinct segment headers with monotonically increasing segment indices. During instantiation all previously stored batches will be read and in-memory representation of the whole contents will be created such that queries to this data structure are quick and not involving any disk I/O.

Implementations

impl SegmentHeadersStore

pub fn new( confirmation_depth_k: BlockNumber, ) -> Result<Self, SegmentHeaderStoreError>

Create new instance

pub fn last_segment_header(&self) -> Option<SegmentHeader>

Returns last observed segment header

pub fn max_segment_index(&self) -> Option<SegmentIndex>

Returns last observed segment index

pub fn add_segment_headers( &self, segment_headers: &[SegmentHeader], ) -> Result<(), SegmentHeaderStoreError>

Add segment headers.

Multiple can be inserted for efficiency purposes.

pub fn get_segment_header( &self, segment_index: SegmentIndex, ) -> Option<SegmentHeader>

Get a single segment header

pub fn segment_headers_for_block( &self, block_number: BlockNumber, ) -> Vec<SegmentHeader>

Get segment headers that are expected to be included at specified block number.

Trait Implementations

impl Clone for SegmentHeadersStore

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SegmentHeadersStore

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

Formats the value using the given formatter.