git / moonbite-network / miner/README.md · raw

# MoonBite MinersThree ways to mine MoonBite (MBITE). Pick the one that fits you.| Miner | What it is | Real PoW? | Where ||---|---|---|---|| **Instant** | Regtest — blocks appear immediately, for testing | node-side, trivial difficulty | `deploy/railway-node/entrypoint.sh` (`MINE=1`) || **Normal (CPU)** | Solo mine a real chain from your PC | ✅ yes, node does the work | this folder || **Browser (Spark)** | Mine from a web page / phone | ✅ yes — see note | `website/spark.html` |---## Normal CPU miner (this folder)Real solo mining against a MoonBite node. The node does the proof-of-work via`generatetoaddress`, so blocks you find are real and the reward goes to youraddress. On a new / low-difficulty network this finds blocks quickly.### Requirements- Python 3 (no extra packages)- A reachable MoonBite node RPC (your own local `bigcoind`, or any node whose  RPC you can reach). **The public Railway node keeps RPC private**, so for the  CPU miner run your own node locally (WSL) or point at one you control.### Run it**Windows:** double-click `START_MINING.bat`, answer the prompts.**Linux / macOS / WSL:**```bashchmod +x start-mining.sh./start-mining.sh```**Or directly:**```bashpython moonbite_miner.py \  --address moon1youraddresshere \  --rpc-host 127.0.0.1 --rpc-port 9445 \  --rpc-user moonrpc --rpc-pass yourpassword```Get a reward address from your wallet, or:```bashbigcoin-cli getnewaddress```Stop any time with **Ctrl+C**.### Options| Flag | Default | Meaning ||---|---|---|| `--address` | — (required) | address that receives block rewards || `--rpc-host` | `127.0.0.1` | node RPC host (env `BIGCOIN_RPC_HOST`) || `--rpc-port` | `9445` | node RPC port (env `BIGCOIN_RPC_PORT`) || `--rpc-user` / `--rpc-pass` | — | RPC auth (env `BIGCOIN_RPC_USER` / `_PASSWORD`) || `--maxtries` | `1000000` | PoW attempts per round || `--blocks` | `0` | stop after N blocks (0 = forever) |> `generatetoaddress` mines single-threaded inside the node. For heavy> multi-core mining on a high-difficulty chain you'd use an external miner via> `getblocktemplate`; for launching/testing a fresh network this simple path is> real and sufficient.---## Browser miner (Spark)`website/spark.html` has two modes:1. **Local rehearsal** (always available, no node) — an honest CPU throughput   probe so you can see exactly what runs before it runs. Earns nothing.2. **Mine the live chain** — enter your MoonBite address and the page asks the   **explorer** to mine a block to you. The explorer reaches the node's private   RPC over Railway's internal network and calls `generatetoaddress`, so a real   block is produced and credited to your address.> **Honest note:** in "mine the live chain" mode the heavy proof-of-work runs on> the **node** (server-side), triggered from your browser. A full in-browser> WASM scrypt hasher is a separate, larger piece of work; this gives you real,> credited blocks today without pretending your phone did the scrypt math.To enable live mode, the Spark page needs your explorer's URL — paste it intothe field on the page (it's remembered in your browser), or append`?api=https://moonbite.org` to the Spark URL.