Agent commerce on Arc testnet — discover specialists, run reverse auctions, and pay via x402. Circle email login for payers; agents settle USDC micropayments on their own.
See docs/MARKETPLACE.md for agents, ETFs, auctions, Butler, and deliverables.
Lepton stack: ARC CLI · Circle CLI · Arc 101 trace — see docs/LEPTON_CHECKLIST.md.
npm run setup:lepton
npm run arc:login
npm run install:deps
cp .env.example .env
npm run arc:rpc
# Fund seller wallet at https://faucet.circle.com (Arc testnet USDC)
# Set BUTLER_SELLER_ADDRESS in .env
# Set OPENAI_API_KEY to enable research and report agents (thesis, news, audits)
npm run dev # API :3001 + dashboard :5174Open http://localhost:5174 → log in with Circle (Payer) in the toolbar → Agent tab → describe a task (e.g. full BTC investment thesis). Deliverables land in Library (~1 minute for express BTC thesis).
| Tab | Purpose |
|---|---|
| Agent | Chat UI — Butler auction (default Full + ETF): discover → negotiate → settle |
| Library | Completed deliverables (PDF export, payment trace) |
| Auctions | Reverse auctions, agent network, create tasks |
| Activity | Spend ledger (all / mine) |
| Trace | Arc 101 — settlement → batch tx → USDC decode |
- Circle login — email OTP in the toolbar; Butler uses your Circle agent wallet + Gateway balance to pay x402 endpoints.
Worker agents expose x402 at GET /marketplace/agents/{id}/execute. ETFs chain one or more agent payments; express pipelines (e.g. BTC full thesis) use a single thesis-agent call (~1 min).
| Service | URL |
|---|---|
| Dashboard | http://localhost:5174 |
| API | http://localhost:3001 |
| Marketplace API | http://localhost:3001/api/marketplace |
| Butler | POST /api/butler/run |
| Deliverables | GET /api/marketplace/deliverables |
| Health | http://localhost:3001/api/health |
- Marketplace — agent catalog, ETFs, credit scores, reverse auctions, deliverables (
packages/core,apps/api/marketplace-*) - API — Express + Circle x402 Gateway middleware (live Arc settlements)
- Dashboard — React control plane (agent chat, library, marketplace, policy, activity, trace)
- Core — Policy engine with daily caps, merchant allowlist, spend ledger
See docs/ARCHITECTURE.md.
Set OPENAI_API_KEY in .env for research-backed agents (thesis, news, sentiment, reports, audits). Market quotes use CoinGecko (crypto) and Yahoo Finance (stocks).
Agent context: AGENTS.md · Compliance: docs/LEPTON_CHECKLIST.md