How to Onboard onto Agoric Testnet

…a Validator Guide

I documented these steps for my future reference (if required) and if you find it useful, do feel free to use it.

These steps are only applicable if you were running a previous version of the Agoric software and were selected to participate in the upcoming | current incentivised testnet.

At a high level, the macro steps needed for this upgrade are:

Steps:

• Check Prerequisites
• Install Node.js
• Install Go
• Download/Install Agoric SDK
• Configure your Node
• Check the Network Parameters
• Apply Network Parameters
• Adjust Configuration
• Sync your Node
• Create your Validator
• Tap the Faucet
• Check your Balance
• Catch Up
• Get Validator Public Key
• Submit Create Validator Transaction

Scripts:

And to assist along, I have created some scripts for each of the step I had to go through.

scripts
├── 00-governance
├── 01-ag-chain-cosmos-version-long.sh
├── 02-ag-chain-cosmos-init.sh
├── 03-ag-cosmos-helper-status.sh
├── 04-ag-cosmos-helper-status-sync-info.sh
├── 05-ag-cosmos-helper-keys-add-recover.sh
├── 06-ag-cosmos-helper-keys-list.sh
├── 07-ag-cosmos-helper-keys-show.sh
├── 08-ag-cosmos-helper-query-bank-balances.sh
├── 09-ag-cosmos-helper-tx-staking-create-validator.sh
├── 10-ag-cosmos-helper-tx-staking-edit-validator.sh
├── 11-ag-chain-cosmos-tendermint-show-validator.sh
└── 12-ag-cosmos-helper-tx-slashing-unjail.sh

01-ag-chain-cosmos-version-long.sh

#!/bin/bash 
ag-chain-cosmos version --long

02-ag-chain-cosmos-init.sh

#!/bin/bash 
ag-chain-cosmos init \
  --chain-id $chainName <moniker> \
  --log_level info

03-ag-cosmos-helper-status.sh

#!/bin/bash
ag-cosmos-helper status \
  -n tcp://127.0.0.1:<port> \
  2>&1 | jq .SyncInfo

04-ag-cosmos-helper-status-sync-info.sh

#!/bin/bash
while sleep 5; do
  sync_info=`ag-cosmos-helper status -n tcp://localhost:<port>  | jq .sync_info`
  echo "$sync_info"
  if test `echo "$sync_info" | jq -r .catching_up` == false; then
    echo "Caught up"
    break
  fi
done

05-ag-cosmos-helper-keys-add-recover.sh

#!/bin/bash
#ag-cosmos-helper keys add --coin-type=118 --recover <moniker>
ag-cosmos-helper keys add  --recover <moniker>

06-ag-cosmos-helper-keys-list.sh

#!/bin/bash
ag-cosmos-helper keys list

07-ag-cosmos-helper-keys-show.sh

#!/bin/bash
ag-cosmos-helper keys show -a <moniker>

08-ag-cosmos-helper-query-bank-balances.sh

#!/bin/bash
ag-cosmos-helper query bank balances \
`ag-cosmos-helper keys show -a <moniker>` \
--node tcp://127.0.0.1:<port>

09-ag-cosmos-helper-tx-staking-create-validator.sh

#!/bin/bash
ag-cosmos-helper tx staking create-validator \
  --amount=50000000uagstake \
  --broadcast-mode=block \
  --pubkey=$(ag-chain-cosmos tendermint show-validator) \
  --moniker="<moniker>" \
  --identity="<keybase>" \
  --details="<details>" \
  --commission-rate="0.1" \
  --commission-max-rate="0.1" \
  --commission-max-change-rate="0.1" \
  --min-self-delegation="1" \
  --from="<moniker>" \
  --chain-id=$chainName \
  --gas=auto \
  --gas-adjustment=1.4 \
  --node tcp://127.0.0.1:<port>

10-ag-cosmos-helper-tx-staking-edit-validator.sh

#!/bin/bash
ag-cosmos-helper tx staking edit-validator \
  --amount=50000000uagstake \
  --broadcast-mode=block \
  --pubkey=$(ag-chain-cosmos tendermint show-validator) \
  --moniker="<moniker>" \
  --identity="<keybase>" \
  --details="<details>" \
  --commission-rate="0.1" \
  --commission-max-rate="0.1" \
  --commission-max-change-rate="0.1" \
  --min-self-delegation="1" \
  --from="<moniker>" \
  --chain-id=$chainName \
  --gas=auto \
  --gas-adjustment=1.4 \
  --node tcp://127.0.0.1:<port>

11-ag-chain-cosmos-tendermint-show-validator.sh

#!/bin/bash
ag-chain-cosmos tendermint show-validator

12-ag-cosmos-helper-tx-slashing-unjail.sh

#!/bin/bash
# Set the chainName value again
chainName=`curl https://testnet.agoric.com/network-config | jq -r .chainName`
# Confirm value: should be something like testnet-1.17.0
echo $chainName
# Replace <key_name> with the key you created previously
ag-cosmos-helper tx slashing unjail \
  --node tcp://localhost:<port> \
  --broadcast-mode=block \
  --from=<moniker> \
  --chain-id=$chainName \
  --gas=auto \
  --gas-adjustment=1.4

You can also find the Github repository for this other scripts here…

Github Agoric Pathway

w3mone/agoric-pathway

General Reference Links:

Validator Guide

Agoric/agoric-sdk

Release Notes

Agoric/agoric-sdk