MarkChain 🎓⛓️

A decentralized academic credential management system built on blockchain technology

MarkChain revolutionizes academic credential verification by leveraging blockchain technology to create tamper-proof, instantly verifiable academic records. Built with Self-Sovereign Identity (SSI) principles, it empowers students with full control over their credentials while ensuring institutional trust and verification.

---

🌟 Features

🔐 Blockchain Security

• Immutable Records: All credentials are anchored on the blockchain
• Smart Contract Verification: Automated validation through Ethereum smart contracts
• Cryptographic Integrity: Hash-based verification ensures data authenticity

🆔 Self-Sovereign Identity (SSI)

• Student Ownership: Complete control over credential sharing
• Decentralized Identifiers (DIDs): W3C compliant identity management
• Verifiable Credentials: Industry-standard VC format support

⚡ Instant Verification

• Real-time Validation: Immediate credential verification for employers
• QR Code Integration: Quick access to verification portal
• Global Accessibility: 24/7 verification from anywhere

🎨 Modern UI/UX

• Glassmorphism Design: Beautiful liquid glass effects
• 3D Animations: Hyperspeed highway effects with Three.js
• Interactive Elements: GSAP-powered smooth animations
• Responsive Design: Optimized for all devices

---

🏗️ Architecture

MarkChain/
├── 🎨 fe/                    # Frontend (Next.js 15)
│   ├── src/
│   │   ├── app/              # App Router pages
│   │   ├── components/       # Reusable UI components
│   │   └── lib/              # Utilities and configurations
│   └── public/               # Static assets
│
├── 🔧 be/                    # Backend (NestJS)
│   ├── src/
│   │   ├── auth/             # Authentication & JWT
│   │   ├── user/             # User management
│   │   ├── schemas/          # MongoDB schemas
│   │   └── config/           # Database configuration
│   └── test/                 # E2E tests
│
└── ⛓️ Contracts/             # Smart Contracts (Hardhat)
    ├── contracts/            # Solidity contracts
    ├── scripts/              # Deployment scripts
    ├── test/                 # Contract tests
    └── ignition/             # Hardhat Ignition modules

---

🚀 Quick Start

Prerequisites

• Node.js >= 18.0.0
• npm or yarn or pnpm
• MongoDB (local or cloud)
• MetaMask or compatible Web3 wallet

1️⃣ Clone Repository

git clone https://github.com/KushalvDesai/MarkChain.git
cd MarkChain

2️⃣ Frontend Setup

cd fe
npm install

# Create environment file
cp .env.example .env.local

# Start development server
npm run dev

The frontend will be available at http://localhost:3000

3️⃣ Backend Setup

cd ../be
npm install

# Configure environment variables
cp .env.example .env

# Start development server
npm run start:dev

The GraphQL API will be available at http://localhost:4000/graphql

4️⃣ Smart Contracts Setup

cd ../Contracts
npm install

# Configure Hardhat network
cp .env.example .env

# Compile contracts
npx hardhat compile

# Deploy to local network
npx hardhat node
npx hardhat run scripts/deploy.ts --network localhost

---

Security Features

Blockchain Security

• Smart contract access controls
• Role-based permissions (RBAC)
• Multi-signature support for institutions
• Immutable credential storage

Identity Protection

• Self-sovereign identity principles
• DID-based authentication
• Zero-knowledge proof capabilities
• Privacy-preserving verification

Data Integrity

• Cryptographic hashing
• IPFS content addressing
• Blockchain anchoring
• Tamper-evident records

---

📊 Performance Metrics

Key Performance Indicators

• ⚡ Page Load Time: < 2 seconds
• 🔍 Verification Speed: < 5 seconds
• 📱 Mobile Performance: 95+ Lighthouse score
• 🔐 Security Rating: A+ SSL Labs score
• ⛽ Gas Efficiency: Optimized contract deployment

Scalability

• Concurrent Users: 10,000+
• Daily Verifications: 100,000+
• Storage: IPFS distributed storage
• Database: MongoDB sharding support

---

🤝 Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Development Guidelines

• Follow TypeScript best practices
• Maintain test coverage above 80%
• Use conventional commit messages
• Update documentation for new features

---

📈 Project Statistics

MarkChain Repository Activity

Repository Analytics

👥 Authors

Core Team

• Kushal Desai - Frontend Developer & Blockchain Architect
• Shrey Lakhtaria - Backend Developer & Blockchain Architect

Contributors

Want to see your name here? Contribute to MarkChain!

---

🙏 Acknowledgments

• W3C for Self-Sovereign Identity standards
• Ethereum Foundation for blockchain infrastructure
• MongoDB for database solutions
• Vercel for deployment platform
• OpenZeppelin for secure smart contract libraries
• ReactBits for inspiring UI components and animations

---

📞 Support

Get Help

• 🐛 Issues: GitHub Issues

Community

• 🌟 Star this repository if you find it helpful
• 💼 Connect on Linkedin- Kushal / Shrey

---

Made by Kushal Desai & Shrey Lakhtaria

⬆ Back to Top