Skip to content

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎓 EduIDChain

EduIDChain is a decentralized academic credential verification system built on the Cardano blockchain. It enables universities to issue NFT-based certificates and allows employers or institutions to verify them securely and transparently.


🚀 Key Features

  • 🏫 NFT-based Certificate Issuance: Universities mint NFTs containing degree data
  • 🔐 Tamper-Proof Credentials: Stored on Cardano Testnet, verifiable forever
  • 👛 Wallet Connect: Supports Eternl and Lace wallets via Mesh SDK
  • 🔍 Verification Page: Employers can validate NFTs using Blockfrost API
  • 🌐 React Frontend: Clean, modern UI built with Tailwind CSS

🧱 Tech Stack

Layer Tools & Libraries
Frontend React.js + Tailwind CSS
Blockchain Layer Cardano (via Mesh SDK + Blockfrost API)
Smart Contract Optional - Aiken (future enhancement)
NFT Minting Mesh SDK mintAssets()
Wallets Supported Eternl, Lace
Metadata Hosting IPFS (optional) + on-chain storage
Deployment GitHub + Vercel

💡 Use Case

Universities can issue verifiable degrees to students on the blockchain. Students share their NFT Asset ID with employers. Employers visit the Verify page, enter the ID, and instantly validate the student's degree metadata on Cardano.


🗂️ Project Structure

eduidchain/
├── public/
├── src/
│   ├── components/
│   │   └── WalletConnector.js
│   ├── pages/
│   │   ├── Home.js
│   │   ├── IssueCredential.js
│   │   └── VerifyCredential.js
│   ├── App.js
│   └── index.js
├── .gitignore
├── tailwind.config.js
├── postcss.config.js
├── package.json
└── README.md

🧪 Getting Started

1. Clone the repository:

git clone https://github.com/Jesuthan/eduidchain.git
cd eduidchain

2. Install dependencies:

npm install

3. Run the app:

npm start

Then open http://localhost:3000


🔗 Connect Your Wallet

Supports:

  • Eternl
  • Lace
  • Any wallet integrated with Mesh SDK

Click "Connect Wallet" at the top and approve the request in your browser extension.


🔐 Minting NFT Certificate

Admins can enter:

  • Student Name
  • Degree Title
  • GPA
  • Date Issued
  • Wallet Address

Click "Mint Certificate", and the student will receive an NFT in their wallet.


🔍 Verifying a Certificate

  1. Get the NFT Asset ID from the student
  2. Go to /verify page
  3. Paste the Asset ID
  4. Click Verify to fetch on-chain metadata from Blockfrost API
  5. Check degree, issuer, and match policy ID (to confirm it's legit)

🧪 Blockfrost API Setup

  1. Sign up at: https://blockfrost.io
  2. Get your Testnet API Key
  3. Create a .env file in the root:
REACT_APP_BLOCKFROST_KEY=your_blockfrost_key

📜 License

MIT — feel free to use, modify, or build on this.


🤝 Built for

UniHack 2025 – Inter-University Blockchain Hackathon in Sri Lanka
Organized by CoinCeylon × University of Kelaniya

Team of 5 students | Built with ❤️ in 2 weeks

About

Decentralized academic credential verification on Cardano: universities mint degree NFTs, employers verify on-chain via Blockfrost. Built for UniHack 2025.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages