Files
zeekay e644ad760f docs: examples section + honest benchmarks rewrite
examples/ — 4 working code samples under zap-proto/rns/examples/.
Every one builds and runs from a clean checkout.

  - 01_compute_did             — derive a did:zap from a (kemPk, sigPk)
  - 02_dual_identity_collision — rotation surfaces in the DID; use
                                  Records, not equality, to track service
                                  identity across rotations
  - 03_signed_record_roundtrip — registry signs Record → resolver returns
                                  it → client verifies + checks window +
                                  derives DID
  - 04_capability_mailbox      — PostCap vs ReadCap, unforgeable handles,
                                  revocation without rotating identities

dev/content/docs/examples/ — three MDX pages walking through the
roundtrip, the cross-language KAT (Go + Rust + Python + Node all
reproduce did:zap:ok7klbkh4p3udjjeo4n7hkevssfyhswx6zygqif3tiemjmbgz7fa
from the same canonical inputs), and the capability model.

benchmarks.mdx — fully rewritten against the actual harness output.
The old page had wall-to-wall fabricated tables (1438×, 736458×,
656× — none traceable to a benchmark file). Replaced with real
numbers from zap-proto/bench/bench-results.txt: ZAP modestly wins
at small payloads, loses at large, ties under concurrency. Honest.
The "ZAP wins at X" argument is moved from µs to mechanism: one
wire format for many protocols, PQ at the transport by default,
capability semantics, PQ-RNS.

This burns the last of the AI-slop in the perf claims. Whatever
numbers replace these will come from a real harness run.
2026-05-27 10:40:33 -07:00
..