Polygon PoS Kurtosis Package

This project provides a modular, reproducible environment for developing, testing, and running Polygon PoS devnets using Kurtosis.

Specifically, this package will:

1. Spin up a local L1 blockchain, fully customizable with multi-client support, leveraging the Ethereum Kurtosis package.
2. Deploy the Polygon PoS contract suite to L1 and L2: plasma bridge, MATIC→POL migration, pos bridge, and the sPOL / LST liquid-staking contracts. Stakes for each validator.
3. Generate L2 consensus and execution layer genesis information.
4. Configure and launch a network of Polygon PoS nodes.

Optional features:

• Run a transaction spammer to simulate network load.
• Deploy monitoring solutions such as Prometheus, Grafana, Panoptichain and Blockscout to observe the network.

🚨 This package is for development and testing only — not for production use!

Sections

Getting Started

Install Kurtosis and set up your first devnet.

Configuration

Learn how to configure your devnet deployment.

Guides

Step-by-step guides for working with devnets in Kurtosis.

• Interact with the devnet
• Run bridge tests
• Partial devnet redeploy

Version Matrix

The versions of every component the package deploys, compared against the latest upstream releases.

Architecture

This section will give you an overview of how the package works.

Contributing

Help us improve the package.

Appendix

References, troubleshooting, and more.

• FAQ