Turn a current node into a validator on the mainnet.
This guide contains instructions on how to setup and run an UX 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 two (2) crucial processes required for a healthy validator node:
In order to become an active validator, you must have more stake than the bottom validator. 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 matrix to make sure you install the right version.
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 UX network.
umeed keys add <key-name> [flags]
umeed will store keys in your OS-backed keyring. You can change this behavior by specifying the
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 documentation for more information
Please click here 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: Releases
- 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
Download the example config file, also on Github
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 here.
[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 systemd 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 coingecko to see the available providers for a given coin
- Not voting on all required tokens
When ready to delegate feed consent, the
price-feeder_addressargument 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
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.
If this upgrade is to an existing validator, first choose the correct Umee release for your architecture here, 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.