Skip to content

A BlockChain based Online Voting Management System made with ReactJS, Tailwind CSS and Solidity.

License

Notifications You must be signed in to change notification settings

Ayan-Banerjee-918/VoteBlocks-Dapp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 

Repository files navigation

VoteBlocks DApp

GitHub repo size GitHub code size in bytes GitHub Hits Website

Live Website : https://voteblocks.netlify.app/

❔ What is this project about?

VoteBlocks Dapp is a decentralised web 3.0 based online voting system which allow voters to vote securely and anonymously while maintaining privacy and transparency.

🖥️ Project Framework

  • Frontend : React JS
  • BlockChain : Polygon Mumbai Testnet
  • Contract/Backend : Solidity
  • IPFS : Infura
  • Contract Management : Truffle

:electron: Project Features

  • Role Based Authorization
  • Separate Dashboards for Voter/Admin
  • TOTP 2FA with Google Authenticator
  • Unique Password 🔑 Generation for addresses
  • Unique Setup Key Generator for addresses for connection to Google Authenticator
  • QR Code for scanning key directly into Google Authenticator
  • Decentralised file storage using Infura
  • Communication with blockchain via Metamask

☑️ Admin Login Test Data

  • Import account 0x2AAD4FFDefCAB7D7Dd0B8D500a8f70c1A38513e4 into Metamask with private key
e439ae6593376e149f0421f7ae7b3c777cc1da5e7d47923766f2e0f85030e723
d&0at5mh]25cD#Jf{edc8-0adf73W07@eK4df0fd4bF=HW17580d8d.<N05Haob3ix=Ka1v&%a
  • Google Authenticator Setup Key
GNLTAN3FJM2GIZRQ

🛠️ Build Setup

  • Clone the repository
git clone https://github.com/Ayan-Banerjee-918/VoteBlocks-Dapp
  • Enter client directory
cd client
  • Install dependencies
npm install
  • Run Project for development
npm run dev
  • Run Project for production
npm run build
npm start

Additional Information:

  • Contract compilation :

    Use Remix Ethereum IDE or truffle migrate to compile and deploy. Then copy the contract address and paste in 'client/src/config.js'.

  • Setup Infura :

    Before running the project, create an infura account and create a ipfs project.Grab the PROJECT_ID Key and API_KEY_SECRET Key.
    Create a .env file in 'clients/' and paste the keys as:

VITE_PROJECT_ID="your-project-id-key" //no space before and after =
VITE_API_KEY_SECRET="your-api-secret-key" //no space before and after =

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

🗝️ License

MIT License

Copyright (c) 2023 Ayan Banerjee

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.