Skip to content

Validator Guide

Jump to bottom
Dan Connolly edited this page Feb 1, 2022 · 182 revisions

Agoric Mainnet Phase 0

The current phase of Mainnet is Cosmos-SDK-only. Phase 1 is planned to enable the Agoric JS VM.

Most BLD assets are locked under the Cosmos "vesting" contract, but you can still use them to tx staking create-validator or tx staking delegate. Just be aware that staking rewards are not yet turned on.

Note: If you require Ledger (hardware wallet) support with ag0, use --coin-type=118.

Test networks

See:

Runbooks

see Runbooks on Recommended Hardware Baseline, Security Coordination, etc.

FAQs

What does Power Change: 49 -> 0 mean?

Your validator was jailed. If your validator never signed any blocks be sure to read the next section before trying to unjail.

How can I verify my validator is properly created?

You can run a simple check script to ensure the node on the current machine has a public key that has a gentx or tx create-validator on the chain.

If this script runs to completion but fails to find your key on-chain, then no amount of unjailing will help you.

You should try to recover the validator node key from the ~/.agoric/config/*_key.json files that were present when you ran your gentx or tx create-validator (this is NOT the same as the operator key you manage with ag0 or agd). After that, you can rerun the script, and it should complete successfully. After that, restart (but don't reset), and unjail your node.

If you can't, you'll have to make a new operator account, transfer tokens to it, and tx create-validator again.

How do I unjail my validator?

First, ensure your validator is caught up.

Run:

# Set the chainName value again
chainName=`curl https://testnet.agoric.net/network-config | jq -r .chainName`
# Confirm value: should be something like agoricdev-N
echo $chainName
# Replace <key_name> with the key you created previously
agd tx slashing unjail \
  --broadcast-mode=block \
  --from=<your-key-name> \
  --chain-id=$chainName \
  --gas=auto \
  --gas-adjustment=1.4

How do I move my validator to another machine?

To preserve your validator's identity, you must copy the $HOME/.ag-chain-cosmos directory to the new machine. Be sure that your agd start is not running on the old machine. If it is, you will be slashed for double-signing.

Finally, just agd start on the new machine. If your validator has been jailed due to downtime, you may have to unjail it.

How do I recover a key?

You should have your 24-word mnemonic; then run:

Most keys

You should try the following:

agd keys add <your-new-key-name> --recover

If agd keys list doesn't show your correct address, and you have been a validator since before testnet-3, go on to the next step.

Otherwise, you're done!

Generated before testnet-3

Only use this method if you are certain you need to recover a key you generated before testnet-3.

agd keys add <your-new-key-name> --recover --coin-type=118

Private key only; no mnemonic recovery phrase

Cosmos-SDK supports only recovery from a mnemonic recovery phrase.

If you have only a private key and you want to import it, see the keyFmt work-around.

Disclaimer: This content is provided for informational purposes only, and should not be relied upon as legal, business, investment, or tax advice. You should consult your own advisors as to those matters. References to any securities or digital assets are for illustrative purposes only and do not constitute an investment recommendation or offer to provide investment advisory services. Furthermore, this content is not directed at nor intended for use by any investors or prospective investors, and may not under any circumstances be relied upon when making investment decisions.

This wiki is for developing agoric-sdk. For help using Agoric SDK, see https://docs.agoric.com/ and https://agoric-sdk.pages.dev/

Clone this wiki locally