UniTrustID is a decentralized identity (DID) management system built on the Algorand blockchain. It enables universities to issue, manage, and verify tamper-proof digital credentials for students anchored on-chain with real transactions that can be verified on the Lora Block Explorer.
Built with AlgoKit, Pera Wallet, Defly Wallet, and the W3C DID specification.
| Feature | Description |
|---|---|
| 🪪 DID Creation | Generate W3C-compliant did:algo: identifiers anchored on Algorand Testnet via a real 1-ALGO transaction |
| 📱 Wallet Integration | Connect using Pera Wallet or Defly Wallet via QR code scanning (mobile) |
| 🎓 Verifiable Credentials | Issue credentials — StudentID, Library Access, Hostel Resident, Event Attendee, Course Enrollment |
| 🔏 Selective Disclosure | Share only specific claims from a credential (e.g., share department without revealing CGPA) |
| 🏫 Campus Services | Simulate credential verification for Library, Hostel, Events, and Exam Hall services |
| 🔗 On-Chain Verification | Every DID anchor is a real Algorand transaction viewable on Lora Explorer |
| 🌗 Dark / Light Theme | Toggle between dark and light mode with persistent preference |
┌─────────────────────────────────────────────────────┐
│ UniTrustID Frontend │
│ (React + TypeScript + Vite) │
├─────────────┬───────────────┬───────────────────────┤
│ DID Module │ Credentials │ Selective Disclosure │
│ (W3C DID) │ (VC Issue) │ (ZK-style reveal) │
├─────────────┴───────────────┴───────────────────────┤
│ @txnlab/use-wallet-react v4 │
│ (Pera Wallet + Defly Wallet SDKs) │
├─────────────────────────────────────────────────────┤
│ algosdk v3 (Transaction Layer) │
│ 1-ALGO self-transfer with DID note │
├─────────────────────────────────────────────────────┤
│ Algorand Testnet (AlgoNode API) │
│ https://testnet-api.algonode.cloud │
└─────────────────────────────────────────────────────┘
UniTrustID/
├── frontend/ # React + TypeScript frontend
│ ├── index.html # Entry HTML
│ ├── package.json # Node dependencies
│ ├── tsconfig.json # TypeScript config
│ ├── vite.config.ts # Vite + polyfills config
│ └── src/
│ ├── main.tsx # Entry point + ErrorBoundary
│ ├── App.tsx # Root component (routing, state)
│ ├── components/
│ │ ├── WalletScreen.tsx # Pera / Defly wallet connection
│ │ ├── OverviewTab.tsx # DID dashboard + Lora link
│ │ ├── CredentialsTab.tsx # Credential cards + issuance
│ │ ├── ServicesTab.tsx # Campus service verification
│ │ ├── ProfileTab.tsx # DID document viewer
│ │ ├── SelDiscModal.tsx # Selective disclosure modal
│ │ ├── Console.tsx # Blockchain log viewer
│ │ ├── CredCard.tsx # Individual credential card
│ │ ├── WalletChip.tsx # Connected wallet badge
│ │ └── Toast.tsx # Toast notifications
│ ├── lib/
│ │ ├── algoNode.ts # Algorand Testnet txn helpers
│ │ ├── did.ts # W3C DID generation & documents
│ │ ├── credentials.ts # Credential issuance & disclosure
│ │ ├── walletProvider.tsx # WalletManager (Pera + Defly)
│ │ ├── types.ts # Shared TypeScript interfaces
│ │ └── utils.ts # Crypto & utility helpers
│ └── styles/
│ ├── globals.css # Global styles + theme variables
│ ├── header.css # Header + logo + theme toggle
│ ├── wallet.css # Wallet connection screen
│ ├── credentials.css # Credential cards
│ ├── services.css # Services tab
│ ├── profile.css # Profile / DID doc viewer
│ └── modal.css # Selective disclosure modal
├── smart_contracts/ # Algorand smart contracts (AlgoKit)
│ ├── __main__.py
│ ├── __init__.py
│ └── hello_world/
│ ├── contract.py # ARC4 HelloWorld contract
│ └── deploy_config.py # Deployment configuration
├── pyproject.toml # Python / Poetry config
└── .algokit.toml # AlgoKit project config
- Node.js ≥ 18
- Python ≥ 3.12
- AlgoKit CLI ≥ 2.x —
pipx install algokit - Pera Wallet or Defly Wallet mobile app (for signing transactions)
- Algorand Testnet account with ≥ 2 ALGO — get free testnet ALGO from the dispenser
git clone https://github.com/<your-username>/UniTrustID.git
cd UniTrustID/projects/CampusIDcd frontend
npm install# Windows (use local Vite binary)
.\node_modules\.bin\vite.cmd --port 5173
# macOS / Linux
./node_modules/.bin/vite --port 5173Open http://localhost:5173 in your browser.
- Click Connect Pera Wallet (or Defly)
- Scan the QR code with your mobile wallet app
- Fill in your campus profile — Name, Student ID, Email, Department
- Click ANCHOR DID ON ALGORAND
- Approve the 1-ALGO transaction in your wallet app
- View the confirmed transaction on Lora Explorer
The project includes an AlgoKit-based smart contract scaffold:
# Activate Python virtual environment
# Windows
.venv/Scripts/Activate.ps1
# macOS / Linux
source .venv/bin/activate
# Build contracts
python -m smart_contracts buildUser fills profile → Generate did:algo:<address>
→ Build W3C DID Document
→ Create 1-ALGO self-transfer txn with DID note
→ Sign via Pera/Defly wallet (mobile approval)
→ Broadcast to Algorand Testnet
→ Confirm on-chain → View on Lora Explorer
| Credential | Icon | Issuer |
|---|---|---|
| Student ID | 🎓 | Campus Registrar Office |
| Library Access | 📚 | University Library |
| Hostel Resident | 🏠 | Hostel Administration |
| Event Attendee | 🎪 | Student Affairs |
| Course Enrollment | 📖 | Academic Office |
When a campus service requests verification, users choose exactly which claims to reveal:
- ✅ Share: Student ID, Department
- 🚫 Withhold: CGPA, Email, Phone
This follows privacy-by-design principles — only the minimum required information is disclosed.
| Layer | Technology |
|---|---|
| Blockchain | Algorand Testnet (AlgoNode API) |
| SDK | algosdk v3.5.2 |
| Wallet | @txnlab/use-wallet-react v4.6.0, Pera Wallet, Defly Wallet |
| Frontend | React 18.2, TypeScript 5.3, Vite 5.4 |
| Smart Contracts | AlgoKit 2.x, Algorand Python (ARC4) |
| Identity Standard | W3C DID Core v1.0, Verifiable Credentials |
| Explorer | Lora Block Explorer |
- Private keys never leave the wallet — all transactions are signed on the mobile device via Pera/Defly
- No central database — DID anchors live on the Algorand blockchain
- Selective disclosure — users control exactly which credential claims are revealed
- Tamper-proof — credentials are cryptographically signed and can be independently verified
- On-chain auditability — every DID anchor transaction is publicly verifiable on Lora
- W3C DID generation (
did:algo:) - On-chain DID anchoring (1-ALGO transaction)
- Pera Wallet & Defly Wallet integration
- Verifiable Credential issuance (5 types)
- Selective disclosure for campus services
- Lora Explorer transaction links
- Dark / Light theme toggle
- Mobile-native app (React Native)
- DID resolution service (off-chain resolver)
- Credential revocation list
- Multi-university federation
- ARC-19 / ARC-69 NFT-based credentials
Prem Kumar Kuppili
- GitHub: @Premkumar1845
- Email: premkumarkuppili18@gmail.com
This project is built for academic/educational purposes as part of a campus decentralized identity initiative.