Rate-limiting (token bucket) • Permission enforcement (manifest + VAPI) • LockGate (wallet-lock) • Resource orchestration • status: ontwerp, bron: security/*.ts + orchestrator/*.ts
De WorkerRateLimiter implementeert een token-bucket algoritme met drie tiers:
| Tier | Default | Burst | Wanneer |
|---|---|---|---|
internal | 500 req/min | 50 | Desktop UI (x-client-id: maos-core) |
verified | 100 req/min | 20 | Geverifieerde DApp (x-dapp-id aanwezig) |
untrusted | 100 req/min | 10 | Alles anders (externe clients) |
check(identifier):
bucket = getOrCreateBucket(identifier)
refill(bucket, now) // tokens bijvullen op basis van elapsed time
if bucket.tokens >= 1:
bucket.tokens -= 1
return { allowed: true, remaining: floor(tokens) }
else:
return { allowed: false, remaining: 0, resetAt: lastRefill + windowMs }
probe(identifier):
// Lezen zonder muteren (voor pre-flight checks)
潜在tokens = min(max, bucket.tokens + refillAmount)
return { allowed: 潜在tokens >= 1, remaining: floor(潜在tokens) }
Bron: security/rate-limiter.ts:45-100.
| Method | Limit | Window |
|---|---|---|
wallet.sign | 10/min/DApp | 60s |
wallet.sendTransaction | 5/min/DApp | 60s |
wallet.connectExtension | 1/10s | 10s |
Wallet-limiter wordt geinjecteerd via BootOrchestrator en gedeeld met de kernel. Bron: security/rate-limiter.ts:8-11.
De MultiTierRateLimiter wrappeer meerdere WorkerRateLimiter-instances en selecteert de juiste op basis van tier:
MultiTierRateLimiter ├── untrusted: WorkerRateLimiter(tier:'untrusted', 100/min) ├── verified: WorkerRateLimiter(tier:'verified', 100/min) └── internal: WorkerRateLimiter(tier:'internal', 500/min) check(tier, identifier) → selected.check(identifier)
Drie lagen van permission-checks, elk onafhankelijk:
Bij DApp-registratie wordt het manifest gevalideerd:
id, name, version, entryuntrusted | verified | internalINVALID_PARAMS errorBron: orchestrator/kernel-permissions.ts:25-62.
Twee formats worden ondersteund:
| Format | Voorbeeld | Mapping |
|---|---|---|
| String-array | ["STORAGE", "WALLET_READ"] | Via VAPI_EQUIVALENTS naar granulair |
| Object-array | [{type:"STORAGE", required:true}] | Direct granulair |
Mapping voorbeeld: STORAGE → storage:read + storage:write + storage:delete.
Bron: orchestrator/kernel-permissions.ts:74-80.
VAPI request binnen │ ▼ buildContext(appId, source) ├── permissionResolver(appId) → PermissionType[] ├── multiTierLimiter.check(tier, identifier) ├── VFS scope vaststellen (manifest basePath of legacy) │ ▼ Handler registratie met requiredPermissions │ ▼ Permission check: requiredPermissions ⊆ context.permissions? │ ├── GEEN match → 403 PERMISSION_DENIED ├── PARTIële match → permissionCovers() check └── VOLLEDIG match → handler uitvoeren
Bron: vapi/server.ts:99-133, orchestrator/kernel-permissions.ts:387.
appId + rawType; (2) default fallback — onbekend type wordt doorgelaten (geen PERMISSION_DENIED); (3) strictMode — als KernelConfig.strictMode=true, worden onbekende types geweigerd. Voorkomt dat nieuwe permission-formats broken clients veroorzaken. Bron: orchestrator/kernel-permissions.ts.Bij double-click openen van een bestand krijgt de DApp een tijdelijke grant:
Bron: security/grant-registry.ts:9-49.
De LockGate blokkeert niet-session VAPI-methoden wanneer de wallet vergrendeld is.
wallet.disconnected
→ client roept session.prepareLock(address)
→ LockGate: isPreparing=true, start 10s flush-timeout
→ client flushed lokale stores
→ client roept session.confirmLock()
→ LockGate: genereert cryptografische nonce, bindt session address
isLocked=true, resolve prepare-promise
→ VAPI server blokkeert niet-session methoden
client leest session.getLockStatus → { isLocked, lockedByAddress, challenge }
→ client signeert challenge via personal_sign
→ client roept session.unlock(address, signature)
→ LockGate verifieert:
1. address === bound address
2. signature recovers naar bound address (viem verifyMessage)
3. challenge matcht huidige nonce (single-use, verbruikt op succes)
→ LockGate reset state, VAPI server hervat
Bij wallet-disconnect krijgt de gebruiker een grace-periode (60s) om te refreshen voordat de lock wordt geforceerd. De armGrace() functie wordt aangeroepen na boot/unlock/session.
Bron: security/lock-gate.ts:53-79.
getLockGate(). Nooit een eigen instantie aanmaken — anders vergrendelt een wallet-lock de verkeerde gate.De ResourceOrchestrator monitort OS-level resources met dynamische budgetten:
| Metric | Bron | Interval |
|---|---|---|
| CPU usage (%) | getCpuUsage() | configurable |
| Memory (used/total/heap/external) | getMemoryUsage() | configurable |
| Event-loop lag (ms) | performance.now() | per check |
| Process uptime + PID + platform | getUptime()/getPid() | bij init |
Bron: orchestrator/resource-orchestrator.ts:32-54.
checkBudget() → BudgetCheckResult ├── cpuPercent > maxCpuPercent? → throttle ├── memoryPercent > maxMemoryPercent? → cleanup ├── memoryMB > maxMemoryMB? → cleanup └── Alles ok → continue
Aanbevolen actie: continue | throttle | cleanup.
De Enforcement-klasse handelt noodgevallen af:
getMountedModules() → unmount() per moduleQ18 — isEssential vlag (productie-blokker): Elke module in de Mount registry heeft een isEssential-vlag. Bij emergency cleanup worden alleen modules zonder isEssential gedisposed. Essentiële modules (kernel-core, wallet-session, permission-store) worden nooit gedisposed, ongeacht geheugendruk. Implementatie: Enforcement.isEssential(moduleId) check voor elke unmount()-call. Ontbrekende vlag = default false (niet essentieel, mag disposed worden).
Bron: orchestrator/enforcement.ts:26-80.
getScalingRecommendation() → ScalingRecommendation ├── action: 'scale_up' | 'scale_down' | 'maintain' ├── reason: string ├── confidence: 0-1 └── targetWorkers?: number
Gebaseerd op tijdsgebonden patronen (tijd van dag, dag van week).
De SessionKeyStore beheert sessiesleutels voor wallet-operaties:
| Veld | Type | Beschrijving |
|---|---|---|
sessionId | string | Unieke sessie-id |
appId | string | DApp-id |
allowedMethods | string[] | Toegestane wallet-methoden |
maxValue | bigint | Maximaal transactiebedrag |
expiresAt | number | Unix timestamp verloop |
maxUseCount | number | Auto-rotate na N uses (0 = onbeperkt) |
Max 5 actieve sessies per DApp. Bron: security/session-key-store.ts:19-60.
Extra security-lagen in services/security/:
| Risico | Impact | Aanbeveling |
|---|---|---|
| Rate-limit tokens lekken tussen tabs | middel | Buckets zijn per-tab (SharedWorker singleton) — geen lek |
| LockGate singleton niet gedeeld | hoog | ALTIJD getLockGate() gebruiken, nooit eigen instantie |
| Permission extractie mist nieuwe formaten | middel | Q20: Onbekende types: audit-log + allow (standaard), deny in strictMode. Test met beide formats + onbekende type-string. |
| Emergency cleanup unmountt essentiële modules | hoog | Q18 opgelost: isEssential-vlag op elke module. Bij cleanup: skip modules met isEssential=true. Productie-blokker — moet opgelost voor live-gang. |
| Session key store groeit onbeperkt | laag | Max 5 sessies/app + auto-expiry + maxUseCount auto-rotate |
| Grace window te kort bij langzame wallet | middel | 60s is conservatief; overweeg dynamische grace op basis van netwerk |
isEssential-check was onvolledig. Q18 opgelost voor productie-live. Q20: Onbekende permission-types worden bij fallback gelogd (audit-log) en doorgelaten, tenzij strictMode=true — dan worden ze geweigerd met PERMISSION_DENIED.