Get Started with Web3

An open-source, bilingual, AI-native Web3 curriculum for beginners, builders, and agents.
11 modules, 58 lessons, AI Tutor, badges, SEO prerendering, llms.txt, and a read-only MCP server.

Live Site  |  All Articles  |  llms.txt  |  中文说明  |  Twitter

---

Why This Exists

Web3 is hard to learn because beginner tutorials, protocol docs, security warnings, and builder examples are scattered everywhere. This project turns that mess into a structured learning path that can be read by humans and queried by AI agents.

If this repo helps you learn or teach Web3, please star the project so more learners can find it.

Who This Is For

Audience	Use this project to
Beginners	Create a wallet, make a first transaction, avoid common scams, and understand the core Web3 workflow.
Builders	Move from concepts to DApps, smart contracts, block explorers, Bitcoin RPC, DeFi, L2, and DAO tooling.
Researchers	Review Bitcoin, Ethereum, DeFi, L2, DAO, bridge, and stablecoin concepts in one curriculum.
AI agents	Search, read, cite, and compose course context through llms.txt, JSON artifacts, and a local MCP server.
Sponsors	Support open-source Web3 education and reach learners before they choose their default tools.

What Is Inside

Area	Current status
Course modules	11 modules
Lessons	58 lessons in the React course map
AI-native index	106 indexed bilingual lesson entries
Glossary	55 Web3 terms
Languages	Chinese first, English in progress
App features	AI Tutor, search, quizzes, badges, XP, dark/light mode, PWA/offline support
Agent surfaces	llms.txt, AI manifest, content index, local read-only MCP server
Monetization	Donations, affiliate disclosure, sponsor kit, future x402-ready tool metadata

Live Site

Use the hosted learning platform:

https://beihaili.github.io/Get-Started-with-Web3/

Public AI entrypoints:

• llms.txt
• AI manifest
• AI content index

Course Map

Module	Lessons	Focus
Web3 Quick Start	7	Wallets, first transaction, DApp interaction, useful tools, token launch, security, CEX basics
Bitcoin: Cryptography and Data Layer	8	Hashing, signatures, transactions, multisig, SegWit, Taproot, data structures
Bitcoin: Network and Consensus Layer	6	Bitcoin Core, P2P, network security, proof-of-work, difficulty, forks and BIPs
Bitcoin: Application Layer	7	Wallets, RPC development, low-fee broadcast, Bitcoin Script, governance, Ordinals, cross-chain DeFi
Web3 Deep Thinking	3	Principles, sovereignty, blockchain necessity, Bitcoin cultural references
Web3 Ecosystem and Tools	6	DeFi, Ethereum, Layer 2, emerging chains, AI x Web3, practical tools
Web3 Builder Lab	4	ERC-20 deployment, first DApp, block explorer reading, smart contract security
DeFi Deep Dive	5	DeFi architecture, AMMs, lending, stablecoins, risks
Cross-Chain and Layer 2	5	Scaling, rollups, L2 ecosystems, bridges, practical L2 usage
DAO and Decentralized Governance	5	DAO basics, governance design, DAO tooling, case studies, challenges
Ethereum and Smart Accounts	2	Post-Pectra/Fusaka Ethereum, account abstraction, smart wallets

Quick Start

git clone https://github.com/beihaili/Get-Started-with-Web3.git
cd Get-Started-with-Web3
npm install
npm run dev

The dev server starts at http://localhost:5173/Get-Started-with-Web3/.

Useful commands:

npm run build      # production build, OG images, sitemap, prerender
npm test           # Vitest suite
npm run lint       # ESLint
npm run ai:verify  # verify public AI entrypoints and x402 metadata

AI Agents and MCP

This repository exposes a machine-readable content layer for AI agents:

npm run ai:index   # regenerate ai/manifest.json, ai/content-index.json, ai/llms.txt
npm run ai:publish # copy AI artifacts into public/
npm run ai:verify  # verify public AI entrypoints and x402 metadata
npm run mcp:web3   # start the local read-only stdio MCP server

Example agent workflow:

npm run mcp:web3

For MCP clients that accept an mcpServers JSON block, copy this config and replace cwd with your local repository path:

{
  "mcpServers": {
    "get-started-with-web3": {
      "command": "npm",
      "args": ["run", "mcp:web3"],
      "cwd": "/absolute/path/to/Get-Started-with-Web3"
    }
  }
}

Then connect an MCP client and use:

• search_web3_content to find relevant lessons and glossary entries.
• read_web3_lesson to read a lesson with citations.
• get_learning_path to get role-based beginner, builder, researcher, or investor paths.
• lookup_web3_glossary to explain Web3 terms.
• compose_web3_context to build a bounded context pack with citations.
• list_monetizable_tools to inspect future x402-ready paid-tool metadata.

Local MCP tools are read-only. They do not enforce payment, sign transactions, or perform chain operations. x402 fields are reserved metadata for future hosted paid tools.

Tech Stack

• Frontend: React 19 + Vite + Tailwind CSS
• State: Zustand
• Routing: React Router
• Content: Markdown in zh/ and en/
• Rendering: react-markdown + remark-gfm + rehype-raw
• AI Tutor: Gemini with user-provided API key
• Agent layer: @modelcontextprotocol/sdk, generated JSON artifacts, llms.txt
• SEO: sitemap generation, OG image generation, prerendering
• Testing: Vitest + happy-dom + Testing Library
• CI/CD: GitHub Actions to GitHub Pages

Contributing

Good first contributions:

• Fix outdated or unclear lesson content.
• Proofread English translations.
• Add quiz questions or glossary entries.
• Improve accessibility, mobile UX, or tests.
• Add examples, diagrams, and case studies.

Start here:

• Contributing guide
• Contributor ladder
• Contributor spotlight template
• Contributor spotlights
• Good first issues catalog
• Open good first issues
• All issues

Support and Sponsorship

This project keeps learning content free. Support helps fund maintenance, translation, new lessons, and AI-native tooling.

• GitHub Sponsors: github.com/sponsors/beihaili
• Buy Me a Coffee: buymeacoffee.com/beihaili
• Sponsor kit: docs/strategy/2026-05-14-sponsor-kit.md
• Disclosure review: docs/strategy/2026-05-18-donation-affiliate-disclosure-review.md
• ETH / EVM: 0xb7Cd29C78B97cdf0A6e6FFC9268d43eDc3eCa649
• BTC: 1GihPqLkjJNK2fzCMSicc9mLapKeGy3Vv1
• Binance: Register with referral link (20% fee rebate)

Some outbound links may be affiliate or sponsor links and are disclosed where used.

Community

• Twitter/X: @bhbtc1337
• WeChat group: Apply via Google Form
• GitHub Issues: Ask questions and give feedback

Contributors

License

MIT License — free to use, modify, and distribute.

Star History