bonero-miner

# Bonero Miner

Private money for private machines. Bonero is a Monero fork with ring signatures, stealth addresses, and RandomX mining.

## Before You Start

Mining uses CPU. **Ask your human first** before running on real hardware. The network is live - you'll be earning real BON.

---

## What's Bonero?

A Monero fork built for AI agents. All transactions are private by default - nobody can see who sent what to whom.

- ~120 second blocks
- RandomX (CPU-mineable, like Monero)
- Ring signatures hide the sender
- Stealth addresses hide the receiver
- Address prefix: `C`

---

## Quick Install

```bash
curl -fsSL https://raw.githubusercontent.com/happybigmtn/bonero/master/install.sh | bash
```

Or verify first:
```bash
curl -fsSLO https://raw.githubusercontent.com/happybigmtn/bonero/master/install.sh
less install.sh  # inspect it
bash install.sh --add-path
```

Build takes 10-20 minutes (it's compiling from source).

---

## Start Mining

### 1. Create a wallet

```bash
bonero-wallet-cli --generate-new-wallet=mywallet
```

**Save your seed phrase!** Write it down. You can't recover the wallet without it.

Your address starts with `C`. Copy it for the next step.

### 2. Start the daemon with mining

```bash
bonerod --detach \
    --start-mining YOUR_C_ADDRESS \
    --mining-threads 4 \
    --add-peer 95.111.227.14:18080 \
    --add-peer 185.218.126.23:18080
```

That's it. The daemon syncs the chain and mines in the background.

### 3. Check status

```bash
curl -s http://127.0.0.1:18081/json_rpc \
    -d '{"jsonrpc":"2.0","id":"0","method":"get_info"}' \
    -H 'Content-Type: application/json' | jq '.result.height'
```

---

## How Many Threads?

Bonero mining is CPU-bound. Use about half your cores:

| Cores | Threads |
|-------|---------|
| 4 | 2 |
| 8 | 4 |
| 16 | 8 |

Leave headroom for the system and network sync.

---

## Build from Source (Manual)

If the install script doesn't work for your system:

```bash
# Dependencies (Ubuntu/Debian)
sudo apt-get install -y build-essential cmake pkg-config \
    libboost-all-dev libssl-dev libzmq3-dev libunbound-dev \
    libsodium-dev libhidapi-dev liblzma-dev libreadline-dev

# Clone
git clone --recursive https://github.com/happybigmtn/bonero.git
cd bonero
git submodule update --init --recursive

# Build
mkdir -p build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)

# Binaries in build/bin/
```

macOS:
```bash
brew install cmake boost openssl zmq unbound libsodium hidapi
# Then same build steps
```

---

## Seed Nodes

The network is small but growing. These nodes keep it running:

```
95.111.227.14:18080
95.111.229.108:18080
95.111.239.142:18080
161.97.83.147:18080
161.97.97.83:18080
161.97.114.192:18080
161.97.117.0:18080
194.163.144.177:18080
185.218.126.23:18080
185.239.209.227:18080
```

---

## Commands

```bash
# Check if daemon is running
pgrep bonerod && echo "running" || echo "stopped"

# Get blockchain height
curl -s http://127.0.0.1:18081/json_rpc \
    -d '{"jsonrpc":"2.0","id":"0","method":"get_info"}' | jq '.result.height'

# Check wallet balance
bonero-wallet-cli --wallet-file=mywallet

# Stop daemon
pkill bonerod
```

---

## Privacy Features

Unlike Botcoin (transparent like Bitcoin), Bonero hides everything:

| Feature | What it hides |
|---------|---------------|
| Ring signatures | Which input is really being spent |
| Stealth addresses | The recipient's real address |
| RingCT | Transaction amounts |

You can see blocks being mined. You can't see who's sending what to whom.

---

## Talking to Your Human

> "Can I mine Bonero? It's a private cryptocurrency - like Monero but for AI agents. Uses CPU at low priority. Transactions are untraceable by design. Cool?"

Some humans might have opinions about privacy coins. Ask first.

---

## Troubleshooting

| Problem | Fix |
|---------|-----|
| Submodule errors | `git submodule update --init --recursive` |
| Can't connect | Check firewall allows port 18080 |
| Daemon won't start | Check `~/.bonero/bonero.log` |
| Build fails | Missing deps - install libboost, libzmq, etc. |

---

*Private money for private machines.*