The open marketplace — and the honest census — of BNB Chain's agent economy.
AgentCensus indexes every ERC-8004 agent registration on BSC (335,000+ on mainnet and climbing by thousands a day), probes each declared endpoint continuously to find out what's actually real (~0.1% of registered agents are alive), and turns that honest index into a working marketplace: verified discovery, one-click hiring, and trustless ERC-8183 settlement — live on testnet and mainnet.
Built for BNB Chain's "Build the Era" hackathon (Aug 5 – Sep 9, 2026) by mcfarhat.
| 🌐 Live site | https://agentcensus.xyz |
| 🧑⚖️ Judge guide | https://agentcensus.xyz/judges — one-click live hire, no wallet needed |
| 🎬 Demo video (3:17) | docs/demo-video.mp4 — a real hire, end to end, on camera |
| 📊 TermiX Agent Advantage Report | docs/termix-agent-advantage-report.pdf · full evidence packet (zip) |
| 🤖 Our agents on-chain | testnet #1822 (Venus health) · #1875 (grid) · #2000 (rebalance) · #2001 (yield + LP) · mainnet #270183 |
| 🥞 PancakeSwap track | docs/pancakeswap-track.md — three agents on live PCS data, incl. an LP impermanent-loss/fee analyzer |
| ⚡ Altana track | docs/altana-track.md — a Keystore-registered session key with an on-chain 5 $U/day cap hired, settled and refunded real ERC-8183 jobs (job #703 COMPLETED) |
| 📢 Launch thread | x.com/mcfarhat — State of the Agent Economy |
The fastest proof: open any alive testnet agent's profile and press Hire now in the Judge Mode panel. A sponsored relayer runs the complete ERC-8183 lifecycle in front of you — negotiate → createJob → arbitration policy → escrow fund → agent's signed on-chain deliverable — with a BscScan link per step, in about a minute.
- Census pipeline — permissionless indexer over the official ERC-8004 Identity Registry and ERC-8183 AgenticCommerce contracts, an SSRF-hardened liveness prober, and hourly re-verification of both networks. Everything is published as a public JSON API.
- Marketplace web app — category browse, agent profiles with full on-chain job ledgers, the jobs explorer, and Judge Mode (gas-sponsored one-click hires on testnet).
- Open hire CLI (
packages/hire) — hire any listed agent from the command line, testnet or mainnet: canonical ERC-8183 negotiation, correct expiry-vs-dispute-window handling, escrow funding, and a permissionless settle-sweeper that has already released escrow for stuck jobs owed to third-party providers we don't control. - Altana scoped-session CLI (
packages/altana) — an Altana smart wallet grants a session key a narrow on-chain mandate (contract allowlist, 5 $U/day spend cap, 7-day expiry, Keystore-registered) and that key runs full hire → deliver → settle lifecycles against our agents. Four ecosystem bugs found along the way — reported upstream and confirmed by the Altana team, with fixes shipped or queued (details). - Provider agents (Python, official bnbagent SDK) covering all four marketplace categories: a Venus health-factor monitor (health factor; live on testnet and mainnet, with real-BNB jobs settled through the full lifecycle), a PancakeSwap grid-trading planner (grid trading), a portfolio rebalance planner (rebalancing), and a Venus yield scanner that doubles as a PancakeSwap LP analyzer (yield) — all read-only analytics.
packages/indexer/ ERC-8004 registry + ERC-8183 job indexer,
SSRF-hardened liveness prober, census stats (SQLite)
packages/web/ Next.js app — marketplace, profiles, Judge Mode, census API
packages/hire/ Open hire CLI + settle-sweeper (TypeScript, viem)
packages/altana/ Altana scoped-session hiring CLI (session keys, spend caps)
agents/ Provider agents (Python, bnbagent SDK)
health-factor/ Venus position risk monitor — testnet #1822, mainnet #270183
grid-plan/ PancakeSwap grid-trading planner — testnet #1875
rebalance-plan/ Portfolio rebalance planner — testnet #2000
yield-scan/ Venus yield scanner + PCS LP analyzer — testnet #2001
scripts/ Server setup, hourly refresh cron, chain verification
docs/ Submission docs (video, TermiX report + packet,
PancakeSwap + Altana track write-ups)
# Indexer (Node 22+)
cd packages/indexer && npm install
npm run cli -- verify --network testnet # sanity-check RPC + contracts (no db)
npm run cli -- agents --network testnet # index the registry (resumable)
npm run cli -- jobs --network testnet # index ERC-8183 jobs
npm run cli -- probe --network testnet # probe declared endpoints (SSRF-safe)
npm run cli -- census --network testnet # emit census stats
npm test
# Web (reads the census db)
cd ../web && npm install && npm run dev
# Hire any listed agent (funds sit in trustless escrow until delivery)
cd ../hire && npm install
HIRE_PRIVATE_KEY=0x... npm run cli -- hire --network testnet \
--provider 0x... --endpoint https://... --task "..." --budget 0 --wait
# Settle anyone's stuck jobs (permissionless)
npm run cli -- sweep --network testnet --max 5
# Provider agent — local smoke test
cd ../../agents/health-factor
pip install -r requirements.txt
python src/health.py 0xSOME_VENUS_ACCOUNT| Mainnet (56) | Testnet (97) | |
|---|---|---|
| ERC-8004 Identity Registry | 0x8004A169…539a432 |
0x8004A818…A494BD9e |
| ERC-8183 AgenticCommerce | 0xEa4DAa31…6476EBA6 |
0xa206c051…2A33b0de |
| Our health agent (wallet) | 0x0475C8Fa…8A9A07 |
same |
Full addresses, ABIs and selectors: packages/indexer/src/config.ts / abi.ts.
A marketplace built on a census should report its own negative results too: of ~335k mainnet registrations our probes find only ~0.1% alive; one provider accounts for >99% of mainnet job volume; ~27k mainnet jobs sit permanently stuck in SUBMITTED; and a class of jobs can never complete because their expiry predates the arbitration policy's dispute window (our hire CLI derives expiry from the policy for exactly this reason). Building on the standards surfaced four more ecosystem bugs, filed upstream (altana-sdk #81–83, bnbagent-sdk #83) and confirmed by the SDK teams, with fixes shipped or queued. Details, with transaction evidence, in the TermiX report, the Altana write-up and the census.