https://github.com/alirizvi11/medledger
MedLedger is a full-stack blockchain-powered platform for verifying medicine authenticity using IPFS, smart contracts, and QR-based traceability. Built for hackathons, optimized for judges—this project combines backend precision, frontend clarity, and decentralized trust.
https://github.com/alirizvi11/medledger
avalanche avalanche-avax avalanche-hackhton blockchain ethersjs express ipfs medicine nodejs qr-code-traceability react smart-contracts tailwindcss verification web3-decentralized-healthcare
Last synced: 10 days ago
JSON representation
MedLedger is a full-stack blockchain-powered platform for verifying medicine authenticity using IPFS, smart contracts, and QR-based traceability. Built for hackathons, optimized for judges—this project combines backend precision, frontend clarity, and decentralized trust.
- Host: GitHub
- URL: https://github.com/alirizvi11/medledger
- Owner: Alirizvi11
- Created: 2025-09-14T09:28:00.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-09-14T10:29:10.000Z (about 1 month ago)
- Last Synced: 2025-09-14T11:35:50.673Z (about 1 month ago)
- Topics: avalanche, avalanche-avax, avalanche-hackhton, blockchain, ethersjs, express, ipfs, medicine, nodejs, qr-code-traceability, react, smart-contracts, tailwindcss, verification, web3-decentralized-healthcare
- Language: JavaScript
- Homepage: https://forzentix-portfolio2.vercel.app/
- Size: 5.3 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🧬 MedLedger – Blockchain-Powered Medicine Verification
> A Web3 decentralized platform to verify **medicine authenticity** using **IPFS, Smart Contracts, and QR-based lookup**.
Built by **Team Forzentix** at hackathon speed ⚡.
---
## 🚀 Live Demo & Links
- 🎥 [Demo Video](https://www.youtube.com/playlist?list=PL6pVu-pne8klSWW_iv24CR9ELjpiN29qN)
- 🌐 [Try the App](https://medledger1.vercel.app/)
- 🧑💻 [Team Portfolio](https://forzentix.vercel.app)
---
## 🛠️ Tech Stack
- **Frontend**: React.js, TailwindCSS
- **Backend**: Node.js, Express.js
- **Blockchain**: Ethers.js + Avalanche Fuji Testnet
- **Storage**: IPFS (Pinata Gateway)
- **QR**: Dynamic QR rendering for CID lookup
---
## 📦 Features
✅ Register new medicine batches with **CID + txHash**
✅ Lookup by **Batch Number** or **CID**
✅ Fetch metadata directly from **IPFS** (with fallback)
✅ **QR-based traceability** – scan to verify instantly
✅ Sleek **Dark/Light UI Toggle** for judges & users
✅ **Hackathon-friendly modular architecture**
---
## 🖼️ Screenshots
### 🧭 Welcome Page
### 🧭 Sign Up
### 🧭 Wallet Connect
### 📚 Dashbord
### 📚 Quick Actions
### 📚 Medicine Registration
### 🔐 Medicine Validation
### 📊 Register Organ
### 📊 Qr Scan
---
## 📂 Folder Structure
```
MedLedger/
├── backend/
| ├── node_modules/ # Python cache files (ignored)
| ├── abi/
| ├── artifacts/
| ├── cache/
| ├── config/
| | └── contract.js
| ├── contracts/
| | └── MedLedger.sol
| | └── MedLedgerDonor.sol
| | └── MedLedgerOrgan.sol
| ├
| ├── data/
| ├── routes/
| | └── api.js
| | └── consent.js
| | └── donor.js
| | └── donorInfo.js
| | └── donorLookup.js
| | └── medicine.js
| | └── medicineLookup.js
| | └── organ.js
| | └── stats.js
| | └── verify.js
| |
| ├── scripts/
| | └── deploy.js
| ├── scripts/
| | └── blockchain.js
| | └── ipfs.js
| | └── pintaUploader.js
| |
| ├── test/
| ├── utils/
| | └── uploadToIPFS.js
| ├── .env
| ├── env.js
| ├── package.lock.json
| ├── hardhat.config.js
| ├── pakage.json
| └── server.js
|
|
├── frontend/
| ├── node_modules/
| ├── public/
| ├── src/
| | ├── components/
| | | └── BlobBackground.jsx
| | | └── DashbordsStats.jsx
| | | └── DashbordsSystem.jsx
| | | └── QRViewer.css
| | | └── QRVivewr.jsx
| | | └── Lucidelcons.jsx
| | | └── StatsDashbord.jsx
| | |
| | |
| | ├── pages/
| | | └── ConsentVerify.jsx
| | | └── Dashboard.jsx
| | | └── DonerLookup.jsx
| | | └── Login.jsx
| | | └── MedicineLookup.jsx
| | | └── Registerbatch.jsx
| | | └── RegisterOrgan.jsx
| | | └── ScanQr.jsx
| | | └── ScanVerify.jsx
| | | └── Welcome.jsx
| | |
| | ├── app.css
| | ├── App.jsx
| | ├── index.css
| | └── main.jsx
| |
| ├──.gitignore
| ├──package-lock.json
| ├──package.json
| ├──postcss.config.js
| ├──tailwind.config.js
| └──README.md
|
├──screenshots/
└──README.md
```
---
## 🧪 Run Locally
# Clone repo
git clone https://github.com/Alirizvi11/MedLedger.git
# Start Backend
cd backend
npm install
node server.js
# Start Frontend
cd ../frontend
npm install
npm run dev
---
## 🛡️ Security & Reliability
🔐 Private key handling with dotenv
🧪 Reproducible smart contract calls
📈 Benchmarked against traceability standards
⚡ Gas-efficient & IPFS-resilient storage
---
## 👨💻 Team Forzentix
>>>>>>> 7a54cba21fec42c42598f5531a41961d955be4de
| Name | Role | GitHub |
| ------------- | ----------------- | ------------------------------------------ |
|** Ali Rizvi **| Backend Architect | [@ali-rizvi](https://github.com/alirizvi11) |
|** Lokendra ** | Frontend Lead | [@loky](https://github.com/guddubhaiya07) |
|** Abhay ** | Blockchain Dev | [@abhay](https://github.com/abhi9519-ux) |
---
## 📬 Contact
📧 teamforzentix@gmail.com
🌐 