Skip to main content

ElectionGuard: Support for e2e verified elections.

Project description

Microsoft Defending Democracy Program: ElectionGuard Python

🗳 ElectionGuard Python

ElectionGuard Specification 0.95.0 Github Package Action Language grade: Python Total alerts Documentation Status license

This repository is a "reference implementation" of ElectionGuard written in Python 3. This implementation can be used to conduct End-to-End Verifiable Elections as well as privacy-enhanced risk-limiting audits. Components of this library can also be used to construct "Verifiers" to validate the results of an ElectionGuard election.

📁 In This Repository

File/folder Description
docs Documentation for using the library.
src/electionguard ElectionGuard library.
src/electionguard_tools Tools for testing and sample data.
src/electionguard_verifier Verifier to validate the validity of a ballot.
stubs Type annotations for external libraries.
tests Tests to exercise this codebase.
CONTRIBUTING.md Guidelines for contributing.
README.md This README file.
LICENSE The license for ElectionGuard-Python.
data Sample election data.

❓ What Is ElectionGuard?

ElectionGuard is an open source software development kit (SDK) that makes voting more secure, transparent and accessible. The ElectionGuard SDK leverages homomorphic encryption to ensure that votes recorded by electronic systems of any type remain encrypted, secure, and secret. Meanwhile, ElectionGuard also allows verifiable and accurate tallying of ballots by any 3rd party organization without compromising secrecy or security.

Learn More in the ElectionGuard Repository

🦸 How Can I use ElectionGuard?

ElectionGuard supports a variety of use cases. The Primary use case is to generate verifiable end-to-end (E2E) encrypted elections. The ElectionGuard process can also be used for other use cases such as privacy enhanced risk-limiting audits (RLAs).

💻 Requirements

🚀 Quick Start

Using make, the entire GitHub Action workflow can be run with one command:

make

The unit and integration tests can also be run with make:

make test

A complete end-to-end election example can be run independently by executing:

make test-example

For more detailed build and run options, see the documentation.

📄 Documentation

Overviews:

Sections:

Step-by-Step Process:

  1. Configure Election
  2. Key Ceremony
  3. Encrypt Ballots
  4. Cast and Spoil
  5. Decrypt Tally
  6. Publish and Verify

Contributing

This project encourages community contributions for development, testing, documentation, code review, and performance analysis, etc. For more information on how to contribute, see the contribution guidelines

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Reporting Issues

Please report any bugs, feature requests, or enhancements using the GitHub Issue Tracker. Please do not report any security vulnerabilities using the Issue Tracker. Instead, please report them to the Microsoft Security Response Center (MSRC) at https://msrc.microsoft.com/create-report. See the Security Documentation for more information.

Have Questions?

Electionguard would love for you to ask questions out in the open using GitHub Issues. If you really want to email the ElectionGuard team, reach out at electionguard@microsoft.com.

License

This repository is licensed under the MIT License

Thanks! 🎉

A huge thank you to those who helped to contribute to this project so far, including:

Josh Benaloh (Microsoft)

Keith Fung (InfernoRed Technology)

Matt Wilhelm (InfernoRed Technology)

Dan S. Wallach (Rice University)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

electionguard-1.4.0.tar.gz (668.1 kB view details)

Uploaded Source

Built Distribution

electionguard-1.4.0-py3-none-any.whl (752.8 kB view details)

Uploaded Python 3

File details

Details for the file electionguard-1.4.0.tar.gz.

File metadata

  • Download URL: electionguard-1.4.0.tar.gz
  • Upload date:
  • Size: 668.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.9.14 Linux/5.15.0-1020-azure

File hashes

Hashes for electionguard-1.4.0.tar.gz
Algorithm Hash digest
SHA256 8dd7990004f1ed9477be50a3f65ecf5f7b4427bd219b847a065dd899e0abb94c
MD5 6f0c74ad9bbecdd0fa7e8fee81fbe949
BLAKE2b-256 bdbd74e1d64b9db33ee914709289791d86c82b4d11a72c54562db29314bfeb05

See more details on using hashes here.

File details

Details for the file electionguard-1.4.0-py3-none-any.whl.

File metadata

  • Download URL: electionguard-1.4.0-py3-none-any.whl
  • Upload date:
  • Size: 752.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.9.14 Linux/5.15.0-1020-azure

File hashes

Hashes for electionguard-1.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 66e7d23b12e4ae4c4b3961266ed037fe0c1dd5e24861f8506bd3dcae317ce260
MD5 0fcd17e8b36ccc264765b388f452b465
BLAKE2b-256 5d691081a74e3a1c8022bfbb6c3deb9b1faba6c62988d3b5735bcbdc38043b1d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page