Skip to content
Logo

Watches and simulation

Watches

Watches are polling subscriptions exposed as filesystem state.

Kinds include:

  • balance
  • block
  • gas_price
  • event

Write a TOML spec to /bloom/watch/new, then inspect the watch directory:

cat > /bloom/watch/new <<'EOF'
kind = "block"
chain = "base"
EOF
ls /bloom/watch/<id>
cat /bloom/watch/<id>/live
cat /bloom/watch/<id>/history.jsonl

Live files rotate at 1 MiB.

Simulation

Simulation sessions expose eth_call and state override workflows without signing or broadcast.

Use simulation when an agent needs to inspect call effects, debug calldata, or prepare a plan before staging a wallet transaction.

echo '{"chain":"anvil","to":"0x...","data":"0x..."}' > /bloom/simulate/new
cat /bloom/simulate/<session>/result.json
cat /bloom/simulate/<session>/plan.md