PIP-64: Paloma Mainnet Upgrade to Paloma v1.15.1

PIP-64: Paloma Mainnet Upgrade to Paloma v1.15.1

Status: Proposed

Author(s): @birdlady

Type: Software Upgrade


Created: 06/28/2024

Simple Summary

This is a software upgrade for Paloma to v1.15.1 for Paloma MAINNET 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 is a software upgrade for Paloma to v1.15.1 for Paloma MAINNET tumbler network.


The motivations for this Paloma upgrade include the following:

  1. Implement Paloma Bridge Tax for Grains Risk Management
  2. Implement Paloma Bridge Limits for any token on the Gravity Bridge
  3. Compass-EVM Deployment retry support

Specification Overview

Upgrade Paloma to v1.15.1

Technical Specification

The technical specification for this release is contained in the following tag: Release v1.15.1 · palomachain/paloma · GitHub. This includes the following:

  • Fix: Withold gravity batches until valset updates
  • Feature: Implement the Paloma Bridge Exit Tax and Burn by Governance
  • Feature: Add Pigeon Feed Relayer Fee settings for validators
  • Feature Add Daily Bridge Transfer Limits for Paloma Tokens
  • Fix: Unpack errors on ReferenceBlockAttestation

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 19705222 or approximately 07/01/2024, 14:00UTC See (Block height: 19705222)
palomad tx upgrade software-upgrade v1.15.1 \
--upgrade-height 19705222 \
--upgrade-info '{"binaries":{"linux/amd64":"https://github.com/palomachain/paloma/releases/download/v1.15.1/paloma_Linux_x86_64.tar.gz"}}' \
--title "PIP-64: Paloma  Mainnet Upgrade to Paloma v1.15.1" \
--summary "PIP-64: Paloma  Mainnet Upgrade to Paloma v1.15.1" \
--chain-id tumbler \
--deposit 10000000ugrain \
--fees 400ugrain \
--gas auto \
--node <Your node> \
--from <Your Paloma Address>  \
--no-validate \

How to Vote on the Proposals

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

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


We are upgrading Paloma to achieve the following objectives:

  1. Add Bridge Risk Management and Security Features to launch the GRAIN token
  2. Deliver more enhancements for Paloma Gravity Bridge Batches
  3. Fix any current bugs

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