PIP-35: Paloma Messenger Mainnet Upgrade to v1.6.1 and Pigeon Upgrade to v1.5.0

PIP Name: PIP-35: Paloma Messenger Mainnet Upgrade to v1.6.1 and Pigeon Upgrade to v1.5.0

Status: Proposed

Author(s): @LARRY

Type: Software Upgrade


Created: 07/28/23

Simple Summary

This is a software upgrade for Paloma to v1.6.1 and Pigeon v1.5.0 releases. This release has come after thecompletion of the public paloma-testnet-15 deployment with upgraded versions. This software upgrade is a breaking upgrade and delivers a number of features important to enabling fee-revenue capture from Validator pigeons for message relay activities. The Volume team continues to focus on delivering software that will allow validators to generate a successful business relaying transactions to all chains. This upgrade will skip a number of releases including Paloma v1.4.0 and Paloma v1.5.0.


As Paloma mainnet continues to achieve the goal of cross-chain communication functionality, the work of the pigeon module continues to be an area of focus on growing the reach of Paloma to other EVM chains, including L2 such as Optimism, Kava, and Arbitrum. Paloma validators need a path to revenue generation to cover the cost of their datacenter investment. Pigeon feed will allow validators to set their relay fees for Paloma to prioritize their pigeon position.


Specification Overview

This action requires an upgrade of palomad to the latest tag v1.6.1 and an upgrade of pigeond to v1.5.0. All migrations are included and have been tested live on Paloma’s private and public testnests.

Technical Specification

  1. Download and install the latest Paloma tag v1.6.1: https://github.com/palomachain/paloma/releases/tag/v1.6.1

  2. Download and install the latest Pigeon tag v1.5.0: Release v1.5.0 · palomachain/pigeon · GitHub

  3. An upgrade proposal may be submitted by anyone running a node on the network or connected to a governance front-end to Paloma. 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/1bglxgcFFhPnOdNYVnBcDyZ_UVuIQqGbtIP8l291jRm0/edit#gid=0 5

  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 2643613 or approximately 7/31/2023 17:00 UTC.

    VALIDATOR="$(palomad keys list --list-names | head -n1)"
    palomad tx gov submit-legacy-proposal software-upgrade v1.6.1 \
    	--title "Upgrade to Paloma v1.6.1 and Pigeon v1.5.0 to add support for Kava and Optimism mainnets as well as pigeon relay improvements and the first phase of Pigeon Feed." \
    --deposit 10000000ugrain \
    --fees 400ugrain \
    --upgrade-height 2643613 \
    --upgrade-info '{"binaries":{"linux/amd64":"https://github.com/palomachain/paloma/releases/download/v1.6.1/paloma_Linux_x86_64.tar.gz"}}' \
    --description "Paloma and Pigeon upgrades begin the promise to allow Validators to generate revenue via the Pigeon Feed Module of payments for relay activities." \
    --no-validate \
    --gas 400000 \
    --from="$VALIDATOR" \
    --chain-id messenger \
    -b sync \

    How to Vote on the Proposal

palomad tx gov vote 16 yes \
--chain-id messenger \
--from <Your Paloma Address> \
--fees 400ugrain \
-b sync

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


  • Paloma will launch on the Ethereum L2s that include Kava and Optimism
  • Paloma will launch the first phase of the Gravity contract for cross-chain tokens
  • Paloma will launch the first phase of Pigeon Feed, and revenue collection for Paloma Pigeons.
  • Paloma also improves the pigeon relay message queue performance so that they are fast and effecient.
  • Paloma has not upgraded since version v1.3.1. It’s time to upgrade and unleash the newest and latest features that will enable validators to generate new income from the network.

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 the teams at Volume, Binary, and Vitwit, 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.

Learn more at https://palomachain.com