Modular | Targeted | Secure
CampusChain is a simulated blockchain-based digital currency system designed for university ecosystems. It features a Targeted Token Protocol that ensures specific funds (like Canteen Credits or Club Grants) can only be spent at authorized nodes, preventing fund misappropriation.
- Targeted Token System: Multi-vault wallets that separate
GENERALfunds from restricted tokens likeANY_MERCHANTorANY_CLUB. - Smart Validator Layer: The UI dynamically filters spendable assets based on the recipient's role, enforcing "Smart Contract" logic at the transaction level.
- Node-Based Architecture: Specialized dashboards for Admins (Minter/Treasury), Students (Users), Merchants (Canteen/Stationary), and Clubs (Events/Fees).
- Auth-Protocol: Integrated PinPad system for every transaction (Transfer, Bill Pay, or Redemption) to ensure node security.
- Global Ledger: A real-time, transparent audit trail of all successful and failed transactions across the network.
- Frontend: React.js + Vite
- Styling: Tailwind CSS (Cyberpunk/Dark Mode Aesthetic)
- Icons: Lucide React
- Animations: Framer Motion
- Persistence: LocalStorage (Simulated Distributed Ledger)
Follow these steps to get the node running locally:
-
Clone the repository:
git clone https://github.com/The-Shreyas-M/CampusChain.git cd CampusChain-V2 -
Install Dependencies:
npm install
-
Run Development Server:
npm run dev
-
Login Credentials (Default Demo Data):
- Admin: UID:
admin| PIN:1234 - Student: UID:
23104188| PIN:1234 - Merchant: UID:
M-999| PIN:1234
- Admin: UID:
Designed and developed for the 24-hour FinTech Hackathon. This version (v6.5_MODULAR) focuses on solving the problem of fund misappropriation in campus grants and restricted scholarship spending.