Skip to content

v2.0.0 — 128-bit nonces, ChaCha20-Poly1305 enrollment

Latest

Choose a tag to compare

@Nexusdeveloper902 Nexusdeveloper902 released this 11 Oct 18:25
· 10 commits to main since this release

Protocol v2 (breaking — phone app, reader firmware, and backend migrate together)

  • 16-byte challenge nonces: CHALLENGE is now 80 10 00 00 10 + 16 bytes (21 B total). Collision probability negligible at any plausible scale.
  • Enrollment wrap is now ChaCha20-Poly1305 AEAD (RFC 8439, dependency-free, pinned against RFC §2.3.2/§2.4.2/§2.8.2 vectors): key derivation binds credId, AAD binds (credId, nonce), 120-hex output (24 nonce + 64 ct + 32 tag). Wrong secrets and any tampering fail closed at unwrap. v1 XOR-HMAC wrap retired.
  • New pinned interop vector (computed independently via Python hmac + BoringSSL ChaCha20-Poly1305) — verify ports against it before touching hardware.

Review hardening (from the API security assessment)

  • Typed CredentialKind enum replaces stringly lastKind() (deprecated shim kept; Tap carries kind + isHce convenience).
  • verifyProof() = cryptographic validity only; replay needs an atomic backend nonce claim (unique constraint); new authoritative docs/SECURITY.md.
  • Production RNG policy, per-device high-entropy reader secrets, relay/proximity limits, radio-only healthy(), borrowed-reference lifetimes, API stability policy, unwrapKeyHex() server mirror.

Verification

  • 106 native tests green (pio test -e native), incl. RFC 8439 vectors and AEAD tamper rejection.
  • BasicTap/HceEnroll cross-compile for esp32dev and megaatmega2560 (CI).
  • CI now also runs on v* tags.