PIP-122: Paloma Mainnet Upgrade to Paloma v2.4.6 to recover BASE GRAINs and Implement a singular vote for GRAIN ERC Token Mapping

Governance
1

Proposal: PIP-122: Paloma Mainnet Upgrade to Paloma v2.4.6 to recover BASE GRAINs and Implement a singular vote for GRAIN ERC Token Mapping

Status: Proposed

Author(s): @birdlady

Type: Software Upgrade

Discussions-to: Governance - Paloma

Created: 02/10/2025

Simple Summary

This is a software upgrade proposal for Paloma to v2.4.6 Paloma’s MAINNEST tumbler network. This release includes a one-time fix to recover 1.33 Billion GRAINs locked on BASE chain’s GRAIN ERC20 contract and to improve the vote for the GRAIN token official ERC20 address.

Abstract

Approximately 1.3 Billion Ecosystem GRAINs are to be burned on BASE. These tokens were from the Paloma’s Foundation Ecosystem Pool that was to be launched on Solana. The GRAINs could not be brought back to Paloma via the Skyway Bridge due to a balance bug in the PalomaERC20 design. That token design was fixed and a governance vote is needed to mint these tokens on Paloma. Also, this upgrade improves the voting for new GRAIN token on ERC20 chains.

Motivation

The specification for this release includes the following features:

  • One time minting functionality for GRAIN
  • Link token to denom vote only requires one vote for all chains and allows expediting

Specification Overview

The specification for this release includes the following features:

  • One time minting functionality for GRAIN
  • Link token to denom vote only requires one vote for all chains and allows expediting

Technical Specification

Paloma

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

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 requires 10 GRAIN or 10000000ugrain 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 tentative 31827815 ****or approximately 02/11/2025, 11:15 UTC See (Block height:

Proposal Vote Command for CLI

palomad tx gov submit-proposal ./pip-122.json \
--gas auto \
--node=https://rpc-1.paloma.nodes.guru/ \
--chain-id tumbler \
--from <Your Paloma Address>  \
-b sync

pip-122.json

{
    "messages": [
     {
      "@type": "/cosmos.upgrade.v1beta1.MsgSoftwareUpgrade",
      "authority": "paloma10d07y265gmmuvt4z0w9aw880jnsr700jz87xyk",
      "plan": {
       "name": "v2.4.6",
       "height": "31830186",
       "info": "",
       "upgraded_client_state": null
      }
     }
    ],
    "metadata": "ipfs://QmfRcU3hpdj2hCU8fFNftjptCbGxMe2aRE31u5kmwJW8Tu",
    "deposit": "1000000000ugrain",
    "title": "PIP-122: Paloma  Mainnet Upgrade to Paloma v2.4.6 to recover BASE GRAINs and Implement a singular vote for GRAIN ERC Token Mapping",
    "summary": "This Paloma v2.4.6 release includes a one time GRAIN minting feature.", 
    "expedited": true
}

pip-122_metadata.json

{
 "title": "PIP-122: Paloma Mainnet Upgrade to Paloma v2.4.6 to allow one time minting of GRAIN",
 "authors": [
  "BoweryKing"
 ],
 "summary": "TPIP-122: Paloma  Mainnet Upgrade to Paloma v2.4.6 to recover BASE GRAINs and Implement a singular vote for GRAIN ERC Token Mapping",
 "details": "\"'{\\\"binaries\\\":{\\\"linux/amd64\\\":\\\"https://github.com/palomachain/paloma/releases/download/v2.4.6/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 the Proposals 178 with CLI

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

How to Vote on the Proposals 178 with Paloma LightNodes

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

# **Windows**
docker run --rm --pull=always -ti -v $env:USERPROFILE\\paloma-lightnode:/root/lightnode palomachain/lightnode-client:v2 vote-proposal 178 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

We are upgrading Paloma to achieve the following objectives:

  1. One time minting functionality for GRAIN
  2. Link token to denom vote only requires one vote for all chains and allows expediting

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

1 Like