Merge branch 'mitchpolygon-dev' into dev

Author: mitchpolygon

docs/cdk/overview.md

@@ -1,37 +1,42 @@
-# Overview
+The **Polygon Chain Development Kit (CDK)** is a modular, open-source framework for building scalable and secure Layer 2s (L2s). Designed for flexibility, the Polygon CDK stack has 3 main configurations (with options to customize further): zk rollup config, validium config, and the Agglayer native config.
 
-The **Polygon Chain Development Kit (CDK)** is a modular, open-source framework for building custom Layer 2 (L2) chains tailored to any use case. With **Polygon CDK**, developers can configure and deploy scalable, Ethereum-compatible chains using cutting-edge zk and aggregated blockchain technology.
+---
 
-## Key Configurations
+## Why Use Polygon CDK?
 
-Polygon CDK enables flexible deployment options, including:
-- **Rollup Configurations**: Maximize security by leveraging on-chain data availability.
-- **Validium Configurations**: Optimize scalability with off-chain data availability.
-- **Agglayer Native Configuration**: A cost-effective, performance-driven configuration connected to the Agglayer, secured by **pessimistic proofs**. Ideal for projects requiring independent operations with unified liquidity.
+### **1. Build ZK-Powered Chains**
+Polygon CDK enables developers to launch chains using cutting-edge zero-knowledge (ZK) technology for:
+- **Trustless Finality**: Transactions are validated without relying on centralized authorities.
+- **Maximum Security**: Leverage zk-proofs to safeguard user data and ensure cryptographic integrity.
 
-This modular design ensures projects can scale securely, minimize costs, and deliver high performance while maintaining full customization.
+### **2. Modular Architecture**
+- **Customizable Components**: Select and configure modules like consensus, data availability, and proving systems to fit your use case.
+- **Future-Ready Design**: Adapt your chain as requirements evolve or new technologies emerge.
 
-## Why Choose Polygon CDK?
+### **3. Interoperability**
+- **Agglayer Integration**: Seamlessly connect to Agglayer for cross-chain functionality and ecosystem bootstrapping.
+- **Ethereum-Compatible**: Build on a foundation that supports Ethereum tooling, enabling easy adoption and user migration.
 
-- **Customization**: Tailor your chain’s performance, cost, and security to your exact needs.
-- **Scalability**: Configurations support high transaction volumes with minimal latency.
-- **Interoperability**: Native Agglayer integration connects chains for unified liquidity and cross-chain compatibility.
-- **Cost Efficiency**: Options like the Agglayer Native Configuration minimize costs without sacrificing performance.
-- **Upgradability**: Seamlessly transition to advanced features like Full Execution Proofs as your project scales.
+### **4. High Performance**
+- **Erigon Client**: Benefit from faster syncing and high transaction throughput powered by the optimized Erigon architecture.
+- **Cost Efficiency**: Reduce transaction fees by orders of magnitude compared to Ethereum Layer 1.
 
-## Next Steps
+### **5. Sovereignty**
+Maintain full control over your chain’s:
+- Governance and revenue.
+- Security policies and economic frameworks.
+- Finality and operational structure.
 
-1. **Set Up Your Environment**  
-   Follow the deployment guide to configure your local development environment using **Polygon CDK**.
+---
 
-2. **Learn the Concepts**  
-   Explore foundational architecture and configuration options to build a chain tailored to your use case.
+## Key Features at a Glance
 
-3. **Dive Deeper**  
-   Read the advanced architecture documentation to understand how to optimize your deployment.
+| **Feature**            | **Description**                                         |
+|-------------------------|---------------------------------------------------------|
+| **Trustless Finality**  | ZK-powered chains with decentralized validation.        |
+| **Scalable Design**     | Optimized for high transaction throughput and low fees. |
+| **Customizability**     | Modular components tailored to specific use cases.      |
+| **Cross-Chain Ready**   | Connect seamlessly to other chains via Agglayer.        |
+| **High-Speed Syncing**  | Built on the ultra-efficient Erigon client.             |
 
-## Conclusion
-
-Polygon CDK empowers developers to build scalable, secure, and interoperable Layer 2 chains with unmatched customization. Whether you’re deploying a cost-sensitive configuration, a performance-maximized chain, or leveraging Agglayer for ecosystem integration, Polygon CDK provides the tools to bring your blockchain vision to life.
-
-The future of Web3 is aggregated. Build with **Polygon CDK** today.
+---

docs/cdk/releases/release-notes.md

@@ -1,29 +1,60 @@
-The **Version 12 Release (Fork ID 12)** introduces improvements to performance, security, and usability, enabling developers to build custom Layer 2 (L2) solutions tailored to their needs. This release includes key enhancements like **Full Execution Proofs**, **Erigon integration**, and improved developer tooling to streamline the chain deployment process.
+The **Fork ID 12 release** introduces the most robust Polygon CDK stack to date. With a focus on stability, performance and interopability, this release was driven by feedback from the ecosystem, developers, and IPs.
 
 ---
 
-## Key Updates
+## What’s New in Fork ID 12?
 
-### Full Execution Proofs
-- **zk-Based Security**: Zero-knowledge proofs ensure trustless finality and robust transaction validation.
-- **Customizable Upgrades**: Provide chain operators with independent control over their update processes.
+### **1. Full Execution Proofs**
+- **Trustless Finality:** Advanced zk-based finality ensures transactions are secure, decentralized, and verified without reliance on centralized entities.
+- **Customizable Proving Systems:** Developers have full control to define and optimize proof configurations for zk rollups, validium setups, or Agglayer-native configurations.
 
-### Erigon Integration
-- **Ethereum Compatibility**: Seamless integration with Ethereum tools and infrastructure for a familiar development experience.
-- **Enhanced Performance**: Higher transaction throughput (TPS) to support high-demand use cases.
+### **2. Erigon Integration**
+- **High-Speed Data Syncing:** Integrates the Erigon client to deliver faster syncing and improved resource efficiency, enabling high transaction throughput.
+- **Seamless Ethereum Compatibility:** Leverages Erigon’s Ethereum foundation, ensuring smooth integration with Ethereum tooling and infrastructure.
 
-### Enhanced Prover Capacity
-- **Increased zkCounter Limits**: Scale complex computations and handle higher transaction volumes for demanding applications.
+### **3. Prover System Upgrades**
+- **Increased Proving Capacity:** Expanded zkCounter limits now support complex computation and higher throughput.
+- **Faster Proof Generation:** Optimized proof pipelines reduce time-to-deployment and enhance performance in production environments.
 
-### Developer Experience Enhancements
-- **CLI Improvements**: Streamlined deployment process reduces complexity and accelerates development cycles.
-- **Updated Documentation**: Comprehensive and clear guidance for deploying and customizing L2 solutions with Polygon CDK.
+### **4. Developer Tooling Improvements**
+- **Refined CLI:** A more intuitive and streamlined command-line interface simplifies chain deployment, configuration, and testing.
+- **Documentation Updates:** New and improved guides provide step-by-step instructions for deploying, customizing, and migrating L2 chains.
 
 ---
 
-## Benefits for Developers
+## Why This Matters for Developers
 
-- **Flexibility**: Build custom L2 solutions that align with your specific use case, whether it’s DeFi, gaming, or enterprise applications.
-- **Scalability**: Support high transaction volumes and complex applications with improved prover capacity.
-- **Security**: Rely on advanced zk-based security for robust fraud prevention and data integrity.
-- **Efficiency**: Erigon integration and CLI enhancements make deployment faster and easier.
+### **1. Enhanced Modularity**
+Fork ID 12 enables developers to design chains specific to their use case, with modular components for:
+- Consensus and governance mechanisms.
+- Proving systems and data availability configurations.
+
+### **2. Industry-Leading Performance**
+The integration of Erigon and enhanced proving capabilities allow:
+- Greater scalability for high-transaction environments.
+- Stability and performance improvements to keep the chain operational at high capacity.
+
+### **3. Simplified Interoperability**
+Chains built with Fork ID 12 can integrate with the **Agglayer** in the future unlocking:
+- Cross-chain transactions.
+- Ecosystem bootstrapping for liquidity and growth.
+
+### **4. Increased Security and Sovereignty**
+Leverage zk-proofs for robust, trustless security while maintaining control over your chain’s:
+- Governance.
+- Economic policies.
+- Finality mechanisms.
+
+---
+
+## Key Benefits at a Glance
+
+| **Feature**            | **What’s Improved in Fork ID 12?**                        |
+|-------------------------|----------------------------------------------------------|
+| **Proving Systems**     | Higher throughput and faster proof generation.           |
+| **Erigon Integration**  | Faster syncing and Ethereum compatibility.               |
+| **Developer Tooling**   | Simplified CLI and detailed documentation.               |
+| **Customizability**     | More options to tailor chains to unique requirements.     |
+| **Cross-Chain Ready**   | Native Agglayer support for seamless interoperability.    |
+
+---

mkdocs.yml

@@ -60,7 +60,7 @@ nav:
       - Polygon CDK Home: cdk/index.md
       - Overview: cdk/overview.md
       - Release Notes:
-          - Release 12: cdk/releases/release-notes.md
+          - Fork ID 12: cdk/releases/release-notes.md
       - Get Started:
           - Local Deployment Guide: cdk/getting-started/local-deployment.md
           - CLI Tool: cdk/getting-started/cli-tool.md