Struct SnapshotStore 

pub struct SnapshotStore { /* private fields */ }

redb-backed store for sealed full-tree snapshots.

The store is policy-free: it persists and retrieves snapshots without filtering by age. Staleness enforcement is the consumer’s responsibility.

Implementations

impl SnapshotStore

pub fn open(path: impl AsRef<Path>) -> Result<Self, BootnodeError>

Open or create the snapshot store at path.

pub fn put( &self, header: &SnapshotHeader, body: &[u8], ) -> Result<(), BootnodeError>

Persist a snapshot. Overwrites any existing snapshot at the same sequence_no.

Header and body are written in a single transaction.

pub fn get( &self, sequence_no: u64, ) -> Result<Option<SnapshotHeader>, BootnodeError>

Retrieve the header at exactly sequence_no, if any.

pub fn latest_at_most( &self, up_to: u64, ) -> Result<Option<SnapshotHeader>, BootnodeError>

Return the header with the largest sequence_no <= up_to, if any.

pub fn read_body( &self, sequence_no: u64, writer: &mut impl Write, ) -> Result<Option<u64>, BootnodeError>

Stream the body of snapshot sequence_no into writer.

Both tables are opened from the same read transaction for snapshot isolation. The header is the source of truth for existence:

• Header missing: returns Ok(None) regardless of BODIES_TABLE state. The canonical “not sealed” signal. An orphan body without a matching header is silently inaccessible through this method — correct, because the only insertion path (put) writes header+body atomically, so an orphan body would be evidence of either external tampering or a redb-internal bug, neither of which read_body should service.
• Header present, body missing: returns BootnodeError::SnapshotBodyLenMismatch with actual: 0. Indicates a torn write or partial restoration.
• Header present, body present, lengths differ: returns BootnodeError::SnapshotBodyLenMismatch with the actual length. Indicates corruption or a write-side invariant violation.
• Header present, body present, lengths match: streams body to writer, returns Ok(Some(body_len)).

Trait Implementations

impl Debug for SnapshotStore

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

Formats the value using the given formatter.