Testing Client Upgrade

Prerequisites

gaiad (v4.2.*), for example:

gaiad version --log_level error --long | head -n4

name: gaia
server_name: gaiad
version: v4.2.0
commit: 535be14a8bdbfeb0d950914b5baa2dc72c6b081c

Testing procedure

Start two gaia instances and initialize hermes:
```
./scripts/dev-env ~/.hermes/config.toml ibc-0 ibc-1
```
The one-chain script is invoked for each chain and modifies the genesis.json file to use a short window for governance proposals (200s for max_deposit_period and voting_period). Therefore, an upgrade proposal can be submitted, voted on and accepted within a short time.

Create one client on ibc-1 for ibc-0:

hermes create client ibc-1 ibc-0

Success: CreateClient(
   CreateClient(
       Attributes {
           height: Height { revision: 1, height: 9 },
           client_id: ClientId(
               "07-tendermint-0",
           ),
           client_type: Tendermint,
           consensus_height: Height { revision: 0, height: 18 },
       },
   ),
)

Create and submit an upgrade plan for chain ibc-0:

Use the hermes test command to make an upgrade proposal. In the example below a software upgrade proposal is made for ibc-0, for the height 300 blocks from latest height. 10000000stake is deposited. The proposal includes the upgraded client state constructed from the state of 07-tendermint-0 client on ibc-1 that was created in the previous step. In addition, the unbonding_period of the client is set to some new value (400h)
```
hermes tx raw upgrade-chain ibc-0 ibc-1 07-tendermint-0 10000000 300
```
```
Success: transaction::Hash(CE98D8D98091BA8016BD852D18056E54C4CB3C4525E7F40DD3C40B4FD0F2482B)
```
Note that the height offset should be picked such that the proposal plan height is reached after the 200s voting period.

Verify that the proposal was accepted:

Query the upgrade plan to check that it was submitted correctly. Note the height at which the proposal will take effect (chain halts). Also status: PROPOSAL_STATUS_VOTING_PERIOD.

gaiad query gov proposal 1 --home data/ibc-0/

content:
  '@type': /cosmos.upgrade.v1beta1.SoftwareUpgradeProposal
  description: upgrade the chain software and unbonding period
  plan:
    height: "332"
    info: upgrade the chain software and unbonding period
    name: test
    time: "0001-01-01T00:00:00Z"
    upgraded_client_state:
      '@type': /ibc.lightclients.tendermint.v1.ClientState
      allow_update_after_expiry: true
      allow_update_after_misbehaviour: true
      chain_id: ibc-0
      frozen_height:
        revision_height: "0"
        revision_number: "0"
      latest_height:
        revision_height: "333"
        revision_number: "0"
      max_clock_drift: 0s
      proof_specs:
      - inner_spec:
          child_order:
          - 0
          - 1
          child_size: 33
          empty_child: null
          hash: SHA256
          max_prefix_length: 12
          min_prefix_length: 4
        leaf_spec:
          hash: SHA256
          length: VAR_PROTO
          prefix: AA==
          prehash_key: NO_HASH
          prehash_value: SHA256
        max_depth: 0
        min_depth: 0
      - inner_spec:
          child_order:
          - 0
          - 1
          child_size: 32
          empty_child: null
          hash: SHA256
          max_prefix_length: 1
          min_prefix_length: 1
        leaf_spec:
          hash: SHA256
          length: VAR_PROTO
          prefix: AA==
          prehash_key: NO_HASH
          prehash_value: SHA256
        max_depth: 0
        min_depth: 0
      trust_level:
        denominator: "0"
        numerator: "0"
      trusting_period: 0s
      unbonding_period: 1440000s
      upgrade_path:
      - upgrade
      - upgradedIBCState
  title: upgrade_ibc_clients
deposit_end_time: "2021-04-12T16:33:37.187389Z"
final_tally_result:
  abstain: "0"
  "no": "0"
  no_with_veto: "0"
  "yes": "0"
proposal_id: "1"
status: PROPOSAL_STATUS_VOTING_PERIOD
submit_time: "2021-04-12T16:30:17.187389Z"
total_deposit:
- amount: "10000000"
  denom: stake
voting_end_time: "2021-04-12T16:33:37.187389Z"
voting_start_time: "2021-04-12T16:30:17.187389Z"

Vote on the proposal

The parameter 1 should match the proposal_id: from the upgrade proposal submitted at step 3. This command must be issued while the proposal status is PROPOSAL_STATUS_VOTING_PERIOD. Confirm transaction when prompted.

gaiad tx gov vote 1 yes --home data/ibc-0/data/ --keyring-backend test --keyring-dir data/ibc-0/ --chain-id ibc-0 --from validator

confirm transaction before signing and broadcasting [y/N]: y

{"height":"85","txhash":"AC24D80B1BFE0832769DECFDD3B3DF999A363D5E4390B0B673344FFDED9150B2","codespace":"","code":0,"data":"0A060A04766F7465","raw_log":"[{\"events\":[{\"type\":\"message\",\"attributes\":[{\"key\":\"action\",\"value\":\"vote\"},{\"key\":\"module\",\"value\":\"governance\"},{\"key\":\"sender\",\"value\":\"cosmos1srfzw0jkyyn7wf0ps4zy0tuvdaclfj2ufgp6w3\"}]},{\"type\":\"proposal_vote\",\"attributes\":[{\"key\":\"option\",\"value\":\"VOTE_OPTION_YES\"},{\"key\":\"proposal_id\",\"value\":\"1\"}]}]}]","logs":[{"msg_index":0,"log":"","events":[{"type":"message","attributes":[{"key":"action","value":"vote"},{"key":"module","value":"governance"},{"key":"sender","value":"cosmos1srfzw0jkyyn7wf0ps4zy0tuvdaclfj2ufgp6w3"}]},{"type":"proposal_vote","attributes":[{"key":"option","value":"VOTE_OPTION_YES"},{"key":"proposal_id","value":"1"}]}]}],"info":"","gas_wanted":"200000","gas_used":"43716","tx":null,"timestamp":""}

Wait approximately 200 seconds until the proposal changes status to PROPOSAL_STATUS_PASSED. Note the final tally_result that includes the vote submitted in the previous step.

gaiad query gov proposal 1 --home data/ibc-0/

   content:
     '@type': /cosmos.upgrade.v1beta1.SoftwareUpgradeProposal
     description: upgrade the chain software and unbonding period
   ...
   final_tally_result:
     abstain: "0"
     "no": "0"
     no_with_veto: "0"
     "yes": "100000000000"
   proposal_id: "1"
   status: PROPOSAL_STATUS_PASSED
   submit_time: "2021-04-12T16:30:17.187389Z"
   total_deposit:
   - amount: "10000000"
     denom: stake
   voting_end_time: "2021-04-12T16:33:37.187389Z"
   voting_start_time: "2021-04-12T16:30:17.187389Z"

Test the upgrade client CLI

The following command performs the upgrade for client 07-tendermint-0. It outputs two events, one for the updated client state, and another for the upgraded state.

hermes upgrade client ibc-1 07-tendermint-0

Success: [
    UpdateClient(
        UpdateClient {
            common: Attributes {
                height: Height { revision: 1, height: 438 },
                client_id: ClientId(
                    "07-tendermint-0",
                ),
                client_type: Tendermint,
                consensus_height: Height { revision: 0, height: 440 },
            },
            header: Some(
                Tendermint(..)
            ),
        },
    ),
    UpgradeClient(
        UpgradeClient(
            Attributes {
                height: Height { revision: 1, height: 438 },
                client_id: ClientId(
                    "07-tendermint-0",
                ),
                client_type: Tendermint,
                consensus_height: Height { revision: 0, height: 441 },
            },
        ),
    ),
]