Security enforcement

Rate-limiting (token bucket) • Permission enforcement (manifest + VAPI) • LockGate (wallet-lock) • Resource orchestration • status: ontwerp, bron: security/*.ts + orchestrator/*.ts

Besluit in 1 zin: MAOSv6 heeft vier overlappende security-lagen: (1) token-bucket rate-limiting per tier, (2) manifest-gedreven permission enforcement met VAPI-equivalents, (3) LockGate wallet-lock met nonce-anti-replay, en (4) resource-orchestrator met emergency cleanup — elke laag is onafhankelijk testbaar.

1. Rate-limiting (token bucket, multi-tier)

De WorkerRateLimiter implementeert een token-bucket algoritme met drie tiers:

TierDefaultBurstWanneer
internal500 req/min50Desktop UI (x-client-id: maos-core)
verified100 req/min20Geverifieerde DApp (x-dapp-id aanwezig)
untrusted100 req/min10Alles anders (externe clients)

1.1 Token bucket mechanisme

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.

1.2 Wallet-specifieke limits

MethodLimitWindow
wallet.sign10/min/DApp60s
wallet.sendTransaction5/min/DApp60s
wallet.connectExtension1/10s10s

Wallet-limiter wordt geinjecteerd via BootOrchestrator en gedeeld met de kernel. Bron: security/rate-limiter.ts:8-11.

1.3 Multi-tier rate limiter

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)

2. Permission enforcement

Drie lagen van permission-checks, elk onafhankelijk:

2.1 Manifest validatie

Bij DApp-registratie wordt het manifest gevalideerd:

Bron: orchestrator/kernel-permissions.ts:25-62.

2.2 Permission extractie

Twee formats worden ondersteund:

FormatVoorbeeldMapping
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.

2.3 Per-call permission check

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.

Q20 — Onbekende permission-types: Bij permission-extractie (sectie 2.2) kunnen onbekende type-strings voorkomen (nieuwe VAPI-methoden, legacy formats). Gedrag: (1) audit-log — onbekend type wordt gelogd met 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.

2.4 Grant registry (launch-scoped)

Bij double-click openen van een bestand krijgt de DApp een tijdelijke grant:

Bron: security/grant-registry.ts:9-49.

3. LockGate (wallet-lock mechanisme)

De LockGate blokkeert niet-session VAPI-methoden wanneer de wallet vergrendeld is.

3.1 Lock-flow

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

3.2 Unlock-flow

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

3.3 Anti-replay nonce

3.4 Grace window

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.

3.5 Singleton

REGEL: De LockGate is een singleton via getLockGate(). Nooit een eigen instantie aanmaken — anders vergrendelt een wallet-lock de verkeerde gate.

4. Resource orchestrator + enforcement

De ResourceOrchestrator monitort OS-level resources met dynamische budgetten:

4.1 Monitoring

MetricBronInterval
CPU usage (%)getCpuUsage()configurable
Memory (used/total/heap/external)getMemoryUsage()configurable
Event-loop lag (ms)performance.now()per check
Process uptime + PID + platformgetUptime()/getPid()bij init

Bron: orchestrator/resource-orchestrator.ts:32-54.

4.2 Budget checks

checkBudget() → BudgetCheckResult
  ├── cpuPercent > maxCpuPercent? → throttle
  ├── memoryPercent > maxMemoryPercent? → cleanup
  ├── memoryMB > maxMemoryMB? → cleanup
  └── Alles ok → continue

Aanbevolen actie: continue | throttle | cleanup.

4.3 Emergency cleanup (Enforcement)

De Enforcement-klasse handelt noodgevallen af:

Q18 — 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.

4.4 Predictive scaling (optioneel)

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).

5. Session key store (wallet)

De SessionKeyStore beheert sessiesleutels voor wallet-operaties:

VeldTypeBeschrijving
sessionIdstringUnieke sessie-id
appIdstringDApp-id
allowedMethodsstring[]Toegestane wallet-methoden
maxValuebigintMaximaal transactiebedrag
expiresAtnumberUnix timestamp verloop
maxUseCountnumberAuto-rotate na N uses (0 = onbeperkt)

Max 5 actieve sessies per DApp. Bron: security/session-key-store.ts:19-60.

6. Security scanner + permission validator

Extra security-lagen in services/security/:

7. Risico's en aanbevelingen

RisicoImpactAanbeveling
Rate-limit tokens lekken tussen tabsmiddelBuckets zijn per-tab (SharedWorker singleton) — geen lek
LockGate singleton niet gedeeldhoogALTIJD getLockGate() gebruiken, nooit eigen instantie
Permission extractie mist nieuwe formatenmiddelQ20: Onbekende types: audit-log + allow (standaard), deny in strictMode. Test met beide formats + onbekende type-string.
Emergency cleanup unmountt essentiële moduleshoogQ18 opgelost: isEssential-vlag op elke module. Bij cleanup: skip modules met isEssential=true. Productie-blokker — moet opgelost voor live-gang.
Session key store groeit onbeperktlaagMax 5 sessies/app + auto-expiry + maxUseCount auto-rotate
Grace window te kort bij langzame walletmiddel60s is conservatief; overweeg dynamische grace op basis van netwerk
Aanbeveling: De security-lagen zijn goed gescheiden. Het zwakste punt was de Enforcement-klasse — de 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.