Olympus-Research: A C++ repository from warifp

Olympus (The blockchain layer in Oort)

Official C++ implementation of the Olympus protocol.

To understand the consensus algorithm in Olympus, refer to the mcp yellow paper.

Building the source

Linux

Prerequisite:

g++ version >= 9. Use command g++ -v to check current version.

Install git, cmake, wget and unzip.

apt-get install -y git cmake wget unzip

Install boost.

wget https://boostorg.jfrog.io/artifactory/main/release/1.81.0/source/boost_1_81_0_rc1.tar.bz2
tar --bzip2 -xf  boost_1_81_0_rc1.tar.bz2
cd boost_1_81_0
./bootstrap.sh --prefix=/usr/local
./b2 -j$(nproc) --with-atomic --with-chrono --with-date_time --with-filesystem --with-log \
    --with-program_options --with-regex --with-system --with-thread link=static install
cd .. && rm -rf boost_1_81_0 boost_1_81_0_rc1.tar.bz2

Install libraries required by rocksdb. The output libraries are liblz4.a libzstd.a libz.a.
```
apt-get install -y liblz4-dev libzstd-dev zlib1g-dev
```
Install rocksdb. The installed library name is librocksdb.a.
```
wget https://github.com/facebook/rocksdb/archive/v8.3.3.zip
unzip v8.3.3.zip
cd rocksdb-8.3.3
PORTABLE=1 make -j$(nproc) USE_RTTI=1 static_lib
make install
cd .. && rm -rf rocksdb-8.3.3 v8.3.3.zip
```
Note: Set USE_RTTI=1 in Makefile. Otherwise, there will be link failed to rocksdb. Moreover, set PORTABLE=1 to enhance the portability of the code. Please refer the Installation Instructions for more details.

Compile MCP

Download source code

git clone https://github.com/oort-tech/Olympus.git --recursive
cd Olympus
mkdir -p build && cd build

CMake configuration

cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo ../

Compile
```
make -j$(nproc)
```

Note: If compilation fails because some libraries can not be found, first check if libraries exist in /usr/local/lib. Check if make install has been run for all installed libraries. If the libraries are installed to other directories, these directories can be specified as a cmake option as following.

cmake -Drocksdb_INCLUDE_DIR=/usr/local/include -Drocksdb_LIBRARY_RELEASE=/usr/local/lib/librocksdb.a

Next is a list of all configurable parameters in cmake：

-DBOOST_ROOT=...
-Drocksdb_INCLUDE_DIR=... -Drocksdb_LIBRARY_RELEASE=.../librocksdb.a -Drocksdb_LIBRARY_DEBUG=.../librocksdb.a
-Dlz4_LIBRARY_DEBUG=.../liblz4.a -Dlz4_LIBRARY_RELEASE=.../liblz4.a
-DZSTD_LIBRARY_DEBUG=.../libzstd.a -DZSTD_LIBRARY_RELEASE=.../libzstd.a
-DZLIB_LIB_DEBUG=.../libz.a -DZLIB_LIB_RELEASE=.../libz.a

Mac

The installation procedure is the same as Linux system. The only difference is to use command brew install to install packages.

Windows

Note：1).Compilation of a few library will fail in Debug mode. Set the "treat warnings as errors" option to be false. 2). Run msbuild in the command line tools inside vs-tools, instead of in command shell.

Prerequisite:

Visual studio version >= 2022.
Install git 、 cmake. Download these tools from official website.
Install boost. Download Version 1.81.0 from boost.org, and install in c:\dependence.

Install lz4 which is required by rocksdb. Download v1.9.2, and install in c:\dependence.

cd c:\dependence (Download the package in this directory and unzip it)
cd lz4-1.9.2
cd visual\VS2017
devenv lz4.sln /upgrade
msbuild lz4.sln /p:Configuration=Debug /p:Platform=x64
msbuild lz4.sln /p:Configuration=Release /p:Platform=x64

Install zstd which is required by rocksdb. Download v1.5.2, and install in c:\dependence.

cd c:\dependence (Download the package in this directory and unzip it)
cd zstd-1.5.2\build\VS2010
devenv zstd.sln /upgrade
msbuild zstd.sln /p:Configuration=Debug /p:Platform=x64
msbuild zstd.sln /p:Configuration=Release /p:Platform=x64

Install zlib which is required by rocksdb. Download v1.2.13, and install in c:\dependence.

cd c:\dependence (Download the package in this directory and unzip it)
cd zlib-1.2.13\contrib\vstudio\vc14
devenv zlibvc.sln /upgrade
msbuild zlibvc.sln /p:Configuration=Debug /p:Platform=x64
msbuild zlibvc.sln /p:Configuration=Release /p:Platform=x64

Install rocksdb in c:\dependence.

cd c:\dependence

Download rocksdb and unzip it.

Edit rocksdb\thirdparty.inc.

set(LZ4_HOME $ENV{THIRDPARTY_HOME}/lz4-1.9.2)
set(LZ4_INCLUDE ${LZ4_HOME}/lib)
set(LZ4_LIB_DEBUG ${LZ4_HOME}/visual/VS2017/bin/x64_Debug/liblz4_static.lib)
set(LZ4_LIB_RELEASE ${LZ4_HOME}/visual/VS2017/bin/x64_Release/liblz4_static.lib)

set(ZSTD_HOME $ENV{THIRDPARTY_HOME}/zstd-1.5.2)
set(ZSTD_INCLUDE ${ZSTD_HOME}/lib ${ZSTD_HOME}/lib/dictBuilder)
set(ZSTD_LIB_DEBUG ${ZSTD_HOME}/build/VS2010/bin/x64_Debug/libzstd_static.lib)
set(ZSTD_LIB_RELEASE ${ZSTD_HOME}/build/VS2010/bin/x64_Release/libzstd_static.lib)

set(ZLIB_HOME $ENV{THIRDPARTY_HOME}/zlib-1.2.13)
set(ZLIB_INCLUDE ${ZLIB_HOME})
set(ZLIB_LIB_DEBUG ${ZLIB_HOME}/contrib/vstudio/vc14/x64/ZlibStatDebug/zlibstat.lib)
set(ZLIB_LIB_RELEASE ${ZLIB_HOME}/contrib/vstudio/vc14/x64/ZlibStatRelease/zlibstat.lib)

Compile rocksdb. Follow Installation Instructions.

mkdir build
cd build
set THIRDPARTY_HOME=c:\dependence(cmd) or $env:THIRDPARTY_HOME="c:\dependence" (powershell)
cmake -G "Visual Studio 17 2022" -DLZ4=1 -DZLIB=1 -DZSTD=1 -DPORTABLE=1 ..
msbuild rocksdb.sln /p:Configuration=Release
msbuild rocksdb.sln /p:Configuration=Debug

Compile MCP

Download source code

git clone https://github.com/oort-tech/Olympus.git --recursive
cd mcp && mkdir -p build && cd build
cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo \
-DBOOST_ROOT=c:\dependence\boost \
-Drocksdb_INCLUDE_DIR=c:\dependence\rocksdb\include \
-Drocksdb_LIBRARY_RELEASE=c:\dependence\rocksdb\build\Release\rocksdb.lib \
-Drocksdb_LIBRARY_DEBUG=c:\dependence\rocksdb\build\Debug\rocksdb.lib \
-Dlz4_LIBRARY_DEBUG=c:\dependence\lz4-1.7.5\visual\VS2010\bin\x64_Debug\liblz4_static.lib \
-Dlz4_LIBRARY_RELEASE=c:\dependence\lz4-1.7.5\visual\VS2010\bin\x64_Release\liblz4_static.lib \
-DZSTD_LIBRARY_DEBUG=c:\dependence\zstd-1.3.7\build\VS2010\bin\x64_Debug\libzstd_static.lib \
-DZSTD_LIBRARY_RELEASE=c:\dependence\zstd-1.3.7\build\VS2010\bin\x64_Release\libzstd_static.lib \
-DZLIB_LIB_DEBUG=c:\dependence\zlib-1.2.11\contrib\vstudio\vc14\x64\ZlibStatDebug\zlibstat.lib \
-DZLIB_LIB_RELEASE=c:\dependence\zlib-1.2.11\contrib\vstudio\vc14\x64\ZlibStatRelease\zlibstat.lib \
-G "Visual Studio 17 2022" ../
msbuild mcp.sln /p:Configuration=Debug /p:Platform=x64
msbuild mcp.sln /p:Configuration=Release /p:Platform=x64

Run a node

Read Help

./mcp --help

Run a node as an ordinary node

./mcp --daemon --console --data_path=<Your data path>

Run a node as a witness

./mcp --daemon --console --data_path=<Your data path> --witness --witness_account=<Witness account keystore file> --password=<Password for the keystore file>

Once the mcp is running, you can change other configuration items in the config.json file in the data path specified.

warifp/Olympus-Research