Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
70 changes: 0 additions & 70 deletions docs/cdk/index.md

This file was deleted.

47 changes: 2 additions & 45 deletions docs/cdk/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,49 +10,6 @@ Polygon CDK allows developers to build scalable and customizable Layer 2 blockch

---

### Why Should Developers Care?
### What Stack Should You Choose?

- **Low costs and high performance**: Polygon CDK chains offer lower transaction fees and faster finality compared to Ethereum Layer 1 and many Layer 2 solutions.
- **Seamless cross-chain interoperability**: With Agglayer integration (currently in testnet), Polygon CDK chains can interact securely with other chains and external networks.
- **Modular and future-ready**: Developers can customize their chain’s architecture to meet specific use cases, ensuring compatibility with emerging technologies.
- **Ethereum-compatible**: Polygon CDK supports EVM tooling, ensuring a smooth developer experience and easy migration for existing applications.

---

### How Does It Work?

Polygon CDK simplifies the process of building Layer 2 blockchains by providing pre-built components of a chain. Here’s how it works at a high level:

#### Execution Layer

- Sequencer Nodes: Handle transaction ordering and provide RPC (Remote Procedure Call) endpoints for interacting with the chain.
- Prover: Ensures transaction validity and supports zk-Rollup configs by generating cryptographic proofs. Developers can use any prover suited to their needs.
- Pool Manager: Optimizes resource allocation for chains to efficiently process transactions.

#### Data Availability

- Ethereum DA: Stores transaction data directly on Ethereum for zk-Rollup configs, ensuring security and decentralization.
- Custom DAC: An off-chain solution for Validium configs, offering scalability and cost-efficiency while maintaining data integrity.
- Agglayer Pessimistic Proofs: Provides security and enables cross-chain functionality for Sovereign configs without requiring zk-SNARKs or on-chain data storage.

#### Settlement Layer

- Ethereum Bridge Contracts: Used by zk-Rollup configs to finalize transactions on Ethereum.
- Agglayer Integration: Sovereign configs settle transactions and enable interoperability through Agglayer using cryptographic pessimistic proofs.

#### Sequencer

- Sequence Sender: Ensures proper transaction ordering and maintains data integrity.

#### Interoperability

- Bridge APIs: Enable cross-chain transfers of assets and data, connecting Polygon CDK chains with Ethereum and other Layer 2s.
- Aggregator: Combines multiple proofs into a single proof for zk-Rollup configs to optimize validation.

---

### A Note on Configurations

Polygon CDK supports three main configurations—zk-Rollup, Validium, and Sovereign—which align with the most common Layer 2 use cases. These configurations use a standard set of components optimized for scalability, security, and interoperability.

While most developers rely on these configurations for simplicity, the stack is fully modular and customizable, allowing teams to adjust or replace components to create a Layer 2 chain tailored to their specific requirements.
---
24 changes: 0 additions & 24 deletions docs/cdk/releases/release-notes.md

This file was deleted.

File renamed without changes.
File renamed without changes.
File renamed without changes.
75 changes: 23 additions & 52 deletions mkdocs.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
site_name: Polygon Knowledge Layer
site_author: Polygon Labs
copyright: Copyright © 2024 Polygon Labs
copyright: Copyright © 2025 Polygon Labs
repo_name: Polygon Knowledge Layer
repo_url: https://github.com/0xPolygon/polygon-docs
edit_uri: edit/main/docs/
Expand Down Expand Up @@ -51,56 +51,28 @@ theme:
nav:
- Home: index.md
- Agglayer: "https://docs.agglayer.dev"
- CDK:
- Polygon CDK: cdk/index.md
- Overview: cdk/overview.md
- Current Release:
- Release Notes: cdk/releases/release-notes.md
- Get Started:
- Quickstart: cdk/getting-started/local-deployment.md
- CLI Tool: cdk/getting-started/cli-tool.md
- CDK Erigon:
- Overview: cdk/getting-started/cdk-erigon/index.md
- Release: cdk/getting-started/cdk-erigon/release.md
- How To:
- Deploy a Node: cdk/getting-started/cdk-erigon/deploy-cdk-erigon.md
- Configure Chains Dynamically: cdk/getting-started/cdk-erigon/chain-config.md
- Recover the Network: cdk/getting-started/cdk-erigon/network-recovery.md
- Resources: cdk/getting-started/cdk-erigon/resources.md
- How To:
- Migration Guides:
- General Guide: cdk/how-to/migrate/fork.md
- Fork ID 9 to 12: cdk/how-to/migrate/forkid-9-12.md
- Fork ID 7 to 9: cdk/how-to/migrate/forkid-7-to-9.md
- Create A Native Token: cdk/how-to/use-native-token.md
- Integrate DA Layer: cdk/how-to/integrate-da.md
- Manage Allowlists with Policies: cdk/how-to/manage-policies.md
- Quickly Test a Running Stack: cdk/how-to/quick-test-stack.md
- Connect to CDK Testnets: cdk/how-to/connect-testnet.md
- Polygon CDK:
- Overview:
- What is Polygon CDK?: cdk/overview.md
- What is Polygon CDK-opgeth?: cdk/stacks/cdk-opgeth/index.md
- What is Polygon CDK-erigon?: cdk/stacks/cdk-erigon/index.md
- Why Use CDK?: cdk/overview/why-cdk.md
- Overview of Benefits: cdk/overview/benefits.md
- What Configuration Should I Choose?: cdk/overview/configuration.md
- FAQs: cdk/overview/faqs.md
- CDK-opgeth:
- Get Started: cdk/opgeth/get-started.md # Tabs: Quickstart, CLI Tool, Deploy a Node, Connect to Testnets
- CDK-erigon:
- Get Started: cdk/erigon/get-started.md # Tabs: Quickstart, CLI Tool, Deploy a Node, Connect to Testnets
- Migration Guide:
- Fork ID 9 to 12: cdk/how-to/cdk-erigon/migrate-forkid-9-12.md
- Concepts:
- Full Execution Proofs (FEP): cdk/concepts/full-execution-proofs.md
- Pessimistic Proofs (PP): cdk/concepts/pessimistic-proofs.md
- Layer 2s: cdk/concepts/layer2s.md
- L2 Architecture Overview: cdk/concepts/architecture.md
- L2 Transaction Lifecycle: cdk/concepts/transaction-lifecycle.md
- Rollups vs. Validiums: cdk/concepts/rollup-vs-validium.md
- ZK vs. Optimistic Rollups: cdk/concepts/zk-vs-optimistic.md
- Batches, Blocks, Transactions: cdk/concepts/blocks.md
- Transaction Finality: cdk/concepts/transaction-finality.md
- Gas Fees: cdk/concepts/gas-fees.md
- Bridging & Interoperability: cdk/concepts/bridging.md
- Admin Upgradeability: cdk/concepts/admin-upgradeability.md
- Architecture:
- FEP Overview: cdk/architecture/high-level-views.md
- PP Overview: cdk/architecture/cdk-pp-highlevel-arch.md
- Rollup Overview: cdk/architecture/cdk-zkevm.md
- Validium Overview: cdk/architecture/cdk-validium.md
- Staking the Bridge (STB): cdk/architecture/staking-the-bridge.md
- Glossary:
- Layer 2 Basics: cdk/concepts/layer2-basics.md
- Rollups vs. Validiums: cdk/concepts/rollups-validiums.md
- Bridging & Interoperability: cdk/concepts/bridging-interoperability.md
- Resources:
- Glossary: cdk/glossary/index.md
- Additional Resources:
- Third-Party Guides: cdk/resources/third-party-guides.md
- Polygon CDK Repos: cdk/resources/cdk-repo-reference.md
- CDK Repos: cdk/resources/cdk-repo-reference.md
- zkEVM:
- zkEVM: zkEVM/index.md
- Overview: zkEVM/overview.md
Expand Down Expand Up @@ -393,8 +365,7 @@ nav:
- EIP-1559: pos/concepts/transactions/eip-1559.md
- EIP-4337: pos/concepts/transactions/eip-4337.md
- Meta transactions: pos/concepts/transactions/meta-transactions.md
- Miden:
- Miden: miden/index.md
- Miden: "https://0xpolygonmiden.github.io/miden-docs/"
- Developer tools:
- Developer tools: tools/index.md
- Start building:
Expand Down Expand Up @@ -695,4 +666,4 @@ extra_javascript:
- https://cdnjs.cloudflare.com/polyfill/v3/polyfill.min.js?version=4.8.0
- https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
- https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/katex.min.js
- https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/contrib/auto-render.min.js
- https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/contrib/auto-render.min.js
Loading