Mining cruzbit

Introduction

Cruzbit miners collectively help to process new transactions, strengthen the network, and earn some cruz in the process. As the network grows, naturally so does the amount of computing power dedicated to the network, and the hardware used to mine evolves. Cruzbit has transitioned from CPU mining to primarily GPU mining. This page has instructions and files needed to start mining cruzbit blocks for both CPU and GPU hardware.

As the network gains more attention, developers are creating an increasing amount of software available to use for mining. Initially, only the reference client, which also acted as a peer on the network, was capable of mining cruzbit blocks. In time other developers released additional miners which were disconnected form the peer functionality, and are used solely for mining new blocks. Some of these miner software are capable of mining by getting work from peers on the network ("solo mining"), while others use the help of mining pools ("pooled mining"). Each of these types is discussed in its own section, below.

Mining Software

There are two (sometimes three) distict parts to mining which must be considered. The first is how to get work from the network, and the second is how that work will be processed. Most miners will only have to worry about the latter, however it's always good to be familiar with the entire process.

The cruzbit communication protocol has messages built in for communicating work between the network and miner software. This makes it easy to connect, regardless of how you choose to mine. When "solo mining" you can either mine directly in the client, or choose a specialty mining software which then connects to a client to request work. In "pooled mining," the mining software connects only to the pool, and the pool is connected to the network, so as network changes occur, the pool propagates work to each of the connected miners.

Reference Client

The client was the first software capable of mining cruzbit via CPU hardware upon release, and shortly after expanded to use GPU resources. It is still able to mine using both (though only one at a time), however many users have discovered that when GPU mining, there is lots of room for performance improvement. The reference client is not capable of connecting to a pool, and therefore can only be used for solo mining.

The full source code is available on Github, and additional instructions can be found on the official website.

Document Description
Client build with CUDA support Command line instructions for building the cruzbit client and wallet with the additional CUDA support library, for GPU mining
Client build with OpenCL support Command line instructions for building the cruzbit client with the additional OpenCL support library, for GPU mining
Windows 10 client build with OpenCL support Installation notes for compiling the cruzbit client with OpenCL support in Windows 10

Precompiled binaries are available to download for various operating systems, and hardware configurations. Compiling from source is the most reliable, and secure way to get the latest software. However, these binaries are made available by various people involved in the cruzbit community if you aren't comfortable with the command line, or simply want an easy way to get running quickly.

The archives include both the client and wallet executables. Where multiple links are listed for the same architecture, they are the same files available as different archive types.

  Architecture Build Date Download
Linux x86-64 2019-07-29 linux_amd64.tar.gz
linux_amd64.tar.xz
    2019-07-29 linux_amd64_cuda.tar.gz
linux_amd64_cuda.tar.xz
  Notes: Includes CUDA GPU miner support, requires CUDA Toolkit 10.1; set path to library: LD_LIBRARY_PATH=<PATH TO libcruzbit_cuda.so> client ...; set -numminers to the number of discrete cards in your system
    2019-07-30 linux_amd64_opencl.tar.gz
linux_amd64_opencl.tar.xz
  Notes: Includes OpenCL GPU miner support, requires OpenCL 1.2 or above AND CUDA Toolkit 10.1; included cruzbit.cl file must be in same directory as client; set path to library: LD_LIBRARY_PATH=<PATH TO libcruzbit_ocl.so> client ...; set -numminers to the number of discrete cards in your system
  ARMv8 2019-07-29 linux_armv8.tar.gz
  ARMv7 2019-07-29 linux_armv7.tar.gz
 
Windows x86-64 2019-07-29 windows_amd64.zip
    2019-07-29 windows_amd64_cuda.zip
  Notes: Includes CUDA GPU miner support, requires CUDA Toolkit 10.1; set -numminers to the number of discrete cards in your system; Compiled by Christian
    2019-07-29 windows_amd64_cuda_cpufix.zip
  Notes: This is an alternate version of the CUDA GPU version above. The changes to this version may reduce CPU usage while mining, however mining performance may be reduced (code change here). Requires CUDA Toolkit 10.1; compiled by Christian
    2019-08-? cruzbit-opencl-client-30-threads.rar
  Notes: OpenCL client support (for further details see the build instructions). Requires CUDA Toolkit 10.1; compiled by The AllFather
    N/A windows_bat.zip
  Notes: Includes two .bat scripts which can be used to easily open the wallet or client without using the command line; edit the files with a text editor to customize them; created by Big Shoots
 
macOS x86-64 2019-07-29 macos_amd64.zip
macos_amd64.tar.gz
asdvxgxasjab's Miner

The "reference miner" was created by asdvxgxasjab after Protovist's ccminer was released. Unlike ccminer, the reference miner is completely open source, written in Go (same as the reference client), giving the ability for any developer to optimize or adapt it to any use. It is based heavily on the reference client code, however is completely separate from the network peer and wallet functionalities, generally making much more easily understandable code, and smaller executable sizes.

The source code is available on Github and includes instructions to compile a binary version.

  Architecture Build Date Download
Linux x86-64 2019-08-17 linux_amd64_opencl_miner.tar.gz
  Notes: Includes OpenCL GPU miner support, requires appropriate OpenCL libraries for your card, for example: CUDA Toolkit 10.1 for Nvidia

Usage example:

LD_LIBRARY_PATH=/usr/local/lib ./miner -pubkey WALLETADDRESS -peer cruzpool.cruzb.it:8811

Ensure LD_LIBRARY_PATH points to the directory where you installed or extracted libcruzbit_ocl.so (this is typically /user/local/lib)

Protovist's ccminer

ccminer is an open source mining software designed for mining with CUDA compatibile GPUs. The original project was built by Christian Buchner's & Christian H. That version has become stagnant, and a new fork is now maintained by Tanguy Pruvot.

Discord user Protovist has used ccminer as a base for adding in the functionality required to mine cruzbit. Protovist's ccminer can connect to both peers and pools for solo and pooled mining functionality. The software was initially closed source at release, but has since been open sourced to satisfy the original GPL license. It uses a feature of the cruzbit protocol to selectively mine to Protovist's wallet address (initially at a theoretical rate of 20%, which has since been reduced to 5%), commonly called a "developer fee."

The code is available on Github.

  Architecture Build Date Download
Linux x86-64 2019-09-02 ccminer-cruzbit
  Notes: Ubuntu 18.04 compatible;
changelog from 2019-08-13 version: dev fee reduced to 5%, claimed ~50% faster; "Use -i22 for 1070/1070ti"
    2019-08-14 ccminer-cruzbit-1604
  Notes: Ubuntu 16.04 compatible; for use with Hive OS
      run_example
  Notes: A demonstration Bash script which can be used to run ccminer; edit this file to include your settings and public key

Usage examples:

Where -i is intensity (max 30)

Cruzpool Miner

The cruzpool miner was developed by Discord user Cruzpool concurrently with the Cruzpool pool software. According to Cruzpool, it is written in ("ugly" - Cruzpool's words) C, and has not yet been released. Hardware compatibility is unknown, beyond that it was built using multiple 1080ti mining rigs as a testbench.

CruzbitMiner Miner

The "CruzbitMiner" software was released 2019-08-17. It is closed source, and initially only available for Windows. A linunx binary (targeted at Ubuntu) was released on 2019-08-21. The author claims rates of 1.24GH/s on one 1080Ti. It supports both pool and solo (via peer) mining. There is a 2% dev fee.

Precompiled binaries are available on Github.

Usage example:

CruzbitMiner.exe -u WALLETADDRESS -o wss://cruzpool.cruzb.it:8811

Load may be specified per-card with the -l option and a (ordered) comma separated list of values:

CruzbitMiner.exe -u WALLETADDRESS -o wss://cruzpool.cruzb.it:8811 -l 28000,24000,22000,20000
Mining Pools

Mining pools reduce the variance of solo mining by combining computing power from multiple workers, and distributing rewards among a larger collection of users.

Pool Description
Cruzpool

Cruzpool is considered highly experimental, and warns that loss of rewards may happen however, in practice, it has to-date been generally considered to be working and stable, and issuing fair payouts. Cruzpool currently has a 5% fee (TX fees paid by pool), uses a proportional weighting for shares, and distributes payouts for shares to each block after the block has "matured" to 100 confirmations.

Cruzpool operates over port 8811 and can be connected to using the following URI schemes:

  • wss://cruzpool.cruzb.it:8811
  • wss://159.65.241.209:8811

Note that Cruzpool was given the use of a subdomain under this website's primary domain name, however there is no further relationship between the two. This website and Cruzpool are under separate control.

CRUZ Bergbau

CRUZ Bergbau (German, "CRUZ Mining") is the second pool to be released publicly. At launch it advertized no pool fee for the first 100 blocks found. Unlike Cruzpool, it has a minimum payout threshold of 10 cruz. It is compatible with Protovist's ccminer.

CRUZ Bergbau can be connected to using the following URI schemes:

  • stratum+wss://cruz.bergbau.pw/arbeit