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§
- Iroh
Blob Store - Content-addressed object store backed by iroh-blobs, keyed by canonical CIDs.