Blockchain_Voting_Dapp

Details

🚀 Installation & Usage

Installation...

0. Prerequisites:

• 0.1: Install Hardhat:

  npm install --save-dev hardhat

• 0.2: Install Node.js:

  nvm install node

• 0.3: Install the http-server package globally:

  npm install -g http-server

• 0.4: Add and configure the MetaMask extension to your browser with the following network:
  • RPC URL: 127.0.0.1:8545
  • Chain ID: 31337
  • Coin Symbol: GO

1. Clone the repository:

git clone https://github.com/MatteoAv/Blockchain_Voting_Dapp

2. Go to the project folder and open the terminal

3. Start a local blockchain:

    npm hardhat node

4. Open a new terminal window in the project folder

5. Deploy the contract:

    npx hardhat run scripts/deploy.js --network localhost

6. Go to the frontend folder and run the command:

    http-server

7. Click on one of the servers that are returned to open the webpage

8. Import one of the accounts created in the local blockchain into MetaMask

9. Click on the "Connect to MetaMask" button to vote

🎥 Watch the Demo:

Click to watch the demo video

🎯 Application Overview: FairVote

FairVote is a DApp (Decentralized Application) designed to ensure a secure and transparent electoral process. By leveraging the power of blockchain, FairVote guarantees the immutability of data, increasing user trust in the electoral system. The primary goal of the application is to allow users to participate in elections through a transparent, secure, and accessible platform.

A key feature of FairVote is the absence of the need to create an account with personal credentials or log in via third-party accounts (such as Google or Meta). Users can simply connect via their MetaMask wallet, using their public key address on the blockchain to access the platform.

🛠️ Main Features of FairVote:

Voting:

• Users can vote in existing elections using a voting code. After selecting a poll, users can view details such as the name, description, deadline, candidates, and the current vote counts. They can then choose the candidate they want to vote for.
• The voting occurs through a 0.05 Ether transaction, and if the transaction is successful, the vote count is updated in real time.
• Each user can cast only one vote per election, and only if they have sufficient funds and the election is still open.

Create Elections:

• Users have the ability to create new elections, defining parameters such as title, description, candidates (up to a maximum of 6), and the voting deadline.
• To create an election, the user must perform a transaction that costs 0.1 Ether. Upon successful creation, the user receives a unique 6-digit voting code, which can be shared with others to participate in the vote.
• The creator of the election cannot vote in the election they created, but anyone else can.

View Elections:

• Users can view the elections they have created in their profile.
• For elections that have expired without votes, the creator can delete them. However, because the blockchain is immutable, the election simply becomes invisible and inaccessible. When an election is deleted, the user is refunded the Ether spent on creating it.

💻 Technologies and Design Patterns Used:

Backend:

• Solidity was used for writing the smart contract, with Hardhat as the development environment for deploying and testing on the Ethereum blockchain.

Frontend:

• The frontend was developed using HTML, CSS, and JavaScript, aiming to provide a simple and user-friendly interface.

Design Patterns:

• Check-Effects-Interaction: This pattern ensures the correct order of operations and prevents reentrancy attacks.
• Guard Check: Used to verify that all conditions are valid before executing a function, protecting the contract from invalid operations.
• Secure-Ether-Transfer: Used to ensure secure transactions via the transfer function, limiting gas to 2300, thus preventing recursive call attacks.