Struct BlobStore 

pub struct BlobStore { /* private fields */ }

A local-filesystem content-addressed blob store. The same path layout is a valid object-store key prefix, so a future S3/R2 backend is a swap behind this type (design Phase 9).

Implementations

impl BlobStore

pub fn new(data_dir: &str) -> Result<Self>

Open (creating if needed) the blob store rooted at <data_dir>/blobs.

pub fn put(&self, content: &[u8]) -> Result<String>

Hash content, write it snap-compressed if not already present, and return the hex sha256. Idempotent: re-putting identical content is a cheap no-op (the dedup property).

pub fn get(&self, hash: &str) -> Result<Option<Vec<u8>>>

Fetch and decompress a blob by hex sha256. Ok(None) if it doesn’t exist (e.g. GC’d under retention).

pub fn list_hashes(&self) -> Result<Vec<String>>

List every stored blob hash (walks the shard tree).

pub fn remove(&self, hash: &str) -> Result<()>

Delete a blob by hash. Missing blobs are a no-op.

pub fn gc(&self, live: &HashSet<String>) -> Result<usize>

Mark-and-sweep GC: delete every blob whose hash is not in live. Returns the number of blobs removed. (Blobs are written before their referencing row, so an orphan = a row that never landed, or a row that retention has since dropped — both safe to collect.)