The work in this prototype complements research that Dr. Kees Leune (Adelphi University) and I have done. Our work was published by Ledger Journal in March 2021.
This is a blockchain-inspired electronic voting system that demonstrates how a blockchain architecture can be used to make the voting process more reliable. It keeps track of voters that have been authenticated as well as ballots that are cast in two separate, unlinked blockchains. This preserves voter anonymity and achieves greater election integrity using an "immutable" audit trail.
The system allows users to configure their own voter roll and ballot with multiple ballot items and multiple selections per item. It aims to simulate the decentralized nature of blockchain with a consensus process that must take place before votes are recorded on the blockchain.
- full voting system (registration, authentication, electronic ballot interface)
- interactive (normal) mode vs. simulated election
- demonstrates consensus process among nodes in the blockchain
- adversarial mode (mocks adversary nodes and demonstrates power of consensus)
- logging (machine logs emulate realistic system messages that is part of the system's auditing)
Docker OR Python 3.5+ & pip
You can use docker
to run this application. See docker instructions for more.
Alternatively, you can set up the environment using pip
to install the dependencies from requirements.txt
(ideally in a virtual environment).
Then run python main.py
. To customize the software for your own voter roll & ballot, modify configs/voter_roll.json
and configs/ballot_config.json
, respectively.