PIP-56: Paloma Mainnet Upgrade to Paloma v1.12.2

PIP Name: PIP-56: Paloma Mainnet Upgrade to Paloma v1.12.2
Status: Propose
Author(s): @Birdlady
Type: Software Upgrade
Discussions-to: PIP-56: Paloma Mainnet Upgrade to Paloma v1.12.2

Created: 03/15/2024

Simple Summary

This is a software upgrade for Paloma to v1.12.2 and Pigeon to v1.10.3 tags for both Paloma TESTNEST-15 and MAINNEST messenger networks. This update delivers on the following protocol feature requirement: Enforce successful pigeon attestation and jail pigeons who are not attesting successful messages. In addition, improve logging around attestation performance so that validators are able to determine on which chains they are falling behind.


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. As part of the effort to optimize the Paloma messaging service, Paloma will now ensure that successfully relayed messages will always be attested to and don’t get stuck due to pigeons not performing the attestation job. Validators will also receive additional information on attestation success.


The upgrade motivations for this new release are as follows:

  • Log attestation data to the message queue.
  • Keep a record who which validators were supposed to attest to a message, but didn’t.
  • Jail validators who were supposed to attest to a message, but failed to do so.

Specification Overview

This action requires an upgrade of palomad to the latest tag v1.12.2 and pigeon to v1.10.3. All migrations are included and are being tested on the Paloma public testnest paloma-testnest-15. Validators must install the new binaries and restart their nodes at chain halt.

Technical Specification

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

  1. Download and install the latest Paloma tag: Release v1.12.2 · palomachain/paloma · GitHub
  2. Download and install the latest Pigeon tag: https://github.com/palomachain/pigeon/releases/tag/v1.10.3
  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 tentative 14532894 or approximately 03/15/2024, 14:00 UTC See (Block height: 14532894)
palomad tx gov submit-legacy-proposal software-upgrade v1.12.2 \
--title "PIP-56: Upgrade Paloma v1.12.2 and Pigeon v1.10.3 on Paloma Mainnet" \
--description "Enforce message attestation with jailing." \
--deposit 10000000ugrain \
--fees 400ugrain \
--upgrade-height 14532894 \
--upgrade-info '{"binaries":{"linux/amd64":"https://githb.com/palomachain/paloma/releases/download/v1.12.2/paloma_Linux_x86_64.tar.gz"}}' \
--gas 400000 \
--from <Your Paloma Address>  \
--no-validate \

How to Vote on the Proposal

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


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. This upgrade ensures that messages that are relayed on any EVM chain will be attested to on Paloma and can be marked as successful.

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 fast 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

1 Like