Struct SecondaryBlockIndex 

pub struct SecondaryBlockIndex { /* private fields */ }

Secondary index for fast block lookups by codec, tag, size range, and creation-tick range.

Maintains inverted indices from codec and tag to CID lists so that lookups by those dimensions are O(bucket-size) instead of O(n). Size-range and tick-range queries use linear filtering over the primary entry map.

Implementations

impl SecondaryBlockIndex

pub fn new() -> Self

Create a new, empty SecondaryBlockIndex.

pub fn insert(&mut self, entry: BlockIndexEntry)

Insert a BlockIndexEntry into the index.

If an entry with the same CID already exists it is removed first so that all inverted indices stay consistent.

pub fn remove(&mut self, cid: &str) -> Option<BlockIndexEntry>

Remove an entry by CID from all indices.

Returns Some(entry) if found, None otherwise.

pub fn get(&self, cid: &str) -> Option<&BlockIndexEntry>

Look up an entry by CID.

pub fn find_by_codec(&self, codec: &str) -> Vec<&BlockIndexEntry>

Return all entries that use the given codec, sorted by CID for deterministic ordering.

pub fn find_by_tag(&self, tag: &str) -> Vec<&BlockIndexEntry>

Return all entries that carry the given tag, sorted by CID.

pub fn find_by_size_range(&self, min: u64, max: u64) -> Vec<&BlockIndexEntry>

Return all entries whose size_bytes is within [min, max] (inclusive), sorted by CID.

pub fn find_by_created_range( &self, min_tick: u64, max_tick: u64, ) -> Vec<&BlockIndexEntry>

Return all entries whose created_tick is within [min_tick, max_tick] (inclusive), sorted by CID.

pub fn entry_count(&self) -> usize

Number of entries currently in the index.

pub fn total_bytes(&self) -> u64

Cumulative size in bytes of all indexed blocks.

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

Return all distinct codec strings, sorted alphabetically.

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

Return all distinct tag strings, sorted alphabetically.

pub fn stats(&self) -> BlockIndexStats

Compute aggregate statistics.

Trait Implementations

impl Default for SecondaryBlockIndex

fn default() -> Self

Returns the “default value” for a type.