Kernel wallet-spec (web3-OS)

Besluiten: sign ≠ send • elk bedrag volle approval • alles via wallet-DApp + browser/extension, nooit direct • 1 provider per sessie • vaste RPC 270 + 260

Har Bali-regel: DApp krijgt nooit raw keys, nooit direct broadcast. DApp maakt intent, wallet-DApp (Tier-0) + browser-wallet of MAOS-extension keurt goed, kernel zendt pas dan uit.

1. Verplichte flow (geen bypass)

DApp ──maos.request('wallet:send'/'chain:send')──▶ SharedWorker ──enqueue──▶ wallet-DApp queue (pending)
                                                                        │
                                              browser-wallet / MAOS-extension ──approve/reject
                                                                        │
                                                        approve ──▶ kernel broadcast ──▶ receipt terug
DApp ziet alleen: queued → approved/rejected → receipt. Geen tx-hash zonder approval.

2. Sign vs send (gesplitst)

MethodeGrantRegels
wallet:sign (personal_sign)wallet:signAltijd leesbare preview. Blind-sign verboden: ondecodeerbaar = deny.
wallet:signTypedDatawallet:signTypedData + contract-allowlistEIP-712 domein + velden tonen. Nieuw contract = step-up (pin/QR).
wallet:send / chain:sendchain:send:<chain>:<contract>Intent only → queue. Gas-ceiling + daglimiet per DApp. Boven limiet = deny + aanvraag.
chain:call (read)chain:callWeb3-OS core: altijd toegestaan zonder prompt binnen capability. Geen state-change.

3. Provider (1 per sessie)

4. RPC (vast, geen fallback)

ChainRolRoute
270Productie (eigen)Alleen via Hono-proxy allowlist. DApp mag geen eigen RPC-URL zetten.
260zkSync mainIdem. Custom RPC = deny.

Later uitbreiden alleen per manifest-allowlist, nooit vrij veld. Fallback-routing uit.

5. Limieten + UX

6. Migratie uit MAOSv6