Design

Design

Normative protocol design covering framing, pairing, key rotation, and capability authorization.

  • Wire protocol and pairing - Preamble framing, Noise XXhfs hybrid PQ handshake, transcript-bound pairing proof, hybrid key rotation chains, and inner encrypted transport frames.
  • Machine-to-machine enrollment - Opt-in headless enrollment using signed single-use tokens, hybrid Ed25519 + ML-DSA-65 transcript proofs, external trust anchors, and atomic burn-log replay protection.
  • Capability grants and revocation - Default-deny capability grammar, RFC 8785 JCS signing, recursive delegation checks, and monotonic revocation lists.
  • Sans-I/O core state machines and path policy - Virtual-clock drivers for pairing, peer rosters, sealed sessions, and Happy Eyeballs path selection.
  • Stateless relay v1 and async runtime providers - WebSocket ciphertext relay challenge-response protocol, managed relay admission (Tiers 1-3 and --auth-scope), local/direct/relay transports, 6-point provider contract, rate limits, and 0700/0600 state persistence.
  • Six-rung path providers and relay ladder - Full six-rung ProviderId implementations, zero-setup and managed iroh P2P (p2p-iroh, p2p-iroh-services), scoped overlay helper IPC, embedded relays, and zero-re-pair relay_hints migration.
  • Optional push wake providers - Pull-first opaque wake hints using hourly HKDF WakeTag rotation, UnifiedPush/APNs/FCM/webhook adapters, SSRF-safe delivery, and per-target coalescing.
  • Wire v2 privacy profile and PAKE - Wire 0x02 anti-downgrade floor, pseudonymous paired reconnect, opt-in Argon2id PAKE pairing, blinded /v2/relay mailboxes, bucketed inner padding, and jittered keepalive/rekey scheduling.

Connections

Local graph

Linked from