zilminer

Zilliqa miner with OpenCL and CUDA support. It supports both Ubuntu and Windows OS.

zilminer is an Ethash GPU mining worker that support Zilliqa's Proof-of-Work process.

This project is a fork of ethminer. Please do see ethminer README for more details.

Features

Zilliqa Getwork protocol
Dual-Mining support
All ethminer features

Install

Standalone executables for Linux, macOS and Windows are provided in the Releases section. Download an archive for your operating system and unpack the content to a place accessible from command line. After which, the zilminer will be ready to go.

Usage

The zilminer is a command line program. This means you will have to launch it either from a Windows command prompt or Linux Bash console. You can also create shortcuts to predefined commands using a Linux Bash script or Windows batch/cmd file. For the full list of available commands, please enter the following:

zilminer --help

Settings on Zilliqa Node

Setup Zilliqa Node by following the Zilliqa Mining Guide
Change the constants.xml for the following parameter:
- Set GETWORK_SERVER_MINE to true.
- Set GETWORK_SERVER_PORT to the port you will be using to GetWork. (default is 4202)
- Set the other mining parameters to false:
```
<CUDA_GPU_MINE>false</CUDA_GPU_MINE>
<FULL_DATASET_MINE>false</FULL_DATASET_MINE>
<OPENCL_GPU_MINE>false</OPENCL_GPU_MINE>
<REMOTE_MINE>false</REMOTE_MINE>
```
Launch your node and find out your IP address with the following command:
```
curl https://ipinfo.io/ip
```

Settings on zilminer client

Key in the following command in your command prompt:

zilminer -P zil://wallet_address.worker_name@zil_node_ip:get_work_port

Please change the wallet_address, worker_name, zil_node_ip, and get_work_port accodingly.

For wallet_address: You can use the Zilliqa Wallet to create a new keypair and a Zilliqa address.
For worker_name You can key in any abitrary worker name you desire.
For zil_node_ip: Please key in the IP address of the Zilliqa node.
For get_work_port: Please key in the port used in GETWORK_SERVER_PORT. Default is 4202.

Dual Mining

Write 2 scripts yourself to start/stop other coin's miner.
Add arg --pow-start to stop other miner before ZIL PoW starting.
Add arg --pow-end to start other miner after ZIL PoW stopped.

example:

zilminer --pow-start stopAE.bat --pow-end startAE.bat -P zil://wallet_address.worker_name@zil_node_ip:get_work_port

[Optional] If your GPU memory is not enough, add arg --clear-dag to clear ZIL DAG after ZIL PoW stopped.

Dual Mining Scripts:

Zilminer + GMiner - Beam + ZIL

Write 2 batch files: start_beam.bat batch file to start beam miner:

taskkill /f /im miner.exe >null
START cmd /c "miner.exe --algo 150_5 --server beam-us.leafpool.com --port 4444 --ssl 1 --user walletxxx.namexxx"

stop_beam.bat batch file to stop beam miner:

taskkill /f /im miner.exe >null

Zilminer:

zilminer.exe --pow-start stop_beam.bat --pow-end start_beam.bat --pow-end-at-startup -P zil://wallet_address.worker_name@proxy.getzil.com:5000/api

If your GPU memory is not enghou for 2 miners, add zilminer arg --clear-dag

Build

Building from source

See docs/BUILD.md for build/compilation details.

cryptowhizzard/ZILMiner