Struct StorageBlockManifest 

pub struct StorageBlockManifest {
    pub entries: HashMap<String, ManifestEntry>,
}

Catalogs all blocks in a storage partition.

Keyed by CID; supports fast lookup, consistency verification, filtering, pinning, statistics, merge, and sorted export.

Fields

entries: HashMap<String, ManifestEntry>

Block entries indexed by CID.

Implementations

impl StorageBlockManifest

pub fn new() -> Self

Create an empty manifest.

pub fn add_entry(&mut self, entry: ManifestEntry)

Add (or overwrite) an entry. The key used is entry.cid.

pub fn remove_entry(&mut self, cid: &str) -> bool

Remove an entry by CID.

Returns true if the entry existed and was removed, false otherwise.

pub fn get_entry(&self, cid: &str) -> Option<&ManifestEntry>

Retrieve an entry by CID, or None if not present.

pub fn pin(&mut self, cid: &str) -> bool

Mark the entry with the given CID as pinned.

Returns false if no such entry exists.

pub fn unpin(&mut self, cid: &str) -> bool

Mark the entry with the given CID as unpinned.

Returns false if no such entry exists.

pub fn filter(&self, filter: &ManifestFilter) -> Vec<&ManifestEntry>

Return all entries matching filter, sorted by added_at_secs ascending.

pub fn stats(&self) -> ManifestStats

Compute aggregate statistics for the manifest.

pub fn merge(&mut self, other: &StorageBlockManifest)

Merge entries from other into self.

• If a CID in other is absent from self, it is inserted.
• If a CID is present in both and other’s entry is pinned, self’s entry is also set to pinned (pin propagation).

pub fn export_cids(&self) -> Vec<String>

Return all CIDs in the manifest, sorted alphabetically.

pub fn verify_checksums(&self) -> Vec<String>

Return the CIDs of entries whose stored checksum does not match the FNV-1a hash recomputed from the CID bytes.

Trait Implementations

impl Clone for StorageBlockManifest

fn clone(&self) -> StorageBlockManifest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StorageBlockManifest

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

Formats the value using the given formatter.

impl Default for StorageBlockManifest

fn default() -> Self

Returns the “default value” for a type.