Browser-only MUST • SharedWorker-kernel • 3 kern-workers (VFS/Wallet/Chain) • health-monitor + stop-sequence • status: ontwerp, bron: orchestrator/*.ts
Shell (main-thread)
└── boot-orchestrator.ts ──postMessage──▶ SharedWorker
│
┌─────────────────┼─────────────────┐
│ KernelOrchestrator │
│ ┌──────────┬──────────┬────────┐ │
│ │VFSWorker │WalletWkr │ChainWkr│ │
│ └──────────┴──────────┴────────┘ │
│ VAPIServer (method dispatch) │
│ MultiTierRateLimiter │
│ LockGate (singleton) │
│ SessionKeyManager │
│ ResourceOrchestrator │
│ KernelHealthMonitor │
│ PluginManager │
│ [Q17] kernel.preload() cache │
└─────────────────────────────────────┘
| Stap | Functie | Bron | Resultaat |
|---|---|---|---|
| 1 | initKernelWorkers | kernel-init.ts:43 | VFSWorker + WalletWorker + ChainWorker (kernel-level perms) |
| 2 | initVFSAndEncryption | kernel-init.ts:89 | NovaVFS store, PBKDF2-sleutel, MAOSVFS, VersionManager |
| 3 | createDAppManager | kernel-init.ts:256 | Sync DAppManager (over NovaVFS) |
| 4 | initAddonWorkerManager | kernel-init.ts:257 | Async (fire-and-forget) addon worker |
| 5 | initResourceMonitoring | kernel-init.ts:262 | ResourceOrchestrator + MemoryMonitor |
| 6 | initMemoryCompactLifecycle | kernel-init.ts:267 | SettingsService + MemoryGuard + SuspendScheduler + ProcessAutoRestart |
| 7 | initPluginManager | kernel-init.ts:278 | PluginManager + IPFS + Metrics plugins |
| 8 | registerVAPIHandlers | kernel-init.ts:281 | Alle VAPI-methoden geregistreerd (60+ handlers) |
| 9 | initAddonVFSPersistence | kernel-init.ts:284 | Addons overleven page-refresh |
| 10 | initQRLoginServer | kernel-init.ts:287 | QR-login server (alleen Node.js/server) |
| 11 | LockGate clear + armGrace | kernel-orchestrator.ts:307-311 | Stale lock opruimen, 60s grace-window |
kernel.preload()-call na stap 11. Deze vult de init-cache (PermissionRegistry, Storage scope resolver, DApp manifest cache) zodat de eerste DApp-call niet 10s lazy-init wacht. Preload is optioneel: als overgeslagen, gedraagt de kernel zich exact als voorheen (lazy init bij eerste VAPI-call). Trigger: KernelConfig.preload.enabled (default: false, consumer zet aan na wallet-connect). Bron: kernel-orchestrator.ts, client-kernel-worker.ts:49.Elke worker krijgt kernel-level permissions bij aanmaak — ze hebben meer rechten dan DApp-workers.
| Worker | Permissions | Default Chain | Bron |
|---|---|---|---|
| VFSWorker | storage:read, storage:write, storage:delete | n.v.t. | kernel-init.ts:49-58 |
| WalletWorker | wallet:read, wallet:sign, wallet:signTypedData | n.v.t. | kernel-init.ts:61-69 |
| ChainWorker | chain:call, chain:send | 324 (zkSync Era) | kernel-init.ts:72-80 |
De KernelHealthMonitor voert periodiek een health-check uit (interval: HEALTH_CHECK_INTERVAL_MS). De check-callback komt van de orchestrator en heeft toegang tot workers, sessions en events.
ProcessAutoRestart)EnforcementDe MultiTierRateLimiter beheert drie tiers met eigen limits:
| Tier | Identificatie | Default limit | Wanneer |
|---|---|---|---|
internal | x-client-id: maos-core | 500 req/min | Desktop UI (eigen kernel) |
verified | x-dapp-id aanwezig | 100 req/min | Geverifieerde DApp |
untrusted | Alles anders | 100 req/min | Externe / onbekende clients |
Wallet-specifieke rate-limiting via optionele WalletRateLimiter (van BootOrchestrator). Bridge: kernel-orchestrator.ts:221-228.
De SessionKeyManager beheert de levenscyclus van sessiesleutels voor geregistreerde DApps.
createSessionKey(dapp, dappId, config) → genereert willekeurige key → slaat op in dapp.sessionKeys + activeSessions Map → key verloopt na config.durationHours validateSessionKey(dapp, key) → returning key of null (verlopen = verwijderd uit beide Maps) revokeSessionKey(dapp, key) → verwijdert uit dapp.sessionKeys + activeSessions
Bron: kernel-sessions.ts:25-78.
De kernel-permissions.ts module beheert drie lagen:
id, name, version, entry + geldig security.tier (untrusted/verified/internal)["STORAGE"]) en object-array ([{type:"STORAGE"}]). Mapping via VAPI_EQUIVALENTS naar granulaire permissiescheckPermission() + permissionCovers() voor equivalente permissiesBron: kernel-permissions.ts:25-80.
Bij shutdown doorloopt de orchestrator een 12-staps guarded stop-sequentie. Elke stap is best-effort: een fout in stap N breekt de rest niet.
| # | Release | Bron | Opgave |
|---|---|---|---|
| 1 | releaseQRLoginServer | kernel-stop-sequence.ts:29 | QR-login server destroy |
| 2 | releaseEncryptionWorker | :44 | Encryption worker terminate |
| 3 | releaseVAPIWSServer | :55 | VAPI WebSocket stop (poort 3008) |
| 4 | releaseVFSBackends | :67 | Elke geregistreerde VFS-backend close() |
| 5 | releaseNovaVFS | :84 | Flush pending debounced writes + stop cross-tab sync |
| 6 | flushObservabilityLogs | :97 | systemLog + securityAudit + logAggregator flush |
| 7 | releasePlugins | :119 | Plugin unregister (onKernelStop hooks) |
| 8 | releaseExtensionBridge | :134 | Extension bridge disconnect |
| 9 | releaseExtensionEventBus | :145 | Extension event listeners verwijderen |
| 10 | stopVAPIHandlers | register-handlers.ts | L3 ticker, netting engine, backup scheduler |
| 11 | stopHeartbeatWatchdog | kernel-orchestrator.ts | Heartbeat watchdog stoppen |
| 12 | flushDesktopStateSafe | kernel-stop-sequence.ts:156 | Desktop state flush (debounced save) |
running = false-toestand. Herinitialisatie vereist een nieuw KernelOrchestrator-instance.De ResourceOrchestrator beheert OS-level monitoring (CPU, geheugen, process stats) met dynamische budgetten:
checkBudget() retourneert continue/throttle/cleanupEnforcement.emergencyCleanup() unmount niet-essentiële modules + force GCBron: resource-orchestrator.ts:32-100, enforcement.ts:26-80.
| Risico | Impact | Aanbeveling |
|---|---|---|
| Init-stap-fout blokkeert hele kernel | hoog | Elke stap moet fallback bieden (bv. default config bij ontbrekende service) |
| Stop-sequentie mist resource (dubbele call) | middel | Idempotente helpers (zoals nu) + guard-checks op null. Q19: Lineair houden, tree als future-note bij >20 stappen. |
| LockGate singleton door meerdere modules | hoog | Blijf getLockGate() gebruiken, nooit eigen instantie |
| Memory pressure zonder emergency cleanup | hoog | SuspendScheduler + MemoryGuard + ProcessAutoRestart als triple safety-net |
| Health-check interval te lang | middel | Configurable via KernelConfig.healthCheck.intervalMs |