Storage-net-recovery: backup, audit en gateway

Besluiten vastgelegd: Q13 recovery optie B • Q14 audit-log met hash chain • OPFS-sync-beperkingen • IPFS private trustless gateways • status: ontwerp, nog geen code

Principe: Client-side encrypted VFS (OPFS + IDB) is de single source of truth. Server (Hono) bewaart alleen ciphertext blobs voor backup/sync. Herstel gebeurt via QR-recovery code. Elke VFS-operatie wordt geaudit met tamper-evident hash chain. IPFS-gegevens worden opgehaald via allowlisted private trustless gateways, nooit via publieke gateways.

1. Q13 — Herstel (optie B: encrypted ciphertext-only backup)

KEUZE: Backup bestaat uit een versleutelde ciphertext-blob op Hono + een QR-herstelcode voor de gebruiker. Nooit plaintext server-side. Geen Shamir guardians, geen no-recovery.

1.1 Architectuur

User device ──VFS snapshot──▶ encrypt met user-DEK ──▶ ciphertext blob ──▶ Hono /api/vault/backup
       │
       └── QR-recovery code = Enc(user-DEK, master-recovery-key) + metadata
           User bewaart QR veilig (papier, password manager)

1.2 Flow bij herstel

StapActieWaar
1Gebruiker scant QR-code op nieuw apparaatMAOS boot-flow
2QR decodeert naar recovery-bundle: { encDEK, metadata, version }Lokaal
3Halo haalt ciphertext blob op via /api/vault/backupHono (ciphertext only)
4Decrypt ciphertext met herstelde DEKLokaal (crypto.subtle)
5VFS herstellen: IndexedDB + OPFS refillLokaal

1.3 Beveiligingsregels

2. Q14 — Audit logging met hash chain

KEUZE: Elke VFS-write, grant, approval, en broadcast wordt gelogd met DApp-id + CID + wallet + hash. 90 dagen lokaal met tamper-evident hash chain. Alleen ciphertext summary naar Hono. User wipe alleen met step-up + 30-dagen abuse window.

2.1 Log-structuur

{
  timestamp: number,        // 10-digit Unix
  type: "write" | "grant" | "revoke" | "approval" | "broadcast" | "deny",
  dappId: string,           // DApp identifier
  cid: string,              // IPFS CID (indien van toepassing)
  wallet: string,           // Wallet address (0x...)
  method: string,           // VAPI method (storage:write, wallet:send, etc.)
  path: string,             // VFS pad (indien van toepassing)
  bytes: number,            // Bytes geschreven (indien write)
  hash: string,             // SHA-256 van: prevHash + timestamp + type + dappId + ...
  prevHash: string          // Hash van vorige entry (hash chain)
}

2.2 Opslag en bewaarduur

LocatieDuurInhoudWaarom
Lokaal (IndexedDB)90 dagenVolledige audit logs + hash chainTamper-evident, snel opvraagbaar, geen server-afhankelijkheid
Hono (ciphertext summary)90 dagenGehashte samenvatting (geen paden, geen wallets)Backup voor forensisch onderzoek, abuse-detectie
User wipe30 dagen abuse windowLokaal gewist, summary blijft 30d op serverVoorkomt dat gebruiker logs wist na misbruik

2.3 Hash chain verificatie

2.4 Step-up bij wipe

3. OPFS-sync-beperkingen (onderzoeksbevindingen)

ONDERZOEK: OPFS biedt synchronisatie-mogelijkheden maar heeft significante beperkingen die de architectuur beinvloeden.

3.1 Workers-only exclusive lock

3.2 Geen native rename

3.3 estimate() onbetrouwbaar

3.4 IV-vereisten (AES-GCM)

ParameterWaardeWaarom
IV grootte96-bit (12 bytes)AES-GCM standaard, maximale efficiency
IV hergebruikVERBODENHergebruik met dezelfde key breekt beveiliging volledig
Tag grootte128-bit (16 bytes)Volledige authenticiteit + integriteit
ChunkingGrote bestanden chunkenVoorkomt geheugenproblemen, maakt delen mogelijk

3.5 Multi-tab BroadcastChannel advisory locks

4. IPFS private trustless gateways (onderzoeksbevindingen)

ONDERZOEK: IPFS-gegevens worden opgehaald via allowlisted private trustless gateways. Geen publieke gateways, geen fallback naar onveilige bronnen.

4.1 Architectuur

SW fetch request ──▶ gateway-allowlist check ──▶ trusted private gateway ──▶ raw block/CAR response
                           │
                           └── onbekende gateway = deny + audit

4.2 Verplichtingen

4.3 Caching

TypeCache-duurReden
Immutable CIDOneindigCID = content hash. Als het eenmaal geverifieerd is, verandert het nooit.
Mutable pointers (IPNS)5 minutenKan wijzigen, frequente herverificatie vereist.
Gateway responsesPer headersRespecteer Cache-Control van gateway.

4.4 Pin-strategie

4.5 Ed25519 manifest-verificatie

5. Integratie met bestaande specs

SpecKoppeling
VFS-specBackup/sync van encrypted VFS. Audit-logging van VFS-operaties.
Wallet-specWallet-adressen in audit logs. Step-up authenticatie bij wipe.
Container-specDApp-id en CID in audit logs. OPFS-toegang via SharedWorker.
Core-vs-IPFSIPFS-pin-strategie. Gateway-allowlist in manifests.
Volgende stap Na akkoord: implementatie van backup-flow (Q13) + audit-logging (Q14) + OPFS-sync in SharedWorker + gateway-allowlist in SW.