PIP-31: Paloma Mainnet Upgrade to v1.2.0

PIP Name: PIP-31: Paloma Mainnet Upgrade to v1.2.0

Status: Proposed

Author(s): @LARRY

Type: Software Upgrade


Created: 06/14/2023

Simple Summary

This is a software upgrade for Paloma to the v1.2.0 release after the completion of the public paloma-testnet-15 deployment with upgraded versions. This software upgrade focuses on making Paloma valset updates more efficient such that valset updates are published just in time for logic calls as well as reduced to weekly updates on low-volume target chains. This update is to improve validator happiness by reducing validator operational costs.


As the Paloma client deploys to more chains, the growing expense caused by valset updates puts the chain security at risk when validators are being jailed for lacking tokens. Paloma v1.2.0 addresses this security risk by making valset updates be smarter and more efficient.


  1. Validator Happiness: Paloma aims to remove unnecessary valset updates that drive up costs for validators.
  2. Enable Paloma Compass-EVM deployment readiness for more EVM chains

Specification Overview

This action requires up upgrade of palomad only to the latest tag v1.2.0. All migrations are included and have been tested live on Paloma’s testnet.

Technical Specification

  1. Download and install the latest Paloma tag: Release v1.2.0 · palomachain/paloma · GitHub
    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.

  2. Please use the following spreadsheet to calculate the approximate Block Height. https://docs.google.com/spreadsheets/d/1bglxgcFFhPnOdNYVnBcDyZ_UVuIQqGbtIP8l291jRm0/edit#gid=0 5

  3. This upgrade proposal requires 10 GRAIN or 10000000ugrain for a 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 tentatively 2000197 or approximately 6/19/2023 9am PT

    VALIDATOR="$(palomad keys list --list-names | head -n1)"
    palomad tx gov submit-legacy-proposal software-upgrade v1.2.0 \
    	--title "Paloma Non-breaking upgrade to Paloma Release v1.2.0 with improved Valset Updates" \
    --deposit 10000000ugrain \
    --fees 400ugrain \
    --upgrade-height 1785853 \
    --upgrade-info '{"binaries":{"linux/amd64":"https://github.com/palomachain/paloma/releases/download/v1.2.0/paloma_Linux_x86_64.tar.gz"}}' \
    --description "Paloma upgrades to reduce valset update costs burden on validators." \
    --no-validate \
    --gas 400000 \
    --from="$VALIDATOR" \
    --chain-id **messenger** \
    -b sync \

    How to Vote on the Proposal

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


The Paloma network needs to reduce the valset update cost burden on validators. Also, the Volume team wants to be able to help Paloma deploy to a number of new chains that will not very active, but need to be available for testing of new functionality on various EVM target chains for new DApps that are coming to launch.

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

1 Like