This is a decentralized application (DApp) for issuing and verifying certificates on the blockchain.
It allows educational institutions and organizations to issue tamper-proof certificates and verify them via Certificate ID or Student Name.
License: MIT
Node.js Version: v22.17.1
Solidity Version: 0.8.0
- Issue Certificates:
- Student Name
- Course Name
- Date of Issue
- Unique Certificate ID
- Verify Certificates:
- By Certificate ID (single certificate)
- By Student Name (all certificates of a student)
- QR Code Integration:
- Generate QR codes for quick verification
- Scan QR codes to verify certificates
- Case-Insensitive Name Lookup
- Solidity 0.8
- Ethereum / Ganache (local blockchain)
- Truffle (for compiling & deploying)
- Ethers.js (for blockchain interaction)
- Node.js + TypeScript
- Express.js REST API
- QR Code generation using
qrcode
- React or Vue.js for QR scanning and verification
cert_gen/
โโ contracts/ # Solidity contracts
โ โโ Certificate.sol
โโ migrations/ # Truffle migration scripts
โโ src/
โ โโ certGenerator.ts # Certificate generation & blockchain interaction
โ โโ server.ts # Express backend API
โโ build/ # Compiled contracts (Truffle output)
โโ .env # Environment variables
โโ package.json
โโ truffle-config.js
git clone <repo-url>cd frontendnpm install --legacy-peer-depsnpm run devgit clone <repo-url>
cd cert_gennpm installCreate a .env file in the project root and add the following:
Wallet_Address=<your_wallet_Address>
PRIVATE_KEY=<your_wallet_private_key>
CONTRACT_ADDRESS=<deployed_contract_address>
INFURA_URL=http://127.0.0.1:7545
PORT=5000npx ganache@7.9.1 --port 7545
truffle compile
truffle migrate --network developmentnpm run devEndpoint: POST /issue-certificate
Request Body:
{
"name": "Alice",
"course": "Blockchain Basics",
"certificateID": "ALICE2025" // Optional
}Response:
{
"message": "Certificate issued!",
"certificateID": "ALICE2025",
"txHash": "<transaction_hash>",
"qrByID": "<base64_qrcode>",
"qrByName": "<base64_qrcode>"
}Endpoint: GET /verify-certificate?id=<certificateID>
Response:
{
"success": true,
"type": "id",
"certificate": {
"certificateID": "ALICE2025",
"name": "Alice",
"course": "Blockchain Basics",
"dateIssued": "2025-10-14T11:00:54.000Z"
}
}Endpoint: GET /verify-certificate?name=<student_name>
Response:
{
"success": true,
"type": "name",
"certificates": [
{
"certificateID": "ALICE2025",
"name": "Alice",
"course": "Blockchain Basics",
"dateIssued": "2025-10-14T11:00:54.000Z"
},
{
"certificateID": "ALICE2026",
"name": "Alice",
"course": "Smart Contracts",
"dateIssued": "2025-11-01T10:20:30.000Z"
}
]
}- Blockchain Requirements:
- Ganache or Infura must be running before issuing/verifying certificates.
- Case-Insensitive Name Lookup:
- Names are case-insensitive for name-based verification.
- QR Code Integration:
- QR codes link directly to verification endpoints.
- Frontend UI for scanning QR codes and displaying certificates
- Integration with IPFS for certificate metadata storage
- Multi-network support (e.g., Polygon, Ethereum mainnet)
- Role-based access control for issuing certificates
This project is licensed under the MIT License.
