| --- |
| 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. |
|
|
