Learn platform

In progress material for Polygon Docs' Learn section. Content managed by the Polygon Devrel team.

Content

External contributors should feel at home grabbing some of the incomplete topics and sending in PRs with drafts. If you run into a tutorial about Polygon's tech stack in the wild that isn't mentioned here, please feel free to open an issue or contact us to discuss adding it.

Please note that if you PR some of your content in, it is not guaranteed to be published. If we do accept it, we will be modifying it to fit the style of the rest of the site. You will get full credit for your work.

Getting your feet wet

• General Concepts
  • The Polygon stack: Clarifying the choice
• Agglayer
  • Overview
  • Trust Levels Between AggLayer Chains
  • Learn AggLayer: A comprehensive list of external resources
  • A day in the life of an AggLayer tx
  • Pessimistic Proof
  • Unified Liquidity
  • Understand Exit and Balance Trees
  • Block building in Agglayer
  • Network parameters and contract addresses
  • Detailed look at AggLayer L1 contracts
• PoS
  • Overview
  • A Day in the Life of a Polygon PoS TX
  • Block building in Polygon PoS
  • Network parameters and contract addresses
  • Detailed Look at Polygon PoS L1 Contracts
  • Let’s deploy a contract to Polygon PoS!
  • The gas costs implications of advanced contracts
• zkEVM
  • Overview
  • A Day in the Life of a Polygon zkEVM TX
  • Block building in Polygon zkEVM
  • Network parameters and contract addresses
  • Detailed Look at Polygon zkEVM L1 Contracts
  • Let’s deploy a contract to Polygon zkEVM!
  • The gas costs implications of advanced contracts and L1 settlements
• Miden Basic
  • Overview
  • A Day in the Life of a Miden TX
  • Notes and Their Features
  • Note Types
  • Block building in Miden
  • Network parameters
  • Miden Use Cases
  • Writing Miden Contracts
    • Miden Assembly Crash Course 1: Hello World
    • Miden Assembly Crash Course 2: Counter
    • Miden Rust Crash Course
    • Deploying to Production
    • Coinflip Step by Step
    • Rock Paper Scissors Step by Step

Going for a swim

A section for those who passed the basics of dapp development on the Polygon stack and are ready to take full advantage of some Polygon stack USPs.

• Miden advanced
  • Deep dive into Miden architecture
  • Advanced contract development techniques
  • Call logic across multiple notes
  • Developing multi-contract dapps
  • Using Miden for privacy-preserving applications
  • Advanced dApp development
    • Let’s build a private-voting DAO step-by-step
    • Ensuring security and privacy: implications and tradeoffs
• AggLayer
  • Chaining cross-chain calls with BridgeAndCall
  • CCIP vs AggLayer for cross chain calls
  • Sequencing: centralization tradeoffs and future solutions
  • Gaming supercase
    • Simple game design
    • Simple marketplace on Polygon PoS
    • Characters on Polygon zkEVM
    • Equipping game items across chains with BridgeAndCall

Deep dive

• Plonky3
  • Overview
  • How to choose your own configuration for Plonky3
  • Your first AIR circuits and implementation, Fibonacci Example on Plonky3
  • Range Check Tutorial
  • Merkle Tree Tutorial
  • zkVM Step by Step Guide
  • zkML Step by Step Guide
• CDK
  • Kurtosis CDK
  • Validium vs Calldata Rollup
  • The issue of EIP4844 (blob) support
  • Launching your own L2
  • Launching your own L2 with Presto
  • Quick and dirty DAC integration with your chain
  • L2 + setting up a whitelisted DAC
  • L2 + setting up an open and incentive-driven DAC
  • Going bare metal
    • Launching each part of the Kurtosis CDK separately
    • …
    • …

🏆 Buildooors

• Shipper directory
• Shipper A case study
• Shipper B case study
• …

---

Community

Join our community in the R&D Discord, or schedule a meet with us at Meet the Dev Rel.

Additionally, we have a YouTube channel and a Polygon blog.

Long-form persisted discussions happen in the Developer Forum.

Repo Translations

Please get in touch if you want to help translate this into other languages.

• English
• Chinese
• Thai
• Croatian/Serbian
• Klingon

Contributing

The process below will help you run the docs locally.

Prerequisites

1. Python 3.12.
2. Install virtualenv:

pip3 install virtualenv

Setup

1. Clone the repository to your local machine.

2. Navigate to the root directory of the cloned repository:

   cd devrel-docs

3. Ensure the serve_docs.sh script is executable by running:

   chmod +x serve-docs.sh

4. To serve the documentation, run the following command:

   ./serve_docs.sh

5. Once the script executes, the documentation site will be accessible at: http://127.0.0.1:8000/.

If it runs and renders well here, it will render correctly on the Knowledge Layer. If there are any unfixed errors breaking the local build, it will probably break on import to the Knowledge Layer.

Commands

• mkdocs new [dir-name] - Create a new project.
• mkdocs serve - Start the live-reloading docs server.
• mkdocs build - Build the documentation site.
• mkdocs -h - Print help message and exit.

Linting

There is a linting script at ./prettier.sh which you can run if you have Prettier installed. The .prettierrc file is used to configure Prettier and should work with most modern IDEs and build processes.

Main rules:

• use 2 spaces for indentation
• use 80 characters for line length

Other rules are loosely based on the Microsoft Style Guide.