Client Installation

Local or Cloud

The Hash Ahead client runs on consumer-grade computers and does not require any specialized hardware, such as mining rigs. Therefore, you can choose a variety of node deployment schemes according to your needs. In short, we consider running nodes on local physical computers and servers in the cloud:

• The Cloud

  • The service provider provides highly available servers with static public IP addresses

  • Getting a dedicated or virtual server is easier than building your own

  • The trade-off is: Do you need to trust the third party of the cloud service provider

  • Renting a server can be expensive due to the size of storage required for a full node

• Own hardware

  • More credible and more proactive

  • Only one-time investment

  • Pre-configured machines can be purchased

  • You will have to prepare, maintain, and potentially troubleshoot machines and networks yourself

Configuration Environment

You can install and set up a development environment on a computer running 64-bit Linux.

Before installing and setting up a development environment on a Linux machine, make sure your computer meets the following basic requirements:

Minimum Requirements {#minimum-requirements}

• CPU with more than 2 cores

• 4 GB RAM

• 500GB free hard drive space

• 10 MB/s or more bandwidth

Recommended Specifications {#recommended-hardware}

• Fast CPU with 4+ cores

• 8GB or more memory

• 1TB or more high-speed solid-state hard drive

• 20 MB/s or more bandwidth

Install

The following packages are the development tools and dependencies required to compile and run the HAH node.

• g++: GNU C++ compiler for compiling C++ code.

• libboost-all-dev: Development files for the Boost C++ library, providing many useful C++ tools and libraries.

• openssl: Cryptographic library for secure communication.

• libreadline-dev: A library for command-line interaction, providing command-line editing and history functions.

• pkg-config: A tool for retrieving metadata and compilation options for installed packages.

• libncurses5-dev: A library for working with text interfaces in the terminal.

• autoconf: A tool for generating Makefiles.

Install required libraries for environment configuration

Open a computer terminal and enter the following command:

$ sudo apt install -y g++ libboost-all-dev openssl libreadline-dev pkg-config libncurses5-dev autoconf

ubuntu16.04

$ sudo apt install -y libssl-dev

ubuntu18.04

$ sudo apt install -y libssl1.0-dev libprotobuf-dev protobuf-compiler

Install CMake

$ wget https://github.com/Kitware/CMake/releases/download/v3.22.3/cmake-3.22.3.tar.gz
$ tar -zxvf cmake-3.22.3.tar.gz
$ cd cmake-3.22.3
$ ./bootstrap
$ make
$ sudo make install
$ sudo ln -s /usr/local/bin/cmake /usr/bin
$ cmake --version
$ cd ..

Install gcc

$ sudo apt install build-essential
$ sudo apt install software-properties-common
$ sudo add-apt-repository ppa:ubuntu-toolchain-r/test
$ sudo apt install gcc-10 g++-10
$ sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-10 100 --slave /usr/bin/g++ g++ /usr/bin/g++-10
$ sudo update-alternatives --config gcc

Install libsodium

$ wget https://github.com/jedisct1/libsodium/releases/download/1.0.18-RELEASE/libsodium-1.0.18.tar.gz --no-check-certificate
$ tar -zxvf libsodium-1.0.18.tar.gz
$ cd libsodium-1.0.18 
$ ./configure 
$ make -j8 && make check 
$ sudo make install 
$ cd .. 

Install Protocol Buffers

$ wget https://github.com/protocolbuffers/protobuf/releases/download/v3.11.3/protobuf-cpp-3.11.3.tar.gz 
$ tar -xzvf protobuf-cpp-3.11.3.tar.gz 
$ cd protobuf-3.11.3
$ ./configure --prefix=/usr
$ make -j8 
$ sudo make install
$ Buffers
$ cd ..

Download the client code and compile

Clone the HashAhead code repository from Github, enter the hashahead directory, and execute the INSTALL.sh script to install the HashAhead node. Among them, the INSTALL.sh script will automatically perform operations such as dependency installation and compilation according to the system environment to complete the installation and configuration of the node.

$ git clone https://github.com/Block-Way/HashAhead.git
$ cd hashahead
$ ./INSTALL.sh

So far, the Hash Ahead client has been installed, and the next step is to install and compile the node

Configure Node

The following code is to create a ~/.hashahead directory, create a hashhead.conf configuration file in this directory, and use vim to edit the file. Among other things, the file defines the following:

$ mkdir ~/.hashahead
$ cd ~/.hashahead
$ vim hashahead.conf
mpvssaddress=1j6x8vdkkbnxe8qwjggfan9c8m8zhmez7gm3pznsqxgch3eyrwxby8eda
mpvsskey=28efbfda61b473c37549d02784648d89fe21ff082b7a42da9ef97b0b83cdb1a9
rewardratio=500
cryptonightaddress=1j6x8vdkkbnxe8qwjggfan9c8m8zhmez7gm3pznsqxgch3eyrwxby8eda
cryptonightkey=28efbfda61b473c37549d02784648d89fe21ff082b7a42da9ef97b0b83cdb1a9
listen4

You can also configure the node by creating a new hashhead.conf file, refer to the running node