Skip to content

Creating a Validator

⚠️

Note: The OLLO testnet is very early in its continued development journey. Keep posted to our Discord and Twitter for the latest updates, as we will frequently be updating the testnet core, documentation, and frontend. Early on, you should expect to encounter some bugs and issues -- please report these to us on our Discord, Telegram, or Twitter. A bug bounty program will be live soon to reward submissions.

  1. After you have initialized your node with a funded account, and are officially connected to the OLLO test network, you can create a validator by running the following command:
ollod tx staking create-validator               \
  --amount="1000000utollo"                      \ # self delegation amount -- set by default to 1 TOLLO
  --pubkey="$(ollod tendermint show-validator)" \ # tendermint validator pubkey generated upon initialization
  --moniker="<VALIDATOR MONIKER>"               \ # validator's moniker, or name
  --chain-id="ollo-testnet-1"                   \ # chain-id for targeted OLLO network
  --commission-rate="0.10"                      \ # percent charged on rewards, fees from delegators
  --commission-max-rate="0.20"                  \ # max commission validator can charge. Fixed after creation
  --commission-max-change-rate="0.05"           \ # max daily increase of commission. Fixed after creation
  --min-self-delegation="1000000"               \ # min amount of utollo that must be bonded by validator
  --gas="auto"                                  \ # amount of gas to use in transaction
  --gas-adjustment="1.5"                        \ # factor to adjust gas to provide buffer
  --from="<KEY NAME>"                           \ # named key from keyring from which tx funds are used
  --website="<WEBSITE>"                         \ # optional: validator website, if applicable
  --details="<DETAILS>"                         \ # optional: description of your validator services
  --security-contact="<EMAIL>"                  \ # optional: email or other contact for your validator
  --identity="<KEYBASE PGP>"                      # optional: keybase PGP value, provides keybase avatar
⚠️

Note: When specifying how to calculate gas, you may pass either a specific gas price: --gas-prices="2500utollo" or a gas-adjustment factor --gas-adjustment="1.5", which provides a buffer above the minimum amount of gas specified in the --gas flag (or the estimated minimum, in the case of --gas='auto'. Passing --gas="auto" and --gas-adjustment="1.5" should very often cover the transaction gas price.

  1. You will then be prompted to confirm the transaction, with the transaction JSON data displayed. If everything looks good, proceed to send the transaction.

  2. You can check the status of your validator by running the following command:

     ollod query staking validator "$(ollod tendermint show-validator)"
⚠️

Note: After sending the create-validator transaction, your inputted values for commission-max-rate and commission-max-change-rate are fixed and cannot be edited. Other values may be edited using the ollod tx staking edit-validator command

Verify your validator is running

After sending the create-validator command, you can verify your validator is listed in the OLLO network validator set by visiting a testnet explorer, either at the official OLLO (WISE) Explorer or the current (under construction) OLLO Testnet frontend. At the OLLO Explorer, you can see your validator's current status, missed blocks, uptime, and a wealth of other information related to your validator's status.

Edit your validator

After creating your validator and verifying its presence on an explorer, you may optionally edit any of its information (besides fields explicitly designated as fixed) through a transaction sent with ollod tx staking edit-validator, as follows:

ollod tx staking edit-validator  \
  --moniker="<NEW NODE MONIKER>" \
  --chain-id="ollo-testnet-1"    \
  --identity="<KEYBASE PGP>"     \
  --from="<KEY NAME>"

Note: To add an icon that will be displayed alongside your validator, add your Keybase PGP key with the --identity flag. You can find your PGP key on your Keybase profile page. The image will be pulled from your profile.

You can see a full list of options and parameters that can be adjusted by running ollod tx staking edit-validator --help.