Become a Validator

Become a validator

This tutorial helps validators and full nodes quickly synchronize with the Oraichain mainnet by downloading a storage snapshot prepared by the team. The downloading speed is much faster than synchronizing from the first block, which allows fast set up to join the network in no time!
If you want to synchronize your node using the traditional method, please follow this tutorial instead.

Hardware specifications for an Oraichain node

Please take a look here

Setup the validator node

1. Download and run the setup file

curl -OL https://raw.githubusercontent.com/oraichain/oraichain-static-files/master/docker-compose.yml && curl -OL https://raw.githubusercontent.com/oraichain/oraichain-static-files/master/orai.env

2. Edit wallet name and moniker you prefer to create a new wallet and validator in the orai.env file you have just downloaded

3. Build and enter the container

With docker, your validator can run on any platforms. As a result, it is a must to install and download Docker & docker-compose. Afterward, please type:
docker-compose pull && docker-compose up -d --force-recreate

4. Initiate the node

Please enter the container and type:
oraid init "$MONIKER" --home /workspace/.oraid
then, you need to download the network's genesis file by using the following command inside your container:
wget -O /workspace/.oraid/config/genesis.json https://raw.githubusercontent.com/oraichain/oraichain-static-files/master/genesis.json

5. Download Chain Data

Download the latest chain data from a snapshot provider. Select the tab to the desired node type (Default or Pruned). A Pruned node will have the smallest disk size possible, but it will only keep the latest network state, which is recommended for sentry, seed nodes & light clients. Meanwhile, a Default node will store more network state history, but it will have larger size, which is suitable for validators.
Click Here to view the chain data download URLs from different regions.
  • Command:
docker-compose exec orai bash -c 'wget -O - <chain-dara-url> | tar -zxvf -'
After extracting the chain data, you need to move such data into the .oraid/ directory:
docker-compose exec orai bash -c 'mv /workspace/data/* /workspace/.oraid/data && mv /workspace/wasm/ /workspace/.oraid && rmdir /workspace/data'

6. Initiate your validator wallet

Please enter your container and type:
oraid keys add $USER 2>&1 | tee account.txt && exit
After running, there will be an account.txt file generated, which stores your account information as well as its mnemonic. Please keep it safe, and remove the file when you finish storing your account information.

Start the network

Please exit the container and follow the below steps to start the nodes

List of seed & sentry nodes that you can connect to

1. Start the node

docker-compose restart orai && docker-compose exec -d orai bash -c 'oraivisor start --p2p.pex false --p2p.persistent_peers "<node-id1>@<pubclic-ip1>:26656,<node-id2>@<public-ip2>:26656"'
If you do not specify the --p2p.persistent_peers flags, you must add at least a persistent peer connection in the .oraid/config/config.toml file before running the below command, otherwise your node will not be able to connect to the Oraichain network.
The above commands run as the background process so when you turn off your Terminal, it is still running. You can always run them in the foreground process by removing the "-d" flag.

3. Wait until your node is synchronized

Please wait until your node is fully synchronized by typing: oraid status &> status.json && cat status.json | jq '{catching_up: .SyncInfo.catching_up}'. If the catching up status is false, you can continue.

4. Create validator transaction

You need to store two following files: .oraid/config/node_key.json, .oraid/config/priv_validator_key.json. They contain your validator information for voting. Create backups for these files, otherwise you will lose your validator node if something wrong happens.
You can check your wallet information by typing: oraid query auth account <your-validator-wallet-address> inside of the container or through the explorer, where you import your wallet. To prevent spamming, your wallet is not activated by default. As a result, it needs to receive at least one MsgSend transaction from a different account. In other words, you should receive some ORAI tokens (minimum of 10^-6 ORAI) to continue. When your wallet has some tokens, please enter the container and type:
wget -O /usr/bin/fn https://raw.githubusercontent.com/oraichain/oraichain-static-files/master/fn.sh && chmod +x /usr/bin/fn && fn createValidator

5. Check your node status with voting power

Type the following command to check your voting power:
oraid status &> status.json && cat status.json | jq '{catching_up: .SyncInfo.catching_up, voting_power: .ValidatorInfo.VotingPower}'
If you see that your VotingPower is greater than 0, and the catching_up is false, then congratulations, you are a validator now!


You should monitor your nodes frequently. Make sure it has the correct tendermint public key to vote. To check, you should take a look at your tendermint public key in the ValidatorInfo attribute after typing:
oraid status
Please compare the tendermint public key to the one when you type:
oraid query staking validator <operator address>
If they match, then your node is still running fine. If not, then you should remove the .oraid/config/node_key.json, .oraid/config/priv_validator_key.json files, replace them with your backup files and restart the node.



Setup your sentry nodes (optional)

This section is optional if you want to follow the sentry architecture. For more information about the sentry architecture, please click here.
Setting up a fast sync sentry node is the same to that of a validator node but without the steps 4 and 5

Setup the sentry architecture (optional)

This section is optional if you want to follow the sentry architecture. You can set the following configurations in the file .oraid/config/config.toml directly. Some pairs can be configured through the start command. This architecture will help you connect your genesis nodes with your sentry nodes, and your sentry nodes are responsible for connecting to other nodes within the network. To start using flags, please type:
oraivisor start --help
You also need to prepare your own VPC network beforehand.

1. Validator node configuration

pex = false
persistent_peers = <list of sentry nodes with node id, private ips, port 26656>
addr_book_strict = false
unconditional_peer_ids (optional) = <list of sentry node ids>
To get a node id, type:
oraid tendermint show-node-id
some configuration values can only be changed in the .oraid/config/config.toml file, like addr_book_strict
pex = false
persistent_peers = "[email protected]:26656,[email protected]:26656"
addr_book_strict = false
unconditional_peer_ids (optional) = "014b6fa1fd8d14fa7e08c353497baa1f5581a089,bc806159212529879b42c737c2338042e396b1dd"

2. Sentry node configuration

pex = true
unconditional_peer_ids = <validator node id>
persistent_peers = <validator nodes, optionally other sentry nodes>
private_peer_ids = <validator node ids>
addr_book_strict = false
external_address = <your-public-address. Eg: tcp://>
when starting, set flag --rpc.laddr tcp://
pex = true
unconditional_peer_ids = "cc433de0f3d7e8e125ca40396e7cedb12a5d68bc"
persistent_peers = "[email protected]:26656"
private_peer_ids = "cc433de0f3d7e8e125ca40396e7cedb12a5d68bc"
addr_book_strict = false
external_address = "tcp://"
when starting: oraivisor start --rpc.laddr tcp://
You should also set up firewalls for your genesis nodes.
Please join the Oraichain validators group on Telegram to discuss ideas and problems!