Demo Walkthrough.
Watch an end-to-end execution of the system in action.
Runtime Screenshots.
Interface states, developer logs, and monitoring views. Click any image to view in lightbox.
Technical Specifications.
Verified parameters and operational benchmarks for this release.
Tech Stack.
Features Checklist.
Core capabilities, verified deliverables, and technical assets included with this release.
- Blockchain-based vote recording
- Solidity smart contract
- Ethereum-compatible blockchain
- Truffle development and migration
- Admin-only candidate management
- Candidate name update via smart contract
- Blockchain event logging
- Wallet-based authentication
- OTP verification
- Multi-factor authentication
- Face recognition authentication
- Aadhaar photo verification
- Aadhaar-selfie face comparison
- Biometric confidence scoring
- Voice-based voting
- Speech-to-text candidate recognition
- Offline speech recognition fallback
- Fuzzy candidate name matching
- Voice recognition confidence scoring
- Browser audio recording
- Multi-step voter registration
- Multi-step voter login
- Camera-based Aadhaar capture
- Camera-based selfie capture
- Image preview and validation
- Admin dashboard
- Voter dashboard
- Candidate management interface
- Vote casting interface
- Cybersecurity attack simulation
System Requirements.
- OS
- Linux / Windows / macOS
- CPU
- 4+ cores recommended
- GPU
- Not required for basic operation; recommended for faster face-recognition processing
- RAM
- 8GB minimum, 16GB recommended
- npm
- 9+
- Camera
- Required for selfie and Aadhaar capture features
- Python
- 3.10+
- Browser
- Chrome / Firefox / Edge recommended
- Network
- Localhost/LAN or internet connection depending on deployment
- Node.js
- 18+
- Storage
- 5GB+ free space
- Blockchain
- Ganache / local Ethereum network
- Microphone
- Required for voice voting
About this Project.
Smart Blockchain Voting System is an advanced full-stack electronic voting research and demonstration platform designed to explore how blockchain, biometric authentication, voice interfaces, and cybersecurity mechanisms can be combined into a modern voting workflow.
The platform uses a Solidity smart contract and an Ethereum-compatible blockchain environment to record voting operations while providing an administrative interface for managing candidates.
The authentication workflow combines multiple security layers including wallet authentication, OTP verification, face recognition, and Aadhaar card photo-to-selfie comparison.
The system also includes an accessibility-oriented voice voting capability. Voters can record a candidate's name through their microphone, convert speech to text, match the recognized name against available candidates, and review the recognition confidence before casting the vote.
Core Modules
Blockchain Voting
Votes are handled through a Solidity smart contract deployed to an Ethereum-compatible local blockchain. Administrative operations such as candidate management are restricted to authorized accounts, while blockchain events provide an auditable record of relevant contract actions.
Multi-Factor Authentication
The login workflow combines wallet verification, OTP authentication, and biometric verification to demonstrate a layered authentication architecture.
Biometric Verification
The system can extract a face from an uploaded Aadhaar card image and compare it against a captured selfie. The implementation provides a confidence score and verification result for demonstration purposes.
Voice Voting
The voice voting module uses browser audio recording together with speech recognition. Candidate names are matched using fuzzy matching to tolerate minor speech-recognition differences.
The system also provides an offline recognition fallback using PocketSphinx.
Administrative Controls
Administrators can manage candidates directly through the dashboard. Candidate names can be updated through an admin-restricted smart-contract function, with the change recorded through a blockchain event.
Cybersecurity Attack Demonstration
The included attack demonstration environment showcases common security scenarios including SQL injection attempts, brute-force attacks, unauthorized access, simulated DDoS traffic, and cascading system failure.
The attack module is intended for controlled educational and security-testing demonstrations.
Modern Registration and Login
The frontend provides guided multi-step registration and authentication flows with progress indicators, validation, camera capture, image previews, error handling, and responsive layouts.
Intended Use Cases
Academic demonstrations Blockchain research Cybersecurity demonstrations Electronic voting research Face authentication research Voice accessibility experiments Research prototypes Hackathon demonstrations Security testing demonstrations AI/ML and computer-vision experimentation
Included
Complete frontend source code Complete backend source code Smart contract source code Blockchain deployment configuration Database models and configuration Voice recognition module Face verification module Aadhaar image verification module Attack simulation module Admin dashboard Voter dashboard Registration workflow Login workflow API endpoints Installation instructions Blockchain migration configuration Attack demonstration documentation
Important Limitations
This project is a research and demonstration platform and is **not intended to be deployed as an actual government or public election system without substantial additional security, privacy, legal, accessibility, cryptographic, infrastructure, and compliance work.
Aadhaar verification is implemented as an image-based face-comparison demonstration. It is not an official UIDAI Aadhaar authentication or e-KYC service.
The cybersecurity attack simulator is intended for controlled testing and educational demonstrations.
Voice recognition accuracy depends on microphone quality, speech clarity, language/accent, background noise, and the underlying recognition engine.
Biometric verification accuracy depends on image quality, lighting, camera quality, and the face-recognition implementation.
The included blockchain environment is primarily intended for local development, testing, and demonstration.
Security Features
Wallet authentication OTP verification Aadhaar image verification Admin access control Smart-contract access restrictions Candidate validation Rate-limiting demonstration Brute-force protection demonstration SQL injection protection demonstration Unauthorized-access protection Blockchain event logging Security attack simulation Audit-oriented architecture