💾Node Installation

Oraichain Mainnet guide

EXPLORER

  • Minimum hardware requirements:

Node Type
CPU
RAM
Storage

Mainnet

8

16GB

250GB

1) Auto_install script

source <(curl -s https://raw.githubusercontent.com/111STAVR111/props/refs/heads/main/Oraichain/oraim)

2) Manual installation

Preparing the server

sudo apt update && sudo apt upgrade -y
sudo apt install curl tar wget clang pkg-config libssl-dev jq build-essential bsdmainutils git make ncdu gcc git jq chrony liblz4-tool -y

GO 1.21.6

ver="1.21.6"
wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz"
rm "go$ver.linux-amd64.tar.gz"
echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile
source $HOME/.bash_profile
go version

Build 17.12.24

cd $HOME && mkdir -p go/bin/
git clone https://github.com/oraichain/wasmd/
cd wasmd
git checkout v0.50.2
make build

oraid version --long | grep -e commit -e version

  • version: 0.50.2

  • commit: 3f1bad9629cf1bdec439a11b848a1d63a8d916a0

Initiation

oraid init STAVR_guide --chain-id=Oraichain
oraid config chain-id Oraichain

Create/recover wallet

oraid keys add <walletname>
           OR
oraid keys add <walletname> --recover

Download Addrbook and Genesis

wget -O $HOME/.oraid/config/addrbook.json "https://server-3.stavr.tech/Mainnet/Orai/addrbook.json"
wget -L -O $HOME/.oraid/config/genesis.json https://server-3.stavr.tech/Mainnet/Orai/genesis.json

sha256sum $HOME/.oraid/config/genesis.json

  • fc8995cee38cdcc545ea903e2ae2a5843477139bba6b0b9adc0010f77b3767d8

Set up the minimum gas price and Peers/Seeds/Filter peers/MaxPeers

sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0orai\"/;" ~/.oraid/config/app.toml
sed -i -e "s/^filter_peers *=.*/filter_peers = \"true\"/" $HOME/.oraid/config/config.toml
external_address=$(wget -qO- eth0.me) 
sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:26656\"/" $HOME/.oraid/config/config.toml
peers=""
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.oraid/config/config.toml
seeds=""
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.oraid/config/config.toml
sed -i 's/max_num_inbound_peers =.*/max_num_inbound_peers = 50/g' $HOME/.oraid/config/config.toml
sed -i 's/max_num_outbound_peers =.*/max_num_outbound_peers = 10/g' $HOME/.oraid/config/config.toml

Pruning (optional)

pruning="custom"
pruning_keep_recent="1000"
pruning_keep_every="0"
pruning_interval="10"
sed -i -e "s/^pruning *=.*/pruning = \"$pruning\"/" $HOME/.oraid/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"$pruning_keep_recent\"/" $HOME/.oraid/config/app.toml
sed -i -e "s/^pruning-keep-every *=.*/pruning-keep-every = \"$pruning_keep_every\"/" $HOME/.oraid/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"$pruning_interval\"/" $HOME/.oraid/config/app.toml

Indexer (optional)

indexer="null" &&
sed -i -e "s/^indexer *=.*/indexer = \"$indexer\"/" $HOME/.oraid/config/config.toml

Create a service file

sudo tee /etc/systemd/system/oraid.service > /dev/null <<EOF
[Unit]
Description=oraid
After=network-online.target

[Service]
User=$USER
ExecStart=$(which oraid) start --home $HOME/.oraid
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

StateSync Oraichain Mainnet

systemctl stop oraid
SNAP_RPC=https://orai.rpc.m.stavr.tech:443
LATEST_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height); \
BLOCK_HEIGHT=$((LATEST_HEIGHT - 1000)); \
TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash)

echo $LATEST_HEIGHT $BLOCK_HEIGHT $TRUST_HASH

sed -i.bak -E "s|^(enable[[:space:]]+=[[:space:]]+).*$|\1true| ; \
s|^(rpc_servers[[:space:]]+=[[:space:]]+).*$|\1\"$SNAP_RPC,$SNAP_RPC\"| ; \
s|^(trust_height[[:space:]]+=[[:space:]]+).*$|\1$BLOCK_HEIGHT| ; \
s|^(trust_hash[[:space:]]+=[[:space:]]+).*$|\1\"$TRUST_HASH\"| ; \
s|^(seeds[[:space:]]+=[[:space:]]+).*$|\1\"\"|" $HOME/.oraid/config/config.toml
oraid tendermint unsafe-reset-all --home /root/.oraid
wget -O $HOME/.oraid/config/addrbook.json "https://server-3.stavr.tech/Mainnet/Orai/addrbook.json"
curl -o - -L https://orai.wasm.stavr.tech/wasm-orai.tar.lz4 | lz4 -c -d - | tar -x -C $HOME/.oraid
sudo systemctl restart oraid && journalctl -fu oraid -o cat

SnapShot Mainnet updated every 5 hours

You can check the size and time of snapshot creation with this command curl -sI https://server-3.stavr.tech/Mainnet/Orai/orai-snap-1.tar.lz4 | grep "last" && curl -sI https://server-3.stavr.tech/Mainnet/Orai/orai-snap-1.tar.lz4 | grep content-length | awk '{printf "%.2f GB\n", $2/1024/1024/1024}'

cd $HOME
apt install lz4
sudo systemctl stop oraid
cp $HOME/.oraid/data/priv_validator_state.json $HOME/.oraid/priv_validator_state.json.backup
rm -rf $HOME/.oraid/data
LATEST_SNAPSHOT=$(curl -s https://server-3.stavr.tech/Mainnet/Orai/ | grep -oE 'orai-snap-[0-9]+\.tar\.lz4' | while read SNAPSHOT; do HEIGHT=$(curl -s "https://server-3.stavr.tech/Mainnet/Orai/${SNAPSHOT%.tar.lz4}-info.txt" | awk '/Block height:/ {print $3}'); echo "$SNAPSHOT $HEIGHT"; done | sort -k2 -nr | head -n 1 | awk '{print $1}')
curl -o - -L https://server-3.stavr.tech/Mainnet/Orai/$LATEST_SNAPSHOT | lz4 -c -d - | tar -x -C $HOME/.oraid
curl -o - -L https://orai.wasm.stavr.tech/wasm-orai.tar.lz4 | lz4 -c -d - | tar -x -C $HOME/.oraid
mv $HOME/.oraid/priv_validator_state.json.backup $HOME/.oraid/data/priv_validator_state.json
wget -O $HOME/.oraid/config/addrbook.json "https://server-3.stavr.tech/Mainnet/Orai/addrbook.json"
sudo systemctl restart oraid && journalctl -fu oraid -o cat

Start

sudo systemctl daemon-reload
sudo systemctl enable oraid 
sudo systemctl restart oraid && sudo journalctl -fu oraid -o cat

Create validator

oraid tx staking create-validator \
--commission-rate 0.1 \
--commission-max-rate 1 \
--commission-max-change-rate 1 \
--min-self-delegation "1" \
--amount 1000000orai \
--pubkey $(oraid tendermint show-validator) \
--from <wallet> \
--moniker="STAVR_guide" \
--chain-id Oraichain \
--gas 300000 \
--fees 30000umed \
--identity="" \
--website="" \
--details="" -y

🧩Services and Tools🧩

Monitoring

You can set up your node status alarm here - Monitoring

Security

You can create secure management of your wallet and your node by following this links.

TMKMS Wallet Security

Delete node

sudo systemctl stop oraid
sudo systemctl disable oraid
rm /etc/systemd/system/oraid.service
sudo systemctl daemon-reload
cd $HOME
rm -rf orai
rm -rf .oraid
rm -rf $(which oraid)
PreviousOraichainNextStateSync/Snapshot

Last updated