Skip to content

Architecture Decision Records

Open decisions

These were decided unilaterally while the records above were drafted and are recorded here so a human can confirm or overturn them.

  • BLAKE3-256 as the content hash (hash suite 1).
  • HKDF-SHA-256 for all key derivation.
  • Canonical CBOR per RFC 8949 section 4.2.1 as the signed and hashed encoding.
  • ECIES over NIST P-256 for the p256 recipient type.
  • ECDSA P-256 with SHA-256 for signatures by p256 (hardware) device keys.
  • Decided (ADR 0029): the default approval TTL is 8 hours.
  • Decided (ADR 0029): the default approval scope is the collection of the first request in a session.
  • The recovery key is an ordinary device key whose private half is Shamir-split, rather than a separate recovery mechanism.
  • S3 put-if-absent implemented with a conditional write (If-None-Match).
  • Epoch wraps nested per collection, and (decided, ADR 0052) under the link that calls for each wrap: epochs/<collection-id>/<epoch>/<link>/<keyid>.wrap, <link> the first 16 hex characters of that link's id.
  • Entry ids are random 128-bit values and the path is a mutable attribute.
  • Decided (ADR 0046): policy files are stored unsharded at their slot path policy/<seqno>.pol, the seqno as 20 zero-padded decimal digits.
  • Decided: the v1 file entry type is capped at 64 KiB; chunked attachments are deferred to a later change.
  • Deferred: forward secrecy via one-time pre-keys (v2; prekey recipient type 4 is reserved and refused by v1).

See also ../threat-model.md.