PIP-103: Protocol Upgrade to Paloma and Pigeon v2.3.0 To Upgrade to Cosmos-SDK v0.50.10 and Relayer Selection Logic

Governance
1

Proposal: PIP-103: Protocol Upgrade to Paloma and Pigeon v2.3.0 To Upgrade to Cosmos-SDK v0.50.10 and Relayer Selection Logic

Status: Proposed

Author(s): @BoweryKing

Type: Software Upgrade

Discussions-to:

Created: 09/27/2024

Summary

This is a software upgrade proposal for Paloma and for Pigeon. We request that the network upgrade the protocol of the tumbler network to v2.3.0.

This release fixes a Pigeon issue in which the base chain reported a current block height lower than what was already processed, improves message processing after errors, and upgrades to cosmos-sdk v0.50.10.

With this release, the Paloma relayer selection logic is being improved. Currently the same validator is always selected to relay messages. This release improves the mechanism to select from a pool of top validators, especially if the selected validator is failing to relay messages. This change also upgrades to cosmos-sdk v0.50.10 and introduces support for cosmwasm 2.0.

Cosmos SDK v50.10 Changes:

  • Add the root command module-hash-by-height to query and retrieve module hashes at a specific height
  • PreBlock events (mainly x/upgrade) are now emitted (this time, for real)
  • A fix in runtime baseapp option ordering, giving issue when other modules were having options

Check out the changelog for an exhaustive list of changes, or compare changes from the last release.

This is a consensus-breaking release!

IMPORTANT FOR ALL VALIDATORS: Read the latest README and upgrade your libwasmvm.so to v2.1.3.

Motivation

The motivations for this Paloma upgrade include the following:

Prior to upgrade

  1. An upgrade proposal that must be submitted by anyone running a node on the network. This proposal should have the correct block height.
  2. Please use the following tool to calculate the approximate Block Height: Huginn - PalomaChain Release Window Planner
  3. This upgrade proposal requires 10 GRAIN or 10000000ugrain for deposit for voting.
  4. 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 and upgrade-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.
  5. The Target block height for chain halt for this proposal is tentative 24548000 or approximately 09/23/2024, 8:24 UTC See (Block height: Block 24548000 Details - Paloma (GRAIN) Blockchain Explorer
palomad tx gov submit-proposal ./pip-103.json \
--gas auto \
--fees 1500ugrain \
--node=https://rpc-1.paloma.nodes.guru/ \
--chain-id tumbler \
--from <Your Paloma Address>  \
-b sync

palomad tx gov submit-legacy-proposal valset propose-pigeon-requirements \
v2.3.0 \
--target-block-height 24548005 \
--title "PIP-103: Paloma Protocol Upgrade to Paloma & Pigeon v2.3.0" \
--summary "This is a software upgrade proposal for Paloma and for Pigeon. We intend for request that the network upgrade the protocol of the tumbler network to v2.3.0" \
--deposit 10000000ugrain \
--fees 400ugrain \
--gas auto \
--node=https://rpc-1.paloma.nodes.guru/ \
--chain-id tumbler \
--from <Your Paloma Address> \
-y

pip-103.json

{
 "messages": [
  {
   "@type": "/cosmos.upgrade.v1beta1.MsgSoftwareUpgrade",
   "authority": "paloma10d07y265gmmuvt4z0w9aw880jnsr700jz87xyk",
   "plan": {
    "name": "v2.3.0",
    "height": "24548000",
    "info": "",
    "upgraded_client_state": null
   }
  }
 ],
 "metadata": "ipfs://QmPMNLWcaTzEsQTtTvHoKJV5o9kFiqHiaGFipRa9GSHwR3",
 "deposit": "10000000ugrain",
 "title": "PIP-103: Paloma Protocol Upgrade to Paloma & Pigeon v2.3.0",
 "summary": "This is a software upgrade proposal for Paloma and for Pigeon. We intend for request that the network upgrade the protocol of the tumbler network to v2.3.0",
 "expedited": false
}

pip-103_metadata.json

{
 "title": "PIP-103: Paloma Protocol Upgrade to Paloma & Pigeon v2.3.0",
 "authors": [
  "BoweryKing"
 ],
 "summary": "This is a software upgrade proposal for Paloma and for Pigeon. We intend for request that the network upgrade the protocol of the tumbler network to v2.3.0",
 "details": "\"'{\\\"binaries\\\":{\\\"linux/amd64\\\":\\\"https://github.com/palomachain/paloma/releases/download/v2.3.0/paloma_Linux_x86_64.tar.gz\\\"}}'\"",
 "proposal_forum_url": "https://forum.palomachain.com/t/pip-103-protocol-upgrade-to-paloma-and-pigeon-v2-3-0-to-upgrade-to-cosmos-sdk-v0-50-10-and-relayer-selection-logic/800",
 "vote_option_context": "Vote YES to support running this binary to upgrade the Paloma Mainnest Network"
}

How to Vote on Proposals 128 & 129

palomad tx gov vote 128 yes \
--chain-id tumbler \
--from <Your Paloma Address> \
--fees 400ugrain \
--node <Your node> \
-y

palomad tx gov vote 129 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

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