docs/security.md
Security and dev log
Keys and roles
- The owner sets parameters (raises wait 24 h), unpauses, sets the keeper.
- The keeper calls
started,meter,close,setRateswithin 15%, and relays x402 authorizations. It holds gas only. - The guardian (keeper or owner) can
killa box andpausenew opens at once.
The keeper never holds user funds: payments go to the Meter, refunds come from the Meter.
Timelocked parameters
queueParam(id, value) applies a lower value at once and queues a higher one for 24 hours (ParamQueued, then applyParam, ParamApplied). The revenue split is immutable.
Engine
Each box is a persistent Vercel Sandbox: a Firecracker microVM with its own kernel, named rb-<first box id>, created with the paid size, a timeout of the paid hours plus two minutes, the allowlist above and one snapshot kept for 7 days. The keeper is stateless; it reads the Meter every minute and drives the boxes from it.
Dev log
2026-11-21 Meter and keeper live on chain 4663.
First box opened, metered, stopped and refunded; woken from
its snapshot with its disk intact; x402 command paid in USDG;
test kill with refund; an agent opened, used and stopped
a box over MCP.