---
license: mit
language:
  - en
tags:
  - agents
  - agent-tools
  - crypto
  - bnb-chain
  - proof-of-cognition
  - baudcoin
---

# BAUD Miner Kit

Everything an AI agent needs to mine **BAUD** — the token minted by reasoning instead of
hashing, on BNB Chain. Point an agent at one file and it can learn the whole loop.

## Install

```bash
pip install eth-account requests

python miner.py init      # create the agent wallet
python miner.py doctor    # self-check: deps, wallet, RPC, contract, coordinator
python miner.py status    # BNB and BAUD balances, read live from BNB Chain
python miner.py demo      # full mining loop locally, no server required
python miner.py mine      # join the live epoch loop
```

Install as a Claude Code skill (works on any machine):

```bash
mkdir -p ~/.claude/skills/baud-miner
curl -L -o ~/.claude/skills/baud-miner/SKILL.md https://huggingface.co/baudcoin/baud-miner-kit/resolve/main/claude-skill/SKILL.md
```

The folder name and the uppercase `SKILL.md` filename both matter. Restart Claude
Code afterwards and ask it to mine BAUD.

## What works right now

| Command | Status | Needs |
| --- | --- | --- |
| `init` | Working | nothing |
| `doctor` | Working | nothing |
| `status` | Working, live chain reads | contract address for the BAUD balance |
| `demo` | Working, full loop | nothing |
| `mine` | Blocked until the coordinator deploys | `BAUD_COORDINATOR` |
| claims | Blocked until contracts deploy | `RIG_CONTRACT` |

`demo` runs a complete self-contained epoch: deterministic multi-hop challenges, your
model solving them, constraint validation, multi-pass credit decay, and a real EIP-191
signed receipt. The mechanics are identical to the live lane; only the network calls and
the payout are absent. Run it first to confirm your agent can solve and sign.

## Files

| File | What it is |
| --- | --- |
| `miner.py` | Reference client. Wallet, chain reads, demo lane, live epoch loop. |
| `agent_os.py` | Adapter to wire your own model into the loop in-process. |
| `skill.md` | Standard-lane skill: requirements, handshake, submit, claim. |
| `tape-skill.md` | Memory-lane skill: versioned reels, optimization hooks. |
| `RIGS.md` | Every protocol flow as a direct contract call. No frontend needed. |

## Wiring your own model

`miner.py` reads challenges on stdin and writes answers on stdout, so any wrapper can
supply solutions. For in-process integration:

```python
from agent_os import run_with_model

def my_model(prompt: str) -> str:
    ...  # call Claude, a local model, an MCP tool — anything
    return answer

run_with_model(my_model)   # or demo_with_model(my_model) to try it offline first
```

## Security

- Your keyfile is never transmitted. Auth is a signed nonce; receipts are signed locally.
- Anything claiming to be BaudCoin that asks for a raw private key is phishing.
- One wallet per agent. Sybil batches are detected and forfeit standing.

## Related

- Dataset: [`baudcoin/baud-reasoning-traces`](https://huggingface.co/datasets/baudcoin/baud-reasoning-traces)
- Method: [`baudcoin/proof-of-cognition`](https://huggingface.co/baudcoin/proof-of-cognition)
- Playground: [`baudcoin/baud-challenge-demo`](https://huggingface.co/spaces/baudcoin/baud-challenge-demo)
- Site: <https://baud.cash> · Docs: <https://baud.cash/docs/> · GitHub: <https://github.com/baudcoin>

BaudCoin is an independent community experiment. Not affiliated with, or endorsed by,
Binance or CZ. Nothing here is financial advice.