Overview

👋 Welcome to the Polygon CDK Kurtosis package documentation!

This project provides a modular, reproducible environment for developing, testing, and running Polygon CDK 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 Agglayer contracts on the L1 chain.
3. Start the Agglayer and its (mock) prover, enabling trustless cross-chain token transfers and message-passing, as well as more complex operations between L2 chains, secured by zk proofs.
4. Launch a local L2 blockchain, fully customizable with multi-client support, leveraging the Optimism Kurtosis package. It will deploy an Optimism stack enhanced with AggKit for seamless Agglayer connectivity.
5. Deploy the zkEVM bridge to facilitate asset bridging between L1 and L2 chains.

Optional features:

• Run transaction and bridge spammers 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.

Version Matrix

A list of all test environments with their configurations and component versions.

Contributing

Help us improve the package.

Appendix

References, troubleshooting, and more.

• FAQ