This glossary is intended to provide terms that are applicable to a variety of audiences:
- Election administrators - Terms that map to their conception of the voting process and user experience
- Developers - Provides entities, constructs, and a detailed grammar that allows them to solve problems quickly
- Cryptographers & election technology contributors - Consistency of usage between the specification and programming code, and sufficiently clear descriptions of the techniques and terms necessary for proper treatment and interpretation of the election record and all processes
- General public - Clear articulation of the meaning and rationale for the different facets of end-to-end verifiability
ElectionGuard seeks to keep most terms and meanings consistent the NIST Election Results Common Data Format Specification and the Civics Common Standard Data Specification. These can be helpful additions to this glossary.
Utilize the search bar to ease searching for a particular terms. There are "other terms" sections to reduce the difficulty to search possible outdated or deprecated terms.
Approval voting is a single-winner electoral system where each voter may choose or approve any number of candidates, and the winner is the single candidate approved by the largest number of voters. Approval voting can be achieved by setting the selection limit to the total number of options in a contest.
auxiliary key pair
Other terms: auxiliary keys
A term used to represent collection of submitted ballots in programming code mimicking the physical item.
If the ballots are encrypted in a particular order by an encryption device, this creates a ballot chain. This can be useful for verification purposes because an inserted or removed ballot can be easily detected as a break in the chain.
A unique hash value generated by an encryption device to anonymously identify a ballot and allow the voter to confirm the ballot has been submitted. code is not to be confused with programming code, but is rather a code to confirm the ballot.
Other terms: code, confirmation code, ballot confirmation code, verification code (deprecated)
The lifecycle the ballot goes through. For ElectionGuard, the ballot goes from a plaintext ballot to a ciphertext ballot to a submitted ballot and then it is either (1) cast, added to tally or (2) spoiled and decrypted during tally ceremony.
A candidate is a choice or option on a contest. This can represent a named a named candidate but also word choices like yes or no.
Other terms: choice, option
A ballot which a voter has submitted as cast to be included in the official election tally.
Other terms: cast, casting
An encrypted representation of a voter's filled-in ballot.
Other terms: encrypted ballot
ciphertext election context
The cryptographic context of an election constructed following the key ceremony. This is a programming concept to coordinate the cryptographic information about the election such as the number of guardians and quorum, and joint key.
Other terms: election context, context
A ciphertext tally is the homomorphically-combined and encrypted representation of all selections made for each option on every contest in the election. It is an aggregate of all the encrypted cast ballots in the election. The ciphertext tally is the tally while it is is still in the encrypted state.
Other terms: aggregate ciphertext ballot
A compact ballot is an ElectionGuard term for an encrypted or plaintext ballot that contains only the basic information for a ballot to allow for faster performance and smaller data size. The compact ballot saves space by removing information that can be reconstituted like contest info from the manifest or mathematical proofs.
compensated decryption share
A partial decryption share value computed by an available guardian to compensate for a missing guardian so that the missing guardian's share can be generated and the tally can be successfully decrypted.
A contest in an manifest consists of a set of candidates or options together with a selection limit. Contests can be customized to suit the voting experience with options like approval voting, ranked-choice voting and write-ins. Contests can have special rules around selection limits to handle undervotes, overvotes, and null votes.
election key pair
Other terms: election keys, guardian key pair, guardian keys
election partial key backup
A point on a secret election polynomial and commitments to verify this point for a designated guardian.
Other terms: backup
election partial key verification
Other terms: backup verification
The election polynomial is the mathematical expression that each guardian uses for encryption. Each guardian has a polynomial where the first coefficient is used to generate their election key pair. A different point associated with the polynomial is shared with each of the other guardians in the key ceremony so that the guardians can come together and decrypt in the tally ceremony.
A verifiable record of the public artifacts or files of the election. This includes items like the manifest and the encrypted ballots so an individual or third party can verify the election end-to-end.
Other terms: record, election artifacts (deprecated)
A programming code base that implements fundamental features of the ElectionGuard Specification (such as ballot encryption) to act as a core or central integration.
The specification indicating how ElectionGuard creates end-to-end verifiable elections. See Specification.
The entire set of repositories associated with ElectionGuard. See Repositories.
The encryption seed is the starting number or point for the encryption. The seed is usually a hash either the starting hash from the encryption device or with a ballot chain the hash from the previous ballot.
Other terms: seed hash
End-to-end verifiable election techniques enable individual voters to check crucial ingredients of election results – without requiring voters to trust election software, hardware, election officials, procedures, or even observers. Voters may check these ingredients themselves, place their trust in others of their choice (e.g. their preferred candidates, news media, and/or interest groups), or accept the outcome produced with the usual administrative safeguards.1
An end-to-end verifiable election must include two principle components:
- Cast as intended - Voters can verify that their own selections have been correctly recorded.
- Counted as cast - Anyone can verify that the recorded votes have been correctly tallied.
One of a number of independent, trustworthy individuals who serve guardians in the election. All guardians must participate in a key ceremony to create a key to encrypt the election and may participate in the accompanying tally ceremony(s) to decrypt the tally(s). A guardian is available if they are available for the tally ceremony. A guardian is missing if they cannot attend the tally ceremony.
Other terms: election guardian, missing guardian, available guardian
Hashing is a common practice in computing as a mechanism to map data of an arbitrary size into a fixed-size equivalent. ElectionGuard uses hashing in its cryptographic context, This is done for a variety of reasons, including preventing discovery of election ballot contents, but also to verify certain information. For example, a hash of the manifest is added to the ballot which can verify the ballot is using the correct manifest.
Creating a joint public key as part of the key ceremony
Other terms: joint public key, encryption key, ballot encryption key, elgamal key
The process conducted at the beginning of the election to create the joint key for ballot encryption during the election. In ElectionGuard, each guardian creates an election key pair and shares a recovery method for their decryption with the other election guardians as part of the key ceremony in case that particular guardian cannot attend the tally ceremony.
A key pair consists of a linked private key and public key. Key pairs are used in public key cryptography, in which public keys are distributed to others to encrypt messages that only the private key can decrypt.
The manifest is the information that uniquely specifies and describes the structure and type of the election, including geopolitical units, contests, candidates, ballot styles, etc. In ElectionGuard, it is a file that is created before running an election. The internal manifest is a wrapper around the manifest used in programming code to simplify and avoid processing the same information twice. Unlike the manifest, the internal manifest is not meant for serialization.
Other terms: election manifest, election description (deprecated), internal election description (deprecated)
A mediator is used to mediate communication (if needed) of information such as keys between the guardians. This can be a person but in ElectionGuard this often refers to the server mediating / coordinating between the guardian machines that maintains all the public information between the key and tally ceremonies.
Other terms: key ceremony mediator, tally mediator
An arbitrary number used for cryptographic applications particularly encryption.
non-interactive-zero-knowledge proof (NIZK)
A non-interactive-zero-knowledge proof (NIZK) is a zero-knowledge proof that can be performed without interaction or intervention by the prover.
An null vote occurs when no candidate is selected for a contest. Example: A contest where 2 candidate must be selected and 0 are chosen.
An overvote occurs when too many candidates are selected for a contest. Example: A contest where 2 candidate must be selected and 3 are chosen.
A legitimate vote in a contest consists of a set of selections with cardinality not exceeding the selection limit of that contest. To accommodate legitimate undervotes or null votes, the internal representation of a contest in programming code is augmented with “placeholder” options equal in number to the selection limit. Placeholder options are selected as necessary to force the total number of selections made in a contest to be equal to the selection limit. When the selection limit is one, for example, the single placeholder option can be thought of as a “none of the above” option.
With larger selection limits, the number of placeholder options selected corresponds to the number of additional options that a voter could have selected in a contest.
The plaintext representation of a voter's selections.
Other terms: ballot
A plaintext tally is the summation of votes for each candidate for each contest in the election. The plaintext tally, or just tally, is the decrypted ciphertext tally or decrypted aggregate ballot which contains the election results.
Other terms: aggregate ballot, tally, election results
A post-election audit verifies that the voting equipment used to count ballots during an election properly counts a sample of voted ballots after an election
The minimum count of guardians that must be present in order to successfully decrypt the tally.
Other terms: threshold
ranked-choice voting (RCV)
A ranked-choice voting is an electoral system in which voters rank candidates by preference on their ballots. ElectionGuard does not currently support this.
risk-limiting audit (RLA)
A risk-limiting audit is a post-election audit that provides strong statistical evidence that the election outcome is correct. RLA has a high probability of correcting a wrong outcome.
A selection or vote is the selected candidate(s) or option(s) in a contest on a voter's ballot.
Other terms: ballot selection, candidate selection, vote
The limit of selections that indicates the number of selections that are allowed to be made in that contest. Most contests have a selection limit of one, but a larger selection limit (e.g., select up to three) is not uncommon in certain elections.
The sequence order is a field used to ensure items such as contests, selections, or guardians are in order for functions that require specific ordering. "In sequence order" means ordered by increasing sequence order number.
Spoiling allows a voter to turn in their ballot without their ballot being included in the election tally. A spoiled ballot is a ballot the voter has submitted as spoiled. The voter must submit a replacement ballot as their official cast ballot.
In ElectionGuard, ballot spoiling is used as a means for voters to challenge the voting machine and force it to reveal the contents of spoiled ballots for public scrutiny. In this way, a spoiled ballot challenges the system and the term challenge ballot is used. The ballot is spoiled after encryption where the machine cannot modify the ballot. Since the ballot will not be used in the official tally, the content of the ballot can be revealed at the same time as the tally allowing a voter to verify the encryption and decryption process.
Other terms: spoil, spoiling, challenge ballot
Other terms: accepted ballot (deprecated)
The process of decrypting the encrypted tally to the decrypted tally. The guardians from the key ceremony who are available attend this ceremony. There must be at least enough guardians to meet the quorum. Each guardian will decrypt their decryption shares and their share for each missing guardian. These shares will then be combined to create the decrypted spoiled ballots and decrypted tally.
An undervote occurs when too little candidates are selected for a contest. Example: A contest where 2 candidate must be selected and 1 is chosen. Selecting no candidates at all will result in a null vote.
A write-in is a candidate or option which does not appear on the manifest's contest. For ElectionGuard, write-ins are assumed to be explicitly registered or allowed to be lumped into a single "write-ins" category for the purpose of verifiable tallying.
A zero-knowledge proof is a method by which one party (the prover) can prove to another party (the verifier) that they know a value
x, without conveying any information apart from the fact that they know the value
x. The essence of zero-knowledge proofs is that it is trivial to prove that one possesses knowledge of certain information by simply revealing it; the challenge is to prove such possession without revealing the information itself or any additional information.2