Mainnet Validator

Turn a current node into a validator on the mainnet.

This guide contains instructions on how to setup and run an Umee validator. First, be sure to check out the full node instructions on how to install and configure the umeed binary as this guide assumes you already have it installed and configured.

There are three (3) crucial processes required for a healthy validator node:

Umeed,
Peggo
Price-Feeder

In order to become an active validator, you must have more stake than the bottom validatoropen in new window. You may still execute the following steps, but you will not be active and therefore won't receive staking rewards.

Release Compatibility Matrix

Please consult release compatibility matrixopen in new window to make sure you install the right version.

Keyring

Prior to creating your validator, you must first create your "operator" key. Note, this is not your consensus key and will not be used for signing. Instead, it is used to identify you validator in the Umee network.

umeed keys add <key-name> [flags]

By default, umeed will store keys in your OS-backed keyring. You can change this behavior by specifying the --keyring-backend flag.

If you already have a key that you'd like to import via a mnemonic, you can provide a --recover flag and the keys add command will prompt you for the BIP39 mnemonic.

Visit the Cosmos SDK's keyring documentationopen in new window for more information

Ethereum Node

The Gravity Bridge requires that validators also run a peggo orchestrator in addition to the umeed process. The orchestrator requires access to a geth node's RPC instance. A geth light client can be used, but a full node is preferable.

You may choose to operate your own geth node or use a publicly available one. However, in production environments, it is recommended that you run your own. Depending on what network you're running your Umee validator on, you'll want to connect to or setup your geth node to the appropriate Ethereum network. See the geth CLI documentationopen in new window for more information on how to connect to different Ethereum networks.

Follow these steps to install a GETH node and turn your Umee node into a validator

First install the go-ethereum binary;
- Download the latest binary from https://geth.ethereum.org/downloads
- unpack: tar xf <archive name>
- chmod +x geth-*/geth
- sudo mv geth-*/geth /usr/local/bin
Create a new ethereum wallet. Copy the wallet address and be sure to store the private keys.
```
geth account new
```
Or you can see the key store using this command
```
geth account list
```

Create a systemdopen in new window service file for your GETH client

sudo tee /etc/systemd/system/geth.service > /dev/null <<EOF
[Unit]
Description=Geth node
After=online.target
[Service]
User=$USER
ExecStart=/usr/local/bin/geth --syncmode light --http --http.addr=0.0.0.0 --http.port=8545 --goerli
Restart=on-failure
RestartSec=3
LimitNOFILE=4096
[Install]
WantedBy=multi-user.target
EOF

Run the service

sudo systemctl daemon-reload
sudo systemctl enable geth
sudo systemctl start geth

Peggo

Start by consulting the latest Peggo release notesopen in new window, to make sure you are aware about the update instructions.

Download Peggo: the gravity bridge orchestrator latest release for your architectureopen in new window. You can build from source. Move the binary to /usr/local/bin.

Let’s export some additional variables. In all commands below in the first command you will receive the value you need to replace part of the next command

Validator address:

umeed keys show UMEE_WALLET_NAME --bech val -a
echo 'export VAL_ADDRESS=VALIDATOR_ADDRESS' >> ~/.profile

Umee wallet address:

umeed keys show UMEE_WALLET_NAME -a
echo 'export PEGGO_UMEE_KEY=UMEE_WALLET_ADDRESS' >> ~/.profile

Ethereum wallet address:

peggo keys eth show ETH_WALLET_NAME
echo 'export PEGGO_ETH_KEY=ETH_WALLET_ADDRESS' >> ~/.profile
source ~/.profile

Register the validator's Ethereum key. This key will be used to sign claims going from Ethereum to Umee and to sign any transactions sent to Ethereum (batches or validator set updates).

Note: do not include the enclosing {} when filling out those variables

$ umeed tx gravity set-orchestrator-address \
  {VAL_ADDRESS} \
  {VAL_ADDRESS or different ORCHESTRATOR_ADDRESS} \
  {PEGGO_ETH_KEY} \
  --eth-priv-key="..." \
  --chain-id="..." \
  --fees="..." \
  --keyring-backend=... \
  --keyring-dir=... \
  --from=...

Run the Orchestrator

export PEGGO_ETH_PK={ETHEREUM_PRIVATE_KEY_HERE}
$ /usr/local/bin/peggo orchestrator {GRAVITY_ADDRESS} \
  --eth-rpc=$ETH_RPC \
  --relay-batches=true \
  --valset-relay-mode=minimum \
  --cosmos-chain-id=... \
  --cosmos-grpc="tcp://..." \
  --tendermint-rpc="http://..." \
  --cosmos-keyring=... \
  --cosmos-keyring-dir=... \
  --cosmos-from=...

Optionally create a service file to automatically start the orchestrator

sudo tee /etc/systemd/system/peggo.service > /dev/null <<EOF
[Unit]
Description=Gravity Bridge Orchestrator
After=online.target
[Service]
User=$USER
Environment="RUST_LOG=INFO"
ExecStart={COMMAND-FROM-STEP-8-ABOVE}
Restart=on-failure
RestartSec=3
LimitNOFILE=4096
[Install]
WantedBy=multi-user.target
EOF

Go more in-depth with Peggo hereopen in new window

Check the sync status. If catching_up is equal to true, wait until it is false. This process may take a minute.
```
umeed status 2>&1 | jq -r '.SyncInfo.catching_up'
```
Check to see if you have received tokens from the faucet or that you have tokens in your new Umee wallet.
```
umeed q bank balances $(umeed keys show UMEE_WALLET_NAME -a)
```

If the node was synced and you have tokens you can now create a validator using the following commands

umeed tx staking create-validator \
--from UMEE_WALLET_NAME \
--amount 990000000uumee \
--pubkey $(umeed tendermint show-validator) \
--chain-id umee-1 \
--moniker=YOUR-MONIKER \
--commission-max-change-rate=0.10 \
--commission-max-rate=1.0 \
--commission-rate=0.08 \
--min-self-delegation="1" \
--fees=200uumee
#--amount can be different just keep on the wallet 10000000uumee

Link all keys on the bridge
```
umeed tx gravity set-delegate-keys $VAL_ADDRESS $PEGGO_UMEE_KEY $PEGGO_ETH_KEY $PEGGO_ETH_SIG \
  --chain-id="umee-1" --from=UMEE_WALLET_NAME --fees=200uumee --gas auto
```
Carefully check if that transaction failed. It requires a lot of gas that can be a source of the issue. Also, if you got a "signing validation error" then repeat last 3 commands.

After a successful transaction from step 13 — run the orchestrator.

sudo systemctl daemon-reload
sudo systemctl enable peggo
sudo systemctl start peggo

To check logs and confirm that everything is in order use the following commands

journalctl -u umeed -f
journalctl -u peggo -f
journalctl -u geth -f

Price Feeder

The x/oracle moduleopen in new window requires that all validators vote on the price of assets which governance has decided to add. In order to vote on these prices, the umee team has built the price feederopen in new window.

Please click hereopen in new window to see what version of the price feeder is compatible with your version of the umeed binary. It is not necessary for umeed v1.0.x.

If the calypso (V3) upgrade has happened successfully, you absolutely must vote on prices to avoid being jailed and slashed.

First, install the most recent price-feeder binary: Releasesopen in new window

Replace the tar with the correct architecture of the most recent price feeder version
make the binary executable: chmod +x price-feeder-v*/price-feeder*
move the binary to /usr/local/bin

Download the example config file, also on Githubopen in new window

cd /usr/local/bin/
wget https://raw.githubusercontent.com/umee-network/umee/main/price-feeder/price-feeder.example.toml

Replace the example values in your config Set up your keyring using the description hereopen in new window.
Update the [account] information with the correct chain-id (umee-1 for mainnet), address, and validator address from your keyring.
```
[account]
address = "umee15nejfgcaanqpw25ru4arvfd0fwy6j8clccvwx4"
chain_id = "umee-1"
validator = "umeevaloper12tysz6mzrawenca2t3t7ltym4hfjj8a5upsn2k"
```
In order to get your address & validator address, given a key with the name alice, you can run:
```
umeed keys show alice -a --bech=acc
umeed keys show alice -a --bech=val
```

Create a systemdopen in new window service file

sudo tee /etc/systemd/system/price-feeder.service > /dev/null <<EOF
[Unit]
Description=Umee Price Feeder
After=online.target[Service]
StartLimitIntervalSec=0
StartLimitBurst=0

[Service]
Type=simple
User=$USER
WorkingDirectory=/usr/local/bin
ExecStart=bash -c 'echo "\n" | price-feeder .price-feeder/config.toml --log-level debug'
Restart=on-failure
RestartSec=5s
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Note: The price feeder hits a lot of endpoints to get prices for assets. Sometimes the websocket connections disconnect and cannot reconnect. If this is happening, set up the service file to restart the process after a few hours:

Restart=always
RuntimeMaxSec=14400s # 4h

Start your service

sudo systemctl daemon-reload
sudo systemctl enable price-feeder
sudo systemctl start price-feeder

Please check to make sure your price feeder is running successfully
```
sudo journalctl -u price-feeder.service -f
```

If it's not, please check your config. Common problems are:

Wrong address
Wrong Chain ID
Wrong keyring info
Invalid providers / token pairs - check coingeckoopen in new window to see the available providers for a given coin
Not voting on all required tokens

When ready to delegate feed consent, the price-feeder_address argument is the same as the address = from your price-feeder.toml, eg.
```
umeed tx oracle delegate-feed-consent <validator_adress> <price-feeder_address> --chain-id umee-1 --fees 2000uumee
```

Calypso - v3 Upgrade Instructions

Overview

Calypso - v3 is Umee Network's latest blockchain technology release. In addition to Peggo, v3 validators must also run our Price Feeder process or will be jailed and slashed! Price Feeder fetches and aggregates exchange rate price data from various providers, then supplies them to the main oracle process.

Release Notes

Price Feeder official release, v1.0.0open in new window

Installation

If cosmovisor is already installed to automatically swap binaries, skip to installing Price Feeder below.

If this upgrade is to an existing validator, first choose the correct Umee release for your architecture hereopen in new window, manually swap the binaries, and install Price Feeder. If you would like to setup a new mainnet validator, follow those instructions first, before proceeding to install Price Feeder.

Validators must set a mempool version before the update version = "v1"open in new window

# Mainnet Validator

# Release Compatibility Matrix

# Keyring

# Ethereum Node

# Peggo

# Price Feeder

# Calypso - v3 Upgrade Instructions

# Overview

# Release Notes

# Installation