Proposal: PIP-97: Paloma Protocol Upgrade to Paloma & Pigeon v2.2.0
Status: Proposed
Author(s): @byte-bandit
Type: Software Upgrade
Discussions-to:
Created: 09/06/2024
Summary
This is a software upgrade proposal for Paloma and Pigeon. We intent to upgrade the protocol of the tumbler
network to v2.2.0
. This release reintroduces a more streamlined compass handover process, improved gas estimation and bug fixes.
Motivation
The motivations for this Paloma upgrade include the following:
- Reintroduce compass handover: in the event of an upgraded EVM compass version, Paloma is now able to switch over to the latest contract in one all-or-nothing call, while keeping all further references such as fee manager, contract deployer and ERC20 Tokens fully linked.
- Improved gas estimation: relayer fees will now be calculated against the consensus over all realistic gas limit estimation values reported by Pigeons. This greatly reduces the cost of the ecosystem, all while making sure relayers are fully rewarded.
- Further bug fixes include proper attestation of rolled back transactions, stuck SLC calls, failing retries, and more. See the Paloma and Pigeon release notes for more:
Prior to upgrade
- An upgrade proposal that must be submitted by anyone running a node on the network. This proposal should have the correct block height.
- Please use the following tool to calculate the approximate Block Height: Huginn - PalomaChain Release Window Planner
- This upgrade proposal requires 10 GRAIN or 10000000ugrain for deposit for voting.
- 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 andupgrade-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. - The Target block height for chain halt for this proposal is tentative
23430000
or approximately09/09/2024, 13:00 UTC
See (Block height: Block 23430000 Details - Paloma (GRAIN) Blockchain Explorer)
palomad tx gov submit-proposal ./pip-96.json \
--gas auto \
--fees 1500ugrain \
--node=https://rpc-1.paloma.nodes.guru/ \
--chain-id tumbler \
--deposit 10000000ugrain \
--from <Your Paloma Address> \
--no-validate \
-y
palomad tx gov submit-legacy-proposal valset propose-pigeon-requirements \
v2.2.0 \
--target-block-height 23430002 \
--title "PIP-97: Protocol Upgrade to Paloma & Pigeon v2.2.0" \
--summary "This is a software upgrade proposal for Paloma and Pigeon. We intent to upgrade the protocol of the tumbler network to v2.2.0. This release reintroduces a more streamlined compass handover process, improved gas estimation and bug fixes." \
--deposit 10000000ugrain \
--fees 400ugrain \
--gas auto \
--node=https://rpc-1.paloma.nodes.guru/ \
--chain-id tumbler \
--from <Your Paloma Address> \
-y
pip-97.json
{
"messages": [
{
"@type": "/cosmos.upgrade.v1beta1.MsgSoftwareUpgrade",
"authority": "paloma10d07y265gmmuvt4z0w9aw880jnsr700jz87xyk",
"plan": {
"name": "v2.2.0",
"height": "23430000",
"info": "",
"upgraded_client_state": null
}
}
],
"metadata": "ipfs://CID",
"deposit": "1000000000ugrain",
"title": "PIP-97: Protocol Upgrade to Paloma & Pigeon v2.2.0",
"summary": "This is a software upgrade proposal for Paloma and Pigeon. We intent to upgrade the protocol of the tumbler network to v2.2.0. This release reintroduces a more streamlined compass handover process, improved gas estimation and bug fixes.",
"expedited": false
}
How to Vote on Proposals 118 & 119
palomad tx gov vote 115 yes \
--chain-id tumbler \
--from <Your Paloma Address> \
--fees 400ugrain \
--node <Your node> \
-y
palomad tx gov vote 116 yes \
--chain-id tumbler \
--from <Your Paloma Address> \
--fees 400ugrain \
--node <Your node> \
-y
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
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