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)

MethodeGrant vereistApprovalBlokkering
chain:callchain:call (of breder)Geen — lees-operatie, geen state-changeAltijd toegestaan binnen capability. Geen wachtrij.
chain:sendchain:send:<chain>:<contract>Volledige approval via wallet-DAppIntent-queue → goedkeuring → pas broadcast. Elke send, ook €0,01.
wallet:signwallet:signLeesbare preview in wallet-DAppBlind-sign verboden: ondecodeerbaar = deny.
wallet:signTypedDatawallet:signTypedData + contract-allowlistEIP-712 domein + velden tonenNieuw contract = step-up (pin/QR).

1.1 chain:call details (read-only, altijd vrij)

1.2 chain:send details (write, altijd achter approval)

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?

2.2 Decoderingsregels

MethodeVereiste weergaveBij falen
personal_signHex → UTF-8 decoding + leesbaar bericht tonenDeny + audit
signTypedDataEIP-712 domein + alle velden met namen + typesDeny + audit
eth_sendTransactionTo, value, data (decoded), gas, nonceDeny + audit

3. 1 provider per sessie (geen switching)

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)

ChainRolRoute via HonoRegels
270Productie (eigen)/api/rpc/270Alleen via Hono-proxy allowlist. DApp mag geen eigen RPC-URL zetten.
260zkSync main/api/rpc/260Idem. 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

5. Gas-ceiling + daglimiet per DApp

ParameterDefaultConfiguratieBij overschrijding
Gas-ceiling per txConfigurabel per DAppmanifest.limits.gasPerTxDeny + melding in wallet-DApp
Daglimiet (aantal tx)Configurabel per DAppmanifest.limits.dailyTxCountDeny + limiet-aanvraag
Daglimiet (value)Configurabel per DAppmanifest.limits.dailyValueDeny + limiet-aanvraag

5.1 Wallet-DApp weergave bij approval

Bij elke send-intent toont de wallet-DApp:

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)

#BeslissingRationaleHerziening
B1chain:call geen DAG-limietCall-volume laag; Hono rate-limit volstaat; writes zijn de risico-categorieHerzien bij misbruik of groei call-volume
B2Wallet-allowlist signed-only (dynamisch via signed config-file)Unsigned providers onbetrouwbaar; UUID-dedup en rdns niet vertrouwen—

7.1 Open Grillvragen