VoteBlocks DApp

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

:grey_question: 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.

:desktop_computer: 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

:ballot_box_with_check: Admin Login Test Data

• Import account 0x2AAD4FFDefCAB7D7Dd0B8D500a8f70c1A38513e4 into Metamask with private key

  e439ae6593376e149f0421f7ae7b3c777cc1da5e7d47923766f2e0f85030e723
  

• Browse to https://voteblocks.netlify.app/adminApp/adminLogin or localhost:port/adminApp/adminLogin
  Note : THIS PAGE IS ACCESSIBLE ONLY IF WALLET ADDRESS IS GIVEN ADMIN RIGHTS
• Aadhar ID : 111111111111
• Login Key

  d&0at5mh]25cD#Jf{edc8-0adf73W07@eK4df0fd4bF=HW17580d8d.<N05Haob3ix=Ka1v&%a
  

• Google Authenticator Setup Key

  GNLTAN3FJM2GIZRQ
  

:hammer_and_wrench: 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 =
  

:handshake: 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.

:old_key: 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.