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, setRates within 15%, and relays x402 authorizations. It holds gas only.
  • The guardian (keeper or owner) can kill a box and pause new 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.
reading the Meter