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
| Status | Betekenis | Tier | Zichtbaarheid |
| staged | Pas gepubliceerd, niet gescand | Tier-2 (default) | Openbaar in store |
| verified | Auto-scan + review goedgekeurd | Tier-1 (na goedkeuring) | Openbaar + "verified" badge |
| untrusted | Auto-scan issues gevonden | Tier-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
| Categorie | Patroon | Gevolg |
| eval / Function() | eval(...), new Function(...) | Direct untrusted |
| innerHTML | .innerHTML =, document.write(...) | Direct untrusted |
| remote fetch | fetch(...) naar niet-allowlist URL | Direct untrusted |
| inline remote scripts | <script src="https://…"> | Direct untrusted |
2. Categorien + search
2.1 Categorien
| Categorie | Beschrijving | Voorbeelden |
| Finance | DeFi, exchanges, portfolio trackers | DEX, lending, staking |
| NFT | NFT-markten, galleries, minters | Marketplace, mint-tool |
| Tools | Utilities, development, analytics | Block explorer, gas tracker |
| Gaming | Web3 games, play-to-earn | RPG, strategy, collectibles |
| Social | Social platforms, messaging | Decentralized social, chat |
| System | Tier-0 kerncomponenten | Wallet, settings, permissions |
2.2 Search-functionaliteit
- Trefwoord: Zoek op naam, beschrijving, auteur.
- Categorie: Filter op categorie.
- Tier: Filter op tier (0/1/2).
- Status: Filter op status (staged/verified/untrusted).
- Sortering: Relevantie, populariteit (downloads), datum (nieuwste), beoordeling.
3. DApp-metadata (store-pagina)
| Veld | Type | Bron | Toelichting |
name | string | manifest.json | Weergave-naam |
description | string | manifest.json | Beschrijving (max 500 tekens) |
icon | CID | manifest.json | IPFS CID van icoon (256×256 PNG) |
author | string | manifest.json | Auteur/publisher |
version | string | manifest.json | Semver versie |
tier | 0|1|2 | store-backend | Trust-tier |
status | string | store-backend | staged/verified/untrusted |
cid | string | store-backend | Huidige IPFS CID |
minCore | string | manifest.json | Minimale core-versie |
capabilities | object | manifest.json | Vereiste capabilities |
downloads | number | store-backend | Aantal keer geopend |
rating | number | store-backend | Gemiddelde beoordeling (1-5) |
publishedAt | timestamp | store-backend | Eerste publicatie |
updatedAt | timestamp | store-backend | Laatste update |
paid | boolean | manifest.json | Betaalde DApp (optioneel) |
price | string | manifest.json | Prijsindicatie (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
| Endpoint | Methode | Beschrijving |
/api/store/list | GET | Lijst van alle DApps (gefilterd op tier/status) |
/api/store/:cid | GET | DApp-details op CID |
/api/store/publish | POST | Nieuwe DApp publiceren |
/api/store/:cid/update | PUT | Bestaande DApp bijwerken |
/api/store/search | GET | Zoeken 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:
- Geen eigen Stripe per DApp: MAOS integreert geen Stripe-direct. Alle betalingen lopen via wallet-DApp als enige payment-rail.
- Top-up alleen via wallet-DApp: Storten (funds) via Stripe SEPA/iDEAL in wallet-DApp. Daarna alles on-chain.
- Wallet-queue met approval: Elke betaling gaat door intent-queue → goedkeuring → pas broadcast. Sign != send.
- Gas/daglimiet: Betaalde DApps vallen onder dezelfde gas-ceiling + daglimiet als andere chain:send operaties.
5.2 Pagina's
- Home: Uitgelichte DApps, categorieen, zoekbalk.
- Categorie: Lijst van DApps in een categorie, gesorteerd op populariteit/datum.
- Detail: DApp-beschrijving, versie, capabilities, ratings, "Openen" knop.
- Zoekresultaten: Filterbare lijst op basis van zoekopdracht.
- Mijn DApps: Overzicht van geïnstalleerde/bezochte DApps.
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)
| # | Beslissing | Rationale | Herziening |
| SC1 | Betaalde DApps JA via VAPI wallet-rail | Enige payment-rail = wallet-DApp; geen eigen Stripe per DApp; on-chain via intent-queue | — |
| SC2 | Top-up alleen via wallet-DApp (Stripe SEPA/iDEAL) | Fiat-to-crypto桥独自 via wallet; daarna alles on-chain | — |
6.1 Open Grillvragen
- Vraag 2: Hoe wordt de populariteit (downloads) gemeten: per CID, per manifest, of per sessie?
- Vraag 3: Moet de store ook een "updates" feed bieden (notificaties bij nieuwe versies van geïnstalleerde DApps)?
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.