Core-vs-IPFS split + release-train

Browser-only MUST • core = bundle-update, DApps = per-CID • minCore-check verplicht • status: ontwerp, nog geen code

Keuze in 1 zin: Core-update = één bundle-push (browser herlaadt automatisch), DApps = per-CID publishing op IPFS met minCore-check, nooit gebundeld in core-image.

1. Core release-train

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.

2. DApp release-train (per-CID)

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

3. minCore-check (verplicht bij mount)

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
}

4. Manifest velden (overzicht)

VeldTypeVerplichtBeschrijving
namestringjaWeergave-naam van de DApp
cidstringjaIPFS CID van de bundle (content-addressed)
versionstringjaSemver versie van de DApp
minCorestringjaMinimale core-versie vereist (semver)
tier0|1|2jaTrust-tier (0=core, 1=store-verified, 2=third-party)
vapistringjaVAPI-compat range (bv "1.x")
capabilitiesobjectja capability-requests met method+pad-match
sigstringjaEd25519-handtekening over manifest (hex)
allowliststring[]neeURLs voor maos.fetch (network:fetch-capabilities)
descriptionstringneeBeschrijving voor store-pagina
iconstringneeIPFS CID van icoon (256×256 PNG)
authorstringneeAuteur/publisher

5. Core-vs-IPFS-verdeling (Tier-0 kernbundle)

Tier-0 componenten worden met de core meegebundeld. Ze draaien direct in de shell, zonder iframe-sandbox. Updates komen mee met core-release.

ComponentLocatieUpdate-padToelichting
Wallet-DAppCore bundle (Tier-0)Core-releaseIntent-queue + goedkeuring. Nooit IPFS-afhankelijk.
SettingsCore bundle (Tier-0)Core-releaseSysteeminstellingen, RPC-config, gebruikersprofiel.
PermissionsCore bundle (Tier-0)Core-releasePermissiebeheer, revocation, capability-matrix.
Boot / AuthCore bundle (Tier-0)Core-releaseOpstartflow, sessiebeheer, QR-login.
Store-backendIPFS + Hono-proxyPer-CID updateIndex + metadata. Code op IPFS, API via Hono.
ExplorerCore v1 (Tier-1)Core-release (v1)In core v1, inhoud via VFS/IPFS. Basis-shell in core, content dynamisch.
Help ViewerCore v1 (Tier-1)Core-release (v1)In core v1, documentatie via VFS/IPFS. Shell in core, content dynamisch.
Third-party DAppsAlleen IPFSPer-CID updateAltijd Tier-2 (standaard) of Tier-1 (na verificatie). Nooit in core.
In core bundelen
Alleen componenten die altijd beschikbaar moeten zijn, ongeacht netwerkstatus, en die het vertrouwensmodel van het OS bepalen.
Op IPFS plaatsen
Alles wat dynamisch is, door derden wordt bijgehouden, of waarvan de inhoud频繁 verandert. Content-addressed = automatische caching.

6. Verwijzingen naar verwante specs

Volgende stap Na akkoord: implementatie van minCore-check in SharedWorker + manifest-validatie in Hono publish-route.