Upgrade

This module provides the basic functions of software version upgrade.

Available Commands

NameDescription
software-upgradeSubmit a software upgrade proposal
cancel-software-upgradeCancel the current upgrade proposal
planQuery the software upgrade plan currently in progress
appliedQuery the executed software upgrade plan

iris tx gov submit-proposal software-upgrade

Initiate a software upgrade proposal through the Gov module.

iris tx gov submit-proposal software-upgrade <plan-name> [flags]

Flags:

Name, shorthandTypeRequiredDefaultDescription
--depositCoinsdeposit of proposal
--titlestringtitle of proposal
--descriptionstringdescription of proposal
--upgrade-heightuint64The height at which the upgrade must happen (not to be used together with --upgrade-time)
--upgrade-timeTimeThe time at which the upgrade must happen (ex. 2006-01-02T15:04:05Z) (not to be used together with --upgrade-height)
--upgrade-infostringOptional info for the planned upgrade such as commit hash, etc.

TIP

If you need to support cosmovisor to automatically perform software upgrades, --upgrade-info needs to use a fixed format, such as:

{
    "binaries": {
        "linux/amd64":"https://example.com/irishub.zip?checksum=sha256:aec070645fe53ee3b3763059376134f058cc337247c978add178b6ccdfb0019f"
    }
}

iris tx gov submit-proposal cancel-software-upgrade

Submit cancellation of the currently ongoing software upgrade proposal through the Gov module.

iris tx gov submit-proposal cancel-software-upgrade [flags]

Flags:

Name, shorthandTypeRequiredDefaultDescription
--depositCoinsdeposit of proposal
--titlestringtitle of proposal
--descriptionstringdescription of proposal

iris query upgrade plan

Query the currently ongoing software upgrade plan.

iris query upgrade plan [flags]

iris query upgrade applied

Query the software upgrade plan that has been executed recently.

iris query upgrade applied <upgrade-name>