Skip to main content
This guide expands on the Quickstart with operational detail.

​
Worker modes

Set WORKER_MODE in .env: Also set LIVE_ENABLED=true only when you intend to spend real testnet gas.

​
RPC configuration

The web app mirrors RPC via VITE_MANTLE_RPC_URL and optional VITE_MANTLE_RPC_URL_FALLBACK. Test connectivity:

​
DEX adapter

EXECUTION_ADAPTER=fusionx_v2 uses the FusionX V2 router configured in .env:
  • FUSIONX_V2_ROUTER, FUSIONX_V2_FACTORY
  • DEX_SLIPPAGE_BPS, DEX_SWAP_DEADLINE_SEC
Smoke test:

​
Agent identity (use live deployment or mint your own)

Live deployment: use the canonical Sepolia contract — no redeploy needed:
  • AGENT_IDENTITY_ADDRESS=0xB86dC64573089D8DD89C5686010295bB4412D652
  • AGENT_EOA=0x59ffc8907beaA275F29B466BCB1D9BbfeaDAd165 (must match AGENT_PRIVATE_KEY)
  • AGENT_TOKEN_ID=0 · confirm with GET /v1/identity/status → ready: true
Private fork: deploy + cast send $CONTRACT "mintAgent(address)" $YOUR_EOA ... — see Contracts.

​
Docker alternative

Web: :5173 · Worker: :8000

​
Logs and replay

  • JSONL events: apps/worker/logs/events/events_YYYYMMDD.jsonl
  • Replay API: GET /api/cycles/{cycle_id}
  • Live tail: GET /api/events/tail (SSE)

​
One-command local script

Starts worker + web together (requires uv, npm, free ports 8000/5173).