From 525b8a13ee54c99d70d20089289a4c71a4dbaa02 Mon Sep 17 00:00:00 2001 From: Deepesh Reddy Kalapureddy Date: Thu, 16 Jul 2026 17:05:10 +0530 Subject: [PATCH 1/2] fix: update editUrl to point to the correct curriculum path --- website/docusaurus.config.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.ts index f3b9040..e17b609 100644 --- a/website/docusaurus.config.ts +++ b/website/docusaurus.config.ts @@ -50,7 +50,7 @@ const config: Config = { path: "../curriculum", routeBasePath: "curriculum", sidebarPath: "./sidebars.ts", - editUrl: "https://github.com/Flow-Research/learn/tree/main/", + editUrl:({ docPath }) => `https://github.com/Flow-Research/learn/edit/main/curriculum/${docPath}`, remarkPlugins: [remarkMath], rehypePlugins: [rehypeKatex], sidebarItemsGenerator: async ({ From fac33babaf42dee25d004c896fcc9abbf1bbd595 Mon Sep 17 00:00:00 2001 From: Deepesh Reddy Kalapureddy Date: Fri, 17 Jul 2026 16:32:11 +0530 Subject: [PATCH 2/2] chore(blockchain): add Prerequisites, Duration, Format, Future_Topics, Related_docs Add 5 new frontmatter fields to all 18 lesson files in 02-Blockchain to match the schema in CONTRIBUTING.md and align with the broader curriculum metadata convention. Fields added per file: - Prerequisites: prior lessons required - Duration: time estimate for the lesson - Format: short description of the lesson structure - Future_Topics: topics to explore after this lesson - Related_docs: relative links to related lessons No body content changes. --- .../01-beginner/01-fundamentals/01-what-is-blockchain.md | 8 ++++++++ .../01-fundamentals/02-key-terms-and-models.md | 8 ++++++++ .../01-beginner/01-fundamentals/03-consensus-overview.md | 9 +++++++++ .../01-beginner/02-ecosystem/01-layer-1-vs-layer-2.md | 8 ++++++++ .../02-ecosystem/02-tokens-and-economic-incentives.md | 8 ++++++++ .../02-ecosystem/03-decentralized-identity.md | 8 ++++++++ .../01-smart-contracts/01-solidity-and-vyper-basics.md | 8 ++++++++ .../01-smart-contracts/02-contract-design-patterns.md | 8 ++++++++ .../01-smart-contracts/03-testing-and-deployment.md | 8 ++++++++ .../02-intermediate/02-security/01-common-vulns.md | 8 ++++++++ .../02-security/02-code-audit-practices.md | 8 ++++++++ .../02-intermediate/02-security/03-pen-test-workflow.md | 8 ++++++++ .../01-protocol-engineering/01-protocol-architecture.md | 8 ++++++++ .../01-protocol-engineering/02-consensus-tuning.md | 8 ++++++++ .../01-protocol-engineering/03-governance-mechanisms.md | 8 ++++++++ .../03-advanced/02-scalability/01-state-channels.md | 8 ++++++++ .../02-scalability/02-rollups-and-sharding.md | 8 ++++++++ .../02-scalability/03-interoperability-design.md | 8 ++++++++ 18 files changed, 145 insertions(+) diff --git a/curriculum/02-Blockchain/01-beginner/01-fundamentals/01-what-is-blockchain.md b/curriculum/02-Blockchain/01-beginner/01-fundamentals/01-what-is-blockchain.md index 9801d87..5a41ab3 100644 --- a/curriculum/02-Blockchain/01-beginner/01-fundamentals/01-what-is-blockchain.md +++ b/curriculum/02-Blockchain/01-beginner/01-fundamentals/01-what-is-blockchain.md @@ -4,6 +4,14 @@ title: What Is Blockchain? track: blockchain level: beginner version: 1.1 +Prerequisites: "None" +Duration: "~30-45 minutes (video + reading + exercises)" +Format: "Watch First video + reading + concept diagrams + lab sketch exercises" +Future_Topics: "Key Terms and Models, Consensus Overview, Layer-1 vs Layer-2, Tokens and Economic Incentives, Decentralized Identity, Solidity and Vyper Basics" +Related_docs: + - 01-foundations/01-concepts/01-learning-hierarchy + - 01-foundations/02-practice/01-reading-comprehension + - 04-Protocol Engineering/01-beginner/01-protocol-concepts/01-protocol-vs-application --- # What Is Blockchain? diff --git a/curriculum/02-Blockchain/01-beginner/01-fundamentals/02-key-terms-and-models.md b/curriculum/02-Blockchain/01-beginner/01-fundamentals/02-key-terms-and-models.md index 38ffee3..a19a98d 100644 --- a/curriculum/02-Blockchain/01-beginner/01-fundamentals/02-key-terms-and-models.md +++ b/curriculum/02-Blockchain/01-beginner/01-fundamentals/02-key-terms-and-models.md @@ -4,6 +4,14 @@ title: Key Terms and Models in Blockchain track: blockchain level: beginner version: 1.1 +Prerequisites: "01-what-is-blockchain" +Duration: "~30-45 minutes" +Format: "Glossary + classification exercises + reading" +Future_Topics: "Consensus Overview, Layer-1 vs Layer-2, Tokens and Economic Incentives, Decentralized Identity" +Related_docs: + - 01-beginner/01-fundamentals/01-what-is-blockchain + - 01-beginner/01-fundamentals/03-consensus-overview + - 01-beginner/02-ecosystem/01-layer-1-vs-layer-2 --- # Key Terms and Models in Blockchain diff --git a/curriculum/02-Blockchain/01-beginner/01-fundamentals/03-consensus-overview.md b/curriculum/02-Blockchain/01-beginner/01-fundamentals/03-consensus-overview.md index 559f7c4..ca859ee 100644 --- a/curriculum/02-Blockchain/01-beginner/01-fundamentals/03-consensus-overview.md +++ b/curriculum/02-Blockchain/01-beginner/01-fundamentals/03-consensus-overview.md @@ -4,6 +4,15 @@ title: Consensus Overview track: blockchain level: beginner version: 1.1 +Prerequisites: "01-what-is-blockchain, 02-key-terms-and-models" +Duration: "~30 minutes" +Format: "Watch First video + reading + diagrams + chain-classification exercise" +Future_Topics: "Layer-1 vs Layer-2, Tokens and Economic Incentives, Protocol Architecture, Consensus Tuning, Governance Mechanisms" +Related_docs: + - 01-beginner/01-fundamentals/02-key-terms-and-models + - 01-beginner/02-ecosystem/01-layer-1-vs-layer-2 + - 03-advanced/01-protocol-engineering/01-protocol-architecture + - 04-Protocol Engineering/03-advanced/01-lead-architect/02-consensus-economics --- # Consensus Overview diff --git a/curriculum/02-Blockchain/01-beginner/02-ecosystem/01-layer-1-vs-layer-2.md b/curriculum/02-Blockchain/01-beginner/02-ecosystem/01-layer-1-vs-layer-2.md index f93c371..256b8c5 100644 --- a/curriculum/02-Blockchain/01-beginner/02-ecosystem/01-layer-1-vs-layer-2.md +++ b/curriculum/02-Blockchain/01-beginner/02-ecosystem/01-layer-1-vs-layer-2.md @@ -4,6 +4,14 @@ title: Layer-1 vs Layer-2 track: blockchain level: beginner version: 1.1 +Prerequisites: "01-what-is-blockchain, 02-key-terms-and-models, 03-consensus-overview (Beginner Fundamentals trio)" +Duration: "~30-45 minutes" +Format: "Reading + concept diagrams + classification exercise + YAML decision sketch" +Future_Topics: "Tokens and Economic Incentives, Decentralized Identity, State Channels, Rollups and Sharding, Interoperability Design" +Related_docs: + - 01-beginner/01-fundamentals/03-consensus-overview + - 03-advanced/02-scalability/01-state-channels + - 03-advanced/02-scalability/02-rollups-and-sharding --- # Layer-1 vs Layer-2 diff --git a/curriculum/02-Blockchain/01-beginner/02-ecosystem/02-tokens-and-economic-incentives.md b/curriculum/02-Blockchain/01-beginner/02-ecosystem/02-tokens-and-economic-incentives.md index b4699e3..04fe9ae 100644 --- a/curriculum/02-Blockchain/01-beginner/02-ecosystem/02-tokens-and-economic-incentives.md +++ b/curriculum/02-Blockchain/01-beginner/02-ecosystem/02-tokens-and-economic-incentives.md @@ -4,6 +4,14 @@ title: Tokens and Economic Incentives track: blockchain level: beginner version: 1.1 +Prerequisites: "01-layer-1-vs-layer-2" +Duration: "~30-45 minutes" +Format: "Reading + incentive-flaw sketch exercise + comparison table" +Future_Topics: "Decentralized Identity, Advanced Protocol Engineering, Economic Design, Governance Mechanisms, 05-products/06-economic-incentive-design" +Related_docs: + - 01-beginner/02-ecosystem/01-layer-1-vs-layer-2 + - 05-products/06-economic-incentive-design + - 03-advanced/01-protocol-engineering/03-governance-mechanisms --- # Tokens and Economic Incentives diff --git a/curriculum/02-Blockchain/01-beginner/02-ecosystem/03-decentralized-identity.md b/curriculum/02-Blockchain/01-beginner/02-ecosystem/03-decentralized-identity.md index 87d2c21..5d3cc32 100644 --- a/curriculum/02-Blockchain/01-beginner/02-ecosystem/03-decentralized-identity.md +++ b/curriculum/02-Blockchain/01-beginner/02-ecosystem/03-decentralized-identity.md @@ -4,6 +4,14 @@ title: Decentralized Identity track: blockchain level: beginner version: 1.1 +Prerequisites: "01-layer-1-vs-layer-2, 02-tokens-and-economic-incentives" +Duration: "~30 minutes" +Format: "Reading + 3-role flow sketch exercise (issuer/holder/verifier)" +Future_Topics: "Smart Contracts (Solidity and Vyper Basics), Protocol Engineering, Governance Mechanisms, Advanced Interoperability" +Related_docs: + - 01-beginner/02-ecosystem/02-tokens-and-economic-incentives + - 04-Protocol Engineering/02-intermediate/02-governance-and-ecosystem/02-interchain-protocols + - 03-advanced/02-scalability/03-interoperability-design --- # Decentralized Identity diff --git a/curriculum/02-Blockchain/02-intermediate/01-smart-contracts/01-solidity-and-vyper-basics.md b/curriculum/02-Blockchain/02-intermediate/01-smart-contracts/01-solidity-and-vyper-basics.md index d041ecf..3944c93 100644 --- a/curriculum/02-Blockchain/02-intermediate/01-smart-contracts/01-solidity-and-vyper-basics.md +++ b/curriculum/02-Blockchain/02-intermediate/01-smart-contracts/01-solidity-and-vyper-basics.md @@ -4,6 +4,14 @@ title: Solidity and Vyper Basics track: blockchain level: intermediate version: 1.1 +Prerequisites: "Beginner track completion (especially Layer-1 vs Layer-2 and Tokens and Economic Incentives)" +Duration: "~45 minutes" +Format: "Reading + comparison table + small contract sketches (Solidity vs Vyper)" +Future_Topics: "Contract Design Patterns, Testing and Deployment, Common Vulnerabilities, Code Audit Practices" +Related_docs: + - 01-beginner/02-ecosystem/01-layer-1-vs-layer-2 + - 02-intermediate/01-smart-contracts/02-contract-design-patterns + - 06-rust-engineering/04-data-modeling-errors-control-flow --- # Solidity and Vyper Basics diff --git a/curriculum/02-Blockchain/02-intermediate/01-smart-contracts/02-contract-design-patterns.md b/curriculum/02-Blockchain/02-intermediate/01-smart-contracts/02-contract-design-patterns.md index 601e444..a843637 100644 --- a/curriculum/02-Blockchain/02-intermediate/01-smart-contracts/02-contract-design-patterns.md +++ b/curriculum/02-Blockchain/02-intermediate/01-smart-contracts/02-contract-design-patterns.md @@ -4,6 +4,14 @@ title: Contract Design Patterns track: blockchain level: intermediate version: 1.1 +Prerequisites: "01-solidity-and-vyper-basics" +Duration: "~45-60 minutes" +Format: "Pattern catalog reading + pattern-recognition exercises" +Future_Topics: "Testing and Deployment, Common Vulnerabilities, Code Audit Practices, Governance Mechanisms" +Related_docs: + - 02-intermediate/01-smart-contracts/01-solidity-and-vyper-basics + - 02-intermediate/01-smart-contracts/03-testing-and-deployment + - 04-Protocol Engineering/01-beginner/02-standards/01-specification-writing --- # Contract Design Patterns diff --git a/curriculum/02-Blockchain/02-intermediate/01-smart-contracts/03-testing-and-deployment.md b/curriculum/02-Blockchain/02-intermediate/01-smart-contracts/03-testing-and-deployment.md index 1a317cf..3925e2d 100644 --- a/curriculum/02-Blockchain/02-intermediate/01-smart-contracts/03-testing-and-deployment.md +++ b/curriculum/02-Blockchain/02-intermediate/01-smart-contracts/03-testing-and-deployment.md @@ -4,6 +4,14 @@ title: Testing and Deployment track: blockchain level: intermediate version: 1.1 +Prerequisites: "02-contract-design-patterns" +Duration: "~45 minutes" +Format: "Test plan + deployment-flow sketch + local-testnet-mainnet checklist" +Future_Topics: "Common Vulnerabilities, Code Audit Practices, Pen Test Workflow, Security Best Practices" +Related_docs: + - 02-intermediate/01-smart-contracts/02-contract-design-patterns + - 02-intermediate/02-security/01-common-vulns + - 06-rust-engineering/13-testing-fixtures-code-review-culture --- # Testing and Deployment diff --git a/curriculum/02-Blockchain/02-intermediate/02-security/01-common-vulns.md b/curriculum/02-Blockchain/02-intermediate/02-security/01-common-vulns.md index 6719f06..38eb4da 100644 --- a/curriculum/02-Blockchain/02-intermediate/02-security/01-common-vulns.md +++ b/curriculum/02-Blockchain/02-intermediate/02-security/01-common-vulns.md @@ -4,6 +4,14 @@ title: Common Vulnerabilities track: blockchain level: intermediate version: 1.1 +Prerequisites: "03-testing-and-deployment" +Duration: "~45-60 minutes" +Format: "Vulnerability catalog reading + checklist-mindset + vulnerability-labeling exercise" +Future_Topics: "Code Audit Practices, Pen Test Workflow, Formal Verification, Secure Upgrade Patterns" +Related_docs: + - 02-intermediate/01-smart-contracts/03-testing-and-deployment + - 02-intermediate/02-security/02-code-audit-practices + - 04-Protocol Engineering/03-advanced/01-lead-architect/03-security-modeling --- # Common Vulnerabilities diff --git a/curriculum/02-Blockchain/02-intermediate/02-security/02-code-audit-practices.md b/curriculum/02-Blockchain/02-intermediate/02-security/02-code-audit-practices.md index fb78a5a..8b6e0dc 100644 --- a/curriculum/02-Blockchain/02-intermediate/02-security/02-code-audit-practices.md +++ b/curriculum/02-Blockchain/02-intermediate/02-security/02-code-audit-practices.md @@ -4,6 +4,14 @@ title: Code Audit Practices track: blockchain level: intermediate version: 1.1 +Prerequisites: "01-common-vulns" +Duration: "~45 minutes" +Format: "5-step audit workflow reading + mini-audit exercise + personal checklist" +Future_Topics: "Pen Test Workflow, Formal Verification and Tools, Automated Security Tooling" +Related_docs: + - 02-intermediate/02-security/01-common-vulns + - 02-intermediate/02-security/03-pen-test-workflow + - 06-rust-engineering/13-testing-fixtures-code-review-culture --- # Code Audit Practices diff --git a/curriculum/02-Blockchain/02-intermediate/02-security/03-pen-test-workflow.md b/curriculum/02-Blockchain/02-intermediate/02-security/03-pen-test-workflow.md index 33a4f06..11d4185 100644 --- a/curriculum/02-Blockchain/02-intermediate/02-security/03-pen-test-workflow.md +++ b/curriculum/02-Blockchain/02-intermediate/02-security/03-pen-test-workflow.md @@ -4,6 +4,14 @@ title: Penetration Testing Workflow track: blockchain level: intermediate version: 1.1 +Prerequisites: "02-code-audit-practices" +Duration: "~45-60 minutes" +Format: "6-phase walkthrough reading + pen-test plan + simulated attack exercise" +Future_Topics: "Security Best Practices Synthesis, Advanced Protocol Security, Governance Attack Analysis" +Related_docs: + - 02-intermediate/02-security/02-code-audit-practices + - 04-Protocol Engineering/03-advanced/01-lead-architect/03-security-modeling + - 05-products/07-security-trust-engineering --- # Penetration Testing Workflow diff --git a/curriculum/02-Blockchain/03-advanced/01-protocol-engineering/01-protocol-architecture.md b/curriculum/02-Blockchain/03-advanced/01-protocol-engineering/01-protocol-architecture.md index 5303823..3c417b6 100644 --- a/curriculum/02-Blockchain/03-advanced/01-protocol-engineering/01-protocol-architecture.md +++ b/curriculum/02-Blockchain/03-advanced/01-protocol-engineering/01-protocol-architecture.md @@ -4,6 +4,14 @@ title: Protocol Architecture track: blockchain level: advanced version: 1.1 +Prerequisites: "Intermediate track completion (Smart Contracts + Security)" +Duration: "~60 minutes" +Format: "Layer-decomposition reading + role-mapping exercise + TypeScript-style Transition sketch" +Future_Topics: "Consensus Mechanism Design, Governance Mechanisms, State Channels, Advanced Scalability" +Related_docs: + - 04-Protocol Engineering/01-beginner/01-protocol-concepts/01-protocol-vs-application + - 04-Protocol Engineering/03-advanced/01-lead-architect/01-optimizing-latency + - 03-advanced/02-scalability/01-state-channels --- # Protocol Architecture diff --git a/curriculum/02-Blockchain/03-advanced/01-protocol-engineering/02-consensus-tuning.md b/curriculum/02-Blockchain/03-advanced/01-protocol-engineering/02-consensus-tuning.md index 7efacd9..48d5d2a 100644 --- a/curriculum/02-Blockchain/03-advanced/01-protocol-engineering/02-consensus-tuning.md +++ b/curriculum/02-Blockchain/03-advanced/01-protocol-engineering/02-consensus-tuning.md @@ -4,6 +4,14 @@ title: Consensus Tuning track: blockchain level: advanced version: 1.1 +Prerequisites: "01-protocol-architecture" +Duration: "~45-60 minutes" +Format: "Real-chain parameter analysis reading + tuned-config sketch + L1 vs L2 comparison" +Future_Topics: "Economic Design and Incentives, Governance Mechanisms, MEV-Aware Tuning, 04-Protocol Engineering Consensus Economics" +Related_docs: + - 03-advanced/01-protocol-engineering/01-protocol-architecture + - 03-advanced/01-protocol-engineering/03-governance-mechanisms + - 04-Protocol Engineering/03-advanced/01-lead-architect/02-consensus-economics --- # Consensus Tuning diff --git a/curriculum/02-Blockchain/03-advanced/01-protocol-engineering/03-governance-mechanisms.md b/curriculum/02-Blockchain/03-advanced/01-protocol-engineering/03-governance-mechanisms.md index 41ea101..ebb97e4 100644 --- a/curriculum/02-Blockchain/03-advanced/01-protocol-engineering/03-governance-mechanisms.md +++ b/curriculum/02-Blockchain/03-advanced/01-protocol-engineering/03-governance-mechanisms.md @@ -4,6 +4,14 @@ title: Governance Mechanisms track: blockchain level: advanced version: 1.1 +Prerequisites: "02-consensus-tuning" +Duration: "~45-60 minutes" +Format: "Comparison-table reading + real-protocol analysis + governance-mix design exercise" +Future_Topics: "Economic Design and Incentives, Treasury Management, Public-Good Governance Patterns, Governance Models for Evolution (04-Protocol Engineering)" +Related_docs: + - 03-advanced/01-protocol-engineering/02-consensus-tuning + - 04-Protocol Engineering/02-intermediate/02-governance-and-ecosystem/03-community-feedback + - 05-products/06-economic-incentive-design --- # Governance Mechanisms diff --git a/curriculum/02-Blockchain/03-advanced/02-scalability/01-state-channels.md b/curriculum/02-Blockchain/03-advanced/02-scalability/01-state-channels.md index 1d7a3e3..9fe2ad4 100644 --- a/curriculum/02-Blockchain/03-advanced/02-scalability/01-state-channels.md +++ b/curriculum/02-Blockchain/03-advanced/02-scalability/01-state-channels.md @@ -4,6 +4,14 @@ title: State Channels track: blockchain level: advanced version: 1.1 +Prerequisites: "01-protocol-architecture, 01-layer-1-vs-layer-2 (Beginner)" +Duration: "~45 minutes" +Format: "Timeline sketch + use-case identification + JSON state-channel message sketch" +Future_Topics: "Rollups and Sharding, Payment-Channel Networks, Lightning-Style Systems, Interoperability Design" +Related_docs: + - 03-advanced/01-protocol-engineering/01-protocol-architecture + - 01-beginner/02-ecosystem/01-layer-1-vs-layer-2 + - 03-advanced/02-scalability/02-rollups-and-sharding --- # State Channels diff --git a/curriculum/02-Blockchain/03-advanced/02-scalability/02-rollups-and-sharding.md b/curriculum/02-Blockchain/03-advanced/02-scalability/02-rollups-and-sharding.md index cce16b7..ab04d9b 100644 --- a/curriculum/02-Blockchain/03-advanced/02-scalability/02-rollups-and-sharding.md +++ b/curriculum/02-Blockchain/03-advanced/02-scalability/02-rollups-and-sharding.md @@ -4,6 +4,14 @@ title: Rollups and Sharding track: blockchain level: advanced version: 1.1 +Prerequisites: "01-state-channels, 01-layer-1-vs-layer-2" +Duration: "~60 minutes" +Format: "Rollup-architecture diagram + sharded-L1 analysis + JSON batch-state sketch" +Future_Topics: "Interoperability Design, Cross-Chain Messaging, Data Availability Layers, State Channels and LN-Style Systems" +Related_docs: + - 03-advanced/02-scalability/01-state-channels + - 03-advanced/02-scalability/03-interoperability-design + - 04-Protocol Engineering/02-intermediate/02-governance-and-ecosystem/02-interchain-protocols --- # Rollups and Sharding diff --git a/curriculum/02-Blockchain/03-advanced/02-scalability/03-interoperability-design.md b/curriculum/02-Blockchain/03-advanced/02-scalability/03-interoperability-design.md index c8fb07d..bb1e5d9 100644 --- a/curriculum/02-Blockchain/03-advanced/02-scalability/03-interoperability-design.md +++ b/curriculum/02-Blockchain/03-advanced/02-scalability/03-interoperability-design.md @@ -4,6 +4,14 @@ title: Interoperability Design track: blockchain level: advanced version: 1.1 +Prerequisites: "02-rollups-and-sharding" +Duration: "~45-60 minutes" +Format: "Trust/latency comparison + simple-bridge diagram + interoperability analysis + TypeScript CrossDomainMessage sketch" +Future_Topics: "Economic Design, IBC-Style Protocols, MEV-Resistant Cross-Chain Messaging, Public-Good Interoperability" +Related_docs: + - 03-advanced/02-scalability/02-rollups-and-sharding + - 04-Protocol Engineering/02-intermediate/02-governance-and-ecosystem/02-interchain-protocols + - 01-beginner/02-ecosystem/03-decentralized-identity --- # Interoperability Design