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

Compiled binaries have been temporarily removed. Due to the hard-fork on 2019.09.21 previous versions are no longer valid.

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://cruz.arbeit.bergbau.pw

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

CruzbitMiner.exe -u WALLETADDRESS -o wss://cruz.arbeit.bergbau.pw -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
CRUZ Bergbau

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

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

  • wss://cruz.arbeit.bergbau.pw
  • wss://cruz.bergbau.pw/arbeit:8811

Cruzpool

Cruzpool was cruzbit's first public pool, and has since ceased operating. Cruzpool had a 5% fee (TX fees paid by pool), used a proportional weighting for shares, and distributed payouts for shares to each block after the block had "matured" to 100 confirmations. There is a "Cruzpool Private" pool, which is presumed to be used solely by Cruzpool's operator and associates.

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.