Skip to content

v2.0.0: Argon2id key derivation

Latest

Choose a tag to compare

@ThaReality ThaReality released this 12 Jun 22:27

Key derivation upgraded from PBKDF2-SHA256 to Argon2id (memory-hard).
New wire-format version v2; all v1 exports still decrypt, permanently.

Changed

  • Key derivation upgraded to Argon2id (OWASP minimum: 19 MB memory, 2 iterations, 1 lane) → 256-bit
    AES-256-GCM key from a 128-bit per-user salt. New wire-format version v2.
  • deriveKey() (PBKDF2-SHA256, 250,000 iterations, v1) retained permanently for backward
    compatibility; no existing export or vault is stranded. Legacy vaults re-derive to Argon2id on next
    unlock.

Added

  • deriveKeyV2() — Argon2id key derivation
  • deriveKeyForVersion() — selects the KDF from the format version token
  • formatExport() / parseEnvelope() — build and parse the HOLDFAST:v<N> wire envelope
  • Argon2id WebAssembly (hash-wasm v4.12.0) vendored and inlined as base64 — nothing fetched at
    runtime, so one SRI hash still covers the whole boundary
  • holdfast-decrypt.py — standalone offline recovery tool reading both v1 and v2 exports
  • .gitattributes — pins the module's bytes so its published SHA-256 verifies on every platform

Note

  • First dependency: one vendored, in-repo, hash-pinned WASM. Under a strict Content-Security-Policy,
    script-src must include 'wasm-unsafe-eval'.

SHA-256 of holdfast-crypto.js is recorded in sha256sum.txt.