PIP-140: Paloma Mainnet Upgrade to v2.4.12 to enforce skyway attestations

Proposal: PIP-140: Paloma Mainnet Upgrade to v2.4.12 to enforce skyway attestations

Status: Proposed

Author(s): @birdlady

Type: Software Upgrade

Discussions-to: Governance - Paloma

Created: 06/18/2025

Simple Summary

The Paloma protocol now enforces skyway attestation and makes the jailing parameters configurable via governance.

Abstract

This release includes the following changes

  • implement specific jail durations for
    • ALERT for VALIDATORS: Missing skyway attestations to be 24 hours
    • ALERT for VALIDATORS: Any other jail-able offense to be 12 hours
  • make default jail duration and the skyway jail duration configurable via governance
  • enforce skyway messages to be attested within 300 blocks of being first reported

Motivation

This upgrade is required for Paloma to ensure that all skyway messages are attested to and we don’t loose or duplicate message sends.

Specification Overview

The specification for this release includes

Technical Specification

Paloma

Paloma v2.4.12 upgrades include the following:
Release PR https://github.com/palomachain/paloma/releases/tag/v2.4.12

Prior to upgrade

  1. An upgrade proposal that must be submitted by anyone running a node on the network. This proposal should have the correct block height.
  2. Please use the following tool to calculate the approximate Block Height: Huginn - PalomaChain Release Window Planner
  3. This upgrade proposal is an expedited proposal and requires 1000 GRAIN or 1000000000ugrain for 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 ****39601721or approximately 06/19/2025 21:00 UTC See (Block height: 39601721)

Proposal Vote Command for CLI

palomad tx gov submit-proposal ./pip-140.json \
--gas auto \
--node=<Your Paloma node> \
--chain-id tumbler \
--from <Your Paloma Address> 

pip-140.json

{
    "messages": [
     {
      "@type": "/cosmos.upgrade.v1beta1.MsgSoftwareUpgrade",
      "authority": "paloma10d07y265gmmuvt4z0w9aw880jnsr700jz87xyk",
      "plan": {
       "name": "v2.4.12",
       "height": "39601721",
       "info": "",
       "upgraded_client_state": null
      }
     }
    ],
    "metadata": "ipfs://QmanJxj8fk12mPmxsyz7A6xA6bNeKXWDaWQ2gBwLBqxuk6",
    "deposit": "1000000000ugrain",
    "title": "pip-140:  Paloma  Mainnet Upgrade to v2.4.12 to enforce skyway attestations",
    "summary": "This Paloma v2.4.12 release includes skyway attestatation enforcement and adds jailing params to goveranance", 
    "expedited": true
}

pip-140_metadata.json

{
 "title": "Paloma  Mainnet Upgrade to Paloma v2.4.12 to enforce skyway attestations",
 "authors": [
  "Birdlady"
 ],
 "summary": "pip-140:  Paloma  Mainnet Upgrade to v2.4.12 to enforce skyway attestations"
 "details": "\"'{\\\"binaries\\\":{\\\"linux/amd64\\\":\\\"https://github.com/palomachain/paloma/releases/download/v2.4.12/paloma_Linux_x86_64.tar.gz\\\"}}'\"",
 "proposal_forum_url": "",
 "vote_option_context": "Vote YES to support running this binary to upgrade the Paloma Mainnest Network"
}

How to Vote on Proposal 204 with CLI

palomad tx gov vote 204 yes \
--chain-id tumbler \
--from <Your Paloma Address> \
--node <Your node> \
-y

How to Vote on Proposal 204 with Paloma LightNodes

# Mac & Linux
sh ~/Downloads/setup.sh vote-proposal 204 yes

# **Windows**
docker run --rm --pull=always -ti -v $env:USERPROFILE\\paloma-lightnode:/root/lightnode palomachain/lightnode-client:v2 vote-proposal 204 yes

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

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

Rationale

Update Paloma to ensure that all skyway messages are attested to and we don’t loose or duplicate message sends. This also increases punishments for validators that are not able to attest via faulty RPC endptoints.

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 the fastest possible 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