System-apps permissions

Permissions-DApp (Tier-0) • direct in shell • per-DApp permissie overzicht • grant/revoke • exact method+pad matching • audit logging • status: ontwerp, nog geen code

Kerndefinitie: De Permissions-DApp is een Tier-0 systeemapplicatie die direct in de shell draait. Het biedt een centraal overzicht van alle permissies per DApp. Gebruikers kunnen permissies verlenen of intrekken. Elke wijziging wordt gelogd voor audit-doeleinden.

1. Architectuur

┌─────────────────────────────────────────────────┐
│               Shell (Tier-0)                     │
│  ┌─────────────────────────────────────────┐     │
│  │         Permissions-DApp (direct)       │     │
│  │  ┌─────────────────────────────────┐    │     │
│  │  │ Per-DApp permissie overzicht    │    │     │
│  │  │ (lijst + details + acties)      │    │     │
│  │  └─────────────────────────────────┘    │     │
│  │  ┌─────────────────────────────────┐    │     │
│  │  │ Grant / Revoke interface        │    │     │
│  │  │ (per veld, met confirmatie)     │    │     │
│  │  └─────────────────────────────────┘    │     │
│  │  ┌─────────────────────────────────┐    │     │
│  │  │ Audit log viewer                │    │     │
│  │  └─────────────────────────────────┘    │     │
│  └─────────────────────┬───────────────────┘     │
│                        │ VAPI                     │
│  ┌─────────────────────┴───────────────────┐     │
│  │           Permission Store               │     │
│  │  ┌─────────────────────────────────┐    │     │
│  │  │ Permissies per DApp + per veld  │    │     │
│  │  │ (exact method+pad matching)     │    │     │
│  │  └─────────────────────────────────┘    │     │
│  └─────────────────────┬───────────────────┘     │
│                        │                         │
│  ┌─────────────────────┴───────────────────┐     │
│  │           Audit Logger                  │     │
│  │  (elke wijziging = log-entry)           │     │
│  └─────────────────────────────────────────┘     │
└─────────────────────────────────────────────────┘

2. Permissie-typen

TypeBeschrijvingVoorbeelden
storageToegang tot VFS-locatiesvfs://app/, vfs://user/, vfs://shared/
walletWallet-operaties (sign, send)wallet:sign, wallet:send, wallet:balance
chainChain-interacties (RPC, calls)chain:call, chain:send:270, chain:send:260
extensionBrowser-extensie koppelingextension:connect, extension:read
networkNetwerktoegang (fetch, WebSocket)network:fetch, network:websocket

3. Exact method+pad matching

BESLIST: Permissies worden gecontroleerd via exacte method+pad matching. Geen family-matching, geen prefix-matching. Elke permissie is een exacte string.
// Correct: exacte matching
permission = "wallet:send:270:0x1234...abcd"
request   = "wallet:send:270:0x1234...abcd"
match     = ✅

// Fout: family-matching (VERBODEN)
permission = "wallet:send"
request   = "wallet:send:270:0x1234...abcd"
match     = ❌ (niet toegestaan)

// Correct: specifieke permissie
permission = "storage:vfs://app/data/"
request   = "storage:vfs://app/data/config.json"
match     = ✅ (pad klopt exact)

// Fout: prefix-matching (VERBODEN)
permission = "storage:vfs://app/"
request   = "storage:vfs://app/data/config.json"
match     = ❌ (niet toegestaan, te breed)

3.1 Permissie-formaat

ComponentVormVoorbeeld
typestring (enum)wallet
methodstringsend
targetstring (optioneel)270:0x1234...abcd
volledigtype:method[:target]wallet:send:270:0x1234...abcd

4. Grant/revoke flow

Gebruiker opent Permissions-DApp
    │
    ├── 1. Overzicht: lijst van alle DApps met hun permissies
    │       │
    │       └── Per DApp: groene (granted) / rode (denied) badges
    │
    ├── 2. Gebruiker klikt op DApp
    │       │
    │       └── Detail: alle permissies met grant/revoke knoppen
    │
    ├── 3. Grant-actie
    │       │
    │       ├── Selecteer permissie-type
    │       ├── Voer target in (indien nodig)
    │       ├── Confirmatie-dialog
    │       └── Opslaan → audit log entry
    │
    └── 4. Revoke-actie
            │
            ├── Selecteer te verwijderen permissie
            ├── Confirmatie-dialog
            └── Verwijderen → audit log entry

5. Permissie-store structuur

{
  "dapp:0x1234...abcd": {
    "permissions": [
      "storage:vfs://app/data/",
      "wallet:sign",
      "wallet:send:270:0x5678...efgh",
      "chain:call",
      "network:fetch:https://api.example.com"
    ],
    "grantedAt": {
      "storage:vfs://app/data/": "2026-01-15T10:30:00Z",
      "wallet:sign": "2026-01-15T10:30:00Z",
      "wallet:send:270:0x5678...efgh": "2026-01-16T14:20:00Z",
      "chain:call": "2026-01-15T10:30:00Z",
      "network:fetch:https://api.example.com": "2026-01-17T09:15:00Z"
    },
    "revokedAt": {},
    "source": "user"  // of "manifest", "kernel"
  }
}

6. Audit logging

Besluit: Elke permissie-wijziging wordt gelogd. Logs bevatten: timestamp, DApp-id, permissie, actie (grant/revoke), bron (gebruiker/kernel/manifest).
VeldTypeBeschrijving
timestampISO 8601Tijdstip van wijziging
dappIdstringID van de DApp
permissionstringVolledige permissie-string
actionenumgrant / revoke
sourceenumuser / kernel / manifest
previousValuestring|nullVorige status (indien revoke)
Audit log entry:
    {
      "timestamp": "2026-01-16T14:20:00Z",
      "dappId": "0x1234...abcd",
      "permission": "wallet:send:270:0x5678...efgh",
      "action": "grant",
      "source": "user",
      "previousValue": null
    }

7. Acceptatiecriteria

8. Risico's en aanbevelingen

RisicoImpactMitigatie
Te brede permissiesHoogExact matching + UI-waarschuwing bij brede paden
Permission escalationHoogTier-0 only grant/revoke, DApps kunnen geen permissies zelf instellen
Audit-log groeiGemiddeldLog-rotation + max bewaartermijn
Gebruiker verwarringGemiddeldClear UI met uitleg per permissie-type

9. Verwijzingen naar verwante specs

Volgende stap Na akkoord: Permissions-DApp UI + permissie-store implementatie + exact matching engine + audit logger + grant/revoke flow.