System-apps explorer
File Explorer (Tier-0) • direct in shell • VFS navigatie • bestanden openen met DApp • context menu • double-click = launch grant • status: ontwerp, nog geen code
Kerndefinitie: De File Explorer is een Tier-0 systeemapplicatie die direct in de shell draait. Het biedt navigatie door het virtuele bestandssysteem (VFS) en stelt gebruikers in staat bestanden te openen, te beheren en te delen. Double-click op een bestand activeert een launch grant met exact-path matching.
1. Architectuur
┌─────────────────────────────────────────────────┐
│ Shell (Tier-0) │
│ ┌─────────────────────────────────────────┐ │
│ │ File Explorer (direct) │ │
│ │ ┌─────────────────────────────────┐ │ │
│ │ │ VFS Navigator │ │ │
│ │ │ (tree view + breadcrumb) │ │ │
│ │ └─────────────────────────────────┘ │ │
│ │ ┌─────────────────────────────────┐ │ │
│ │ │ File Operations │ │ │
│ │ │ (open, delete, rename, share) │ │ │
│ │ └─────────────────────────────────┘ │ │
│ │ ┌─────────────────────────────────┐ │ │
│ │ │ Context Menu │ │ │
│ │ │ (right-click actions) │ │ │
│ │ └─────────────────────────────────┘ │ │
│ │ ┌─────────────────────────────────┐ │ │
│ │ │ Launch Grant Manager │ │ │
│ │ │ (double-click handler) │ │ │
│ │ └─────────────────────────────────┘ │ │
│ └─────────────────────┬───────────────────┘ │
│ │ VAPI │
│ ┌─────────────────────┴───────────────────┐ │
│ │ VFS Layer │ │
│ │ ┌─────────┐ ┌─────────┐ ┌──────────┐ │ │
│ │ │ vfs:// │ │ vfs:// │ │ vfs:// │ │ │
│ │ │ app/ │ │ user/ │ │ shared/ │ │ │
│ │ └─────────┘ └─────────┘ └──────────┘ │ │
│ │ ┌─────────┐ │ │
│ │ │ vfs:// │ │ │
│ │ │ tmp/ │ │ │
│ │ └─────────┘ │ │
│ └─────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘
2. VFS navigatie
| Prefix | Beschrijving | Toegankelijkheid |
vfs://app/ | App-specifieke bestanden (per DApp geïsoleerd) | Alleen eigen DApp + Tier-0 |
vfs://user/ | Gebruikersbestanden (persoonlijke opslag) | Gebruiker + geautoriseerde DApps |
vfs://shared/ | Gedeelde bestanden (tussen DApps) | Alle geautoriseerde DApps |
vfs://tmp/ | Tijdelijke bestanden (automatisch opruimen) | Alle DApps (tijdelijk) |
VFS boomstructuur:
vfs://
├── app/
│ ├── 0x1234...abcd/ (DApp-specifiek)
│ │ ├── data/
│ │ ├── config.json
│ │ └── index.html
│ └── 0x5678...efgh/
│ └── ...
├── user/
│ ├── documents/
│ ├── images/
│ └── downloads/
├── shared/
│ ├── public/
│ └── exchange/
└── tmp/
└── (automatisch opruimen na sessie)
3. Bestanden openen met DApp
Besluit: Elk bestandstype kan worden gekoppeld aan een specifieke DApp. De koppeling wordt bepaald door bestandsextensie of MIME-type. Double-click activeert de gekoppelde DApp via launch grant.
| Bestandstype | Standaard DApp | Alternatieven |
.html | Browser-viewer | Code-editor, HTML-validator |
.json | JSON-viewer | Code-editor, Schema-validator |
.md | Markdown-viewer | WYSIWYG-editor |
.png/.jpg | Image-viewer | Image-editor, Gallery |
.pdf | PDF-viewer | PDF-editor |
.sol | Solidity-editor | Contract-deployer |
4. Context menu
Rechtsklik op bestand/map
│
├── Openen (met standaard DApp)
│
├── Openen met... (lijst van compatibele DApps)
│
├── ─────────────────────────────
│
├── Kopiëren (pad naar clipboard)
│
├── Plakken (vanuit clipboard)
│
├── Hernoemen (inline bewerken)
│
├── Verwijderen (met confirmatie)
│
├── ─────────────────────────────
│
├── Delen (genereer share-link via vfs://shared/)
│
├── Eigenschappen (grootte, aanmaakdatum, type)
│
└── ─────────────────────────────
└── Launch grant beheren (permissies voor deze DApp)
5. Double-click = launch grant
BESLIST: Double-click op een bestand activeert een launch grant. Dit is een tijdelijke permissie die een DApp toestaat het bestand te openen. Maximaal 32 launch grants actief, met exact-path matching.
| Property | Waarde | Toelichting |
maxGrants | 32 | Maximaal aantal actieve launch grants |
matching | exact-path | Geen prefix-matching, geen family-matching |
expiry | Sessie | Grants verlopen bij sluiten van DApp |
scope | per bestand | Elk grant is gekoppeld aan specifiek bestandspad |
Double-click flow:
│
├── 1. Gebruiker dubbelklikt op bestand
│ │
│ └── Pad: vfs://user/documents/contract.sol
│
├── 2. Launch Grant check
│ │
│ ├── Grant bestaat al? → direct openen
│ │
│ └── Grant bestaat niet? → nieuwe grant aanmaken
│ │
│ ├── maxGrants < 32? → grant toekennen
│ │
│ └── maxGrants >= 32? → oudste grant verwijderen
│
├── 3. DApp openen
│ │
│ └── Laad bestand in gekoppelde DApp
│
└── 4. Grant opslaan
├── Pad: "vfs://user/documents/contract.sol"
├── DApp: "0xabcd...1234"
└── Timestamp: "2026-01-16T14:20:00Z"
6. Bestandsoperaties
| Operatie | Beschrijving | Permissie vereist |
| Openen | Bestand laden in DApp | storage:read:{pad} |
| Verwijderen | Bestand verwijderen (met confirmatie) | storage:delete:{pad} |
| Hernoemen | Bestandsnaam wijzigen (inline bewerking) | storage:write:{pad} |
| Delen | Share-link genereren via vfs://shared/ | storage:share:{pad} |
| Kopiëren | Pad naar clipboard | Geen permissie vereist |
| Plakken | Bestand/plakken vanuit clipboard | storage:write:{doelpad} |
7. Acceptatiecriteria
- File Explorer draait direct in shell, niet in iframe.
- VFS-navigatie werkt voor alle 4 prefixes (app/, user/, shared/, tmp/).
- Double-click opent bestand in gekoppelde DApp via launch grant.
- Max 32 launch grants, oudste wordt verwijderd bij overschrijding.
- Context menu toont alle beschikbare acties per bestandstype.
- Bestanden openen met bijbehorende DApp (extensie-gebaseerd).
- Launch grants verlopen bij sluiten van DApp.
8. Risico's en aanbevelingen
| Risico | Impact | Mitigatie |
| Launch grant misbruik | Hoog | Exact-path matching + max 32 + sessie-expiry |
| VFS-pad manipulatie | Hoog | Pad-sanitisatie + canonicalisatie + toegangscontrole |
| Performance bij grote mappen | Gemiddeld | Lazy loading + virtuele scroll + caching |
| Conflicten bij delen | Gemiddeld | Copy-on-write + versiebeheer |
9. Verwijzingen naar verwante specs
Volgende stap Na akkoord: File Explorer UI + VFS-navigatie + context menu + launch grant manager + double-click handler + bestandsoperaties.