files/

Package broker is the fileprotov2 client of the files subsystem (SYN-27): batch RPCs against the space's responsible fileV2 nodes (routing by nodeconf.FileV2Peers with NotResponsible failover), the presigned HTTP upload, and durable-custody receipt verification against the fleet.

Package carfile reads and writes the files byte-layer pack format: one standard CARv2 (pragma + v2 header + CARv1 data payload + embedded multihash-sorted index) per file, keyed by its UnixFS root cid.

Package crypt implements the files byte-layer cipher: whole-file AES-256-CFB with a zero IV and a random per-file key — the exact format anytype-heart writes (cfb.New(key, [aes.BlockSize]byte{})), so ciphertext and the derived UnixFS cids stay byte-compatible.

Package fetch is the client download path of the files subsystem (SYN-28): resolve a rootCid through the block-source ladder — local store → peer (SYN-24 seam) → public CARv2 GET with HTTP Range — and expose verified plaintext as a seekable reader.

Package filep2p is the SDK's peer-to-peer file transfer: a read-only server that streams a device's stored CAR objects to LAN peers, and a PeerSource that fetches file objects from LAN peers before the public HTTP path.

Package gc is the local-cache reclamation of the files subsystem (SYN-26).

Package status is the files background-work engine (SYN-29): one persistent queue with two job kinds — drive-toward-durable (every registered row whose backup hasn't succeeded yet) and pin (full background fetches).

Package store is the local content-addressed payload store of the files subsystem (SYN-25): one CARv2 per file keyed by its root cid (byte-identical to the uploaded S3 object), plus an any-store metadata collection holding the small hot state — download bitmap, state, per-file refs, the per-space content-dedup index and LRU access times.

Package upload is the client upload path of the files subsystem (SYN-27): spool → tier decision (inline / BIND dedup / full) → encrypt → UnixFS DAG → local CARv2 → register the payloads row → enqueue the durable phase.