Skip to content

README.md

Latest commit

 

History

History
105 lines (76 loc) · 4.22 KB

README.md

File metadata and controls

105 lines (76 loc) · 4.22 KB
Raw

Web3 Student Lab 🎓⛓️

License: MIT PRs Welcome Open Source Love

Web3 Student Lab is an open-source educational platform that helps students learn blockchain, smart contracts, open-source collaboration, and hackathon project development in one place.

The platform provides interactive tools, coding environments, and guided learning paths designed for beginners and university students.

🟢 Live Deployment

The application is fully deployed and accessible online:

  • Frontend Application: https://web3-student-lab.vercel.app/
  • Backend Infrastructure: Hosted securely on Render using PostgreSQL, Redis, and integrated with the Stellar/Soroban Testnet.
  • Smart Contracts: My contract is deployed!

🚀 Core Modules

  1. Blockchain Learning Simulator: Visually learn how blockchains work (create transactions, mine blocks, view hashes, and see how blocks connect).
  2. Smart Contract Playground: Write, run, and test smart contracts directly in your browser. Focuses on Soroban contracts written in Rust.
  3. Web3 Learning Roadmap: A guided path spanning programming fundamentals, cryptography, blockchain architecture, smart contracts, and full Web3 applications.
  4. Hackathon Project Idea Generator: Overcome coder's block by generating ideas based on technology and sector preferences.
  5. Open Source Contribution Trainer: Get hands-on with Git, simulated GitHub issues, PR exercises, and decentralized identity verification that attaches DID-backed contributor proof to saved training submissions.

🛠 Technology Stack

Frontend

  • React / Next.js
  • Tailwind CSS
  • Monaco Editor

Backend

  • Node.js / Express
  • PostgreSQL

Blockchain Integration

  • Stellar SDK
  • Soroban Smart Contracts

📁 Repository Structure

web3-student-lab/
├── contracts/            # Platform smart contracts (e.g., on-chain certificates)
├── frontend/             # Next.js/React frontend application
│   └── src/app/
│       ├── simulator/    # Visual blockchain tools
│       ├── playground/   # In-browser smart contract editor
│       ├── roadmap/      # Learning progress tracking and paths
│       └── ideas/        # Hackathon project generator UI
├── backend/              # Node.js backend application
│   └── src/
│       ├── blockchain/   # Interaction with Stellar/Soroban
│       ├── contracts/    # Compilation and execution engine for student code
│       ├── learning/     # Curriculum and progress APIs
│       └── generator/    # Prompt/AI layer for hackathon ideas
└── docs/                 # Documentation and learning materials

👥 Local Development

Prerequisites

  • Node.js (v18+)
  • Docker and Docker Compose (for PostgreSQL/Redis)
  • Rust toolchain (for smart contracts)
  • Stellar CLI

🔐 MVP Update: Decentralized Identity Verification

The Open Source Contribution Trainer now includes decentralized identity verification for contributor workflows in frontend/src/app/version-control/page.tsx.

  • Contributors link a DID, Stellar wallet address, and GitHub handle before saving a verified trainer version.
  • Verified saves persist proof metadata in the version history engine at frontend/src/lib/version-control/engine.ts.
  • Core attestation creation and verification logic lives in frontend/src/lib/open-source-trainer/identity.ts.

origin/main

🤝 Contributing

We love our contributors! This project is being built for students, by students and open-source enthusiasts.

To start contributing:

  1. Read our Contribution Guidelines.
  2. Check out our existing Issues or look for the good first issue label.
  3. Fork the repository and submit a Pull Request!

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.