Universal ID is a decentralized identity aggregation and verification protocol built on Filecoin that empowers users with comprehensive identity verification through multiple proof vectors. By leveraging zero-knowledge proofs and tensor AI models, Universal ID creates a privacy-preserving, trustless verification identity that bridges on-chain and off-chain identity elements while keeping user data secure and sovereign.
Our solution addresses the critical need for reliable, privacy-preserving identity in Web3 by combining multiple verification methods: ENS verification, liveness detection, humanity proof via Worldchain, social media verification through TLSNotary, nationality verification using AnonAadhaar, and reputation scoring through advanced AI models—all unified on Filecoin's secure and decentralized storage infrastructure.
The blockchain ecosystem suffers from severe identity fragmentation and verification challenges:
- Trust Gap: DeFi protocols and DAOs lack reliable mechanisms to verify real human users without compromising privacy
- Sybil Attacks: Projects remain vulnerable to manipulation through multiple fake identities
- Siloed Verification: Users must repeatedly verify identity across different platforms with no unified solution
- Privacy vs. Verification Tradeoff: Current solutions force users to choose between privacy and verifiability
- Limited Cross-Chain Identity: Identity systems lack interoperability across blockchain ecosystems
- Reputation Isolation: On-chain reputation and credit history remain disconnected and underutilized
This fragmentation creates friction for users, increases costs, and prevents mainstream adoption of Web3 applications.
graph TD
subgraph "Frontend Layer"
WebApp[Web App - Next.js 14]
style WebApp fill:#D4F1F9,stroke:#333
end
subgraph "Backend Services"
Server[REST API Server]
AI[AI Service - TensorFlow]
style Server fill:#FFE6CC,stroke:#333
style AI fill:#E1D5E7,stroke:#333
end
subgraph "Blockchain Layer"
Contracts[Smart Contracts]
FilecoinBC[Filecoin Network]
style Contracts fill:#D5E8D4,stroke:#333
style FilecoinBC fill:#DAE8FC,stroke:#333
end
subgraph "External Services"
WorldCoin[World ID]
Twitter[Twitter Verification]
ENS[ENS Service]
AnonAadhaar[Anon Aadhaar]
FaceVerification[Face Verification]
style WorldCoin fill:#FFF2CC,stroke:#333
style Twitter fill:#FFF2CC,stroke:#333
style ENS fill:#FFF2CC,stroke:#333
style AnonAadhaar fill:#FFF2CC,stroke:#333
style FaceVerification fill:#FFF2CC,stroke:#333
end
WebApp --> Server
WebApp --> Contracts
Server --> AI
Contracts --> FilecoinBC
WebApp --> WorldCoin
WebApp --> Twitter
WebApp --> ENS
WebApp --> AnonAadhaar
WebApp --> FaceVerification
sequenceDiagram
actor User
participant WebApp as Web App
participant Server as API Server
participant AI as AI Service
participant ExternalServices as External Verification Services
participant Blockchain as Filecoin Network
User->>WebApp: Visit Agentic Identity platform
Note over User,WebApp: Verification Phase
User->>WebApp: Connect wallet
WebApp->>ExternalServices: ENS verification check
ExternalServices-->>WebApp: ENS verification status
User->>WebApp: Request face verification
WebApp->>ExternalServices: Process face verification
ExternalServices-->>WebApp: Face verification result
User->>WebApp: Connect with Worldcoin
WebApp->>ExternalServices: Verify with World ID
ExternalServices-->>WebApp: Human verification proof
User->>WebApp: Connect with Anon Aadhaar
WebApp->>ExternalServices: Verify nationality
ExternalServices-->>WebApp: Nationality verification proof
Note over User,AI: Reputation Scoring Phase
User->>WebApp: Request wallet reputation score
WebApp->>Server: GET /api/score/enhanced/:walletAddress
Server->>AI: Request enhanced reputation score
AI->>AI: Run AI model inference
AI-->>Server: Return score, confidence & factors
Server-->>WebApp: Return reputation data
WebApp-->>User: Display reputation score
Note over User,Blockchain: NFT Minting Phase
User->>WebApp: Mint AgenticID NFT
WebApp->>Blockchain: Call mintAgenticID(...)
Note right of WebApp: Pass verification flags, nationality, wallet score
Blockchain-->>WebApp: Return transaction result
WebApp-->>User: Display NFT minting confirmation
User->>WebApp: Request identity details
WebApp->>Blockchain: Call getIdentity(tokenId)
Blockchain-->>WebApp: Return identity details
WebApp-->>User: Display identity details
```
```mermaid
flowchart TD
subgraph Client
WebApp[Web App]
end
subgraph Server
APIController[Score Controller]
ScoreService[Score Service]
end
subgraph AIService
AIEndpoint[AI API Endpoint]
ScoreGenerator[Score Generator]
FeatureExtractor[Feature Extractor]
Model[TensorFlow Model]
MockGen[Mock Generator]
end
WebApp-->|GET /api/score/enhanced/:address|APIController
APIController-->|getEnhancedReputationScore|ScoreService
ScoreService-->|HTTP Request|AIEndpoint
AIEndpoint-->|generateScore|ScoreGenerator
ScoreGenerator-->|Extract Features|FeatureExtractor
FeatureExtractor-->|Features|ScoreGenerator
ScoreGenerator-->|Prediction Request|Model
Model-->|Score Prediction|ScoreGenerator
%% Fallback path
ScoreGenerator-.->|Fallback on Error|MockGen
ScoreGenerator-->|Score Response|AIEndpoint
AIEndpoint-->|JSON Response|ScoreService
ScoreService-->|Score Data|APIController
APIController-->|JSON Response|WebApp
WebApp-->|Display Score|User((User))
User-->|Mint NFT with Score|Blockchain[Filecoin Network]
Universal ID provides a unified identity verification layer on Filecoin that leverages decentralized storage with smart contract flexibility. Our solution introduces a comprehensive verification framework through six key components:
- Cross-chain ENS name resolution and verification
- Secure linking of Rootstock RNS addresses and ENS identities
- Custom AI model for advanced facial recognition and liveness detection
- Proof of human existence and its liveliness without storing biometric data
- Integration with World ID for Sybil-resistant human verification
- ZK-based proof of humanity verification
- Anonymous proof of unique personhood
- Twitter account verification using TLSNotary for trustless proofs
- ZK-based proof of social identity without revealing account details
- Anonymous verification of Indian nationality through AnonAadhaar
- Zero-knowledge proofs of government-issued identity ( in future we will add verification for other countries)
- AI-driven reputation models analyzing on-chain transaction history
- Wallet scoring based on transaction patterns and history
- Credit scoring using TLSNotary to verify off-chain financial data
- Thinking to bring credit scoring from web2 platform to web3 ecosystem without storing sophisticated credit data of user.
Universal ID leverages Filecoin's unique capabilities as a decentralized storage network with smart contract support:
- Core verification registry deployed on Filecoin
- Modular verification contracts for each proof type
- Upgradeable proxy pattern for future enhancements
- Soulbound NFTs based Universal ID representing verified identity of user wallet onchain
- Privacy-preserving proofs using Groth16 and PLONK protocols
- Off-chain proof generation with on-chain verification
- Custom ai models for facial recognition and liveness detection
- Reputation scoring tensor algorithms analyzing on-chain transaction patterns ( implemented on ai folder)
- Zero-knowledge proofs ensure no sensitive data is stored on-chain
- Decentralized storage for encrypted verification artifacts on IPFS
AgenticID enables revolutionary applications across multiple sectors:
- KYC/AML compliance without privacy compromise
- Credit scoring for under-collateralized lending
- Sybil-resistant governance and airdrops
- One-person-one-vote governance systems
- Quadratic funding with verified unique humans
- Reputation-based contribution recognition
- Regulatory compliance with privacy preservation
- B2B identity verification for blockchain applications
- Privacy-preserving public service delivery
- Digital citizenship verification
- Cross-border identity verification ( helping refugees and other unrecognized communities)
- Smart contract deployment on Filecoin testnet
- Integration of initial verification modules (ENS, Liveness)
- Integration of Worldchain, TLSNotary, and AnonAadhaar
- MVP development and deployment to test basic functionalities.
- Development of more complex AI-based reputation scoring model
- UI flow improvement ( better designs)
- Comprehensive testing and security audits
- Full deployment to Filecoin mainnet
- Developer SDK and API for third-party integration
- Cross-chain identity bridging implementations
- Additional verification vectors
- Enterprise partnership program
- Mobile application development
Universal ID aims to become the standard for decentralized identity verification and aggregation across the Filecoin and broader Web3 ecosystems by creating a unified, privacy-preserving identity layer.
- Node.js 18+ (recommended)
- yarn 4.1
- MetaMask or another Web3 wallet
- Filecoin network configuration
-
Clone the repository:
git clone https://github.com/0xshikhar/universal-id.git cd universal-id -
Install root-level dependencies:
yarn install
-
Run frontend app:
yarn run dev:web-app
-
Navigate to web app directory:
cd main/apps/web-app -
Install dependencies:
yarn install
-
Create a
.envfile with necessary environment variables:NEXT_PUBLIC_FILECOIN_RPC_URL=https://api.calibration.node.glif.io/rpc/v1 NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID=your_wallet_connect_project_id -
Run development server:
yarn dev
-
Navigate to server directory:
cd ../server -
Install dependencies:
bun install
-
Set up environment configuration:
cp .env.example .env
-
Build the server:
bun run build
-
Start the server:
bun run start ```
-
Navigate to AI directory:
cd ../ai -
Create a environment:
bun install
-
Run AI services:
bun run serve
-
Navigate to contracts directory:
cd ../contracts -
Install dependencies:
npm install
-
Compile contracts:
npx hardhat compile
-
Deploy to Rootstock Testnet:
npx hardhat run scripts/deploy.js --network rskTestnet
- Open MetaMask
- Add Rootstock Testnet:
- Network Name: Rootstock Testnet
- RPC URL: https://public-node.testnet.rsk.co
- Chain ID: 31
- Currency Symbol: tRBTC
Contributions are welcome! Please follow these steps:
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.