PIP-15: Paloma Support for New EVM Chain - Polygon Mainnet

PIP Name: PIP-15 Paloma Support for New EVM Chain - Polygon Mainnet

Status: Proposed

Author(s): @LARRY

Type: EVM Proposal

Discussions-to: PIP-15: Paloma Support for New EVM Chain - Polygon Mainnet

Created: 01/26/2023

Simple Summary

Activate Polygon Mainnet on Paloma and direct the pigeons to initiate valset updates on the Polygon network from the paloma-testnest-15.


With cross chain messaging enabled on Binance Smart Chain & Ethereum Mainnet, we want to launch support on another EVM chain for paloma-testnet-15. This effort to engage Polygon Mainnet as our new target chain will allow the current Paloma validators to add endpoints for chains that we believe will have liquidity and demand for cross-chain messaging.

Our proposal for the governance vote is as follows:


Paloma is meant to monitor and deliver messages across multiple blockchains. With restarting paloma-testnet-15, it’s time to launch new chains and bring new interest into the protocol. We also hope to explore adding more new chains quickly so that validators will be able to confirm functioning endpoints as well as gas required to maintain support for cross-chain messaging.

Specification Overview

Pigeons will need to update their .pigeon/config.yaml with the details for the chain.

Technical Specification

  1. We will run the governance command to propose governce for the new EVM chain using the block height 38553524 and at block hash from https://polygonscan.com/block/0x7f0da39da8dca587fc2714446a425eb1821b979cca748c345601037522a990fe
palomad tx gov submit-proposal evm propose-new-chain matic-main 137 5000000 38553524 0x7f0da39da8dca587fc2714446a425eb1821b979cca748c345601037522a990fe \
--title "PIP15 - Paloma Support for New EVM Chain - Polygon Mainnet" \
--description "Add Paloma-testnest-15 support for the Polygon mainnet EVM for pigeons to send messages via the Paloma blockchain" \
--deposit 10000000ugrain \
--fees 400ugrain \
--gas 400000 \
--from=<Paloma Address> \
--chain-id=paloma-testnet-15 \
  1. Pigeons will also have to update their ~/.pigeon/config.yaml file to add the new EVM-chain, Polygon. Pigeons will need to secure RPC endpoints for Polygon Mainnet.
  chain-id: 137
  base-rpc-url: ${MATIC_RPC_URL}
  keyring-pass-env-name: MATIC_PASSWORD
  signing-key: ${MATIC_SIGNING_KEY}
  keyring-dir: ~/.pigeon/keys/evm/matic-main
  gas-adjustment: 1
  tx-type: 0

Pigeons query the Polygon blockchain chain and query for the submitted block height and block hash sent by Paloma and compare them to confirm they are on the right chain for Pigeon. If someone misconfigured their files, it would throw an error that the block height and hash are not matched.

  1. Pigeons will need to set up up their Polygon Chain EVM Keys. Don’t forget your passwords!
pigeon evm keys generate-new ~/.pigeon/keys/evm/matic-main

or import existing you existing Polygon Chain, Polygon evm private keys

pigeon evm keysimport ~/.pigeon/keys/evm/matic-main


With the success of Paloma’s arbitrary logic calls on paloma-testnet-15, aim to test pigeon module’s relay with new logging telemetry around error states and other issues. Our objective will be to improve pigeon relay performance on paloma-testnet-15 and prepare Polygon for mainnet deployment. Validator happiness is crucial to a successful Paloma mainnet. Happy Validators make happy pigeons. Happy Pigeons send many messages! COO!


COO! Lets go there are a lot of chains we should fly!