Blockchain-laag: source-of-truth
Alles draait op blockchain als single source of truth • chain:call vrij, chain:send achter approval • 1 provider per sessie • RPC 270+260 via Hono • blind-sign verboden • status: ontwerp, nog geen code
Kerndefinitie: In MAOSv6 is de blockchain de enige source-of-truth voor token-ownership, transacties en state. De browser-interface is een weergave-laag die nooit eigen staat bewaalt. Elke write-operatie gaat door de intent-queue → wallet-DApp approval → kernel broadcast. Reads (chain:call) zijn altijd vrij binnen capability-scope.
1. chain:call vs chain:send (gesplitst, geen uitzondering)
| Methode | Grant vereist | Approval | Blokkering |
chain:call | chain:call (of breder) | Geen — lees-operatie, geen state-change | Altijd toegestaan binnen capability. Geen wachtrij. |
chain:send | chain:send:<chain>:<contract> | Volledige approval via wallet-DApp | Intent-queue → goedkeuring → pas broadcast. Elke send, ook €0,01. |
wallet:sign | wallet:sign | Leesbare preview in wallet-DApp | Blind-sign verboden: ondecodeerbaar = deny. |
wallet:signTypedData | wallet:signTypedData + contract-allowlist | EIP-712 domein + velden tonen | Nieuw contract = step-up (pin/QR). |
1.1 chain:call details (read-only, altijd vrij)
- Wat: Balances, nonce, contract-reads (view/pure), logs, gas-estimates.
- Grant:
chain:call is voldoende. DApp-specifieke pad-grants optioneel.
- Beperking: Geen state-change via call.
eth_call met value = deny.
- Performance: Direct door naar RPC-proxy (geen queue). P95 <50ms (lokaal).
- Rate-limit: BESLIST: chain:call krijgt geen eigen DAG-limiet. Call-volume is laag (reads, geen writes). Hono token-bucket rate-limit per tier volstaat. Herzien bij misbruik of groei call-volume. Rationale: writes zijn de risico-categorie, niet reads; DAG-limiet toevoegen op reads geeft onnodige overhead zonder veiligheidswinst.
1.2 chain:send details (write, altijd achter approval)
- Wat: Token-transfers, contract-interacties met state-change, NFT-mints.
- Grant-formaat:
chain:send:<chain>:<contract>. Exact match, geen wildcard.
- Intent-queue: DApp stuurt intent → SharedWorker queue → wallet-DApp toont details → approve/reject → kernel broadcast.
- Geen shortcuts: Geen
broadcast:true flag voor DApps. Geen auto-sign bij kleine bedragen.
2. Blind-sign verbod (harde regel)
VEILIGHEIDSREGEL: Blind-signing is ten strengste verboden. Elke handtekening moet een leesbare, decodeerbare preview tonen in de wallet-DApp. Ondecodeerbaar = automatisch deny. Dit geldt voor alle methodes: personal_sign, signTypedData, en custom signing.
2.1 Wat is blind-sign?
- personal_sign met onleesbaar payload: Hex-gecodeerde data zonder decoding = blind.
- signTypedData zonder veld-weergave: EIP-712 zonder domein/velden tonen = blind.
- Custom RPC zonder decode: Onbekende methodes zonder preview = blind.
2.2 Decoderingsregels
| Methode | Vereiste weergave | Bij falen |
personal_sign | Hex → UTF-8 decoding + leesbaar bericht tonen | Deny + audit |
signTypedData | EIP-712 domein + alle velden met namen + types | Deny + audit |
eth_sendTransaction | To, value, data (decoded), gas, nonce | Deny + audit |
3. 1 provider per sessie (geen switching)
- Regel: Elke sessie heeft exact 1 geselecteerde wallet-provider. Wisselen = sessie-reset + nieuwe attest.
- EIP-6963: Wallet-providers worden gefilterd in SharedWorker. Alleen OS-gesigneerde wallets worden getoond. DApp-injectie wordt genegeerd.
- UUID-dedup: Elke wallet krijgt unieke UUID bij eerste detectie. Duplicaten gefilterd op UUID, niet op naam. UUID-dedup is niet betrouwbaar voor verificatie — alleen signed allowlist telt.
- rdns onbetrouwbaar: Het
rdns-veld in EIP-6963 is onbetrouwbaar. Niet gebruiken voor verificatie. Alleen eigen signed manifests tellen.
- Signed-only allowlist: BESLIST: Wallet-allowlist is ALLEEN signed (dynamisch via signed config-file, niet hardcoded). Unsigned providers worden geblokkeerd + audit-log. UUID-dedup en rdns worden niet vertrouwd voor provider-verificatie.
- Freeze: Na eerste announce worden providers gefrost. Nieuwe announces genegeerd gedurende sessie.
3.1 Provider-selectie flow
Sessie starten
│
├── EIP-6963 announces filteren (alleen OS-gesigneerde)
│
├── Wallet-keuze tonen aan gebruiker
│
└── Selectie vastzetten (freeze)
│
├── DApp ziet: maos.provider (gefilterde EIP-1193)
│
├── Switchen = sessie-reset + nieuwe attest
│
└── 1 provider = geen address-confusion bij 10k DApps
4. RPC: vast via Hono-proxy (geen fallback)
| Chain | Rol | Route via Hono | Regels |
270 | Productie (eigen) | /api/rpc/270 | Alleen via Hono-proxy allowlist. DApp mag geen eigen RPC-URL zetten. |
260 | zkSync main | /api/rpc/260 | Idem. Custom RPC = deny. |
4.1 Hono RPC-proxy architectuur
DApp iframe ──maos.request('chain:call', {chain:270, ...})──▶ SharedWorker
│
└── capability-check ──▶ Hono /api/rpc/270
│
├── rate-limit (token bucket per tier)
├── cache (immutable responses, 30s TTL)
└── proxy naar vaste RPC-node
4.2 Verboden
- Geen custom RPC: DApp kan geen eigen RPC-URL instellen. Alleen chain-codes (270, 260).
- Geen fallback: Als Hono-proxy niet bereikbaar is, geen terugval naar publieke nodes.
- Geen WebSocket: RPC via HTTP POST only. Geen wss:// verbindingen.
- Uitbreiden: Nieuwe chains alleen per manifest-allowlist, nooit vrij veld.
5. Gas-ceiling + daglimiet per DApp
| Parameter | Default | Configuratie | Bij overschrijding |
| Gas-ceiling per tx | Configurabel per DApp | manifest.limits.gasPerTx | Deny + melding in wallet-DApp |
| Daglimiet (aantal tx) | Configurabel per DApp | manifest.limits.dailyTxCount | Deny + limiet-aanvraag |
| Daglimiet (value) | Configurabel per DApp | manifest.limits.dailyValue | Deny + limiet-aanvraag |
5.1 Wallet-DApp weergave bij approval
Bij elke send-intent toont de wallet-DApp:
- DApp-id + CID (identificatie)
- Methode + decoded payload
- Chain + contract-adres
- Value (in ETH/munt + fiat-equivalent)
- Gas-schatting (max + estimated)
- Dag-totaal (aantal sends + totale value vandaag)
Approve = door naar extension-sign. Reject = blokkeer + audit.
6. Verwijzingen naar verwante specs
Volgende stap Na akkoord: implementatie van chain:call/chain:send splitting in SharedWorker + Hono RPC-proxy + gas-ceiling logging in intent-queue.
7. Beslissingen (Q1-Q22 + blockchain)
| # | Beslissing | Rationale | Herziening |
| B1 | chain:call geen DAG-limiet | Call-volume laag; Hono rate-limit volstaat; writes zijn de risico-categorie | Herzien bij misbruik of groei call-volume |
| B2 | Wallet-allowlist signed-only (dynamisch via signed config-file) | Unsigned providers onbetrouwbaar; UUID-dedup en rdns niet vertrouwen | — |
7.1 Open Grillvragen
- Vraag 2: Hoe wordt de gas-ceiling per DApp geconfigureerd: in het manifest (door publisher) of in de store-config (door reviewer)?
- Vraag 3: Wat gebeurt er als een DApp een onbekende chain-code aanvraagt (niet 270/260): deny + audit, of allowlist-check?