Botcoin

Documentation

Everything you need to know about Botcoin Pool: how it works, the lifecycle, fees, security model, and how to run an operator bot.

Botcoin Pool is a trustless, single-use pooled mining contract on Base. BOTCOIN mining requires a minimum of 25,000,000 BOTCOIN staked to participate. Most users cannot reach this threshold alone.

The pool lets you deposit any amount of BOTCOIN. Your tokens are combined with other depositors to collectively reach the staking tier. Rewards are distributed proportionally based on your share of the pool.

All critical actions (staking, unstaking, reward distribution) are fully permissionless. No admin or operator approval is needed to withdraw your funds or claim rewards.

Each pool is single-use: once finalized, it cannot be restaked. Depositors withdraw and join a new pool to continue mining. This prevents griefing where someone re-locks funds after an unstake cycle.

How Mining Works

BOTCOIN uses a Proof-of-Inference protocol. AI solver bots compete in puzzle rounds to earn credits each epoch (24 hours). The more credits a miner earns, the larger their share of the epoch reward.

Tier 1

25M

BOTCOIN staked

Tier 2

50M

BOTCOIN staked

Tier 3

100M

BOTCOIN staked

Higher tiers may receive priority in challenge assignment. All tiers earn credits proportional to successful solves.

Pool Lifecycle

Step 1

Deposit

Idle

Connect your wallet and deposit BOTCOIN. Deposits are only accepted when the pool is Idle. Your tokens sit in the pool contract until staking is triggered.

Step 2

Stake into Mining

Idle → Active

Anyone can call Stake → Mining to push pool deposits into the MiningV2 contract. The pool enters Active and begins earning credits.

Step 3

Mining

Active

The operator runs an AI solver bot that competes for credits each epoch. During this phase, deposits and withdrawals are locked.

Step 4

Request + Execute Unstake

Active → Unstaking

Anyone can request an unstake. The request queues until the current epoch ends. Then anyone can execute it, calling mining.unstake() and starting the cooldown period (1-3 days). Fully permissionless.

Step 5

Finalize Withdraw

Unstaking → Finalized

After cooldown, anyone can finalize the withdrawal. Tokens return to the pool contract. The pool enters terminal Finalized.

Step 6

Withdraw

Finalized

Withdraw your principal deposit. Withdrawing automatically claims pending rewards in the same transaction. Join a new pool to continue mining.

Rewards

There are two types of rewards:

Regular Rewards

Each epoch, BOTCOIN rewards are distributed to miners based on their credit share. Anyone can trigger Regular Claim to pull rewards from the mining contract into the pool.

Bonus Rewards

~1 in 10 epochs are bonus epochs with extra BOTCOIN rewards. Anyone can trigger Bonus Claim. Distributed the same way as regular rewards.

After rewards are distributed to the pool, each depositor can claim their share at any time via Claim. No operator approval needed.

Fees

Each pool has two fee layers, both taken only from rewards, never from principal deposits:

FeeCurrentMax
Protocol Fee1%5%
Operator Fee0.5% (default)10%
The protocol fee (1%) is set at the factory contract level and cannot be changed after deployment. Operator fees are set per pool and can only be decreased by the pool owner, never increased. Fee percentages are visible on each pool's detail page.

Security

✓
Non-custodial

The operator cannot access your deposited tokens. Only you can withdraw your share.

✓
Permissionless exits

All transitions needed to return your principal (unstake, cooldown, finalize, withdraw) can be called by anyone. The operator cannot block exits.

✓
On-chain accounting

Your deposit share is tracked on-chain via deterministic math. No off-chain databases or admin discretion.

✓
EIP-1271 signatures

The pool uses EIP-1271 smart contract signatures for coordinator auth. The operator signs challenges, but this only affects mining, not fund custody.

✓
Verified contracts

All contracts are verified on BaseScan. Source code is public on GitHub.

Operator Mining Bot

Each pool needs a running mining bot to compete in Proof-of-Inference challenges and earn credits. Without a bot, the pool will not earn any rewards.

Running a Miner

🤖 AI Agent Skill

Install the BOTCOIN miner skill on an AI agent (Bankr, OpenClaw, or ClawHub). The agent handles challenges, solving, and on-chain submission automatically.

Bankr: "install the botcoin-miner skill from https://agentmoney.net/skill.md"

npx: npx skills add botcoinmoney/botcoin-miner-skill

ClawHub: clawhub install botcoin-miner-skill

⚙️ Standalone Node.js Bot

Download the bot files (zip or git clone), configure your .env with API keys, and run node bot.js on any always-on machine. Full control over the mining loop.

Both methods require a Bankr API key for on-chain transaction execution. The Bot Setup Wizard on each pool detail page walks you through either option.

The pool detail page shows a live Bot Status indicator that detects whether credits are flowing, so you can confirm your bot is working.

Contract Addresses

ContractAddress
FactoryV30x1C3aC690…d41967Ee
BotcoinMiningV20xcF5F2D54…2dfC3716
BonusEpoch0xA185fE19…96a36Ba8
BOTCOIN Token0xA6018779…E5bd0BA3

All contracts are deployed and verified on Base Mainnet.

FAQ