Become Testnet Fullnode From Source

Instructions to install the oraid binary and run as a service by systemd

Oraid Installation and setup

Preresquites

Operating System

This tutorial assumes that your node is running Ubuntu LTS version (i.e: 18.04, 20.04 or 22.04). It does not work with Ubuntu 16.04 or older versions.

Go version (required)

The Golang version should be from 1.21 and above If you have not installed it yet, you can refer to this document.

Make sure that $GOPATH is in your $PATH. It's the crucial part of this tutorial.

Make (required)

If your node does not have Make, install using:

sudo apt update && sudo apt install make

Gcc (required)

You need to install Gcc to build the binary. Type:

sudo apt update && sudo apt install gcc

Build the binary from source

Please define the $ORAI_HOME environment variable which will be used as the working directory, in this tutorial we will assume that your $ORAI_HOME is root. If you don't define it, all of the following installations will be using your $HOME folder as $ORAI_HOME, please replace $ORAI_HOME with $HOME in the corresponding commands (except export ORAI_HOME command).

Make sure your user has enough permissions to write data to the $ORAI_HOME folder.

# Export ORAI_HOME env variable
export ORAI_HOME="/root"

# clone the Oraichain network repository
cd $ORAI_HOME
git clone https://github.com/oraichain/orai.git

# enter the repo
cd orai

# checkout the latest tag
git checkout <tag>

The <version-tag> will need to be set to either a testnet or the latest mainnet version tag.

The current mainnet version tag will be v0.42.1 - i.e:

git checkout v0.42.1

Next, you should be able to build the binary file using the below command:

# go to main folder ($ORAI_HOME/orai/orai)
cd orai
go mod tidy
make install

After running the above commands, your oraid binary can be found in $GOPATH/bin. To confirm that the installation is succeeded, you can run (please make sure that $GOPATH/bin is in your $PATH):

oraid version

The current binary version for Linux users is v0.42.1

Libwasmvm version: oraid query wasm libwasmvm-version, which should give: 1.5.2

Initialize Orai Testnet Node

Use oraid to initialize your node (replace the NODE_NAME with a name of your choosing):

oraid init NODE_NAME --home $ORAI_HOME/.oraid --chain-id Oraichain-fork

Download and place the genesis file in the orai config folder:

sudo apt-get install wget liblz4-tool aria2 -y
wget -O $ORAI_HOME/.oraid/config/genesis.tar.lz4 https://orai.s3.us-east-2.amazonaws.com/testnet/genesis.tar.lz4
lz4 -c -d $ORAI_HOME/.oraid/config/genesis.tar.lz4 | tar -x -C $ORAI_HOME/.oraid/config/
rm -rf $ORAI_HOME/.oraid/config/genesis.tar.lz4 

Finally, your working directory should be like below:

$ORAI_HOME/.oraid/
├── config
│   ├── app.toml
│   ├── client.toml
│   ├── config.toml
│   ├── genesis.json
│   ├── node_key.json
│   └── priv_validator_key.json
└── data
    └── priv_validator_state.json

2 directories, 7 files

Setup to run node

Edit config

vim $ORAI_HOME/.oraid/config/config.toml

Update seed and persistent_peers address

seeds = "3aa2643144cc59e2d60a4b0c328223b0773e5d9e@134.209.164.196:26656, fc7d01a6ffbbc097e60fcf7b5bb6970d693161c0@134.209.164.196:26666"
persistent_peers = "3aa2643144cc59e2d60a4b0c328223b0773e5d9e@134.209.164.196:26656, fc7d01a6ffbbc097e60fcf7b5bb6970d693161c0@134.209.164.196:26666"

Start your node

oraid start --x-crisis-skip-assert-invariants --home $ORAI_HOME/.oraid

Start node process may take many minutes, even hour!