EduVerify - Academic Credential Verification System

EduVerify is a decentralized platform for issuing, managing, and verifying academic credentials using blockchain technology. Built on Polygon with a governance model for institutions, this system provides a tamper-proof solution for academic credential verification.

---

Table of Contents

1. Features
2. Technology Stack
3. Installation Guide
4. Configuration
5. Running the Application
6. Team
7. License

---

Features

• 🎓 Issue verifiable academic credentials
• 🔍 Verify credentials instantly using blockchain
• 🗳️ Multi-signature governance
• 🔒 Secure document storage on IPFS via Pinata
• 👨‍🎓 Student-friendly credential management
• 🏫 Institution dashboard for credential issuance

---

Technology-Stack

Blockchain

• Polygon PoS – Low-cost, scalable transactions
• Solidity – Smart contract development
• OpenZeppelin – Battle-tested contract libraries

Frontend

• React.js – Component-based UI
• React Bootstrap – Responsive UI components
• Ethers.js – Blockchain interactions
• Web3.js – Wallet connectivity

Storage

• IPFS – Decentralized file storage
• Pinata – IPFS pinning service

---

Installation-Guide

Prerequisites

• Node.js (v16+)
• npm (v8+)
• MetaMask wallet (configured for Polygon Mumbai testnet)
• Pinata account (for IPFS storage)

Frontend Setup

1. Clone the repo

   git clone https://github.com/your-username/EduVerify.git
   cd EduVerify

2. Install dependencies

   npm install

3. Configure environment
   Create a .env.local file in frontend/:

   REACT_APP_EDU_VERIFY_ADDRESS=0xb82957F92e5519f653f6C9284D38fCA449913Ae8
   REACT_APP_GOVERNOR_ADDRESS=0xdA943b9AF079ED6Acdc41235621dbCCdd40eBE82
   REACT_APP_PINATA_API_KEY=your_pinata_api_key
   REACT_APP_PINATA_SECRET_API_KEY=your_pinata_secret_api_key
   REACT_APP_PINATA_JWT=your_pinata_jwt

Configuration

MetaMask Setup

1. Install MetaMask extension.
2. Add Polygon Apoy Testnet:
   • Network Name: Apoy Testnet
   • RPC URL: https://rpc-mumbai.maticvigil.com/
   • Chain ID: 80002
   • Currency Symbol: POL
3. Get test POL from the [Polygon Faucet. ](https://faucet.stakepool.dev.br/amoy)

Pinata Setup

1. Create a Pinata account.
2. Generate API keys under Dashboard → API Keys.
3. Add them to .env.local as shown above.

---

Running-the-Application

1. Start the frontend

   npm start

2. Open http://localhost:3000.
3. Connect MetaMask.

Depending on your address, you will see:

• Governor Dashboard (if wallet is a governor)
• Institution View (if authorized institution)
• Student/Verifier View (otherwise)

---

Team

Sanasar Hambardzumyan – s.hambardzumyan@studenti.unitn.it

Gabriele Volani – gabriele.volana@studenti.unitn.it

Course: Blockchain University: UniTrento Academic Year: 2024–2025

License

This project is licensed under the MIT License.