LearnLumen

A blockchain-powered education platform built on Stellar that enables verifiable academic credentials, student rewards, and borderless scholarship payments.

---

Project Structure

LearnLumen/
├── contracts/          # Soroban smart contracts (Rust)
│   ├── credential/     # Issues & verifies on-chain credentials
│   ├── rewards/        # Student reward token logic
│   └── scholarship/    # Scholarship disbursement logic
├── backend/            # Node.js/Express REST API (TypeScript)
│   ├── src/
│   │   ├── routes/     # API route handlers
│   │   ├── middleware/  # Auth middleware
│   │   └── db.ts       # Prisma DB client
│   └── prisma/         # Database schema
├── frontend/           # Next.js app (TypeScript + Tailwind)
│   └── src/
│       ├── app/        # Pages (dashboard, verify, scholarships, institution)
│       ├── components/ # Shared UI components
│       ├── contexts/   # Auth context
│       └── lib/        # API client & Freighter wallet
├── db/migrations/      # SQL migration files
├── docker-compose.yml  # Local dev environment
└── .github/workflows/  # CI pipeline

---

Key Files

File	Description
contracts/credential/src/lib.rs	Soroban contract for issuing/verifying credentials
contracts/rewards/src/lib.rs	Soroban contract for student reward tokens
contracts/scholarship/src/lib.rs	Soroban contract for scholarship payments
backend/src/index.ts	Express server entry point
backend/src/routes/credentials.ts	Credentials API routes
backend/src/routes/rewards.ts	Rewards API routes
backend/src/routes/scholarships.ts	Scholarships API routes
backend/src/routes/auth.ts	Auth API routes
backend/src/middleware/auth.ts	JWT auth middleware
backend/prisma/schema.prisma	Database schema
frontend/src/app/page.tsx	Landing page
frontend/src/app/dashboard/page.tsx	Student dashboard
frontend/src/app/verify/[id]/page.tsx	Credential verification page
frontend/src/app/scholarships/page.tsx	Scholarships listing page
frontend/src/app/institution/page.tsx	Institution portal
frontend/src/lib/freighter.ts	Freighter wallet integration
frontend/src/lib/api.ts	API client
db/migrations/0001_init.sql	Initial DB migration
docker-compose.yml	Docker dev environment
.github/workflows/ci.yml	CI workflow

---

Getting Started

Prerequisites

• Docker & Docker Compose
• Node.js v18+
• Rust + Soroban CLI
• Freighter Wallet browser extension

Local Development

# Start all services (Postgres, backend, frontend)
docker compose up

# Backend only
cd backend && npm install && npm run dev

# Frontend only
cd frontend && npm install && npm run dev

Copy environment files before running:

cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env

Smart Contracts

cd contracts
cargo build --target wasm32-unknown-unknown --release

---

Features

• Verifiable Credentials — institutions issue tamper-proof diplomas and certificates on-chain
• Student Rewards — students earn tokens for academic milestones
• Scholarship Payments — borderless, trustless scholarship disbursement via Stellar
• Wallet Integration — connect with Freighter for Stellar account management