Experimental OpenCL based miner for TUNA

Please keep in mind this is an early experimental version of the miner, please report issues and the hash rates you get with your devices to the issue tracker on Github. Let's make it compatible with as many devices and operating systems as possible to improve decentralization!

this miner core can only calculate hashes, for submitting transactions it needs this fork of the official repo: https://github.com/nullhashpixel/fortuna

tips: $gputunaminer

Only tested on Linux (Ubuntu 20) so far. NOT compatible with WSL, Windows users please compile it with Visual Studio, see below.

For NVIDIA GPUs, the proprietary graphics driver is needed. On Ubuntu search for "Additional drivers" and select the latest Nvidia version. NOT the line which contains "Nouveau". After this, run:

apt update
apt install build-essential opencl-headers clinfo nvidia-opencl-dev

and then check with

clinfo

if number of platforms is > 0. (It is 1 in most cases with a single GPU and no special hardware)

git clone https://github.com/nullhashpixel/cltunaminer.git
cd cltunaminer

make

./cltuna

• Install CUDA Toolkit 12.2 from

https://developer.nvidia.com/cuda-downloads?target_os=Windows&target_arch=x86_64&target_version=11&target_type=exe_local

• Install Visual Studio from https://visualstudio.microsoft.com/downloads/

During the installation select "Building C++", no other options. This alone is a 18 GB download.

If you have git installed, run:

git clone https://github.com/nullhashpixel/cltunaminer.git
cd cltunaminer

otherwise you can also just download the repository.

• Create an empty project (search for "blank solution")

• copy the sha256.h to "Header files", the "sha256.c"+"main.c" to "Source files"

• Right click on your project name in the right panel, select properties

• Add the library and include paths of you CUDA Toolkit installation, the paths are not always exactly the same, but by default look like:

• Library path: C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.2\lib\x64

• Include path: C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.2\include

The Library path should contain an "OpenCL.lib" The include path should contain a folder "CL" with a file "cl.h"

This will create an exe file inside your project directory in a subfolder called Debug or Release

Copy the executable into your cltunaminer/ directory, where the sha256_opencl.cl is. Run it from there.

To be able to mine, you also need the custom fork of the TypeScript transaction building code from: https://github.com/nullhashpixel/fortuna

• Install and compile the miner core, see above steps 1-4

• Install the fortuna code and setup your wallet as described in the fortuna repository

• Start the mining core(s): ./cltuna

• Add the hostname(s) of your miner cores to the main.ts file of the mining code in the cltunaminer directory of the TypeScript code

Simple example for running with 1 local GPU:

const miners = [
        {port: 2023}
]

Running the code on two different machines in your network:

const miners = [
        {hostname: "192.168.0.100", port: 2023},
        {hostname: "192.168.0.101", port: 2023}
]

• (in a different terminal window): Start the TypeScript mining script with deno: deno task cltunaminer mine

• check the window of your GPU miner core, it should show you hash rates, estimates for how often solutions are found and the current difficulty

./cltuna 0.0.0.0 12345

Running the benchmark will not wait for connection from the mining script, just computes the hash rate.

./cltuna benchmark

If you experience occasional crashes of the miner, consider running it in an infinite loop with a delay.

while true; do ./cltuna; sleep 1; done

v1.1: 23/09/05 Windows compatibility
v1.0: 23/09/04 initial release

Multi GPU support
AMD cards untested

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.