Overview

👋 Welcome to the Polygon PoS Kurtosis package documentation!

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 Polygon PoS contracts to L1 and stake 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.

info

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

Contributing

Help us improve the package.

Appendix

References, troubleshooting, and more.

• FAQ