Web3 Learning Wiki

📖 Online Wiki：<https://mia03ther.github.io/web3-learning-wiki/>

✨ General readers do NOT need to clone, download or install any software. Open the link above in your browser for full‑featured reading: sidebar navigation, full‑text search, formatted styles.

This repository holds the source Markdown for an open‑source personal knowledge archive, focused on practical learning and experiments at the intersection of AI × Web3. Topics include blockchain basics, on‑chain AI Agents, hackathon practice, developer tooling and ecosystem research.

⚠️ Note: Browsing raw .md source files directly on GitHub will discard website layout, styling and search functions. Always use the online wiki link for proper reading experience.

What’s Inside

• Start Here: Project introduction & usage guide for new builders
• Web3 Fundamentals: Blockchain, wallets, smart contracts, transactions, gas, L2 and core protocol knowledge
• AI × Web3: On‑chain Agents, Agent Payments, MCP, AI‑DeFi combination research and practice notes
• Builder Notes: Hackathon playbook, GitHub workflow, deployment workflow, debugging tips & developer tools
• Field Notes: Conference meeting records, ecosystem observations, protocol analysis and project reviews
• Roadmap: Stage‑oriented learning path, curated course resources, skill checklist and interview handbook

Run Wiki Locally (Contributors & Editors Only)

⚠️ Skip this whole section if you just want to read content. These steps are only for people who want to modify source documents and preview site locally.

System Requirement

Python ≥ 3.11

# 1. Clone repository
git clone [https://github.com/mia03ther/web3-learning-wiki.git](https://github.com/mia03ther/web3-learning-wiki.git)
cd web3-learning-wiki

# 2. Install mkdocs‑material theme
pip install mkdocs-material

# 3. Start local preview server
mkdocs serve

Visit preview site: [http://127.0.0.1:8000](http://127.0.0.1:8000)

Offline Reading Without Python

If you wish to read content offline without environment setup: Open the online wiki, use browser Save as to export static web pages to local disk.

Deployment Workflow

• main branch：Store all markdown sources, configuration and static assets. All edits must be committed here.
• gh‑pages branch：Static site artifacts auto‑generated by GitHub Actions CI.

  ❗ Never manually edit gh‑pages branch, manual changes will be overwritten on next push to main.

• Every commit pushed to main triggers automatic build and GitHub‑Pages deployment.

Contributing

• Submit an Issue for feedback, resource recommendation or content suggestions.
• Pull requests for note improvement, supplement materials and typo fixes are highly welcome.

License

MIT