VoteOn (The Perfect Decentralized Election System on Ethereum)

VoteOn offers a secure and transparent solution for modern elections. By harnessing the power of Ethereum’s blockchain, this system creates tamper-proof voting records, allowing users to cast votes remotely while ensuring anonymity and preventing fraud. This innovative project represents a step forward in trustworthy, decentralized voting, making it ideal for secure and fair electoral processes.

Features

• Implements JWT for secure voter authentication and authorization.
• Utilizes Ethereum blockchain for tamper-proof and transparent voting records.
• Removes the need for intermediaries, ensuring a trustless voting process.
• Admin panel to manage candidates, set voting dates, and monitor results.
• Intuitive UI for voters to cast votes and view candidate information.

Requirements

• Node.js
• Metamask
• Python
• FastAPI
• MySQL Database (port – 3306)

Screenshots

Installation

1. Open a terminal.

2. Clone the repository by using the command

3. Download and install Ganache.

4. Create a workspace named developement, in the truffle projects section add truffle-config.js by clicking ADD PROJECT button.

5. Download Metamask extension for the browser.

6. Now create wallet (if you don't have one), then import accounts from ganache.

7. Add network to the metamask. ( Network name - Localhost 7575, RPC URl - http://localhost:7545, Chain ID - 1337, Currency symbol - ETH)

8. Open MySQL and create database named voter_db. (DON'T USE XAMPP)

9. In the database created, create new table named voters in the given format and add some values.

       CREATE TABLE voters (
       voter_id VARCHAR(36) PRIMARY KEY NOT NULL,
       role ENUM('admin', 'user') NOT NULL,
       password VARCHAR(255) NOT NULL
       );
   

   
   

    +--------------------------------------+-------+-----------+
    | voter_id                             | role  | password  |
    +--------------------------------------+-------+-----------+
    |                                      |       |           |
    +--------------------------------------+-------+-----------+
   

10. Install truffle globally

    npm install -g truffle
    

11. Go to the root directory of repo and install node modules

    npm install
    

12. Install python dependencies

    pip install fastapi mysql-connector-python pydantic python-dotenv uvicorn uvicorn[standard] PyJWT
    

Usage

Note: Update the database credentials in the ./Database_API/.env file.

1. Open terminal at the project directory

2. Open Ganache and it's development workspace.

3. open terminal in project's root directory and run the command

    truffle console
   

   then compile the smart contracts with command

    compile
   

   exit the truffle console

4. Bundle app.js with browserify

    browserify ./src/js/app.js -o ./src/dist/app.bundle.js
   

5. Start the node server server

    node index.js
   

6. Navigate to Database_API folder in another terminal

    cd Database_API
   

   then start the database server by following command

    uvicorn main:app --reload --host 127.0.0.1
   

7. In a new terminal migrate the truffle contract to local blockchain

    truffle migrate
   

You're all set! The Voting app should be up and running now at http://localhost:8080/.

Code Structure

├── blockchain-voting-dapp            # Root directory of the project.
    ├── build                         # Directory containing compiled contract artifacts.
    |   └── contracts                 
    |       ├── Migrations.json       
    |       └── Voting.json           
    ├── contracts                     # Directory containing smart contract source code.
    |   ├── 2_deploy_contracts.js     
    |   ├── Migrations.sol            
    |   └── Voting.sol                
    ├── Database_API                  # API code for database communication.
    |   └── main.py                   
    ├── migrations                    # Ethereum contract deployment scripts.
    |   └── 1_initial_migration.js    
    ├── node_modules                  # Node.js modules and dependencies.
    ├── public                        # Public assets like favicon.
    |   └── favicon.ico               
    ├── src                           
    |   ├── assets                    # Project images.
    |   |   └── eth5.jpg              
    |   ├── css                       # CSS stylesheets.
    |   |   ├── admin.css             
    |   |   ├── index.css             
    |   |   └── login.css             
    |   ├── dist                      # Compiled JavaScript bundles.
    |   |   ├── app.bundle.js         
    |   |   └── login.bundle.js       
    |   ├── html                      # HTML templates.
    |   |   ├── admin.html            
    |   |   ├── index.html            
    |   |   └── login.html            
    |   └── js                        # JavaScript logic files.
    |       ├── app.js                
    |       └── login.js              
    ├── index.js                      # Main entry point for Node.js application.
    ├── package.json                  # Node.js package configuration.
    ├── package-lock.json             # Lockfile for package dependencies.
    ├── README.md                     # Project documentation.
    └── truffle-config.js                    # Truffle configuration file.