Software Upgrade Proposal

What is a Software Upgrade Proposal?

A Software Upgrade Proposal allows the network to transition to a new version of the blockchain software. The proposal specifies an upgrade plan and schedule that validators and node operators must follow to avoid disruptions.

Use Cases

  • Fix bugs in the current software.

  • Enhance security and performance.

  • Addressing bugs or issues in the current software.

Proposal Structure

Title: A concise title summarizing the upgrade (e.g., “Proposal to Upgrade Self Chain to v2.0”).

Summary: summarize the upgrade in 2-3 sentences, including the new software version and the rationale for the upgrade.

Upgrade Plan:

  • Testing: Describe any testing that has been conducted to validate the upgrade.

  • Validator Actions: Outline the steps validators and node operators must take to upgrade their nodes.

  • Upgrade Height: Indicate the block height when the upgrade will take effect.

  • New Software Version: Specify the version number (e.g., v2.0).

Preprate the JSON file:

{
  "messages": [
    {
      "@type": "/cosmos.upgrade.v1beta1.MsgSoftwareUpgrade",
      "authority": "self10d07y265gmmuvt4z0w9aw880jnsr700jlfwec6",
      "plan": {
        "name": "v2.0-upgrade",
        "time": null,
        "height": "1000000",
        "info": "https://selfchain.xyz/releases/v2.0",
        "upgraded_client_state": null
      }
    }
  ],
  "metadata": "ipfs://CID",
  "deposit": "10000000uslf",
  "title": "Add CosmWasm Support",
  "summary": "Adding CosmWasm module support",
}

height: Set height to a block number after the voting period ends(calculate based on blocks per year).

To query the gov account for the authority field, use the command:

selfchaind query auth module-account gov --node http://165.232.125.66:26657

Last updated