elys

1. Clone the Elys chain repository:

git clone https://github.com/elys-network/elys.git

1. Navigate to the cloned repository:

cd elys

1. Optionally, checkout the specific branch or tag you want to build:

git checkout [version]

1. Ensure that you have the necessary dependencies installed. For instance, on Ubuntu you need to install the make tool:

sudo apt-get install --yes make

In order to generate proto files, install the dependencies below:

• buf
• clang-format
• protoc-gen-go-cosmos-orm: go install cosmossdk.io/orm/cmd/protoc-gen-go-cosmos-orm@latest

Then run the following command:

make proto

1. Optional: Use RocksDB instead of pebbledb

Ensure that you have RocksDB installed on your machine. On Ubuntu, you can install RocksDB using the following suite of commands:

# set rocks db version
ROCKSDB_VERSION=8.9.1

# install rocks db dependencies
sudo apt install -y libgflags-dev libsnappy-dev zlib1g-dev libbz2-dev liblz4-dev libzstd-dev

# download and extract on /tmp
cd /tmp
wget https://github.com/facebook/rocksdb/archive/refs/tags/v${ROCKSDB_VERSION}.tar.gz
tar -xvf v${ROCKSDB_VERSION}.tar.gz && cd rocksdb-${ROCKSDB_VERSION} || return

# build rocks db
export CXXFLAGS='-Wno-error=deprecated-copy -Wno-error=pessimizing-move -Wno-error=class-memaccess'
make shared_lib

# install rocks db
sudo make install-shared INSTALL_PATH=/usr

# cleanup to save space
rm -rf /tmp/rocksdb-${ROCKSDB_VERSION} /tmp/v${ROCKSDB_VERSION}.tar.gz

In order to build the binary with RocksDB, you need to run the following command:

ROCKSDB=1 make build

Note: RocksDB is only required for Linux machines. For macOS, you can continue without installing RocksDB.

When running ROCKSDB=1 make build, if you are getting this error:

elysd: error while loading shared libraries: librocksdb.so.8.9: cannot open shared object file: No such file or directory

You might need to set the LD_LIBRARY_PATH environment variable to the local library path. You can do this by running the following command:

export LD_LIBRARY_PATH=/usr/local/lib

1. Run the make build command to build the binary:

make build

1. The binary will be generated in the ./build directory. You can run the binary using the following command:

./build/elysd

You can also use the make install command to install the binary in the bin directory of your GOPATH.