Running the Zilliqa Client


Hardware Requirements

The Zilliqa Client is officially supported on Ubuntu 18.04 OS.

The minimum requirements for running the Zilliqa Client are:

  • x64 Linux operating system (e.g Ubuntu 18.04.5)
  • Recent dual-core processor @ 2.2 GHZ. Examples: Intel Xeon (Skylake)
  • 8GB DRR3 RAM or higher
  • Public static IP address
  • 50GB Solid State Drive
  • Any GPUs with at least 2 GB RAM
  • 100MB/s upload and download bandwidth
info

Hashing rate of the network is currently very high. A single GPU will be insufficient. You will need to setup mining proxy connecting to multiple GPUs.

Mining Steps

  1. Create a single local or remote CPU node instance with Ubuntu 18.04 OS installed following instructions HERE.

  2. Install Docker CE for Ubuntu on your CPU node instance by following instructions HERE.

  3. Make a new directory in your Desktop and change directory to it:

    cd ~/Desktop && mkdir join && cd join
  4. Get the joining configuration files:

    wget https://mainnet-join.zilliqa.com/configuration.tar.gz
    tar zxvf configuration.tar.gz
  5. Find out your current IP address in the command prompt and record it down:

    curl https://ipinfo.io/ip
note

Please consult the previous section if you are in a NAT environment.

  1. Edit your constant.xml file in your configuration folder:

    • Set GETWORK_SERVER_MINE to true.

    • Set GETWORK_SERVER_PORT to the port you will be using to GetWork. (default is 4202)

    • Set the following 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>
  2. Install the python dependencies:

    sudo apt install python-pip
    export LC_ALL=C
    pip install request requests clint futures
  3. Run the shell script in your command prompt to launch your docker image:

    ./launch_docker.sh
  4. You will be prompted to enter some information as shown below:

    note

    DO NOT duplicate your IP address and use different ports to create different CPU nodes. You will be blacklisted by the network and hence not be able to receive any rewards.

    • Assign a name to your container (default: zilliqa):
      [Press Enter to skip if using default]

    • Enter your IP address (*.*.*.*):
      [Key in your IP address as found in step 5]

    • Enter your listening port (default: 33133):
      [Press Enter to skip if using default]

Monitoring Progress

You are now a miner in the Zilliqa Mainnet. You can monitor your progress on your CPU node by using:

tail -f zilliqa-00001-log.txt

Checking Your Generated Keypairs

To check your locally generated public and private key pairs in your mykey.txt file, you can enter the following in your command prompt on your CPU node:

less mykey.txt

The first hex string is your public key, and the second hex string is your private key.

note

This key pair is generated locally on your disk. Do remember to keep your private key somewhere safe!

Checking Your $ZIL Balance

To check your balance for mining, input the address located in your myaddr.txt file in the search bar of https://viewblock.io/zilliqa:

less myaddr.txt

Stopping the Mining Process

To stop the mining client, stop the docker container running the Zilliqa Client on the CPU node:

sudo docker stop zilliqa