Browser-only MUST • core = bundle-update, DApps = per-CID • minCore-check verplicht • status: ontwerp, nog geen code
Core (shell + kernel + Tier-0 system-apps) wordt als één bundle gedistribueerd. De browser laadt de core via een vaste URL (later IWA). Updates komen via service-worker cache-invalidation: nieuwe versie → SW herlaadt shell bij volgende load.
MAJOR.MINOR.PATCH. MAJOR = brekende API-wijzigingen (DApps moeten herschreven worden). MINOR = nieuwe features, backwards-compatible (minimaal 2 minors backwards compat). PATCH = bugfixes, geen API-wijziging.vapi:"1.x" in DApp-manifest = kernel ondersteunt alles vanaf 1.0 tot 1.x./core/. SW checkt versie via /core/version.json. Nieuwere versie = cache purge + reload bij volgende navigatie.minCore < nieuwe MAJOR worden niet geladen tot ze updated zijn.DApps worden gepubliceerd als gesigneerde bundles op IPFS. Elke publish = nieuwe CID, vastgelegd in store-backend. Geen auto-update: gebruiker kiest wanneer een DApp bijgewerkt wordt (of store regelt dit per tier).
maos publish → Vite-build → manifest.json + Ed25519-sig → IPFS pin → CID registreren in store-backend. Oude CID blijft beschikbaar (geen destructive replace)."version":"1.4.2"). CID = versie-identificator. Rollback = terug naar oude CID.Bij het laden van een DApp controleert de SharedWorker of de huidige core-versie voldoet aan het minCore-veld in het DApp-manifest. Dit voorkomt dat oude DApps op nieuwe kernels kapot gaan of nieuwe DApps op oude kernels onverwacht gedrag vertonen.
// manifest.json van DApp
{
"name": "Mijn DApp",
"cid": "bafy…",
"minCore": "1.3.0", // vereiste minimale core-versie
"tier": 2, // trust-tier (0/1/2)
"vapi": "1.x", // VAPI-compat
"capabilities": { … },
"sig": "ed25519:…"
}
// SharedWorker check bij mount:
if (coreVersion < manifest.minCore) {
// → deny mount + toon melding: "Update MAOS naar ≥{minCore}"
// → DApp niet laden, geen fallback
}
MAJOR.MINOR.PATCH. Vergelijking is lexicaal per component.| Veld | Type | Verplicht | Beschrijving |
|---|---|---|---|
name | string | ja | Weergave-naam van de DApp |
cid | string | ja | IPFS CID van de bundle (content-addressed) |
version | string | ja | Semver versie van de DApp |
minCore | string | ja | Minimale core-versie vereist (semver) |
tier | 0|1|2 | ja | Trust-tier (0=core, 1=store-verified, 2=third-party) |
vapi | string | ja | VAPI-compat range (bv "1.x") |
capabilities | object | ja | capability-requests met method+pad-match |
sig | string | ja | Ed25519-handtekening over manifest (hex) |
allowlist | string[] | nee | URLs voor maos.fetch (network:fetch-capabilities) |
description | string | nee | Beschrijving voor store-pagina |
icon | string | nee | IPFS CID van icoon (256×256 PNG) |
author | string | nee | Auteur/publisher |
Tier-0 componenten worden met de core meegebundeld. Ze draaien direct in de shell, zonder iframe-sandbox. Updates komen mee met core-release.
| Component | Locatie | Update-pad | Toelichting |
|---|---|---|---|
| Wallet-DApp | Core bundle (Tier-0) | Core-release | Intent-queue + goedkeuring. Nooit IPFS-afhankelijk. |
| Settings | Core bundle (Tier-0) | Core-release | Systeeminstellingen, RPC-config, gebruikersprofiel. |
| Permissions | Core bundle (Tier-0) | Core-release | Permissiebeheer, revocation, capability-matrix. |
| Boot / Auth | Core bundle (Tier-0) | Core-release | Opstartflow, sessiebeheer, QR-login. |
| Store-backend | IPFS + Hono-proxy | Per-CID update | Index + metadata. Code op IPFS, API via Hono. |
| Explorer | Core v1 (Tier-1) | Core-release (v1) | In core v1, inhoud via VFS/IPFS. Basis-shell in core, content dynamisch. |
| Help Viewer | Core v1 (Tier-1) | Core-release (v1) | In core v1, documentatie via VFS/IPFS. Shell in core, content dynamisch. |
| Third-party DApps | Alleen IPFS | Per-CID update | Altijd Tier-2 (standaard) of Tier-1 (na verificatie). Nooit in core. |