Software Upgrade Proposals
Information on how to propose, vote, and track a software upgrade proposal
Software upgrade proposals will occur when major upgrades are required on the Provenance Blockchain network. When this does occur a governance proposal will be made to request all validators vote on the new software upgrade. All software upgrades will be sourced from the provenance-io/provenance repository.

Submit a software upgrade proposal

Once a new release for the Provenance Blockchain binary has been created, a software upgrade proposal can be run. The proposal should have a name, title, a description of the changes, a url of the plan with the necessary binaries, upgrade block height, required deposit, and chain-id
Parameter
Description
home
home directory containing the blockchain data for the node
title
Title of Software Upgrade
description
Short description of what the upgrade is for
upgrade-info
url that points to the json upgrade plan
from
the account that holds the Hash to be delegated
upgrade-height
blockchain height of where the software upgrade should take place
deposit
required amount of nhash needed to create the proposal
chain-id
name of the network you are connected to
export PIO_HOME=~/.provenanced
provenanced tx gov submit-proposal software-upgrade test1 \
--title "test1" \
--description "upgrade Provenance Blockchain to version test1" \
--upgrade-info https://github.com/provenance-io/provenance/releases/download/test1/plan-test1.json\
--from <name_of_key> \
--upgrade-height 1000 \
--deposit 10000000nhash \
--chain-id pio-testnet-1 \
--testnet

Reviewing the newly created proposal

After submitting the software upgrade proposal you can review that proposal by running the following command:
provenanced query gov proposal 1 --testing
content:
'@type': /cosmos.upgrade.v1beta1.SoftwareUpgradeProposal
description: upgrade Provenance Blockchain to version test1
plan:
height: "1000"
info: https://github.com/provenance-io/provenance/releases/download/test1/plan-test1.json
name: test1
time: "0001-01-01T00:00:00Z"
upgraded_client_state: null
title: test1
deposit_end_time: "2021-03-19T15:41:31.171271855Z"
final_tally_result:
abstain: "0"
"no": "0"
no_with_veto: "0"
"yes": "0"
proposal_id: "1"
status: PROPOSAL_STATUS_VOTING_PERIOD
submit_time: "2021-03-17T15:41:31.171271855Z"
total_deposit:
- amount: "10000000"
denom: nhash
voting_end_time: "2021-03-17T15:46:31.171271855Z"
voting_start_time: "2021-03-17T15:41:31.171271855Z"
This shows that the proposal is live on the chain and the voting period has begun.

Voting on the Proposal

At this time the proposal is live on the Provenance Blockchain network and in order to pass will require a greater than 2/3 majority yes vote. Voting has 4 different parameters abstain, no, no_with_veto, and yes. To vote on the proposal you will run the following:
provenanced tx gov vote 1 yes \
--from $KEY_NAME \
--chain-id pio-testnet-1 \
--fees 1395nhash \
--gas auto \
--testing

Tally current vote

You can review the current state of the governance proposal by running the following:
provenanced query gov tally 1 --testing
abstain: "0"
"no": "0"
no_with_veto: "0"
"yes": "0"

End of Voting Period

Once the voting period has expired the votes will be tallied and if the proposal was voted on in the affirmative it will pass and take affect on the agreed upon block height.
provenanced query gov proposal 1 --testing
content:
'@type': /cosmos.upgrade.v1beta1.SoftwareUpgradeProposal
description: upgrade Provenance Blockchain to version test1
plan:
height: "1000"
info: https://github.com/provenance-io/provenance/releases/download/test1/plan-test1.json
name: test1
time: "0001-01-01T00:00:00Z"
upgraded_client_state: null
title: test1
deposit_end_time: "2021-03-19T15:41:31.171271855Z"
final_tally_result:
abstain: "0"
"no": "0"
no_with_veto: "0"
"yes": "10000000"
proposal_id: "1"
status: PROPOSAL_STATUS_VOTING_PASSED
submit_time: "2021-03-17T15:41:31.171271855Z"
total_deposit:
- amount: "10000000"
denom: nhash
voting_end_time: "2021-03-17T15:46:31.171271855Z"
voting_start_time: "2021-03-17T15:41:31.171271855Z"
Copy link
On this page
Submit a software upgrade proposal
Reviewing the newly created proposal
Voting on the Proposal
Tally current vote
End of Voting Period