explaingit

saarthi3108-tech/votechain-v2

★ 21HTMLAudience · developerComplexity · 3/5Setup · moderate

TLDR

A student demo of a blockchain-based web voting system with OTP verification, fraud detection, and real-time results, built as an IEEE final-year project.

Mindmap

mindmap
  root((VoteChain India))
    Voter Auth
      Phone OTP verification
      QR code voter ID
    Vote Recording
      SHA-256 blockchain ledger
      Tamper detection
    Fraud Detection
      IP address checks
      Duplicate submission filter
      Risk scoring
    Real-time Results
      Socket.io live updates
      No page refresh needed
    Admin Panel
      Vote analytics charts
      Flagged activity logs
    Languages
      Tamil and English UI
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Run a demo online election with OTP voter verification and see results update live without refreshing the page.

USE CASE 2

Study how SHA-256 hashing can link vote records into a tamper-evident chain for a university project on blockchain.

USE CASE 3

Use the admin panel to monitor vote analytics and review fraud detection logs in a simulated election scenario.

Tech stack

HTMLJavaScriptNode.jsSocket.io

Getting it running

Difficulty · moderate Time to first run · 30min

Demo mode only: OTP appears on-screen rather than being sent to a real phone number.

In plain English

VoteChain India is a student project built as an IEEE final-year submission. It is a web-based voting system that combines several security techniques to prevent fraudulent votes in digital elections. The system verifies voters using a phone-based one-time password before they can cast a vote. Each vote is recorded using a blockchain structure where records are linked together using SHA-256 hashing, making it difficult to change past entries without detection. There is also a fraud detection layer that examines IP addresses and looks for duplicate submissions, assigning each voting attempt a risk score. Voters get a QR code as their voter ID. Results update in real time using a technology called Socket.io, which pushes data to the browser without needing to refresh the page. The interface supports both Tamil and English. An admin panel is included with charts showing vote analytics and logs of flagged activity. The project comes pre-loaded with four example political parties from Tamil Nadu politics. The README is short and focused on getting the demo running. It starts the server with two commands and includes a default admin login. The project is described as a demo or prototype context, with the OTP showing on screen rather than being sent to a real phone number.

Copy-paste prompts

Prompt 1
I'm learning about blockchain voting. Walk me through how VoteChain India links each vote to the previous one using SHA-256 hashing and explain why changing a past vote would be detectable.
Prompt 2
I want to extend VoteChain's fraud detection to also flag multiple votes from the same device fingerprint, not just the same IP address. Show me where in the code to add this check.
Prompt 3
Help me replace the on-screen OTP display in VoteChain with real SMS delivery using Twilio, so votes can only be cast by people with access to the registered phone number.
Open on GitHub → Explain another repo

← saarthi3108-tech on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.