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.
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
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
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
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.
- 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'
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.
Please exit the container and follow the below steps to start the nodes
[email protected]:26656,
[email protected]:26656,
[email protected]:26656,
[email protected]:26656,
[email protected]:26656,
[email protected]com:26656
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.
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.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
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.
YOU MUST NOT RUN TWO VALIDATOR NODES WITH THE SAME NODE KEY AND VALIDATOR KEY AT THE SAME TIME. OTHERWISE, YOUR VALIDATOR WILL BE TOMBSTONED BECAUSE OF DOUBLE SIGNING, AND IT WILL NEVER BE ABLE TO JOIN THE VALIDATORSET EVER AGAIN.
This section is optional if you want to follow the sentry architecture. For more information about the sentry architecture, please click here.
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.
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
Example:
pex = false
persistent_peers = "[email protected]:26656,[email protected]:26656"
addr_book_strict = false
unconditional_peer_ids (optional) = "014b6fa1fd8d14fa7e08c353497baa1f5581a089,bc806159212529879b42c737c2338042e396b1dd"
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://1.2.3.4:26656>
when starting, set flag --rpc.laddr tcp://0.0.0.0:26657
Example:
pex = true
unconditional_peer_ids = "cc433de0f3d7e8e125ca40396e7cedb12a5d68bc"
persistent_peers = "[email protected]:26656"
private_peer_ids = "cc433de0f3d7e8e125ca40396e7cedb12a5d68bc"
addr_book_strict = false
external_address = "tcp://1.2.3.4:26656"
when starting: oraivisor start --rpc.laddr tcp://0.0.0.0:26657
You should also set up firewalls for your genesis nodes.
Last modified 7d ago