Releases
v2.0.0
v2.0.0 — 128-bit nonces, ChaCha20-Poly1305 enrollment
Latest
Compare
Sorry, something went wrong.
No results found
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.
You can’t perform that action at this time.