Next-generation digital land title tokenization, automated multi-signature escrow settlements, AI fraud risk monitoring, and tamper-proof judicial oversight on Ethereum Sepolia.
- Overview
- Key Features
- System Architecture & Lifecycle
- Smart Contract Ecosystem (Ethereum Sepolia)
- AI & Machine Learning Risk Engine
- Technical Stack
- Project Structure
- Setup & Installation
- API Overview
- Security & Compliance
- License
Traditional land registry systems suffer from severe vulnerabilities: document forgery, fraudulent multiple sales of the same parcel, non-transparent bureaucratic delays, and slow judicial dispute resolution.
Digiverify solves these systemic problems by combining:
- ERC-721 Property Tokenization on Ethereum Sepolia, minting immutable, sovereign digital land titles with cadastral boundaries and dynamic SVG deed certificates.
- ASBA-Style Bank Fund Blocking & Liens, locking buyer funds securely in escrow to prevent defaults and payment fraud.
- Multi-Party Multi-Signature Settlement, requiring non-repudiable wallet signatures from the Seller, Buyer, Bank Admin, and Government Registrar before deed finalization.
- AI-Powered Fraud & Market Risk Engine, running Random Forest valuation with bulk land parcel economics alongside Isolation Forest AML anomaly detection and buyer income verification.
- Judicial Injunction & Dispute Protection, allowing legal authorities to freeze contested titles or execute court-ordered reversals transparently on-chain.
- Municipal Tax & Probate Governance, managing succession claims, inheritance transfers, and property tax clearances on-chain.
- Biometric Face ID Scan & Rekognition, leveraging AWS Rekognition for liveness detection and instant citizen identity lookup.
- Decentralized IPFS Storage, securing deed documents and survey maps pinned via Pinata and immutably anchored on-chain.
- ERC-721 Digital Title Tokenization: Land ownership is minted as a non-fungible token containing unique government parcel identifiers, cadastral survey coordinates, and document hashes.
- 3-Party Multi-Signature Escrow: Enforces automated on-chain consensus where the Seller, Buyer, and Land Authority must each sign with cryptographic wallets before ownership transfers.
- ASBA-Style Bank Fund Blocking: Integrates banking fund-locking mechanisms that hold transaction funds in an account and guarantee payout only upon on-chain conveyance.
- Autonomous Title Conveyance: Zero manual sync needed — once all signatures and bank locks are in place, smart contracts finalize deed transfer atomically.
- AI Fraud & Valuation Model: Tri-engine ML assessment evaluating price deviation (with acreage bulk discounting), AML anomaly detection, and buyer velocity/income verification.
- Judicial Emergency Freeze & Injunction: Authorized court roles can freeze encumbered assets or execute judicial reversal orders with cryptographically verifiable case citations.
- Municipal Tax Vault & NOC: Tracks municipal valuations, records payments, and issues verifiable Tax Clearance NOCs directly on-chain.
- Inheritance & Succession Protocol: Formal probate workflows for legal heirs to stake inheritance claims with verification checkpoints and title reassignment.
- Biometric Citizen Identity Verification: Live camera face identification matching facial feature vectors against verified citizen biometric databases.
- Soulbound Citizen Attestation: On-chain cryptographic identity attestation linking citizen KYC verification status.
The smart contract suite is written in Solidity 0.8.28, compiled with Hardhat, and deployed on the Ethereum Sepolia Testnet (Chain ID: 11155111):
| Contract | Address | Purpose |
|---|---|---|
LandNFT |
0xbCB28DC4eF6242572c0a65D1643595C582106249 |
ERC-721 token representing sovereign land titles with freeze and judicial transfer hooks. |
LandRegistry |
0xd6e6e94c053D204Ad535Ef8f2b01A1835696e9B1 |
Sovereign property registration, boundary specifications, and government title clearance. |
SaleContract |
0xA94321fA51b6F600Ef32Ab652965AC689D967b9B |
3-party multi-sig escrow settlement coordinating buyer, seller, and authority consent. |
CourtOverride |
0x4437904bF4cff91E91c16bB135752038d3418B8C |
High Court emergency injunctions, judicial freezes, and title rectifications with case citations. |
BankLienRegistry |
0x6E8953f0288820bDB77CA89eaAF6c54Ff1250300 |
ASBA mortgage liens and fund-blocking controls ensuring liquidity before deed release. |
InheritanceSuccession |
0x712a073f1849456b13c983195a62fc79D50F52B8 |
Probate claims, legal heir verification, and cryptographic title re-assignment upon death. |
PropertyTaxVault |
0x4bC7B4A62b7a97c40Bf4F028EbF043Fb0AbB7999 |
Municipal tax ledger, annual tax assessment recording, and on-chain Tax Clearance Certificates (NOC). |
CitizenIdentityRegistry |
0xCaa02E5ba741c314c12563dBE2eABCd2d6c5c6a3 |
Soulbound KYC attestation registry verifying citizen authorization and biometric binding. |
Digiverify incorporates an automated tri-factor risk engine (model/score_api.py) evaluating transactions in real time:
flowchart LR
A[Property Sale / Transaction Payload] --> B[Risk Scoring Engine]
B --> C[Price Valuation Model\nRandom Forest Regressor]
B --> D[AML Anomaly Detector\nIsolation Forest]
B --> E[Buyer Velocity Model\nIncome & Velocity Check]
C --> F[Weighted Composite Score\n0 - 100 Risk Rating]
D --> F
E --> F
F --> G{Risk Level}
G -->|>= 80| H[Critical Risk\nHold & Enhanced Due Diligence]
G -->|60 - 79| I[High Risk\nManual Officer Review]
G -->|35 - 59| J[Medium Risk\nRequest Supporting Docs]
G -->|< 35| K[Low Risk\nStandard Monitoring & Approval]
-
Random Forest Price Valuation (30% Weight):
- Evaluates listing prices against district and locality circle guidance rates.
- Incorporates a calibrated bulk land parcel discount curve for acreage/large plots (
$>4,000\text{ sq.ft.}$ ) to ensure realistic cadastral land pricing.
-
Isolation Forest AML Detection (35% Weight):
- Unsupervised outlier analysis detecting anomalous transaction values, velocity spikes, and counterparty clustering.
-
Buyer Velocity & Income Verification (35% Weight):
- Assesses purchase value against annual declared income and 90-day transaction frequency.
| Layer | Technologies |
|---|---|
| Blockchain | Solidity 0.8.28, Hardhat, OpenZeppelin, Ethers.js v6, Ethereum Sepolia Testnet |
| Backend API | Node.js, Express v5, PostgreSQL (pg), Multer, Helmet, Axios, Dotenvx |
| Frontend Web | React 19, Vite, Tailwind CSS v4, Lucide Icons, React Router v7, Canvas Confetti |
| Machine Learning | Python 3, Scikit-Learn (Random Forest, Isolation Forest, HistGradientBoosting), Pandas, NumPy |
| Biometrics | AWS Rekognition (Face Verification & Liveness), Browser MediaDevices API |
| Storage & Security | IPFS (Pinata Cloud), JWT Authentication, bcrypt, ASBA-style Escrow |
Digiverify/
├── backend/ # Node.js Express 5 API Server
│ ├── blockchain/ # Contract abstractions & ethers.js service bindings
│ ├── config/ # PostgreSQL pool, schema.sql, and blockchain config
│ ├── controllers/ # Business logic (Auth, Property, Court, Tax, Succession, Biometric)
│ ├── events/ # Blockchain event listener & DB synchronization
│ ├── middlewares/ # JWT auth, RBAC authorization, timeout, rate-limiting
│ ├── models/ # PostgreSQL data access models
│ ├── routes/ # Express API route declarations
│ ├── services/ # Core services (Audit, ML Risk, Rekognition, Court, Tax)
│ └── utils/ # Zod validation schemas, temporary file storage, helpers
│
├── contracts/ # Hardhat Solidity Suite
│ ├── contracts/ # Solidity smart contracts
│ ├── scripts/ # Deployment and test scripts
│ ├── hardhat.config.js # Hardhat compiler & Sepolia network configuration
│ └── deployments.json # Deployed contract addresses & deployment metadata
│
├── frontend/ # React 19 + Vite Web Application
│ ├── public/ # Static brand assets, certificates, and icons
│ └── src/
│ ├── components/ # Reusable UI components (RiskAnalysisWidget, modals)
│ ├── context/ # AuthContext, Web3Context
│ ├── layouts/ # AdminSidebar, CitizenSidebar, Navigation layouts
│ ├── pages/
│ │ ├── Admin/ # Authority dashboards, KYC approval, revenue analytics, disputes, tax vault, succession, face scan
│ │ ├── Auth/ # Login, registration, biometric capture
│ │ └── Dashboard/ # Property management, purchase review, sales, tax vault, succession claims
│ └── services/ # Axios API clients & Web3 transaction helpers
│
└── model/ # Machine learning risk scoring & anomaly detection engine
├── artifacts/ # Serialized model weights (price_model.joblib, aml_model.joblib)
├── price_risk.py # Random Forest valuation & bulk land discount model
├── aml_risk.py # Isolation Forest AML anomaly detector
├── buyer_risk.py # Buyer velocity & income consistency engine
├── risk_engine.py # Composite scoring orchestrator
└── score_api.py # Subprocess JSON scoring CLI interface
- Node.js
>= 18.x& npm>= 9.x - Python
>= 3.10withvenv - PostgreSQL
>= 14.x - MetaMask browser extension configured for Ethereum Sepolia Testnet
- Testnet Sepolia ETH (from Google Cloud Web3 Faucet or Alchemy Faucet)
- Start your local PostgreSQL server.
- Create the database:
createdb digiverify
- Initialize the database schema:
psql -d digiverify -f backend/config/schema.sql
The contracts are already compiled and deployed to Ethereum Sepolia. If you wish to recompile or redeploy:
cd contracts
npm install
# Compile contracts
npx hardhat compile
# Deploy to Ethereum Sepolia
npx hardhat run scripts/deploy.js --network sepolia-
Navigate to
backend/and install dependencies:cd backend npm install -
Create
.envfrom.env.example:cp .env.example .env
-
Configure your environment variables in
.env:- Set PostgreSQL credentials (
PGHOST,PGPORT,PGUSER,PGPASSWORD,PGDATABASE). - Set
SEPOLIA_RPC_URL(e.g. from Alchemy or Infura). - Set
SIGNER_PRIVATE_KEYfor the backend authority wallet. - Set
PINATA_API_KEYandPINATA_SECRET_API_KEYfor IPFS uploads. - Set AWS credentials for facial recognition (
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY,AWS_REGION).
- Set PostgreSQL credentials (
-
Start the backend server:
npm run dev
The backend API will start at
http://localhost:5000.
-
Navigate to
frontend/and install dependencies:cd frontend npm install -
Start the Vite development server:
npm run dev -- --host
The application will be accessible at
http://localhost:5173.
| Route Group | Path Prefix | Description |
|---|---|---|
| Authentication | /api/auth |
User registration, login, wallet binding, JWT token renewal. |
| Properties | /api/properties |
Property registration, survey approval, deed hashes, parcel search. |
| Sales & Escrow | /api/sales |
Multi-sig sale initiation, buyer signing, automated final settlement. |
| Banking (ASBA) | /api/bank |
Fund block creation, bank admin confirmation, lien status. |
| Biometrics | /api/biometric |
Live facial verification, face scan citizen lookup via AWS Rekognition. |
| Municipal Tax | /api/tax |
Tax assessments, property tax clearance, on-chain Tax NOC vault. |
| Succession & Probate | /api/succession |
Legal heir claims, court decree verification, inheritance title transfers. |
| Court & Injunctions | /api/admin/property |
Judicial freeze orders, reverse freezes, forced judicial transfers. |
| Admin & Authority | /api/admin |
KYC attestation, survey review, dispute center, revenue analytics. |
| Risk & Analytics | /api/risk |
ML-driven transaction risk scoring, circle valuations, and anomaly detection. |
- Role-Based Access Control (RBAC): Smart contracts implement OpenZeppelin
AccessControlsegregation (DEFAULT_ADMIN_ROLE,AUTHORITY_ROLE,BANK_ROLE,COURT_ROLE). - Cryptographic Multi-Signature Settlement: Eliminates unilateral transfers by requiring explicit on-chain authorizations from buyer, seller, bank, and regulatory authority.
- Automatic Fallback Reconciliation: The backend guarantees that database status and blockchain token ownership stay 100% consistent across all transactions.
- Cryptographic Document Integrity: Deed documents and boundary surveys are hashed with SHA-256 before upload and stored immutably on IPFS.
- Judicial Intervention: Protects against fraud and lost keys through designated court injunction and title deed force-transfer capabilities with automated unfreeze safeguards.
This project is licensed under the Apache License, Version 2.0. See the LICENSE file for full details.
