VERSION HISTORY FIRST STABLE BUILD

Release Changelog

All notable modifications, cryptographic additions, and security improvements to the Entangl Android application are documented here.

LATEST RELEASE FIRST STABLE BUILD September 30, 2026

v1.0.0 — First Stable Build

The first production build of Entangl: mutual QR handshake pairing, encrypted relay messaging with ratcheted per-message keys, ephemeral TTL, hardware-backed encrypted storage, and contact management. This baseline describes the shipped code exactly — no prior history is retained.

Mutual Handshake & Pairing

  • Two-Way QR Handshake: Both peers must scan each other's codes while on the handshake screen. QR payloads are CBOR-encoded with rolling 32-byte nonces, 60-second TTL, single-use replay rejection, and P-256/ECDSA signatures over canonical bytes.
  • Strict Mutual Gate: Chat unlocks only after outbound scan + inbound scan proof + safety-number display. One-sided packet loss self-converges via scan-proof echo and handshake retry sweeps — no rescan required.
  • 60-Digit Safety Numbers: Deterministic fingerprint shown at scan time and any time from the chat shield icon for out-of-band comparison.

Messaging & Transport

  • Ratcheted Message Keys: HKDF-SHA256 chain ratchet deriving a unique AES-256-GCM key per message with sequence binding; chains never reset per send and self-heal after peer restart or rescan.
  • Signed Envelopes: Every transport envelope (messages, delivery ACKs, scan proofs, TTL) is signed over canonical bytes including the ephemeral TTL field. ACKs are verified before flipping delivery state.
  • Fixed-Size Padding: Ciphertexts are padded to fixed 2,048-byte blocks to blunt length side-channels.
  • Ephemeral TTL: Per-message self-destruct timers ride the signed envelope to both sides, with live countdown, glitch vaporization, vault deletion, and background purge.
  • Multi-Relay Inbox: Signed envelopes fan out across redundant relays under blinded per-UID inbox topics with 24-hour replay windows and duplicate suppression.

Storage & Device Security

  • Encrypted Vault: SQLCipher database (Room schema v4) with a Keystore-wrapped random passphrase; contacts, messages, session keys, and identity in encrypted preferences.
  • Hardware Identity: P-256/ECDSA identity key generated in Android Keystore (StrongBox preferred); X25519 ephemerals held off-heap and zeroized after use.
  • Runtime Hardening: FLAG_SECURE capture blocking, tapjacking filters, root/debugger/accessibility advisories, clipboard auto-clear, and zero-leak VISIBILITY_SECRET notifications (silent for the open chat).
  • Device Succession: LAN-based encrypted migration with signed succession certificates and atomic old-device decommissioning.

Chat Experience

  • Day dividers (Today / Yesterday / date), open-at-newest-unseen with read marking, [SENDING] / [SENT] / [DELIVERED] indicators, per-contact delete / clear-history / block management, and adaptive phone / foldable layouts.
  • Handshake success moment: after both scans verify internally, a one-time HANDSHAKE SUCCESSFUL confirmation offers Chat now / Later — no extra taps, no repeated prompts.
  • Live presence & previews: roster rows show the real latest message with liveness dots driven by fresh verified traffic (pending magenta, live green, quiet gray).
  • Replay-proof notifications: exactly-once processing survives restarts, stale backlog stays silent, and the open chat never buzzes.
  • Live connectivity: Settings shows measured signal bars, an internet dot, and honest relay diagnostics with a working renew action.
  • Verified by 51 Android unit tests plus 8 shared-module tests with zero Android Lint code findings.
v1.0.0 SHA-256 CHECKSUM: 1288AEDE9F651FFC42912693423F671780EB9E730B3A15658741F4EB0692CBC8