A decentralized voting platform, built over Ethereum, where candidates and voters can register to participate in voting process, which can be initiated by the contract owner.
- Allows contract owner to initiate and end a voting session.
- Prevents common issues like double voting, spam voters and candidates by requiring a nominal amount of ether for some operations.
- Voting results are hidden until contract owner ends voting session, which provide more transparency.
- Fully decentralized architecture tested and verified on Ethereum Sepolia Testnet.
- Elaborate testing infrastructure with unit and staging tests using mocha.
- 94% test code coverage according to istanbul-js reports
This smart contract has not been audited and is provided as-is, we make no guarantees or warranties to its safety and reliability
Make sure you have nodejs, yarn, and git installed.
Clone the repo
git clone https://github.com/aritroCoder/ethereum-voting-system.git
cd ethereum-voting-systemInstall required dependencies:
yarnTo run this project, you will need to add the following environment variables to your .env file
ALCHEMY_API_KEY: Go to alchemy and create an API key.
SEPOLIA_PRIVATE_KEY: Use any ethereum wallet private key that is used to access Sepolia testnet.
Compile the smart contract code
yarn hardhat compileRun unit and staging tests
yarn hardhat testDeploy to sepolia testnet (make sure you have some sepolia test ether). This command will output the address where it is deployed.
yarn hardhat run scripts/deploy.js --network sepoliaGet code coverage report
yarn hardhat coverageLatest version of the contract is currently deployed at Sepolia address: 0x6f9f4957e157127eA607580B6231E7379C199f2c
Contributions are always welcome!
Please adhere to the code formatting style while contributing. Prettier is configured in this project and will autoformat your code on command.
yarn formatFor contributing, start be checking the issues section or create your own issue.