PIP-45: Paloma Mainnet upgrade to Paloma v1.9.1 and Pigeon v1.9.2

PIP Name: PIP-45: Paloma Mainnet upgrade to Paloma v1.9.1 and Pigeon v1.9.2

Status: Proposed

Author(s): @LARRY

Type: Software Upgrade

Discussions-to: PIP-45: Paloma Mainnet upgrade to Paloma v1.9.1 and Pigeon v1.9.2

Created: 10/13/2023

Simple Summary

This is a software upgrade for Paloma to v1.9.1 and Pigeon to v1.9.2 tags after the completion of the public testnet deployment with upgraded binaries. IMPORTANT: This update includes upgrades for the Paloma Gravity Bridge. Paloma’s Bridge now comes with migration for redeployed compasses. All ERC20s will now have continuous ownership changes, when Compass upgrades, as needed by governance. In addition, this software re-update reintroduces transaction locks on validator messages to reverse the removal of these blocks which led to increased account sequence mismatch errors. This software upgrade adds additional validator happiness fixes for pigeon jailing as well as improvements for message relaying.


The Paloma mainnet continues to achieve the goal of fast and reliable validator node support for effective cross-chain communication and cross-chain relay functionality. Validator performance to interact with mainnet relays continues to be an area of improvement for the Paloma team.


  1. Ensuring that Paloma Gravity Bridges have automatic migrations when Compass-EVM migrates after Governance upgrades
  2. Governance-driven migration for ERC20s to new Gravity Bridges
  3. Enhancement and fixes of Gravity bridge bugs
  4. Fixes for pigeon jailing due to small TTLs
  5. Fixes for account sequence mismatch errors

Specification Overview

This action requires an upgrade of palomad to the latest tag v1.9.1 and an upgrade of pigeond to v1.9.2. All migrations are included and are being tested on the Paloma public testnest paloma-testnest-15. Validators simply need to install the new binary and restart their nodes at chainhalt.

Technical Specification

The latest releases of Paloma and Pigeon are available here and includes the change logs for each for review prior to deployment:

  1. Download and install the latest Paloma tag: Release v1.9.1 · palomachain/paloma · GitHub
  2. Download and install the latest Pigeon tag: Release v1.9.2 · palomachain/pigeon · GitHub
  3. An upgrade proposal that must be submitted by anyone running a node on the network. This proposal should have the correct block height.
  4. Please use the following spreadsheet to calculate the approximate Block Height. https://docs.google.com/spreadsheets/d/1eoXoDWWYHIOYbdPiv8B6vfwDUUkelZgeifnX4foa7yw/edit#gid=0
  5. This upgrade proposal requires 10 GRAIN or 10000000ugrain for deposit for voting.
  6. 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.
  7. The Target block height for chain halt for this proposal is tentatively 6238830 or approximately 10/16/2023 12:53 UTCSee ([NG] Explorer | Paloma | 6238830)

palomad tx gov submit-legacy-proposal software-upgrade v1.9.1 \
  --title "Upgrade to Paloma v1.9.1 & Pigeon v1.9.2" \
  --description "Maintenance update, contains less agressive pigeon jailing, gravity bridge support for compass EVM updates and more bugfixes." \
  --deposit 10000000ugrain \
  --fees 400ugrain \
  --upgrade-height $UPGRADE_HEIGHT \
  --upgrade-info '{"binaries":{"linux/amd64":"https://github.com/palomachain/paloma/releases/download/v1.9.1/paloma_Linux_x86_64.tar.gz"}}' \
  --gas 400000 \
  --from=Volume \
  --chain-id messenger \
  --no-validate \

How to Vote on the Proposal

palomad tx gov vote 33 yes \
--chain-id=messenger \
--from <Your Paloma Address> \
--fees 400ugrain \

How to check if 2/3 of the network are online after 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


Fast and efficient pigeons as welll as a well functioning relay are at the core of Paloma’s value prop. This release aims at improving validator happiness by improving pigeon and relay performance.

About Paloma

Paloma Protocol is a Cosmos-SDK blockchain protocol custom-built for omnichain communication that allows permissionless controls of any contract on any chain. Built by Volume, Paloma delivers the world’s first intelligently scheduled and automated smart contract transaction execution for the Cosmos ecosystem. The protocol enables developers to remotely control the transmission of value without the need to wrap, bridge tokens, or trust validators with their digital assets. Led by
founding members of Sommelier, Paloma is building the primary communication layer of Web3.

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