BloxMiner

High-Performance VerusHash v2.2 CPU Miner for Verus Coin

Warning

This project is in beta and not ready for production use. Expect breaking changes, incomplete features, and rough edges. Use at your own risk.

Index

Installation
Usage
Configuration
Features
API
Requirements
Algorithm
License

Installation

One-Line Install (Recommended)

curl -sL https://raw.githubusercontent.com/bokiko/bloxminer/master/install.sh | bash

The installer will:

Install build dependencies (cmake, libssl-dev, etc.)
Clone and build BloxMiner to ~/bloxminer
Prompt for your wallet, pool, worker name, and thread count
Save configuration to ~/bloxminer/bloxminer.json
Create run scripts and offer to start mining

Manual Install

# Install dependencies
sudo apt update
sudo apt install build-essential cmake libssl-dev git

# Clone and build
git clone https://github.com/bokiko/bloxminer.git ~/bloxminer
cd ~/bloxminer
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)

# Run (interactive setup on first run if no config exists)
./bloxminer

Updating

Run the installer again - it will detect existing installation and offer to update:

curl -sL https://raw.githubusercontent.com/bokiko/bloxminer/master/install.sh | bash
# Choose [U] Update when prompted (default)

Or update manually:

cd ~/bloxminer
git pull
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)

HiveOS

Quick Install (Terminal)

curl -sL https://raw.githubusercontent.com/bokiko/bloxminer/master/h-install.sh | bash

The installer automatically:

Installs build dependencies
Detects Zen 2/Zen 3 CPUs and disables AVX-512 (prevents crashes)
Sets up RAPL power monitoring with persistent udev rules
Builds optimized binary for your CPU

Flight Sheet Setup

Create New Flight Sheet
- Coin: VRSC (Verus)
- Wallet: Select your Verus wallet
- Pool: Configure your pool (e.g., pool.verus.io:9999)
Add Miner
- Miner: Custom
- Installation URL:
```
https://raw.githubusercontent.com/bokiko/bloxminer/master/h-install.sh
```
- Hash algorithm: verushash
- Wallet and worker template: %WAL%.%WORKER_NAME%
- Pool URL: %URL%
- Pass: Number of threads (e.g., 32) or leave empty for auto
Apply Flight Sheet to your rig

Flight Sheet Fields

Field	Value	Notes
Miner	`custom`	Required
Installation URL	`https://raw.githubusercontent.com/bokiko/bloxminer/master/h-install.sh`	First install only
Miner name	`bloxminer`	After install
Hash algorithm	`verushash`
Wallet template	`%WAL%.%WORKER_NAME%`	Your wallet.worker
Pool URL	`stratum+tcp://pool.verus.io:9999`	Your pool
Pass	`32`	Thread count (optional)

Important: After first install, clear the Installation URL field (leave empty). HiveOS parses the miner name from the URL, which can cause issues if left populated.

HiveOS Features

Auto CPU Detection: Zen 2/Zen 3 (Ryzen 3000/5000) automatically built without AVX-512
Power Monitoring: CPU power via RAPL shown in miner stats
Stats Integration: Hashrate, temperature, accepted/rejected shares reported to HiveOS dashboard
Per-Thread Stats: Individual thread hashrates visible in miner output

Updating on HiveOS

Re-run the installer to update:

curl -sL https://raw.githubusercontent.com/bokiko/bloxminer/master/h-install.sh | bash

Or via Miner actions in HiveOS web interface.

Usage

After installation, run the miner:

# Using run script (recommended)
cd ~/bloxminer && ./run.sh

# Run in background
cd ~/bloxminer && ./run-background.sh

# View logs (background mode)
tail -f ~/bloxminer/miner.log

# Stop miner
pkill -f bloxminer

Command Line Options

./bloxminer [options]

Option	Description	Default
`-c, --config`	Config file path	bloxminer.json
`-o, --pool`	Pool address (host:port). Repeat for failover	From config
`-u, --user`	Wallet address	From config
`-w, --worker`	Worker name	hostname
`-p, --pass`	Pool password	x
`-t, --threads`	Mining threads (0 = auto)	Auto-detect
`-q, --quiet`	Quiet mode (warnings/errors only)	Off
`--api-port`	API port (0 to disable)	4068
`--api-bind`	API bind address	127.0.0.1

Examples

# Use saved config (recommended)
./bloxminer

# Override thread count
./bloxminer -t 8

# Full command line (no config needed)
./bloxminer -o pool.verus.io:9999 -u RYourWalletAddress -w rig1 -t 4

# Multiple failover pools
./bloxminer -o pool.verus.io:9999 -o na.luckpool.net:3956 -u RYourWalletAddress

Install as System Service

sudo cp ~/bloxminer/bloxminer.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable bloxminer
sudo systemctl start bloxminer

Configuration

BloxMiner saves settings to bloxminer.json so you don't need to enter them every time.

First Run (Interactive Setup)

If no config file exists and no wallet is provided via CLI, the miner prompts for configuration:

========================================
   BloxMiner First-Run Setup
========================================

Enter your Verus (VRSC) wallet address:
> RYourWalletAddress

Enter pool address [pool.verus.io:9999]:
>

Enter worker name [hostname]:
> rig1

Enter thread count (1-32) [auto=32]:
>

Save this configuration? [Y/n]: y
Configuration saved to bloxminer.json

Config File Format

{
  "wallet": "RYourWalletAddress",
  "pools": [
    {"host": "pool.verus.io", "port": 9999},
    {"host": "na.luckpool.net", "port": 3956}
  ],
  "worker": "rig1",
  "threads": 0,
  "api": {
    "enabled": true,
    "port": 4068,
    "bind": "127.0.0.1"
  }
}

Config File Locations

./bloxminer.json (current directory - checked first)
~/.config/bloxminer/config.json (user global)

Edit Configuration

nano ~/bloxminer/bloxminer.json

Features

Category	Features
Performance	VerusHash v2.2, AES-NI acceleration, AVX2 optimizations, thread affinity
Reliability	Failover pools, exponential backoff (5s→60s), auto pool switching after 3 failures, primary pool retry every 5 min
Monitoring	htop-style display, per-thread hashrates, CPU temp, separate CPU/GPU power (RAPL + hwmon)
Compatibility	Multi-threaded auto-detect, Stratum v1, all major pools, HiveOS ready

Live Stats Display

+--------------------------------------------------------------+
|  BloxMiner v1.1.1 - VerusHash CPU Miner                      |
+--------------------------------------------------------------+
|  Hashrate: 26.97 MH/s     Accepted: 132      Rejected: 0     |
|  55C   CPU: 101W  GPU: N/A  Eff: 268 KH/W    Up: 1h 24m      |
|  Pool: pool.verus.io:9999                    Diff: 128       |
+--------------------------------------------------------------+
|  Thread hashrates (KH/s):                                    |
|  897 899 842 853 840 833 847 848 839 841 825 827 822 825 ... |
+--------------------------------------------------------------+

CPU/GPU Power: Separate readings from RAPL (CPU) and hwmon (AMD GPU)
Efficiency: Hashrate per watt (KH/W)
Scroll region: Logs scroll below header without overwriting stats

API

BloxMiner exposes a JSON API on port 4068:

curl http://localhost:4068

{
  "miner": "BloxMiner",
  "version": "1.1.1",
  "algorithm": "verushash",
  "uptime": 12345,
  "hashrate": {
    "total": 26970.5,
    "threads": [897.4, 899.2, 842.1, ...],
    "unit": "KH/s"
  },
  "shares": {
    "accepted": 132,
    "rejected": 0
  },
  "hardware": {
    "threads": 32,
    "temp": 55,
    "cpu_power": 101.0,
    "gpu_power": 0.0,
    "efficiency": 268.0,
    "efficiency_unit": "KH/W"
  }
}

Requirements

Category	Requirement
OS	Ubuntu 20.04+, Debian 11+, HiveOS
CPU	x86-64 with AES-NI, AVX2, PCLMULQDQ
Compiler	GCC 9+ or Clang 10+
Build	CMake 3.16+, OpenSSL dev libs

Most Intel (Haswell+) and AMD (Zen+) processors are supported.

Algorithm

VerusHash v2.2 combines multiple cryptographic primitives for ASIC resistance:

Block Data (1487 bytes)
    |
    v
Haraka512 Chain (AES-NI accelerated)
    |
    v
Key Generation (8832 bytes via Haraka256)
    |
    v
CLHash v2.2 (32 iterations + AES mixing)
    |
    v
Final Haraka512 (keyed)
    |
    v
Hash Result (32 bytes)

License

MIT License - see LICENSE for details.

Acknowledgments

VerusCoin Team - Original VerusHash implementation
ccminer-verus - Reference CPU implementation
Daniel Lemire - CLHash algorithm

GitHub • Verus.io

Made by @bokiko

Name		Name	Last commit message	Last commit date
Latest commit History 70 Commits
.claude/tsc-cache/16716aa1-bf96-42a8-89cc-43fd2bc1521f		.claude/tsc-cache/16716aa1-bf96-42a8-89cc-43fd2bc1521f
include		include
src		src
tests		tests
.gitignore		.gitignore
CMakeLists.txt		CMakeLists.txt
LICENSE		LICENSE
README.md		README.md
h-install.sh		h-install.sh
h-stats.sh		h-stats.sh
install.sh		install.sh
pgo-build.sh		pgo-build.sh

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

BloxMiner

Index

Installation

One-Line Install (Recommended)

Manual Install

Updating

HiveOS

Quick Install (Terminal)

Flight Sheet Setup

Flight Sheet Fields

HiveOS Features

Updating on HiveOS

Usage

Command Line Options

Examples

Install as System Service

Configuration

First Run (Interactive Setup)

Config File Format

Config File Locations

Edit Configuration

Features

Live Stats Display

API

Requirements

Algorithm

License

Acknowledgments

About

Uh oh!

Releases 4

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

BloxMiner

Index

Installation

One-Line Install (Recommended)

Manual Install

Updating

HiveOS

Quick Install (Terminal)

Flight Sheet Setup

Flight Sheet Fields

HiveOS Features

Updating on HiveOS

Usage

Command Line Options

Examples

Install as System Service

Configuration

First Run (Interactive Setup)

Config File Format

Config File Locations

Edit Configuration

Features

Live Stats Display

API

Requirements

Algorithm

License

Acknowledgments

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 4

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages