Struct DataCache 

pub struct DataCache { /* private fields */ }

Local content-addressed cache. Stores chunks on disk, indexed by BLAKE3 hash.

Layout: <cache_dir>/ manifests/<root_hash>.json — chunk manifests chunks// — raw chunk data (sharded by first 2 hex chars)

Implementations

impl DataCache

pub async fn new(dir: &Path) -> Result<Self>

pub async fn put_chunk(&self, chunk: &Chunk) -> Result<()>

Store a chunk locally.

pub async fn get_chunk(&self, hash: &str) -> Result<Option<Chunk>>

Retrieve a chunk from local cache.

pub async fn has_chunk(&self, hash: &str) -> bool

Check if we have a chunk.

pub async fn put_manifest(&self, manifest: &ChunkManifest) -> Result<()>

Store a manifest.

pub async fn get_manifest(&self, root_hash: &str) -> Option<ChunkManifest>

Get a manifest.

pub async fn local_chunks(&self) -> Vec<String>

List all chunk hashes we have.

pub async fn local_manifests(&self) -> Vec<ChunkManifest>

List all manifests we have.

pub async fn manifest_completeness( &self, manifest: &ChunkManifest, ) -> (usize, usize)

Check how many chunks of a manifest we have locally.

pub async fn store_data( &self, data: &[u8], content_type: &str, label: &str, ) -> Result<ChunkManifest>

Store complete data: split into chunks, store all, store manifest.

pub async fn retrieve_data( &self, manifest: &ChunkManifest, ) -> Result<Option<Vec<u8>>>

Retrieve complete data from cache, given a manifest.

pub async fn size_bytes(&self) -> u64

Cache size in bytes (approximate).