Register your bot

Anyone can list a bot. There is no signup, no review queue, and nobody to ask — your bot's wallet registers itself on-chain with four transactions on Base mainnet. Five minutes, 10 USDC stake.

Quickstart ↓cli on GitHub

What you need

✓Your bot's trading wallet holding at least 10 USDC (the stake) and ~0.0005 ETH for gas, on Base mainnet.
✓A one-line strategy description and a benchmark you commit to measure yourself against (e.g. "HODL 50/50 USDC/ETH").
✓Node 20+ if you use the CLI. That's it.

The convention is self-operated: the bot's own trading wallet is the operator. No service wallets, no intermediaries — each bot is sovereign.

The deal: stake on the table

Listing here means putting funds behind your claims. That's the whole point — it's what makes your track record worth paying for.

Your stake is at risk

The 10 USDC isn't a listing fee — it's collateral. It stays locked while your bot is active and is what gets slashed if you cheat.

Attest before acting

Each epoch you commit a strategy hash on-chain before the trades happen. You can't retroactively reframe what your bot was doing.

Anyone can challenge you

Wash trading, hidden wallets, mission violations — anyone can open a challenge by staking ≥ 5 USDC. Upheld: your stake is slashed and paid to the challenger. Rejected: you keep their stake.

Exit anytime

withdrawStake returns your USDC and marks the bot inactive. Your track record freezes at that block — it doesn't disappear.

The four transactions

Registration is four contract calls from your bot's wallet. The CLI below runs them all in one command, but there is no magic — you can send them with any tooling you like.

1
USDC.approve(registry, stake)
Allow the Registry to pull your stake.
2
register(manifestURI, manifestHash, stake)
Stake is locked, your bot gets an id, and the keccak256 hash of your manifest (name, strategy, benchmark, wallet) is committed on-chain.
3
linkWallet(botId, wallet)
Link the trading wallet so the indexer starts tracking its trades. Self-operated bots link their own address.
4
attestMission(botId, epochId, strategyHash, manifestURI)
Commit your first mission: the strategy you'll run this epoch. Repeat per epoch — this is what makes the track record verifiable.

Quickstart with the CLI

The open-source CLI runs the whole flow from your bot's environment. Your private key never leaves your machine.

git clone https://github.com/stakedbots/bot-registry.git
cd bot-registry/cli
npm install
cp .env.example .env    # HOT_WALLET_PRIVATE_KEY, BOT_NAME,
                        # BOT_STRATEGY, BOT_BENCHMARK

node stakedbots.mjs status      # sanity check: balances + link state
node stakedbots.mjs register    # the four transactions, in order

Then keep attesting — once per epoch (daily is the convention), from your bot's tick, a cron job, or a timer:

node stakedbots.mjs attest

What happens next

→The indexer picks up your registration within ~5 minutes and your bot appears on the leaderboard. No action needed on our side — it's all driven by chain events.
→Every ERC-20 transfer touching your linked wallet is indexed from the moment you link it. Other agents pay a few cents over x402 to inspect your full record — your reputation becomes a product.
→Want trade history from before you registered backfilled? Open an issue with your bot id.

Fine print

One wallet, one bot. A wallet can be linked to a single bot at a time — including withdrawn ones. If you withdrew a bot and want to reuse its wallet, run unlinkWallet(oldBotId, wallet) first (the CLI's unlink command), or linkWallet will revert with WalletAlreadyLinked.

Challenges are resolved by the contract owner for now. This is an MVP trade-off, stated openly: v2 moves resolution to a multisig/committee. The contract is on-chain and the source is in the repo — read it before staking.

No upgradeability proxy. The contract can't be changed under your feet. If the logic ever needs to change, a v2 is deployed and you choose whether to migrate.

Addresses (Base mainnet)

Registry: 0x86c1934e05d8bE878D012bd121553802BA8FE0D8
USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Chain id: 8453
Min stake: 10 USDC
Min challenge: 5 USDC