PIP-61: Paloma Mainnet Upgrade to Paloma v1.15.0 and Pigeon v1.12.0

Governance
1

PIP-61: Paloma Mainnet Upgrade to Paloma v1.15.0 and Pigeon v1.12.0

Status: Proposed

Author(s): @LARRY

Type: Software Upgrade

Discussions-to: PIP-61: Paloma Mainnet Upgrade to Paloma v1.15.0 and Pigeon v1.12.0

Created: 06/14/2024

Simple Summary

This is a software upgrade for Paloma to v1.15.0 and Pigeon to v1.12.0 tag for Paloma MAINNEST tumbler network. This release includes upgrades for the token bridge support of multiple target chains, pigeon feed features, as well as security enhancements for validator balances. This update also requires the minimum pigeon version to join the network to be Pigeon v1.12.0. There will be a separate vote to enforce the new version of Pigeon.

Abstract

This is a software upgrade for Paloma to v1.15.0 tag for Paloma MAINNEST tumbler network. This update also sets the minimum pigeon version to join the network as Pigeon v1.12.0. This release provides additional improvements for token bridge support of multiple target chains as well as increased security enhancements for validator balances on target chains. This release prepares Paloma for Pigeon Feed functionality for the Paloma blockchain.

Motivation

The motivations for this Paloma upgrade include the following:

  1. Enhancements for cross-chain bridge functionality
  2. Features for Pigeon Feed
  3. Code stability and dependency upgrades
  4. Compass-EVM Deployment retry support

Specification Overview

Upgrade Pigeon and set minimum pigeon version for Paloma from governance.

Technical Specification

The upgrade motivations for this new release are as follows:

  1. Enable Compass-EVM deployment retries
  2. Improve cross-chain bridge functionality
  3. Deliver more enhancements for Pigeon Feed.
  4. Code stability improvements

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 spreadsheet to calculate the approximate Block Height. https://docs.google.com/spreadsheets/d/1eoXoDWWYHIOYbdPiv8B6vfwDUUkelZgeifnX4foa7yw/edit#gid=0
  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 18941223 or approximately 06/17/2024, 14:00UTC See (Block height: 18941223)
palomad tx upgrade software-upgrade v1.15.0 \
--upgrade-height 18941223 \
--upgrade-info '{"binaries":{"linux/amd64":"https://github.com/palomachain/paloma/releases/download/v1.15.0/paloma_Linux_x86_64.tar.gz"}}' \
--title "PIP-61: Paloma Mainnet Upgrade to Paloma v1.15.0" \
--summary "PIP-61: Paloma Mainnet Upgrade to Paloma v1.15.0 and Pigeon v1.12.0" \
--chain-id tumbler \
--deposit 10000000ugrain \
--fees 400ugrain \
--gas 400000 \
--node <Your node> \
--from <Your Paloma Address>  \
--no-validate \
-y

The target block height for pigeon upgrade is set to 2 blocks after chain halt

palomad tx gov submit-legacy-proposal valset \
propose-pigeon-requirements v1.12.0 \
 --target-block-height 18941225 \
 --title "PIP-61: Update to Pigeon v1.12.0" \
 --summary "PIP-61: Increase the minimum version of Pigeon to v1.12.0, introducing support for bridging tokens." \
 --chain-id tumbler
 --deposit 10000000ugrain \
 --fees 10000ugrain \
 --gas-adjustment 1.1 \
 --gas auto \
 --node <Your node> \
 --from <Your Paloma Address>  \
 --yes

How to Vote on the Proposals

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


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

  1. Improve cross-chain bridge functionality for n chains
  2. Deliver more enhancements for Pigeon Feed engineering

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