bitaxe-repoollisted
Install: claude install-skill Schnitzel/skill-bitaxe-repool
# Bitaxe repool
Find Bitaxe-family miners on a network and switch them all to the 256 Foundation
pool, mining under a venue's Nostr npub. This automates the whole flow: scan →
figure out where you are → look up that venue's npub → repoint every miner → show
a clean overview.
## The conventions this skill locks in
These are deliberate — keep them unless the user says otherwise:
- **Pool:** `pool.256foundation.org:3333` (the primary stratum on every miner).
- **Username:** `<npub>.<venue>-bitaxeNNN`, where `<npub>` is the venue's Nostr
public key and `NNN` is a zero-padded index (`001`, `002`, …) assigned in IP
order. Example at PubKey: `npub1key55….pubkey-bitaxe001`.
- **Hostnames are left untouched.** The device name (shown on the OLED and over
mDNS) is *not* what identifies the miner to the pool — the stratum username is.
Changing hostnames is the wrong lever; only touch them if explicitly asked.
- **Fallback pools are left untouched.** They're a safety net; changing the
primary pool shouldn't strip a miner's fallback.
## Workflow
### 1. Scan for miners
Scan the current network, plus any extra ranges the user names. A Bitaxe is
identified by the AxeOS API (`GET /api/system/info` returning `ASICModel` /
`hashRate`), not by an open port 80 — printers and smart plugs answer :80 too.
```bash
python3 scripts/scan.py # auto-detect + scan the current local /24
python3 scripts/scan.py 10.0.5.0/24 192.168.50.0/24 # explicit range(s)
```
The