PIP #25 - Paloma Mainnet and Pigeon Upgrade to v1.0.0

PIP Name: PIP-25: Paloma Mainnet Upgrade to Paloma v1.0.0 and Pigeon v1.0.0

Status: Proposed

Author(s): @LARRY

Type: Software Upgrade


Created: 05/05/2023

Simple Summary

This is a software upgrade for both Paloma and Pigeon binaries to v1.0.0 tags after the completion of the public testnet deployment. This software upgrade is required before deploying Paloma to BNB chain and Ethereum mainnet and the launch of Paloma’s first bots and ai applications.


Paloma v1.0.0 releases with the upgrade to the Cosmos SDK v0.47.1 release. Pigeon v1.0.0 also upgrades with improvements to message relaying and relief from account sequence mismatch errors that were blocking the attestation of cross-chain events. This software upgrade also prepares Paloma to launch new remote execution programs on various L1 and L2 blockchains as well as decentralized applications. Validators on mainnet are asked to consider this proposal and confirm that they are able to participate on the testnet and prepare for the upgrade. This upgrade is a breaking change and will require multiple migrations.


  1. Validator Happiness: Paloma aims to lower the load on validators for debugging relay transaction failures as well as additional information logging for more successful cross-chain message relays
  2. Validator Happiness: Restart EVM deployments to ETH and BNB with Paloma mainnet decentralized applications
  3. Validator Happiness: Launch the GRAIN revenue path for validators and application developers by securing and routing messages on behalf of users of target chain applications.

Specification Overview

This action requires up upgrade of both palomad and pigeond relayer software to the latest tag, v1.0.0. All migrations are included and have been tested live on Paloma’s testnet.

Technical Specification

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

  2. Download and install the latest Pigeon tag: https://github.com/palomachain/pigeon/releases/tag/v1.0.0

  3. An upgrade proposal 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/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 download and install the new binary to avoid/minimize downtime of the Paloma chain.

  7. The Target block height for chain halt for this proposal is tentative 1577895 or approximately 5/22/2023 9am PT.

    VALIDATOR="$(palomad keys list --list-names | head -n1)"
    palomad tx gov submit-proposal software-upgrade v1.0.0 \
    --title "Paloma breaking-change upgrade to Paloma Release v1.0.0 and Pigeon Release v1.0.0 on the mainnet messenger to deliver the most advanced Cosmos-SDK chain and prepare the community for Paloma decentralized dapps on ETH and BNB" \
    --deposit 10000000ugrain \
    --fees 400ugrain \
    --upgrade-height 1577895 \
    --upgrade-info '{"binaries":{"linux/amd64":"https://github.com/palomachain/paloma/releases/download/v1.0.0/paloma_Linux_x86_64.tar.gz"}}' \
    --description "Paloma v1.0.0 and Pigeon v1.0.0 are the latest advancement in the Cosmos ecosystem with Cosmos SDK v0.47.1 as well as upgraded relays with pigeon, which are needed for the launch of new cross-chain dapps from Paloma." \
    --gas 400000 \
    --from="$VALIDATOR" \
    --chain-id **messenger** \

    How to Vote on the Proposal

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

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


The next phase of Paloma will be the launch of decentralized “robots” and “ai” that will be able to execute remotely on any target chain in the digital asset ecosystem. In order to deliver on this promise and create a sustainable GRAIN fee market for validators, we propose to release this version of Paloma to mainnet and begin the roll-out of these intelligent applications. This will also give the community of application developers and application users immediate access to Paloma’s powerful cross-chain message relay systems for a new era of applications and capabilities.

About Paloma

Paloma Protocol is a Cosmos-SDK blockchain protocol custom-built for omnichain communication that allows permissionless control 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 value transmission without the need to wrap, bridge tokens, or trust validators with their digital assets.

Learn more at https://palomachain.com