System-apps store — catalog

Store-catalog met staged→verified pipeline • categorien + search • DApp-metadata + ratings • publish-flow • status: ontwerp, nog geen code

Kerndefinitie: De store is de centrale catalogus voor alle DApps in MAOS. Elke DApp begint als staged (openbaar zichtbaar), wordt verified na auto-scan + handmatige review, of untrusted bij deny-list hits. De store biedt categorien, search en DApp-metadata.

1. Store states + statusovergangen

StatusBetekenisTierZichtbaarheid
stagedPas gepubliceerd, niet gescandTier-2 (default)Openbaar in store
verifiedAuto-scan + review goedgekeurdTier-1 (na goedkeuring)Openbaar + "verified" badge
untrustedAuto-scan issues gevondenTier-2 (strict)Openbaar + "untrusted" waarschuwing

1.1 Statusovergangen

publish (staged) ──▶ auto-scan ──┬── geen issues ──▶ handmatige review ──┬── goedgekeurd ──▶ verified
                                  │                                      │
                                  └── issues gevonden ──────────────────-─┘── afgewezen ──▶ untrusted
                                                                                              │
                                                                  handmatige review ──────────-─┘── alsnog goedgekeurd ──▶ verified

1.2 Auto-scan deny-list

CategoriePatroonGevolg
eval / Function()eval(...), new Function(...)Direct untrusted
innerHTML.innerHTML =, document.write(...)Direct untrusted
remote fetchfetch(...) naar niet-allowlist URLDirect untrusted
inline remote scripts<script src="https://…">Direct untrusted

2. Categorien + search

2.1 Categorien

CategorieBeschrijvingVoorbeelden
FinanceDeFi, exchanges, portfolio trackersDEX, lending, staking
NFTNFT-markten, galleries, mintersMarketplace, mint-tool
ToolsUtilities, development, analyticsBlock explorer, gas tracker
GamingWeb3 games, play-to-earnRPG, strategy, collectibles
SocialSocial platforms, messagingDecentralized social, chat
SystemTier-0 kerncomponentenWallet, settings, permissions

2.2 Search-functionaliteit

3. DApp-metadata (store-pagina)

VeldTypeBronToelichting
namestringmanifest.jsonWeergave-naam
descriptionstringmanifest.jsonBeschrijving (max 500 tekens)
iconCIDmanifest.jsonIPFS CID van icoon (256×256 PNG)
authorstringmanifest.jsonAuteur/publisher
versionstringmanifest.jsonSemver versie
tier0|1|2store-backendTrust-tier
statusstringstore-backendstaged/verified/untrusted
cidstringstore-backendHuidige IPFS CID
minCorestringmanifest.jsonMinimale core-versie
capabilitiesobjectmanifest.jsonVereiste capabilities
downloadsnumberstore-backendAantal keer geopend
ratingnumberstore-backendGemiddelde beoordeling (1-5)
publishedAttimestampstore-backendEerste publicatie
updatedAttimestampstore-backendLaatste update
paidbooleanmanifest.jsonBetaalde DApp (optioneel)
pricestringmanifest.jsonPrijsindicatie (optioneel, bij paid=true)

4. Publish-flow

4.1 Stappen

Publisher: maos publish
    │
    ├── 1. Vite-build → bundle (minified)
    │
    ├── 2. manifest.json genereren
    │       ├── name, description, icon, author
    │       ├── cid (IPFS CID van bundle)
    │       ├── version (semver)
    │       ├── minCore (minimale core-versie)
    │       ├── tier (door publisher opgegeven)
    │       ├── vapi (API-compat range)
    │       ├── capabilities (vereiste permissies)
    │       └── allowlist (URLs voor maos.fetch)
    │
    ├── 3. Ed25519-sign over canonical JSON
    │
    ├── 4. IPFS pin via /api/ipfs/pin
    │       ├── Pin bij eigen Kubo
    │       ├── Pin bij externe provider(s)
    │       └── Verificatie (hash-match)
    │
    ├── 5. CID registreren in store-backend
    │
    └── 6. Status: staged (wacht op auto-scan)

4.2 Store-backend API

EndpointMethodeBeschrijving
/api/store/listGETLijst van alle DApps (gefilterd op tier/status)
/api/store/:cidGETDApp-details op CID
/api/store/publishPOSTNieuwe DApp publiceren
/api/store/:cid/updatePUTBestaande DApp bijwerken
/api/store/searchGETZoeken met filters

5. Store-UI (web3-website)

5.1 Betaalde DApps

BESLIST: Betaalde DApps zijn toegestaan, maar uitsluitend via VAPI-payment door wallet-DApp. De dapp-wallet is de enige payment-rail. MAOS draait geen eigen Stripe-integratie per DApp. Funds top-up (storten) kan uitsluitend via de wallet-DApp (Stripe SEPA/iDEAL als top-up-rail), daarna alles on-chain via wallet-queue met approval + gas/daglimiet.

Betaal-flow:

Gebruiker: opent betaalde DApp in store
    │
    ├── 1. Store toont: "Deze DApp vereist betaling"
    │
    ├── 2. DApp stuurt VAPI-payment intent
    │       │
    │       └── wallet-DApp toont: bedrag + contract + chain
    │
    ├── 3. Gebruiker approve in wallet-DApp
    │       │
    │       ├── Wallet heeft saldo? → on-chain betaling via intent-queue
    │       │
    │       └── Onvoldoende saldo? → redirect naar top-up (wallet-DApp)
    │               │
    │               ├── Top-up via Stripe SEPA/iDEAL (wallet-DApp)
    │               │
    │               └── Na storting → on-chain betaling
    │
    └── 4. Receipt → DApp toegang geven

Regels betaalde DApps:

5.2 Pagina's

5.2 Interactie met kernel

Gebruiker klikt "Openen" op DApp in store
    │
    ├── 1. Store checkt: DApp geïnstalleerd? (CID in local VFS)
    │       │
    │       ├── Ja → direct openen (mount)
    │       │
    │       └── Nee → download via IPFS
    │               │
    │               ├── CID-resolutie via Helia/gateway
    │               ├── Download + hash-verificatie
    │               ├── Pin in lokale cache
    │               └── Mount via <maos-app> container
    │
    └── 2. Container: verify → spawn → iframe + port

6. Beslissingen (store-catalog)

#BeslissingRationaleHerziening
SC1Betaalde DApps JA via VAPI wallet-railEnige payment-rail = wallet-DApp; geen eigen Stripe per DApp; on-chain via intent-queue—
SC2Top-up alleen via wallet-DApp (Stripe SEPA/iDEAL)Fiat-to-crypto桥独自 via wallet; daarna alles on-chain—

6.1 Open Grillvragen

7. Verwijzingen naar verwante specs

Volgende stap Na akkoord: store-backend API + auto-scan pipeline + store-UI pagina's + publish-flow + betaalde DApps VAPI-payment implementatie.