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.
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.
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.
|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.
|Notes:||Includes CUDA GPU miner support, requires CUDA Toolkit 10.1; set path to library:
|Notes:||Includes OpenCL GPU miner support, requires OpenCL 1.2 or above AND CUDA Toolkit 10.1; included
|Notes:||Includes CUDA GPU miner support, requires CUDA Toolkit 10.1; set
|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|
|Notes:||OpenCL client support (for further details see the build instructions). Requires CUDA Toolkit 10.1; compiled by The AllFather|
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.
|Notes:||Includes OpenCL GPU miner support, requires appropriate OpenCL libraries for your card, for example: CUDA Toolkit 10.1 for Nvidia|
LD_LIBRARY_PATH=/usr/local/lib ./miner -pubkey WALLETADDRESS -peer cruzpool.cruzb.it:8811
LD_LIBRARY_PATH points to the directory where you installed or extracted
libcruzbit_ocl.so (this is typically
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."
|Notes:||Ubuntu 18.04 compatible;
changelog from 2019-08-13 version: dev fee reduced to 5%, claimed ~50% faster; "Use
|Notes:||Ubuntu 16.04 compatible; for use with Hive OS|
|Notes:||A demonstration Bash script which can be used to run ccminer; edit this file to include your settings and public key|
./ccminer -a cruz -o stratum+wss://localhost:8831/ -i 26 -u WALLETADDRESS
./ccminer -a cruz -o stratum+wss://cruzpool.cruzb.it:8811 -i 26 -u WALLETADDRESS
-i is intensity (max 30)
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.
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.
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 reduce the variance of solo mining by combining computing power from multiple workers, and distributing rewards among a larger collection of users.
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:
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 (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: