Browser-only MUST • minimaal laden • maximale veiligheid • IWA-ready • status: ontwerp, nog geen code
window.maos, nooit direct met browser/kernel. Backend nu iframe, later IWA zonder DApps te breken.DApp (IPFS CID) ──postMessage(MessageChannel)──▶ <maos-app> ──▶ SharedWorker VAPI-router ──▶ kernel/Hono
│ │ │
│ iframe sandbox, opaque origin │ capability-check │ SW: verified-fetch + CID-cache
└── window.maos.request() SDK ─────────────────────┘ └── server-only: mint/stripe/DID
| Laag | Taak | Waarom hier |
|---|---|---|
| Iframe | UI renderen, SDK-shim | Enige echte DOM-isolatie in browser |
| SharedWorker | VAPI-router + permissies + crypto | Leeft bij open tabs, deelt state, SW sterft na ~30s |
| Service Worker | IPFS verify + immutable cache + fallback | Fetch-laag, geen RPC (geen dynamic import) |
allow-same-origin, preloaded bridge, SW-cache.sandbox="allow-scripts allow-popups" zonder allow-same-origin. Opaque origin. Alles via Worker-capabilities.<maos-app cid="bafy…" version="1.4.2" tier="2"></maos-app>
<script>
const el = document.querySelector('maos-app');
await el.spawn(); // resolve → verify → iframe + port
el.suspend(); el.resume(); // hibernate: port bevriezen, iframe uit DOM
el.destroy(); // port revoke = instant kill
el.oncaprevoked = (c) => ui.badge(c); // permissie ingetrokken
</script>
Lifecycle: resolve → verify → spawn → attest → mount → [suspend ↔ resume] → destroy. Attest = manifest-handtekening + CID-match, anders geen mount.
// in iframe, 8KB shim, geen window.ethereum direct
const sig = await maos.request('wallet:sign', { tx }); // → Worker checkt capability
const file = await maos.request('storage:read', { path });
const res = await maos.fetch('https://api.allowlist…', opts); // allowlist uit manifest
maos.on('capability-revoked', cb);
{ "name":"…", "cid":"bafy…", "vapi":"1.x",
"capabilities":{ "wallet:sign":true, "storage:read":true, "network:fetch":["https://…"] },
"sig":"ed25519:…" }
Check 2x: Hono bij publish/register + SharedWorker bij elke call. Geen sig = geen mount. vapi:"1.x" = kernel blijft 2 minors backwards compatible.
allow-same-origin (tier-2), allow="camera 'none'; microphone 'none'", per-DApp CSP.CSP, COOP: same-origin, COEP: require-corp, Trusted-Types. Vereist voor SharedArrayBuffer + IWA-pad.MessageChannel port = credential. Bij intrekken: port.close() + iframe reload zonder capability.fetch; alleen maos.fetch naar manifest-allowlist, via Worker-proxy met ratelimit.manualChunks: vendor-react, vendor-web3).suspend() (RAM −80%). SW-cache: tweede open instant.apps/dapps/<naam>/ ──vite-plugin-maos──▶ dist/ ──▶ manifest.json + .sig ──▶ IPFS CID ──▶ Hono register
Vite: worker:{format:'es'}, ?sharedworker voor router, ?worker voor wallet/vfs/chain
Hono: /api/dapps, /api/ipfs/[cid], /api/kernel, /api/vapi — export type AppType → hc() client
Zelfde signing + CSP + bundle-vorm als .swbn. Shell kan later als isolated-app:// installeren (ChromeOS-managed). DApps blijven IPFS-dynamisch — IWA verbiedt nu remote code, dus DApps niet in shell bundelen.
| Map | Inhoud | Bron nu |
|---|---|---|
os/ | shell, window-manager, lifecycle | apps/core/src/app, components, desktop-features |
kernel/ | orchestrator, VAPI-handlers, sessies, permissies | src/orchestrator, src/vapi (60+ handlers) |
container/ | deze spec + bridge + SDK + manifest-schema | src/shared/dapp-bridge.ts, workers/dapp-* |
dapps/ | tier-1/2 DApps, store, publish-flow | apps/dapps, packages/cli (publish/build) |
system-apps/ | tier-0: wallet, settings, permissions, boot | src/boot, src/auth, lib/stores |
ipfs/ | gateway, pinning, verified-fetch SW | api/ipfs/[cid], apps/ipfs* |
api/ | Hono-routes + middleware (Fase 1) | 42× route.ts + proxy.ts |