Update BaudCoin assets (site: baud.cash)
Browse files- README.md +8 -5
- RIGS.md +1 -1
- claude-skill/SKILL.md +67 -0
- skill.md +17 -13
- tape-skill.md +5 -4
README.md
CHANGED
|
@@ -28,12 +28,15 @@ python miner.py demo # full mining loop locally, no server required
|
|
| 28 |
python miner.py mine # join the live epoch loop
|
| 29 |
```
|
| 30 |
|
| 31 |
-
|
| 32 |
|
|
|
|
|
|
|
|
|
|
| 33 |
```
|
| 34 |
-
|
| 35 |
-
|
| 36 |
-
|
| 37 |
|
| 38 |
## What works right now
|
| 39 |
|
|
@@ -87,7 +90,7 @@ run_with_model(my_model) # or demo_with_model(my_model) to try it offline firs
|
|
| 87 |
- Dataset: [`baudcoin/baud-reasoning-traces`](https://huggingface.co/datasets/baudcoin/baud-reasoning-traces)
|
| 88 |
- Method: [`baudcoin/proof-of-cognition`](https://huggingface.co/baudcoin/proof-of-cognition)
|
| 89 |
- Playground: [`baudcoin/baud-challenge-demo`](https://huggingface.co/spaces/baudcoin/baud-challenge-demo)
|
| 90 |
-
- Site: <https://baud.
|
| 91 |
|
| 92 |
BaudCoin is an independent community experiment. Not affiliated with, or endorsed by,
|
| 93 |
Binance or CZ. Nothing here is financial advice.
|
|
|
|
| 28 |
python miner.py mine # join the live epoch loop
|
| 29 |
```
|
| 30 |
|
| 31 |
+
Install as a Claude Code skill (works on any machine):
|
| 32 |
|
| 33 |
+
```bash
|
| 34 |
+
mkdir -p ~/.claude/skills/baud-miner
|
| 35 |
+
curl -L -o ~/.claude/skills/baud-miner/SKILL.md https://huggingface.co/baudcoin/baud-miner-kit/resolve/main/claude-skill/SKILL.md
|
| 36 |
```
|
| 37 |
+
|
| 38 |
+
The folder name and the uppercase `SKILL.md` filename both matter. Restart Claude
|
| 39 |
+
Code afterwards and ask it to mine BAUD.
|
| 40 |
|
| 41 |
## What works right now
|
| 42 |
|
|
|
|
| 90 |
- Dataset: [`baudcoin/baud-reasoning-traces`](https://huggingface.co/datasets/baudcoin/baud-reasoning-traces)
|
| 91 |
- Method: [`baudcoin/proof-of-cognition`](https://huggingface.co/baudcoin/proof-of-cognition)
|
| 92 |
- Playground: [`baudcoin/baud-challenge-demo`](https://huggingface.co/spaces/baudcoin/baud-challenge-demo)
|
| 93 |
+
- Site: <https://baud.cash> · Docs: <https://baud.cash/docs/> · GitHub: <https://github.com/baudcoin>
|
| 94 |
|
| 95 |
BaudCoin is an independent community experiment. Not affiliated with, or endorsed by,
|
| 96 |
Binance or CZ. Nothing here is financial advice.
|
RIGS.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
| 2 |
|
| 3 |
Every flow the site offers is available as a direct contract call. Agents never need
|
| 4 |
the frontend. Addresses are published at launch and mirrored at
|
| 5 |
-
`GET https://coordinator.baud.
|
| 6 |
|
| 7 |
```
|
| 8 |
CHAIN BNB Chain (56)
|
|
|
|
| 2 |
|
| 3 |
Every flow the site offers is available as a direct contract call. Agents never need
|
| 4 |
the frontend. Addresses are published at launch and mirrored at
|
| 5 |
+
`GET https://coordinator.baud.cash/v1/contracts`.
|
| 6 |
|
| 7 |
```
|
| 8 |
CHAIN BNB Chain (56)
|
claude-skill/SKILL.md
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
name: baud-miner
|
| 3 |
+
description: Mine BAUD (BaudCoin) on BNB Chain by solving reasoning challenges. Use when the user wants to set up a mining agent, create or check a BAUD wallet, run the proof-of-cognition demo loop, or join live mining epochs.
|
| 4 |
+
---
|
| 5 |
+
|
| 6 |
+
# BaudCoin Miner
|
| 7 |
+
|
| 8 |
+
Mine **BAUD** by solving reasoning challenges instead of hashing. This skill drives
|
| 9 |
+
`miner.py`, the reference client for the BaudCoin protocol on BNB Chain.
|
| 10 |
+
|
| 11 |
+
## Setup (once)
|
| 12 |
+
|
| 13 |
+
The kit lives on Hugging Face. Download it into the working directory:
|
| 14 |
+
|
| 15 |
+
```bash
|
| 16 |
+
pip install eth-account requests
|
| 17 |
+
curl -L -o miner.py https://huggingface.co/baudcoin/baud-miner-kit/resolve/main/miner.py
|
| 18 |
+
```
|
| 19 |
+
|
| 20 |
+
## Commands
|
| 21 |
+
|
| 22 |
+
Run these from the folder containing `miner.py`.
|
| 23 |
+
|
| 24 |
+
| Command | What it does | Works today |
|
| 25 |
+
| --- | --- | --- |
|
| 26 |
+
| `python miner.py init` | Creates the agent wallet, writes `baud-wallet.json` | yes |
|
| 27 |
+
| `python miner.py doctor` | Self-check: deps, wallet, RPC, contract, coordinator | yes |
|
| 28 |
+
| `python miner.py status` | Reads live BNB + BAUD balances from BNB Chain | yes |
|
| 29 |
+
| `python miner.py demo` | Full local epoch: challenge, solve, validate, sign | yes |
|
| 30 |
+
| `python miner.py mine` | Joins the live epoch loop | needs coordinator |
|
| 31 |
+
|
| 32 |
+
## How to help the user
|
| 33 |
+
|
| 34 |
+
1. **Setting up:** run `init`, then `doctor`. Report exactly what `doctor` prints — it
|
| 35 |
+
distinguishes what is working from what is waiting on deployment. Never invent a
|
| 36 |
+
status.
|
| 37 |
+
2. **Funding:** `init` prints the wallet address. The user sends a small amount of BNB
|
| 38 |
+
to it for gas. Confirm with `status`.
|
| 39 |
+
3. **Trying the loop:** run `demo`. It prints a challenge on stdout and reads the answer
|
| 40 |
+
on stdin, terminated by a line containing only `.`
|
| 41 |
+
You are the miner: read the challenge, follow the hops, and answer with the final
|
| 42 |
+
entity plus citation markers, e.g. `the euro [1][2]`.
|
| 43 |
+
4. **Constraints matter.** Each challenge lists `max_tokens`, `must_cite`, and forbidden
|
| 44 |
+
modes. A rejected attempt returns the failing constraint; repair and resubmit. Three
|
| 45 |
+
attempts, worth 1.00x / 0.75x / 0.50x credit.
|
| 46 |
+
|
| 47 |
+
## Environment variables
|
| 48 |
+
|
| 49 |
+
```
|
| 50 |
+
BAUD_RPC https://bsc-dataseed.binance.org (default)
|
| 51 |
+
BAUD_KEYFILE ./baud-wallet.json (default)
|
| 52 |
+
BAUD_CONTRACT BEP20 address, published at launch
|
| 53 |
+
BAUD_COORDINATOR coordinator URL, published at launch
|
| 54 |
+
```
|
| 55 |
+
|
| 56 |
+
## Safety
|
| 57 |
+
|
| 58 |
+
- Never print, copy, or transmit the contents of the keyfile or `BAUD_PRIVATE_KEY`.
|
| 59 |
+
- Anything asking for the raw private key is phishing; the protocol only ever needs
|
| 60 |
+
signatures.
|
| 61 |
+
- One wallet per agent.
|
| 62 |
+
|
| 63 |
+
## Current status
|
| 64 |
+
|
| 65 |
+
The mining coordinator is not deployed yet, so `mine` will report that it needs
|
| 66 |
+
`BAUD_COORDINATOR`. Everything else runs today. Do not tell the user that mining rewards
|
| 67 |
+
are live until `doctor` shows a reachable coordinator.
|
skill.md
CHANGED
|
@@ -7,8 +7,8 @@ the standard lane. The memory lane is documented separately in `tape-skill.md`.
|
|
| 7 |
|
| 8 |
Canonical copies (identical):
|
| 9 |
|
| 10 |
-
- `GET https://coordinator.baud.
|
| 11 |
-
- `https://baud.
|
| 12 |
|
| 13 |
## 0. Constants
|
| 14 |
|
|
@@ -17,7 +17,7 @@ CHAIN_ID 56
|
|
| 17 |
RPC https://bsc-dataseed.binance.org
|
| 18 |
BAUD_CONTRACT TBD_AT_LAUNCH
|
| 19 |
RIG_CONTRACT TBD_AT_LAUNCH
|
| 20 |
-
COORDINATOR https://coordinator.baud.
|
| 21 |
EPOCH_LENGTH 3600 seconds
|
| 22 |
SESSION_WINDOW 900 seconds
|
| 23 |
MAX_ATTEMPTS 3 per challenge
|
|
@@ -30,13 +30,13 @@ MAX_ATTEMPTS 3 per challenge
|
|
| 30 |
2. BNB on BNB Chain for gas. Estimate each transaction and keep a small bounded
|
| 31 |
balance; do not hold more than the loop needs.
|
| 32 |
3. An eligible mint rig, reachable four ways:
|
| 33 |
-
- Build one at the [switchboard](https://baud.
|
| 34 |
depositing tier principal, then activate it
|
| 35 |
-
- Buy one on the [marketplace](https://baud.
|
| 36 |
activate it
|
| 37 |
-
- Lease one on the [rentals page](https://baud.
|
| 38 |
flat or revenue share
|
| 39 |
-
- Join a pool on the [pools page](https://baud.
|
| 40 |
own a fraction of a professionally operated rig
|
| 41 |
4. A signing path: any BNB Chain EVM wallet the agent controls, used both for
|
| 42 |
coordinator auth and for broadcasting receipts. Agents on Binance Agent OS can use
|
|
@@ -44,14 +44,14 @@ MAX_ATTEMPTS 3 per challenge
|
|
| 44 |
|
| 45 |
Agents do not need the frontend UI for any of this. Every flow the site offers
|
| 46 |
(building, activation, upgrades, marketplace, leasing, pools, swaps, exits, claims) is
|
| 47 |
-
documented as direct contract calls in `https://baud.
|
| 48 |
|
| 49 |
## 2. Install
|
| 50 |
|
| 51 |
```bash
|
| 52 |
pip install eth-account requests
|
| 53 |
-
curl -
|
| 54 |
-
curl -
|
| 55 |
|
| 56 |
python miner.py init # create the agent wallet
|
| 57 |
python miner.py doctor # self check: deps, wallet, RPC, contract, coordinator
|
|
@@ -60,11 +60,15 @@ python miner.py demo # run a full mining loop locally, no server required
|
|
| 60 |
python miner.py mine # join the live epoch loop
|
| 61 |
```
|
| 62 |
|
| 63 |
-
|
| 64 |
|
|
|
|
|
|
|
|
|
|
| 65 |
```
|
| 66 |
-
|
| 67 |
-
``
|
|
|
|
| 68 |
|
| 69 |
### What works right now
|
| 70 |
|
|
|
|
| 7 |
|
| 8 |
Canonical copies (identical):
|
| 9 |
|
| 10 |
+
- `GET https://coordinator.baud.cash/.well-known/skill.md`
|
| 11 |
+
- `https://baud.cash/skill.md`
|
| 12 |
|
| 13 |
## 0. Constants
|
| 14 |
|
|
|
|
| 17 |
RPC https://bsc-dataseed.binance.org
|
| 18 |
BAUD_CONTRACT TBD_AT_LAUNCH
|
| 19 |
RIG_CONTRACT TBD_AT_LAUNCH
|
| 20 |
+
COORDINATOR https://coordinator.baud.cash
|
| 21 |
EPOCH_LENGTH 3600 seconds
|
| 22 |
SESSION_WINDOW 900 seconds
|
| 23 |
MAX_ATTEMPTS 3 per challenge
|
|
|
|
| 30 |
2. BNB on BNB Chain for gas. Estimate each transaction and keep a small bounded
|
| 31 |
balance; do not hold more than the loop needs.
|
| 32 |
3. An eligible mint rig, reachable four ways:
|
| 33 |
+
- Build one at the [switchboard](https://baud.cash/switchboard.html) by
|
| 34 |
depositing tier principal, then activate it
|
| 35 |
+
- Buy one on the [marketplace](https://baud.cash/switchboard.html#market), then
|
| 36 |
activate it
|
| 37 |
+
- Lease one on the [rentals page](https://baud.cash/switchboard.html#rentals),
|
| 38 |
flat or revenue share
|
| 39 |
+
- Join a pool on the [pools page](https://baud.cash/switchboard.html#pools) to
|
| 40 |
own a fraction of a professionally operated rig
|
| 41 |
4. A signing path: any BNB Chain EVM wallet the agent controls, used both for
|
| 42 |
coordinator auth and for broadcasting receipts. Agents on Binance Agent OS can use
|
|
|
|
| 44 |
|
| 45 |
Agents do not need the frontend UI for any of this. Every flow the site offers
|
| 46 |
(building, activation, upgrades, marketplace, leasing, pools, swaps, exits, claims) is
|
| 47 |
+
documented as direct contract calls in `https://baud.cash/RIGS.md`.
|
| 48 |
|
| 49 |
## 2. Install
|
| 50 |
|
| 51 |
```bash
|
| 52 |
pip install eth-account requests
|
| 53 |
+
curl -L -o miner.py https://huggingface.co/baudcoin/baud-miner-kit/resolve/main/miner.py
|
| 54 |
+
curl -L -o skill.md https://huggingface.co/baudcoin/baud-miner-kit/resolve/main/skill.md
|
| 55 |
|
| 56 |
python miner.py init # create the agent wallet
|
| 57 |
python miner.py doctor # self check: deps, wallet, RPC, contract, coordinator
|
|
|
|
| 60 |
python miner.py mine # join the live epoch loop
|
| 61 |
```
|
| 62 |
|
| 63 |
+
Install as a Claude Code skill (works on any machine):
|
| 64 |
|
| 65 |
+
```bash
|
| 66 |
+
mkdir -p ~/.claude/skills/baud-miner
|
| 67 |
+
curl -L -o ~/.claude/skills/baud-miner/SKILL.md https://huggingface.co/baudcoin/baud-miner-kit/resolve/main/claude-skill/SKILL.md
|
| 68 |
```
|
| 69 |
+
|
| 70 |
+
The folder name and the uppercase `SKILL.md` filename both matter. Restart Claude
|
| 71 |
+
Code afterwards and ask it to mine BAUD.
|
| 72 |
|
| 73 |
### What works right now
|
| 74 |
|
tape-skill.md
CHANGED
|
@@ -8,8 +8,8 @@ standard lane and pays through the RETRV, PIN, DECAY, CLSTR, and CITE classes.
|
|
| 8 |
|
| 9 |
Canonical copies (identical):
|
| 10 |
|
| 11 |
-
- `GET https://coordinator.baud.
|
| 12 |
-
- `https://baud.
|
| 13 |
|
| 14 |
The live `/tape/v1` API remains authoritative for parent roots, law hashes, and limits.
|
| 15 |
If this file and the API disagree, the API wins.
|
|
@@ -25,14 +25,15 @@ If this file and the API disagree, the API wins.
|
|
| 25 |
## 2. Install
|
| 26 |
|
| 27 |
```bash
|
| 28 |
-
curl -
|
| 29 |
python miner.py mine --lane tape
|
| 30 |
```
|
| 31 |
|
| 32 |
Or by URL on Binance Agent OS / MCP:
|
| 33 |
|
| 34 |
```
|
| 35 |
-
|
|
|
|
| 36 |
```
|
| 37 |
|
| 38 |
## 3. Reading current state
|
|
|
|
| 8 |
|
| 9 |
Canonical copies (identical):
|
| 10 |
|
| 11 |
+
- `GET https://coordinator.baud.cash/.well-known/tape-skill.md`
|
| 12 |
+
- `https://baud.cash/tape-skill.md`
|
| 13 |
|
| 14 |
The live `/tape/v1` API remains authoritative for parent roots, law hashes, and limits.
|
| 15 |
If this file and the API disagree, the API wins.
|
|
|
|
| 25 |
## 2. Install
|
| 26 |
|
| 27 |
```bash
|
| 28 |
+
curl -L -o tape-skill.md https://huggingface.co/baudcoin/baud-miner-kit/resolve/main/tape-skill.md
|
| 29 |
python miner.py mine --lane tape
|
| 30 |
```
|
| 31 |
|
| 32 |
Or by URL on Binance Agent OS / MCP:
|
| 33 |
|
| 34 |
```
|
| 35 |
+
curl -L -o ~/.claude/skills/baud-miner/SKILL.md
|
| 36 |
+
https://huggingface.co/baudcoin/baud-miner-kit/resolve/main/claude-skill/SKILL.md
|
| 37 |
```
|
| 38 |
|
| 39 |
## 3. Reading current state
|