DECENTRALIZED VOTING SYSTEM

📗 Table of Contents

• 📖 About the Project
  • 🛠 Built With
    • Tech Stack
    • Key Features
• 💻 Getting Started
  • Prerequisites
  • Setup
  • Install
  • Usage
  • Run tests
• 👥 Authors
• 🔭 Future Features
• 🤝 Contributing
• ⭐️ Show your support
• 🙏 Acknowledgements
• 📝 License

📖 Decentralized Voting System 🗳️

A blockchain-based voting system that enables:

• Secure proposal creation
• Delegated voting rights
• Tamper-proof vote recording
• Transparent result calculation

🛠 Built With

Tech Stack ⚙️

• Foundry
• Solidity
• EVM

(back to top)

Key Features ✨

✅ Chairperson-controlled voter registration
✅ Vote delegation to trusted parties
✅ Automatic tie detection between proposals
✅ Fully auditable voting history
✅ Gas-efficient operations

(back to top)

💻 Getting Started

To get a local copy up and running, follow these steps.

Prerequisites

In order to run this project you need to install the following items:

• Foundry
• Solidity extension

Install

Install this project by using:

git clone https://github.com/rbd3/Voting-Contract.git
cd Voting-Contract
forge install

Run tests

To run tests, run the following command:

forge test

(back to top)

👥 Authors

👤 Andry Narson

• GitHub: @rbd3
• LinkedIn: @Andry Narson

(back to top)

🔭 Future Features

Potential upgrades to expand the voting system's capabilities:

🌐 Build a frontend interface to:

• Visualize real-time vote counts

• Track delegation chains

• Display proposal details and winner history

⛓️ Support cross-chain voting via:

• Layer 2 solutions (Polygon, Arbitrum) for gas efficiency

• Bridge contracts for inter-chain vote aggregation

🤝 Advanced Delegation:

• Time-limited delegation (expiring votes)

• Proposal-specific delegation (delegate power per topic)

🕵️♂️ Anonymous Voting:

• Zero-knowledge proof verification

• Tally contracts to hide individual votes until reveal

(back to top)

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

(back to top)

⭐️ Show your support

Give a star⭐️ or a thumbs up 👍 if you like this project! You can visit my GitHub profile for more of my projects. link

(back to top)

🙏 Acknowledgments

• My family who supported me
• Patrick Collins who teach me

(back to top)

📝 License

This project is MIT licensed.

(back to top)