How to build - hadescoincom/hds-core GitHub Wiki

Starting from version 5.0 we separated core hds library project and its UI.

Desktop UI is a separte git repostotry now https://github.com/hadescoincom/hds-core-ui.

For earlier versions, build instructions are located here.

Before build

  1. Ensure that you have git installed
  2. hds-ui and hds project use CMake to generate build environment. The minimal supported version of CMake is 3.13
  3. Download and install boost library. The minimal supported version is 1.66
  4. Download and install OpenSSL library

Common part

  1. Clone Hds sources before building

    git clone https://github.com/hadescoincom/hds-core.git

  2. Hds has submodules

    cd hds-core
git submodule update --init --recursive

Branch convention

  1. We use master branch for development.
  2. To be able to connect to testnet you have to checkout testnet branch
  3. To be able to connect to mainnet you have to checkout mainnet branch

CMake options

Hds uses CMake to generate a build. Hds has several options to say how to build the project, which feature to turn ON/OFF. T Please, look reference to root CMakeLists.txt file.

Windows

  1. Install Visual Studio >= 2017 with CMake support.
  2. Download and install Boost prebuilt binaries https://sourceforge.net/projects/boost/files/boost-binaries/1.68.0/boost_1_68_0-msvc-14.1-64.exe, also add BOOST_ROOT to the Environment Variables.
  3. Download and install OpenSSL prebuilt binaries https://slproweb.com/products/Win32OpenSSL.html (Win64 OpenSSL v1.1.0h for example) and add OPENSSL_ROOT_DIR to the Environment Variables.
  4. Add .../boost_1_68_0/lib64-msvc-14.1 to the System Path.
  5. Open project folder in Visual Studio, select your target (Release-x64 for example, if you downloaded 64bit Boost and OpenSSL) and select CMake -> Build All.
  6. Open cache folder 
    Visual Studio 2017:
Go to CMake -> Cache -> Open Cache Folder -> hds

Visual Studio 2019:
Project -> CMake Cache -> Open in Explorer

You'll find binaries in hds/..., wallet/cli/..., explorer/... subfolders.

Linux

Please read carefully the points below

1. After finishing your build you'll find the the hds-node binary (node) in the hds/hds folder, hds-wallet (cli wallet) in the hds/wallet/cli folder.

2. You need to clone hds sources before building

git clone https://github.com/hadescoincom/hds-core.git

The command above checks out the latest master branch where all the development happens. Usually it is not what you want to build. Choose an appropriate branch here and check out it after you have the main repository cloned. For example the command below checks out the Double Doppler 4.0 release branch

cd hds-core
git checkout double_doppler_4.0RC

3. By default instructions produce masternet builds (development version, development blockchain). To be able to build testnet (testing) or mainnet (real-world blockchain) you need to edit the hds/CMakeLists.txt file lines 151-157. Uncomment (remove the '#' sign) respective definitions.

# uncomment next line for testnet
#set(HDS_TESTNET TRUE)
# uncomment next line for mainnet
#set(HDS_MAINNET TRUE)

# uncomment next line for swap mainnet
#set(SWAP_MAINNET TRUE)

Ubuntu 18.04 Desktop

Instructions below are valid for a clean default Ubuntu 18.04.03 Desktop LTS install. If your're building on an aged system please check that steps 1, 2 & 4 do not overwrite/conflict with more recent versions of cmake and boost that might have been installed before. You can omit cmake/boost installation if you already have more recent versions.

  1. Install dependencies

    sudo add-apt-repository ppa:mhier/libboost-latest
sudo apt-get update && sudo apt-get upgrade
sudo apt-get install g++-8 libssl-dev curl wget git make 
sudo apt-get install libgl1-mesa-dev zlib1g-dev libboost1.67-dev

  2. Install cmake

    wget https://cmake.org/files/v3.13/cmake-3.13.0-Linux-x86_64.sh
sudo sh ./cmake-3.13.0-Linux-x86_64.sh --skip-license --prefix=/usr

  3. Go to the Hds project folder and start the release build

    export CC=gcc-8 && export CXX=g++-8
cmake -DCMAKE_BUILD_TYPE=Release && make -j4

Ubuntu 18.04 Server

Instructions below are valid for a clean default Ubuntu 18.04.03 Server LTS with all the updates applied during install. If your're building on an aged system please check that steps 1 & 2 do not overwrite/conflict with more recent versions of cmake and boost that might have been installed before. You can omit cmake/boost installation if you already have more recent versions.

  1. Install dependencies

    sudo add-apt-repository ppa:mhier/libboost-latest
sudo apt-get update && sudo apt-get upgrade
sudo apt-get install g++-8 libssl-dev curl wget git make 
sudo apt-get install libgl1-mesa-dev zlib1g-dev libboost1.67-dev

  2. Install cmake

    wget https://cmake.org/files/v3.13/cmake-3.13.0-Linux-x86_64.sh
sudo sh ./cmake-3.13.0-Linux-x86_64.sh --skip-license --prefix=/usr

  3. Go to the Hds project folder and start the release build

    export CC=gcc-8 && export CXX=g++-8
cmake -DCMAKE_BUILD_TYPE=Release && make -j4

Ubuntu 19.10 Server

Instructions below are valid for a default Ubuntu 19.10 Server install with updates applied during install.

  1. Install dependencies

    sudo apt-get update && sudo apt-get upgrade
sudo apt-get install g++ git make cmake libboost-all-dev zlib1g-dev
sudo apt-get install libssl-dev

  2. Go to the Hds project folder and start the release build

    cmake -DCMAKE_BUILD_TYPE=Release . && make -j4

Ubuntu 19.10 Desktop

Instructions below are valid for a minimal Ubuntu 19.10 Desktop install with 'update during install' option enabled.

  1. Install dependencies

    sudo apt-get install g++ git make cmake libboost-all-dev zlib1g-dev
sudo apt-get install libssl-dev

  2. Go to the Hds project folder and start the release build

    cmake -DCMAKE_BUILD_TYPE=Release . && make -j4

Centos 7.7

Instructions below are valid for a clean CentOS 7.0-1908 minimal install. If your're building on an aged system please check that steps 2 & 3 do not overwrite more recent versions of cmake and boost that might have been installed before.

  1. Install dependencies

    sudo yum update && shutdown -r now
sudo yum install centos-release-scl yum-utils
sudo yum-config-manager --enable rhel-server-rhscl-8-rpms
sudo yum install devtoolset-8-gcc* 
scl enable devtoolset-8 bash
sudo yum install git make wget openssl-devel

  2. Build & install boost. This step could take considerable amount of time

    wget https://dl.bintray.com/boostorg/release/1.66.0/source/boost_1_66_0.tar.gz
tar xzvf boost_1_66_0.tar.gz
cd boost_1_66_0 && ./bootstrap.sh && sudo ./b2 install && cd ~

  3. Install cmake

    wget https://cmake.org/files/v3.13/cmake-3.13.0-Linux-x86_64.sh
sudo sh ./cmake-3.13.0-Linux-x86_64.sh --skip-license --prefix=/usr

  4. Go to the hds sources folder and start the release build

    cmake -DCMAKE_BUILD_TYPE=Release . && make -j4

CentOS 8

Instructions below are valid for a clean CentOS 8.0-1905 minimal install. If your're building on an aged install please check that step 2 does not overwrite more recent version of cmake that might have been installed before.

  1. Install dependencies

    sudo dnf update
sudo dnf config-manager --set-enabled PowerTools
sudo dnf install git make cmake gcc-c++ libstdc++-static boost-devel 
sudo dnf install openssl-devel tar wget

  2. Install cmake

    wget https://cmake.org/files/v3.13/cmake-3.13.0-Linux-x86_64.sh
sudo sh ./cmake-3.13.0-Linux-x86_64.sh --skip-license --prefix=/usr

  3. Go to the hds sources folder and start the release build

    cmake -DCMAKE_BUILD_TYPE=Release . && make -j4

Fedora 31 Workstation

Instructions below are valid for a default Fedora 31-1.9 Workstation install.

  1. Install dependencies

    sudo dnf update && shutdown -r now
sudo dnf install git make cmake gcc-c++ libstdc++-static boost-devel 
sudo dnf install zlib-devel openssl-devel tar

  2. Go to the Hds project folder and start the release build

    cmake -DCMAKE_BUILD_TYPE=Release . && make -j4

Fedora 31 Server

Instructions below are valid for a default Fedora 31-1.9 Headless Server install.

  1. Install dependencies

    sudo dnf update && shutdown -r now
sudo dnf install git make cmake gcc-c++ libstdc++-static boost-devel 
sudo dnf install zlib-devel openssl-devel tar

  2. Go to the Hds project folder and start the release build

    cmake -DCMAKE_BUILD_TYPE=Release . && make -j4

Mac

  1. Download the source code by using:

    git clone https://github.com/hadescoincom/hds-core.git

    this will give you a master branch which is developer's version of Hds. To get mainnet or testnet use

    git clone --branch mainnet https://github.com/hadescoincom/hds-core.git

    or

    git clone --branch testnet https://github.com/hadescoincom/hds-core.git

  2. Install Brew Package Manager.

  3. Install necessary packages using:

    brew install openssl cmake

  4. Remove any existing brew installations of boost:

    brew uninstall --ignore-dependencies boost

  5. Download and install a compatible version of boost:

    curl -O https://raw.githubusercontent.com/Homebrew/homebrew-core/5da5895add2f6b9320d654dd844d4827f6876c8b/Formula/boost.rb
brew install ./boost.rb

  6. Set your Environment Variables by using the following:

    - export OPENSSL_ROOT_DIR="/usr/local/opt/[email protected]"

  7. Go to Hds project folder and call

    cmake -DCMAKE_BUILD_TYPE=Release . && make -j4

  8. Use cpack to get .dmg file

  9. You'll find binaries in hds/wallet/cli, and hds/explorer subfolders.