File size: 3,493 Bytes
cb0d6c4
 
fdb4876
 
 
 
 
 
 
 
 
cb0d6c4
fdb4876
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2237be0
fdb4876
2237be0
 
 
fdb4876
2237be0
 
 
fdb4876
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2237be0
fdb4876
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
---
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.