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
| Type | Beschrijving | Voorbeelden |
storage | Toegang tot VFS-locaties | vfs://app/, vfs://user/, vfs://shared/ |
wallet | Wallet-operaties (sign, send) | wallet:sign, wallet:send, wallet:balance |
chain | Chain-interacties (RPC, calls) | chain:call, chain:send:270, chain:send:260 |
extension | Browser-extensie koppeling | extension:connect, extension:read |
network | Netwerktoegang (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
| Component | Vorm | Voorbeeld |
type | string (enum) | wallet |
method | string | send |
target | string (optioneel) | 270:0x1234...abcd |
volledig | type: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).
| Veld | Type | Beschrijving |
timestamp | ISO 8601 | Tijdstip van wijziging |
dappId | string | ID van de DApp |
permission | string | Volledige permissie-string |
action | enum | grant / revoke |
source | enum | user / kernel / manifest |
previousValue | string|null | Vorige 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
- Permissions-DApp draait direct in shell, niet in iframe.
- Per-DApp overzicht toont alle permissies met status (granted/denied).
- Grant/revoke werkt met confirmatie-dialog.
- Exact method+pad matching, geen family-matching.
- Elke wijziging wordt gelogd in audit-trail.
- Permissie-typen: storage, wallet, chain, extension, network.
- Real-time update na wijziging.
8. Risico's en aanbevelingen
| Risico | Impact | Mitigatie |
| Te brede permissies | Hoog | Exact matching + UI-waarschuwing bij brede paden |
| Permission escalation | Hoog | Tier-0 only grant/revoke, DApps kunnen geen permissies zelf instellen |
| Audit-log groei | Gemiddeld | Log-rotation + max bewaartermijn |
| Gebruiker verwarring | Gemiddeld | Clear 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.