README.md

DApp that allows users to cast votes using blockchain technology, ensuring tamper-proof, one-person-one-vote elections.

---

🎥 Demo

🔧 Tech Stack

🖥️ Frontend

• React (via Vite)
• TypeScript
• Tailwind CSS
• Lucide React Icons
• Ethers.js (for blockchain interaction)
• MetaMask (for wallet authentication)

🔌 Backend / Smart Contracts

• Solidity (for voting contract)
• Hardhat (for local development, testing & deployment)

🔗 Blockchain

• Ethereum Testnet (Sepolia)
• MetaMask Wallet

---

🛠️ Installation

1. Clone the Repository

git clone https://github.com/Gregster31/BlockVote.git
cd BlockVote

2. Install Dependencies

npm install

3. Setup Environment Variables

Create a .env file in the root directory:

SEPOLIA_RPC="YOUR_KEY_HERE"
PRIVATE_KEY="YOUR_KEY_HERE"

4. Compile and Deploy Smart Contract

npm install
npx hardhat compile
npx hardhat run scripts/deploy.js --network sepolia

Copy the deployed contract address and paste it in CONTRACT_ADDRESS

5. Run the Frontend

npm run dev

---

✨ Features

• ✅ Wallet Integration – Connect MetaMask to authenticate voters.
• ✅ Candidate Listing – Live data fetched directly from the smart contract.
• ✅ Secure Voting – Vote cast is signed and recorded immutably on the Ethereum blockchain.
• ✅ One Person, One Vote – Each address can vote only once.
• ✅ Live Vote Count – Real-time updates pulled from blockchain.
• ✅ Beautiful UI – Smooth animations and accessible design using Tailwind CSS.
• ✅ Decentralized – No backend server required. All voting data is on-chain.

---

🧠 Smart Contract Overview

Written in Solidity, the Voting smart contract:

• Stores candidate info on-chain
• Allows one vote per Ethereum address
• Prevents double voting
• Exposes public functions to retrieve candidates and vote counts

---