Skip to main content

Module blobs

Module blobs 

Source
Expand description

iroh-blobs-backed content-addressed object store (F1, #899).

Evaluation + first-integration spike for Track F of the gittorrent → hyprstream-p2p convergence (epic #880 §2). Provides a LOCAL (in-process, no network) put/get pair preserving the consumer contract used by git-xet-filter and git2db:

put_object(Vec<u8>)              -> Sha256Hash
get_object(&Sha256Hash)          -> Option<Vec<u8>>
put_object_by_cid(ContentCid, ..) -> ()
get_object_by_cid(&ContentCid)    -> Option<Vec<u8>>

§CID → BLAKE3 locator index

iroh-blobs addresses raw bytes by BLAKE3. Consumers address several domains: raw Git objects use SHA-256, while XET file reconstruction DAGs use a keyed BLAKE3 MerkleHash. Those are carried in a self-describing ContentCid and indexed to the raw iroh-blobs hash without collapsing algorithm or content-domain identity. SHA-256 methods remain compatibility wrappers that construct a git-raw + sha2-256 CID.

For the persistent (FsStore) backend the index is an append-only sidecar file (sha256-blake3.index, one cid blake3hex line per object) loaded at open. Legacy sha256hex blake3hex entries are upgraded in memory to a Git object CID. Malformed entries are skipped with a warning.

§Scope

Local store only. Networked fetch (provider discovery via the at9p mainline locator + remote transfer) is F2 (#900). Wiring this store under GitTorrentService::{put,get}_object in place of the libp2p DHT is also F2; retiring libp2p is F3 (#901).

Structs§

IrohBlobStore
Content-addressed object store backed by iroh-blobs, keyed by canonical CIDs.