Performance-budgets + strangler migratie + MV3 patterns
Besluiten vastgelegd: Q15 hard budgets als CI gates • Q16 strangler migratie achter proxy • MV3 survivability patronen • status: ontwerp, nog geen code
Principe: Performance is geen optie maar een verplichting. Hard budgets worden gecontroleerd via CI-pijplijnen. Migratie van Next.js naar Hono gebeurt incrementeel achter een proxy (strangler fig pattern). MV3-extensie heeft specifieke beperkingen die het OS-ontwerp beinvloeden.
1. Q15 — Hard budgets als CI gates
KEUZE: Alle performance-vereisten worden gecontroleerd als CI-gates. Bij overschrijding = build-faal. Geen uitzonderingen, geen handmatige overrides.
1.1 Budgetoverzicht
| Methode | Budget | Tooling | Faal-gedrag |
| Shell boot | <1.5 seconden | Lighthouse CI (Performance score ≥90) | Build faal |
| DApp open (koud) | <800ms | k6 load-test (p95) | Build faal |
| DApp open (warm) | <300ms | k6 load-test (p95) | Build faal |
| VAPI-call (lokaal) | p95 <50ms | k6 micro-benchmark | Build faal |
| Bridge-shim | ≤8KB (minified) | Rollup bundle-analyzer | Build faal |
| Shell totaal | ≤120KB (minified) | Rollup bundle-analyzer | Build faal |
1.2 CI-pijplijn integratie
git push ──▶ CI pipeline ──▶ build ──▶ bundle-analyse ──▶ Lighthouse ──▶ k6 tests ──▶ deploy
│ │ │
└── bundle >120KB? ── FAAL │
└── shim >8KB? ────── FAAL │
└── boot >1.5s? ── FAAL
└── DApp >800ms? ── FAAL
└── VAPI >50ms? ─── FAAL
1.3 Toelichting per budget
- Shell boot <1.5s: Vanaf eerste byte tot functionele UI. Inclusief SW-registratie, SharedWorker-start, vault-init. Exclusief network-aftrek (offline-first).
- DApp open <800ms (koud): Vanaf kliks op DApp-icoon tot eerste render. Inclusief CID-resolutie, SW-fetch, iframe-mount. Koud = geen cache-hit.
- DApp open <300ms (warm): Tweede en volgende keren. SW-cache hit, iframe hergebruik, geen network-fetch.
- VAPI-call p95 <50ms: Lokale operaties (storage, capabilities, crypto). P95 van 100 opeenvolgende calls. Geen network involved.
- Bridge-shim ≤8KB: De volledige DApp-SDK die in de iframe draait. Minified + gzipped. Bevat: maos.request, maos.fetch, event-handlers.
- Shell ≤120KB: Totaal bundled gewicht van shell + kernel + Tier-0 systemen. Exclusief DApp-chunks.
1.4 Bij overschrijding
REGEL: Bij overschrijding van elk budget wordt de build automatisch gefaald. Geen handmatige override, geen "waarschuwing-only" modus. Performance is een verplichting, geen suggestie.
- Onmiddellijk: CI stopt, foutmelding wordt weergegeven, PR kan niet gemerged worden.
- Geen uitzonderingen: Zelfs niet voor urgent fixes. Eerst budget herstellen, dan mergen.
- Monitoring: Dagelijkse performance-rapporten via Lighthouse CI + k6 trends. Alert bij regressie (>10% verslechtering).
2. Q16 — Strangler migratie achter proxy
KEUZE: Migratie van Next.js naar Hono gebeurt incrementeel via strangler fig pattern. /kernel-routes worden achter een proxy gemigreerd. Oude STORAGE-grants worden automatisch gemigreerd naar exacte pad-grants met reviewed:false, wat één keer opnieuw bevestigen vereist. Geen big-bang migratie.
2.1 Strangler fig architectuur
Client ──▶ Proxy (Caddy/Nginx) ──┬── /kernel/* ──▶ Hono (nieuw) ──▶ nieuw kernel
│
└── /* ─────────▶ Next.js (oud) ──▶ overig
2.2 Migratie-stappen
| Fase | Route(s) | Methode | Verificatie |
| 1 | /kernel/api/vault/* | Proxy naar Hono | Vergelijk responses, geen verschil = ok |
| 2 | /kernel/api/permissions/* | Proxy naar Hono | Capability-check in Worker identical |
| 3 | /kernel/api/dapps/* | Proxy naar Hono | Manifest-validatie + sig-check vergelijken |
| 4 | /kernel/api/vapi/* | Proxy naar Hono | 60+ handlers vergelijken, test-coverage ≥90% |
| 5 | Next.js uitschakelen | Proxy verwijderen | Alle routes op Hono, geen fallback meer |
2.3 STORAGE-grants migratie
- Oude brede grants:
VAPI_EQUIVALENTS["STORAGE"] = brede toegang tot alle opslag.
- Nieuwe exacte grants: Elke brede grant wordt automatisch omgezet naar expliciete pad-grants per DApp.
- reviewed:false: Gemigreerde grants krijgen
reviewed: false. Gebruiker moet één keer opnieuw bevestigen.
- Geen big-bang: Migratie gebeurt per DApp, niet alles tegelijk. Oude grants blijven werken tot review.
2.4 Proxy-regels
# Caddy configuratie (voorbeeld)
kernel.maos.local {
handle /kernel/* {
reverse_proxy localhost:3001 # Hono
}
handle {
reverse_proxy localhost:3000 # Next.js (oud)
}
}
- Geleidelijk: Eerst 1% van het verkeer naar Hono (canary), dan 10%, 50%, 100%.
- Rollback: Bij problemen: proxy terugdraaien naar Next.js in seconden.
- Geen downtime: Strangler migratie = zero-downtime. Beide systemen draaien parallel.
3. MV3 survivability patronen
MV3 BEPERKINGEN: Chrome MV3 heeft significante beperkingen die het OS-ontwerp beinvloeden. Service workers worden na 30 seconden inactiviteit afgesloten. WebSockets zijn onbetrouwbaar. Alarms zijn het enige betrouwbare wake-up mechanisme.
3.1 Alarms-only survival (30s-1min)
- Beperking: MV3 service workers worden afgesloten na ~30 seconden inactiviteit.
- Oplossing: Gebruik
chrome.alarms voor wake-up events. Interval: 30 seconden tot 1 minuut.
- Toepassing: Periodieke SSE-check, intent-queue-poll, sessie-heartbeat.
- Geen WebSocket: WebSocket-verbindingen worden verbroken bij SW-suspend. Alleen SSE + polling.
3.2 SSE/WS via single offscreen document
- Probleem: SW kan geen lange verbindingen onderhouden. Main thread is niet altijd beschikbaar.
- Oplossing: Single offscreen document voor SSE/WS-verbindingen. Document blijft bestaan zolang de extensie actief is.
- Coordinatie: SW stuurt berichten naar offscreen document via
chrome.runtime.sendMessage.
- Lifecycle: Offscreen document wordt aangemaakt bij eerste behoefte, vernietigd bij extensie-suspend.
3.3 storage.session + local hydration
| Storage-type | Gebruik | Beperking |
storage.session | Tijdelijke sessie-state (intent-queue, actieve tabs) | Wordt gewist bij browser-sluiting |
storage.local | Persistente settings, wallet-refs, manifest-cache | Max 10MB, synchronisatie across devices optioneel |
- Hydration: Bij SW-herstart: laad storage.session + storage.local om state te herstellen.
- Snelle toegang: Storage is beschikbaar zonder network. Gebruik voor kritieke paden.
3.4 EIP-6963 freeze + UUID-dedup + rdns untrusted
- EIP-6963 freeze: Na eerste announce worden wallet-providers gefrost. Nieuwe announces worden genegeerd gedurende sessie.
- UUID-dedup: Elke wallet krijgt een unieke UUID bij eerste detectie. Duplicaten worden gefilterd op UUID, niet op naam.
- rdns untrusted: Het
rdns-veld in EIP-6963 is onbetrouwbaar. Gebruik het niet voor verificatie. Alleen eigen signed manifests tellen.
3.5 Queue-model: reads passthrough / sends queued
- Reads (passthrough): Lees-operaties (balance, nonce, call) gaan direct door naar RPC. Geen wachtrij.
- Sends (queued): Schrijf-operaties (send, sign) gaan naar de intent-queue. Wacht op goedkeuring in wallet-DApp.
- Reden: Reads zijn veilig, sends vereisen menselijke goedkeuring.
3.6 externally_connectable + sender validation + CSP
- externally_connectable: Extensie accepteert berichten alleen van geverifieerde afzenders (MAOS domain).
- Sender validation: Bij elk bericht: check
sender.url tegen allowlist. Ongeldige afzender = deny + audit.
- CSP in manifest: Strikte Content Security Policy in extensie-manifest. Geen inline scripts, geen remote code.
3.7 TWIST als defense-in-depth
- TWIST: "Trusted Web Integrity Score Tool" — extra verificatielaag voor extensie-integriteit.
- Doel: Detecteer of de extensie gemanipuleerd is (tijdens installatie of daarna).
- Implementatie: Periodieke hash-check van extensie-bestanden tegen bekende good-state.
- Defense-in-depth: Niet de primaire beveiligingslaag, maar een extra vangnet.
4. Referentie: gesette stack
Definitieve architectuur:
| Component | Besluit |
| Browser-only | MUST. Geen server-side rendering, geen Node.js dependencies in client. |
| Framework | Vite + Hono. Hono voor API-routes, Vite voor build. |
| 3-tier | Iframe (UI) + SharedWorker (VAPI-router) + Service Worker (IPFS/cache). |
| Signed manifests | Ed25519 over canonical JSON. Verificatie bij publish + mount. |
| VFS | Client-side encrypted OPFS + IndexedDB. Hot path 100% lokaal. |
| Wallet | Intent-queue volledige goedkeuring. Geen directe broadcast. |
| RPC | Vast: chain 270 + 260. Geen custom RPC, geen fallback. |
| Network | Worker-proxy-only. DApp heeft geen raw fetch. |
| Hibernate | 15 minuten inactiviteit → snapshot + suspend. |
| Core-train | Bundle-update, DApps per-CID, minCore-check verplicht. |
| Extension | Tier-1 via wallet queue. Geen directe communicatie. |
5. Integratie met bestaande specs
| Spec | Koppeling |
| Container-spec | Shell budget ≤120KB, bridge-shim ≤8KB, DApp open <800ms. |
| VFS-spec | VAPI-call p95 <50ms, OPFS in SharedWorker. |
| Wallet-spec | Intent-queue goedkeuring, vaste RPC 270+260. |
| Boot-extension | Extension Tier-1, MV3 survival, TWIST verificatie. |
| Core-vs-IPFS | Core-train, minCore-check, per-CID DApps. |
Volgende stap Na akkoord: CI-pijplijn opzetten met Lighthouse + bundle-analyzer + k6. Proxy-configuratie voor strangler migratie. MV3-extensie aanpassen aan survivability patronen.