TrueID

Decentralized Biometric Identity System

Secure biometric authentication backed by blockchain — tamper-proof, privacy-first, and built for scale.

TrueID combines biometric authentication with blockchain technology to create a tamper-proof, decentralized identity management system. Users register once, verify with their face, and carry a cryptographically-secured identity that no central authority can alter or revoke.

• Overview
• Features
• Architecture
• Getting Started
• Security
• Development
• Contributing
• Support

Biometric Auth Secure face recognition	Blockchain Immutable records	Privacy End-to-end encryption
Mobile App Cross-platform	Gov Portal Admin dashboard	Security Multi-factor auth

TrueID combines blockchain technology with biometric authentication to create a tamper-proof identity management system. The system consists of the following components:

_{TrueID System Architecture}

TrueID/
├── 📱 android-app/         # Mobile application
│   ├── 📂 app/            # Android source
│   │   ├── 📂 src/        # Source code
│   │   └── 📄 build.gradle # Build config
│   └── 📂 gradle/         # Gradle wrapper
├── 🖥️ backend/            # Node.js server
│   ├── ⛓️ blockchain/     # Smart contracts
│   ├── ⚙️ config/         # Config files
│   ├── 🎮 controllers/    # API controllers
│   ├── 🔌 middleware/     # Express middleware
│   ├── 📊 models/         # Database models
│   ├── 🛣️ routes/         # API routes
│   ├── 🛠️ services/       # Business logic
│   └── 🧰 utils/          # Utilities
├── 🔧 c-client/           # C implementation
├── 💾 database/           # DB schemas
├── 🌐 frontend/           # React web app
├── 🏛️ government-portal/  # Admin dashboard
│   ├── 📂 public/         # Static assets
│   ├── 📂 src/            # React components
│   └── 📄 package.json    # Dependencies
└── 📜 scripts/            # Utilities

Node.js v14+	PostgreSQL v13+	Android Studio
JDK 8+	Metamask	Avalanche Fuji

# Server Configuration
PORT=5000
NODE_ENV=development
FRONTEND_URL=http://localhost:3000

# Database Configuration
DB_USER=your_db_user
DB_HOST=localhost
DB_NAME=trueid_db
DB_PASSWORD=your_db_password
DB_PORT=5432

# Authentication
JWT_SECRET=your_jwt_secret
JWT_EXPIRATION=1h
REFRESH_TOKEN_SECRET=your_refresh_token_secret
REFRESH_TOKEN_EXPIRATION=7d

# Blockchain
BLOCKCHAIN_RPC_URL=https://api.avax-test.network/ext/bc/C/rpc
CONTRACT_ADDRESS=your_contract_address
ADMIN_WALLET_PRIVATE_KEY=your_private_key

# API Configuration
REACT_APP_API_URL=http://localhost:5000

# Blockchain Configuration
REACT_APP_AVALANCHE_CONTRACT_ADDRESS=your_contract_address
REACT_APP_AVALANCHE_NETWORK=fuji
REACT_APP_AVALANCHE_RPC_URL=https://api.avax-test.network/ext/bc/C/rpc

# Server Configuration
PORT=8000

# API Configuration
REACT_APP_API_URL=http://localhost:5000
REACT_APP_AVALANCHE_CONTRACT_ADDRESS=your_contract_address

GitHub Issues

Email Support

TrueID provides an interactive setup wizard to simplify backend configuration, database setup, blockchain contract deployment, and admin creation.

cd backend
npm run setup
# or
node setup.js

What the setup tool does:

• Installs all backend dependencies (if needed)
• Asks for PostgreSQL connection info and tests the connection
• Creates the database if it doesn't exist
• Runs the schema and migrations
• Configures JWT secrets (auto-generates or lets you enter your own)
• Asks for Avalanche wallet private key and derives the address
• Optionally deploys the smart contract to Avalanche Fuji testnet
• Creates the initial admin account (argon2-hashed password)
• Writes the complete .env file (backs up old one if present)
• Prints a summary and next steps

You can re-run the setup tool any time to update your configuration.

Made with ❤️ by Akshay

_{Copyright © 2026 TrueID. All rights reserved.}