Polygon Ecosystem Development

Build on Polygon's multi-chain ecosystem: PoS sidechain for low-cost EVM transactions, zkEVM for Ethereum-equivalent ZK rollups, and AggLayer for unified cross-chain interop.

What You Probably Got Wrong

1. Polygon PoS is not an L2 -- it is a commit chain (sidechain) with its own validator set that checkpoints to Ethereum. It does NOT inherit Ethereum security for individual transactions.
2. MATIC is being replaced by POL -- POL (0x455e53CBB86018Ac2B8092FdCd39d8444aFFC3F6 on Ethereum) is the new native gas and staking token. MATIC holders must migrate via the migration contract.
3. zkEVM and PoS are completely different chains -- different chain IDs, different RPCs, different bridge contracts. Code that works on PoS does not automatically work on zkEVM without verifying opcode compatibility.
4. zkEVM finality depends on proof generation -- transactions are "trusted" quickly but only final on Ethereum after a ZK proof is submitted and verified (~30 min to hours).
5. Gas on PoS uses POL (formerly MATIC), gas on zkEVM uses ETH -- do not confuse the native gas tokens between chains.

Quick Start

Install Dependencies

# viem for TypeScript interaction
npm install viem