Proposal: PIP-89: Paloma Mainnest and Tesnest Upgrade to Paloma v2.1.1
Status: Proposed
Author(s): birdlady
Type: Software Upgrade
Discussions-to:
Created: 08/27/24
Simple Summary
This is a software upgrade proposal for Paloma and Pigeon both to v2.1.1
Paloma’s TESTNEST and MAINNEST tumbler
networks. This release includes a bug fix for resetting the skyway nonce and a new governance proposal message to override the nonce.
Abstract
This is a software upgrade proposal for Paloma to v2.1.1
for Paloma’s TESTNEST and MAINNEST tumbler
networks. This release includes a bug fix for resetting the Skyway nonce when a new Compass contract is deployed and a new governance proposal message to override the nonce.
Motivation
The motivations for this Paloma upgrade include the following:
Ensure that the skyway nonce is reset when a new Compass is deployed. This is required for Skyway messages to be relayed.
Specification Overview
The specification for this release includes the following features:
- Bug fix to reset the skyway nonce.
- Add a governance proposal message, which may be used to override the last nonce across all validators for a given chain to recover from a desync
Technical Specification
Paloma upgrade includes the following:
- Add skyway nonce reset and new CLI command github ticket #1275
Prior to upgrade
- An upgrade proposal that must be submitted by anyone running a node on the network. This proposal should have the correct block height.
- Please use the following spreadsheet to calculate the approximate Block Height. https://docs.google.com/spreadsheets/d/1eoXoDWWYHIOYbdPiv8B6vfwDUUkelZgeifnX4foa7yw/edit#gid=0
- This upgrade proposal requires 10 GRAIN or 10000000ugrain for deposit for voting.
- IMPORTANT: The
upgrade height
is the block height where the chain halts and requires the upgrade. Allow at least one (1) day AFTER voting end time andupgrade-height
for 2/3 of the network to have downloaded the new binary and prepped for the switch over to avoid/minimize downtime of the Paloma chain. - The Target block height for chain halt for this proposal is tentative
22805165
or approximately08/29/2024, 6:30 UTC
See (Block height: 22805165)
palomad tx upgrade software-upgrade v2.1.1 \
--upgrade-height 22805165 \
--upgrade-info '{"binaries":{"linux/amd64":"https://github.com/palomachain/paloma/releases/download/v2.1.1/paloma_Linux_x86_64.tar.gz"}}' \
--title "PIP-89: Paloma Mainnet Upgrade to Paloma v2.1.1" \
--summary "PIP-89: Paloma Mainnet Upgrade to Paloma v2.1.1 to fix Skyway module Nonce reset bug" \
--chain-id tumbler \
--deposit 10000000ugrain \
--fees 400ugrain \
--gas auto \
--node <Your node> \
--from <Your Paloma Address> \
--no-validate \
-y
How to Vote on Proposals 108
palomad tx gov vote 108 yes \
--chain-id tumbler \
--from <Your Paloma Address> \
--fees 400ugrain \
--node <Your node> \
-y
How to check if 2/3 of the network is online after the vote is complete
curl -s localhost:26657/consensus_state | jq -r ".result.round_state.height_vote_set[0].prevotes_bit_array"
—> needs to return ≥ ~0.67 for the chain to start up again
To see which validators are online with the new binary, use GitHub - blockpane/pvtop: top-like tui for watching validator pre-votes on Tendermint chains.
Rationale
We are upgrading Paloma to achieve the following objectives:
- Reset the skyway nonce when a new compass contract is deployed.
- Allow for the nonce to be reset via governance.
About Paloma
Paloma wants to be the fastest relay chain in the world with the most decentralized network of validators that can attest to any transaction with the fastest possible execution. Paloma aims to make it easy for developers to control smart contracts on any Solana, Ethereum L1, L2, and L3 chain.
To learn more about Paloma, please visit https://palomachain.com
To follow the project on Github, please star the project GitHub - palomachain/paloma: The fast blockchain messenger protocol
To participate in the community, please join the Paloma Discord: Paloma