# `band-wenchang/guanyu-testnet3`

For the upgrade from Wenchang to Guanyu on mainnet, there are 2 things that we want to test before the real upgrade commences

1. The upgrade process. We want to make sure existing validators can stop, export, and migrate their genesis file and start a GuanYu node with the exported chain state.
2. We want to restart our testnet and make final stress test before mainnet launch. (With new version of `yoda` that improves on problems that happened on testnet2)

## Briefly timeline
- Validators start syncing on `September 10`
- The upgrade will happen at `September 17, 2020 at or around 14:00 UTC`. Please book your time and watch our discord channel to communicate between upgrade. You will need to have Wenchang node up before that.

**Note:** The upgrade procedure and how to start Guanyu testnet will be pinned in the discord channel. Please keep an eye out for it

## Recommended instance specification to run node

The node that you'll be starting will be upgrade to a GuanYu node, so we require the following minimum spec.

- CPU: 2vCPU
- RAM: 4GB
- Disk space: 80 GB

## Start Wenchang node and sync on testnet#3

1. Download binary release of Wenchang version

wget https://github.com/bandprotocol/bandchain/releases/download/v0.2.4/bandd_linux_amd64
chmod +x bandd_linux_amd64
sudo mv bandd_linux_amd64 /usr/local/bin/bandd

wget https://github.com/bandprotocol/bandchain/releases/download/v0.2.4/bandcli_linux_amd64
chmod +x bandcli_linux_amd64
sudo mv bandcli_linux_amd64 /usr/local/bin/bandcli

2. Initialize your node key

bandd init YOUR_MONIKER

3. Download genesis file and move to config folder

wget https://raw.githubusercontent.com/bandprotocol/launch/master/band-wenchang-testnet3/genesis.json
mv genesis.json $HOME/.bandd/config/

4. Create a config file at `/etc/systemd/system/bandd.service`, using the contents below. You will need to edit the default ubuntu username to reflect your machine’s username. Note that you may need to use sudo as it lives in a protected folder.

[Unit]
Description=BandChain Node Daemon
After=network-online.target

[Service]
User=ubuntu
ExecStart=/usr/local/bin/bandd start --p2p.persistent_peers "[e-mail]:26656,[e-mail]:26656"
Restart=always
RestartSec=3
LimitNOFILE=4096

[Install]
WantedBy=multi-user.target

5. Start the service

sudo systemctl enable bandd
sudo systemctl start bandd

**Noted:** You can tail the log output with `journalctl -u bandd.service -f`. If all goes well, you should see that the node daemon has started syncing. Now you should wait until your node caught up with the most recent block.

## Apply to be a validator

1. Create your key for applying to be a validator

bandcli keys add YOUR_WALLET

2. Request BAND testnet token from faucet

curl --location --request POST 'https://wenchang-testnet3.bandchain.org/faucet/request' \
--header 'Content-Type: application/json' \
--data-raw '{
 "address": "'"$(bandcli keys show -a YOUR_WALLET)"'"
}'

3. Send message to create validator

bandcli tx staking create-validator \
    --amount 3000000uband \
    --commission-max-change-rate 0.01 \
    --commission-max-rate 0.2 \
    --commission-rate 0.1 \
    --from YOUR_WALLET \
    --min-self-delegation 1 \
    --moniker YOUR_MONIKER \
    --pubkey $(bandd tendermint show-validator) \
    --chain-id band-wenchang-testnet3

**Noted:** You can check your validator status by

bandcli query staking validator $(bandcli keys show -a --bech val YOUR_WALLET) --chain-id band-wenchang-testnet3

It should be

  operatoraddress: bandvaloper1...
  conspubkey: bandvalconspub1...
  jailed: false
  status: 2
  tokens: "3000000"
  delegatorshares: "3000000.000000000000000000"
  description:
    moniker: YOUR_MONIKER
    identity: ""
    website: ""
    details: ""
  unbondingheight: 0
  unbondingcompletiontime: 1970-01-01T00:00:00Z
  commission:
    commission_rates:
      rate: "0.100000000000000000"
      max_rate: "0.200000000000000000"
      max_change_rate: "0.010000000000000000"
    update_time: TIME_WHEN_YOU_APPLY
  minselfdelegation: "1"

That's all you need to do!

Please join this wenchang testnet3 before `September 17,2020 at or around 14:00 UTC`