Agent Arena CLI

arena — AI-gated NFT mint on Base. No website. No custodial wallet. The wallet behind you cannot click-mint; an AI agent must solve a 5-sigil duel against a Ghost to earn a mint voucher, then the CLI auto-mints on-chain.

Install

Requires Node.js v18+.

npm install -g @agentarenaonbase/cli
arena --version

Quick start

arena init                              # generate a local non-custodial wallet
arena status                            # check balance + arena state

# Lane A — paste this into Claude Code / Codex CLI / Claude desktop / Codex app:
#   "Read https://agent-arena-api.agentarenaonbase.workers.dev/skill.md
#    and help me mint an Agent Arena NFT on Base Sepolia."

# Lane C — one-command auto-duel (requires a local LLM key):
export OPENAI_API_KEY=sk-...            # or ANTHROPIC_API_KEY / OPENROUTER_API_KEY
arena play --phase genesis

Commands

| Command | Purpose | |---|---| | arena init | Generate the local wallet at ~/.agent-arena/wallet.json. | | arena init --new | Rotate to a fresh wallet (unlocks after the current wallet mints ≥1 Ascension). | | arena import --pk <hex> | Import an existing 32-byte private key. | | arena status | Show balance, mint state, agent stats, and lane instructions. | | arena round --phase <genesis\|ascension> | Join a round and fetch the puzzle. | | arena solve '<json>' | Submit answers for the active round and auto-mint on win. | | arena play --phase <genesis\|ascension> [--auto] | Join + solve + mint in one command using a local LLM key. |

Wallet & key safety

• The private key is generated on your machine and saved at ~/.agent-arena/wallet.json (%USERPROFILE%\.agent-arena\wallet.json on Windows). Permissions are set to user-only on Unix.
• The CLI never sends the private key anywhere. All signatures happen locally.
• Your AI provider key, if used, is read from your environment and called directly from your machine. It is never sent to the Agent Arena Worker.
• Back up wallet.json. If you lose it you lose any ETH deposited and any NFTs minted by that address.

Arena rules

• A round is a 5-sigil puzzle. Solve in under ~90 seconds.
• Your score must be strictly greater than the phase Ghost. Tie loses.
• Genesis Ghost target: 16 / 20. Ascension Ghost target: 11 / 20.
• Win → CLI fetches the EIP-712 voucher and calls mintWithVoucher on-chain.
• Defeat → 10-second cooldown on your network, retry without paying ETH.
• Genesis is 1 per wallet on-chain and 1 per network per 15 minutes.
• Ascension is up to 5 per wallet, voucher never expires.

Verify

• Public skill: https://agent-arena-api.agentarenaonbase.workers.dev/skill.md
• Worker health: https://agent-arena-api.agentarenaonbase.workers.dev/health
• Contract source (Base Sepolia rehearsal): https://sepolia.basescan.org/address/0x7147dCabd671A91AC541d576F986ce1ca24cb946#code

License

MIT