feeder

feeder

Submit exchange rate prevotes and votes, implementing the voting procedure.

Requirements

Every Oracle Chain validator must participate in the oracle process and periodically submit a vote for the exchange rate of Luna in all whitelisted denominations. Because this process occurs every 30 seconds, validators must set up an automated process to avoid getting slashed and jailed.

Make a new key for oracle votes

You can separate the keys used for controlling a validator account from those that are submitting oracle votes on behalf of a validator. Run:

oracled keys add <feeder>

Show the feeder account details:

oracled keys show <feeder>

Delegate feeder consent

The account address used to submit oracle voting transactions is called a feeder. When you set up your oracle voting process for the first time, you must delegate the feeder permission to an account.

oracled tx oracle set-feeder <feeder-address> --from=<validator>

Instructions

1. Install dependencies

npm install

2. Create a key from your mnemonic

You need the mnemonic phrase for the feeder account for your validator.

npm start add-key

Enter a passphrase to encrypt your key to disk: ********
Repeat the passphrase: ********
Enter your bip39 mnemonic : <some nice mnemonic>
saved!
✨  Done in 9.19s.

3. Vote

Make sure the Price Server is running.

You can start feeder with arguments or env.

• Arguments

  $ npm start vote -- \
     --source http://localhost:8532/latest \
     --lcd-url https://lcd-1.anr.dev \
     --lcd-url https://lcd-2.anr.dev \
     --chain-id andromeda-oralce-1 \
     --validators anrvaloper1xx \
     --validators anrvaloper1yy \
     --password "<password>"

• Env

  # set your env vars 
  $ npm start vote

Argument	Env	Description	Example
password	PASSWORD	Password for mnemonic (assigned in step #2)	12345678
data-source-url	DATA_SOURCE_URL	Price server URL.	http://localhost:8532/latest
lcd-url	LCD_ADDRESS	LCD server URL (can be multiple)	https://lcd.anr.dev
chain-id	CHAIN_ID	Chain ID.	andromeda-oralce-1
validators	VALIDATOR	Validator to submit prices for (can be multiple)	anrvaloper1xx...
key-name	KEY_NAME	name to be given to the key that will be encrypted in file	voter
coin-type	COIN_TYPE	coin type used to derive the public address (default 118)	118
key-path	KEY_PATH	signing key store path (default voter.json)	voter.json

Set up oracle feeder program

To start submitting oracle messages with your feeder account, install and set up an oracle feeder.

• Install Terra's Node.js oracle-feeder by visiting Terra's oracle feeder Github repo.

Validators are encouraged to set up their own oracle feeders.