Struct OrphanGarbageCollector 

pub struct OrphanGarbageCollector { /* private fields */ }

Lightweight garbage collector that targets orphaned blocks — blocks that are present in the store but are not referenced by any pinned CID.

Unlike the full mark-and-sweep GarbageCollector, this collector does not traverse DAG links. It simply checks every stored CID against the caller-supplied pinned_cids set and deletes the rest.

Implementations

impl OrphanGarbageCollector

pub fn new(config: OrphanGcConfig) -> Self

Create a new orphan garbage collector with the given configuration.

pub async fn collect<S: BlockStore>( &self, store: &S, pinned_cids: &HashSet<String>, ) -> Result<OrphanGcResult>

Collect orphaned blocks from store.

pinned_cids – the set of CID string representations that must not be deleted. Every block whose string CID is absent from this set and is not otherwise protected is treated as an orphan.

When snapshot_registry is supplied, CIDs registered there are also excluded from collection (they represent HNSW / knowledge-base snapshot blocks that must outlive their originating sessions).

pub async fn collect_with_snapshot_registry<S: BlockStore>( &self, store: &S, pinned_cids: &HashSet<String>, snapshot_registry: Option<&SledSnapshotPinRegistry>, ) -> Result<OrphanGcResult>

Variant of collect that additionally consults a SledSnapshotPinRegistry so that HNSW snapshot CIDs are never GC’d.

Only available when the sled-backend feature is enabled.