Skip to content

nishant-uxs/blockforge_monad

Repository files navigation

BlockForge

AI-Powered Academic Assessment Platform on Monad Blockchain

Built for LNMHacks 8.0 Hackathon - Track 3: x402 Agent Economy.


Live Demo

(https://blockforge.replit.app/)


Smart Contracts

Deployed on Monad Testnet (Chain ID: 10143)

Contract Address
BatchManagement 0xddD637Fd04a8b14470Bcf3b78c683c1a87C99aB8
TokenReward (BFT) 0x9151B358942B3278bEbC7359f75C4110CA5ebc55

Verify on Explorer: https://testnet.monadexplorer.com


About

BlockForge is a decentralized application for academic assessment that combines blockchain technology with artificial intelligence. The platform provides transparent, tamper-proof grading with AI-assisted evaluation.


Features

Blockchain Verification

  • Gasless wallet signatures via eth_signMessage
  • SHA-256 content hashing for tamper-proof records
  • On-chain token rewards for academic performance

AI Grading Agent

  • Google Gemini 2.5 Flash integration
  • Automatic PDF/DOC text extraction
  • Grade suggestions with confidence scores
  • Detailed feedback generation in 5 seconds

Token Economy

  • Non-transferable BFT tokens
  • Grade-based multipliers: A=100%, B=80%, C=60%, D=40%
  • Gamified learning incentives

File Storage

  • IPFS via Pinata for permanent storage
  • Verifiable content hashes on blockchain
  • Direct gateway access for verification

Tech Stack

Layer Technologies
Frontend React 18, TypeScript, Vite, TailwindCSS, shadcn/ui
Web3 MetaMask SDK, ethers.js 6.15
Backend Express.js, Node.js
AI Google Gemini 2.5 Flash
Storage IPFS (Pinata)
Blockchain Monad Testnet, Hardhat, OpenZeppelin

Architecture

Frontend (React + Vite)
        |
        v
Backend (Express.js) -----> Gemini AI Grading Agent
        |
        v
Monad Blockchain (Smart Contracts)
        |
        v
IPFS Storage (Pinata)

User Roles

Role Capabilities
Admin Register teachers, manage platform
Teacher Create batches, assignments, grade with AI assistance
Student Submit work, view grades, earn tokens

Monad Network Configuration

Add Monad Testnet to MetaMask:

Field Value
Network Name Monad Testnet
RPC URL https://testnet-rpc.monad.xyz
Chain ID 10143
Currency MON
Explorer https://testnet.monadexplorer.com

Getting Started

Prerequisites

  • Node.js 18+
  • MetaMask wallet
  • Monad Testnet MON tokens

Installation

cd monad_blockforge
npm install

Environment Variables

GEMINI_API_KEY=your_key
PINATA_API_KEY=your_key
PINATA_SECRET_KEY=your_key

Run Development Server

npm run dev

Server starts at http://localhost:5000


How It Works

  1. Connect MetaMask wallet
  2. Admin registers teachers
  3. Teachers create batches and add students
  4. Teachers upload assignments with deadlines
  5. Students submit work (stored on IPFS)
  6. AI Agent grades submissions automatically
  7. Teachers review and approve with wallet signature
  8. Students receive BFT token rewards

Why Monad

  • 10,000+ TPS - Ultra-high throughput
  • 1 second blocks - Near-instant finality
  • EVM Compatible - Same Solidity contracts work
  • Low gas fees - Practically free on testnet

Team

Member Role
Nishant Agarwal Project Lead, Blockchain Architect
Ayushika Verma Frontend Developer, UI/UX Designer
Rimjhim Bhura Backend Developer, AI Integration
Mohit Kumar Gola Smart Contract Developer, DevOps

Resources


License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors