==============================================
     ****  C64 CHAIN  -  CPU MINER  ****
 ==============================================
     RANDOMX RX/C64    CPU MINING    ANY PC
     NO GPU   .   NO ASIC   .   FAIR LAUNCH
 ----------------------------------------------
     READY.
     ▓

C64 Miner

CPU-only RandomX miner for C64 Chain — a privacy coin with genuine Commodore 64 soul. Mine it from any PC.

C64 Miner is the CPU mining software for C64 Chain, forked from XMRig. It ships with an integrated Commodore 64–themed ncurses TUI: real-time hashrate, accepted / rejected blocks, difficulty, and a Datasette loading animation on startup.

---

Why mine C64 Chain?

C64 Chain uses RandomX (rx/c64) — a CPU-friendly proof-of-work. That has real consequences:

• 🧑‍💻 CPU-only, by design. No GPU farms, no ASICs. Any reasonably modern processor — even a laptop — can take part. Mining stays in the hands of regular people.
• 🔒 Private by default. Built on CryptoNote/Monero technology — ring signatures, stealth addresses and RingCT — so your activity stays yours.
• 📼 Genuine 8-bit soul. A built-in Commodore 64–style interface, complete with a Datasette loading animation. A working miner that also happens to be a love letter to 8-bit computing.

No hype, no promises of riches — just fair CPU mining with a bit of personality.

---

Features

• 🖥️ C64-themed ncurses TUI — built into the binary
• ⚡ Optimized CPU mining — RandomX (rx/c64 variant)
• 📊 Real-time stats — hashrate, accepted, rejected, difficulty
• 🎮 Datasette animation on startup

---

Prerequisites

Before mining, you need:

1. A running C64 Chain node — see c64chain-mainnet to install and run the node.
2. A C64 wallet address — create one with c64wallet (see the c64chain README).

The miner connects to your local node via RPC. The node must be running before you start the miner.

---

Quick Start

Option A — Pre-compiled binary (Ubuntu 24.04 x86_64)

Download c64miner from Releases, then:

wget https://github.com/oxynaz/c64miner/releases/download/v0.2.1/c64miner-v0.2.1-ubuntu24-x86_64.tar.gz
tar xzf c64miner-v0.2.1-ubuntu24-x86_64.tar.gz
mkdir -p ~/c64miner
mv c64miner ~/c64miner/

Option B — Build from source

sudo apt update
sudo apt install -y build-essential cmake libuv1-dev libssl-dev \
    libncurses5-dev libncursesw5-dev libhwloc-dev git

git clone https://github.com/oxynaz/c64miner.git
cd c64miner
mkdir build && cd build
cmake .. -DWITH_OPENCL=OFF -DWITH_CUDA=OFF -DWITH_HWLOC=OFF
make -j$(nproc)

Updating to a new version

cd ~/c64miner
git pull --tags
rm -rf build
mkdir build && cd build
cmake .. -DWITH_OPENCL=OFF -DWITH_CUDA=OFF -DWITH_HWLOC=OFF
make -j$(nproc)

---

Configuration

Create a config.json in ~/c64miner/:

{
    "autosave": false,
    "donate-level": 0,
    "cpu": {
        "enabled": true
    },
    "opencl": false,
    "cuda": false,
    "pools": [
        {
            "url": "127.0.0.1:19641",
            "user": "YOUR_C64_WALLET_ADDRESS_HERE",
            "algo": "rx/c64",
            "coin": "c64chain",
            "daemon": true,
            "daemon-poll-interval": 1000
        }
    ],
    "print-time": 5
}

⚠️ Important notes about the config:

• "daemon": true is required. Without it the miner tries stratum mode and fails.
• "coin": "c64chain" is required. This tells the miner to use the rx/c64 algorithm.
• "url" must point to your running node's RPC port (127.0.0.1:19641).

LAN mining

If another machine on your local network is running the node, point the miner at its local IP instead:

{
    "url": "192.168.X.X:19641",
    "daemon": true
}

The node machine must be started with --rpc-bind-ip=0.0.0.0 --confirm-external-bind. No node is needed on the miner-only machines.

Config parameters reference

Parameter	Value	Description
url	127.0.0.1:19641	Node RPC address
user	9...	Your C64 Chain wallet address
algo	rx/c64	Mining algorithm
coin	c64chain	Required — identifies the coin and algorithm
daemon	true	Required — enables daemon RPC mode (not stratum)
daemon-poll-interval	1000	How often to poll for new blocks (ms)
-t N	number	Number of CPU threads (leave 1–2 for the system)

---

Run

⚠️ Make sure your C64 Chain node is running first!

If you built from source:

cd ~/c64miner
sudo ./build/c64miner -c config.json -t $(nproc)

If you downloaded the pre-compiled binary:

cd ~/c64miner
sudo ./c64miner -c config.json -t $(nproc)

Always run with sudo for best performance. This enables huge pages and MSR register optimizations, which can improve hashrate by 30–50%.

Run in the background with screen

screen -dmS miner bash -c "cd ~/c64miner && sudo ./build/c64miner -c config.json -t \$(nproc)"

View the miner TUI with screen -r miner (detach with Ctrl+A then D).

---

Troubleshooting

Problem	Cause	Fix
Miner exits immediately	Node not running	Start the node first
connect error	Wrong RPC port	Check url in config.json
login failed	Missing daemon: true	Add "daemon": true to your config.json
algorithm not found	Missing coin field	Add "coin": "c64chain" to your config.json
Low hashrate	Not running as root	Run with sudo for huge pages
config not found	Wrong directory	config.json must be in ~/c64miner/, not build/

Note: The old values "coin": "wownero" and "algo": "rx/wow" are still supported for backward compatibility, but "coin": "c64chain" and "algo": "rx/c64" are recommended.

---

⚡ Join the community — PulseMining

C64 Chain is mined and discussed inside PulseMining, a community for people who like to spot good mining projects early — and actually understand what they're mining.

• 🌍 Fully multilingual, translated in real time (FR · EN · ES · RU) — follow the whole international community without missing a thing.
• 💎 Signal over noise — promising projects surfaced and discussed, not endless hype.
• 🛠️ Real support — wallet stuck, miner acting up? You're never on your own.
• 🤝 Builders welcome — tinkering on a miner, a pool, a tool? Here you're not a spectator. Pools, devs and partners are already in.

No promises of miracle gains — just people who'll help you move forward.

You mine. We handle the rest. 🚀

👉 Join PulseMining: https://discord.gg/VQxP4TDZTC

C64 Chain links

• 🔎 Block explorer: c64chain.com
• 📦 Node & wallet: github.com/oxynaz/c64chain-mainnet
• 💬 C64 Chain official Discord: discord.gg/MTRgHT8r45

---

Credits & License

C64 Miner is a fork of XMRig.

Licensed under the GNU General Public License v3.0 — see LICENSE.

Modifications from XMRig:

• Integrated ncurses TUI with C64 aesthetics
• Added rx/c64 algorithm alias and c64chain coin support
• Fixed duplicate log lines in the TUI
• Rebranded to C64 Miner

All original XMRig copyrights remain intact.