Zum Inhalt springen
Condorcet.vote Alpha
← Technische Dokumentation

Öffentliches Register

Was jede Wahl öffentlich macht, unabhängig vom Transportweg, und was jeder davon prüfen kann, ohne der Plattform zu vertrauen.

Das Register ist die überprüfbare Aufzeichnung der Wahl. Während der Stimmabgabe ist die Plattform ein vertrauenswürdiger Dritter; alles, was sie getan hat, lässt sich danach allein anhand des veröffentlichten Registers kontrollieren. Diese Seite beschreibt seinen Inhalt unabhängig vom Transportweg. Die Blockchain ist nur ein Weg, ihn zu verbreiten: derjenige, über den jeder seine Integrität und Unveränderlichkeit prüfen kann.

Protokoll v1

Inhalt

Wer abgestimmt hat, und getrennt davon, was abgestimmt wurde.

Eine Definition und Ringe (in der Oberfläche „virtuelle Wahllokale“ genannt), die für die ganze Wahl gelten, dazu zwei bewusst getrennte Teile: Die Teilnahmeliste sagt, wer teilgenommen hat. Das Register der Stimmzettel sagt, was abgestimmt wurde, mit dem kryptografischen Nachweis, aber ohne Spur davon, von wem oder wann. Daraus ergibt sich das Ergebnis.

  • Kontext

    Definition der Wahl

    Titel, Organisator, Typ, Sitze, Kandidaten, Stimmzettelregeln und Datenschutzoptionen, fixiert vor dem ersten Stimmzettel.

    Bei der Eröffnung · configuration-Block

  • Kontext

    Ringe

    Die vollständige Liste der öffentlichen Schlüssel, die signieren dürfen, Ring für Ring, mit dem Hashwert jedes Rings.

    Bei der Eröffnung, dann je Ausweichring · rings-Blöcke

  • Teilnahme

    Teilnahmeliste

    Eine Zeile pro Wähler unter einer zufälligen Wähler-ID: abgestimmt oder nicht, in welchem Ring, wie viele Schlüssel erhalten, welches Gewicht. Standardmäßig pseudonym.

    Beim Ende der Stimmabgabe, als einmalige Momentaufnahme · closure-Block

  • Stimmzettel

    Signierte Stimmzettel

    Jeder Stimmzettel so, wie er signiert wurde, Byte für Byte, mit Ringsignatur und Schlüsselabbild (key image), ohne Identität und ohne Zeitstempel.

    Während der Stimmabgabe, in Stapeln von mindestens 600 · votes-Blöcke

  • Berechnung

    Veröffentlichtes Ergebnis

    Die maßgebliche Rangfolge mit der gespeicherten Methode und den Berechnungsversionen, dazu die Stimmzettel im CEF-Format. Nie ein Block: Das Ergebnis wird neu berechnet.

    Bei Veröffentlichung durch den Organisator · Ergebnisseite

  • Außerhalb des Registers

    Nie veröffentlicht

    Zeitstempel, Eingangsreihenfolge, die Zuordnung von Wähler-ID zu Identität (außer bei namentlicher Teilnahmeliste), die optische Gestaltung: Logo, Fotos, Dankesnachricht.

    Weder auf der Seite noch in einem Block

Definition & Ringe

Was vor dem ersten Stimmzettel fixiert wird.

Die Definition wird beim Start der Wahl fixiert, jeder Ring bei seiner Erstellung. Danach ändern sich beide nicht mehr: Jeder Stimmzettel wird gegen die veröffentlichte Definition und den veröffentlichten Ring geprüft.

Definition der Wahl

protocol_version Ganzzahl
Die Protokollversion, derzeit 1, dauerhaft an die Wahl gebunden.
election_id UUID v4
Die ID der Wahl, enthalten in jedem signierten Stimmzettel und in jeder Signaturprüfung.
title, description?, organizer_name Zeichenketten
Informativer Kontext, im Klartext veröffentlicht, nie eine Eingabe der Auszählung.
election_type, seats preferential | fptp, Ganzzahl ≥ 1
Rangfolge oder eine einzige Auswahl; Anzahl der Sitze, also der an der Spitze der Rangfolge gewählten Kandidaten.
candidates[].label Array
Die Bezeichnungen der Kandidaten, ihre einzige Kennung, sortiert nach Bezeichnung.
ballot_rules Objekt
Die Parameter des Stimmzettels (Gleichstände, teilweise Rangfolge, leerer Stimmzettel, vollständige Rangfolge), aus denen sich die Bedingungen der Auszählung nach einer dokumentierten Regel ergeben.
non_anonymous_voting, nominative_participation, weighted_voting boolesche Werte
Die Optionen für Datenschutz und Gewichtung, standardmäßig deaktiviert. Die nicht anonyme Stimmabgabe erzwingt die namentliche Teilnahmeliste.
max_ring_size, initial_electoral_roll_size Ganzzahlen
Die Obergrenze der Ringgröße (derzeit 600) und die Größe des Wählerverzeichnisses bei der Eröffnung.

Die Einzelheiten Feld für Feld, einschließlich voter_access_mode und enrolment_mandatory, stehen in der Spezifikation der Blockchain. Die maßgebliche Methode gehört dazu (Feld method): Sie wird vor der Stimmabgabe festgelegt, und das Ergebnis wird mit ihr neu berechnet.

Ringe

ring_id UUID
Der Ring, gegen den ein Stimmzettel signiert wird; jeder Stimmzettel nennt ihn.
public_keys[] pk_<64 hex>_<8 hex>
Alle öffentlichen Schlüssel des Rings, eindeutig, aufsteigend sortiert, höchstens max_ring_size.
ring_digest ring_<64 hex>_<8 hex>
Der kanonische, von der Reihenfolge unabhängige Hashwert der Mitgliedermenge, aus den Schlüsseln nachrechenbar.

Die Anonymität eines Stimmzettels ist genau der Ring, unter dem er signiert wurde: Eine Plattform, die einem Wähler einen Ring liefert, der sich in nur einem Mitglied unterscheidet, könnte seinen Stimmzettel wiedererkennen. Die Abstimmungsseite berechnet den Hashwert aus dem erhaltenen Ring (sie bekommt ihn nie von der Plattform), zeigt ihn vor der Signatur an und schreibt ihn in den Prüfbeleg. Der Wähler vergleicht ihn mit dem Wert, der hier für alle veröffentlicht ist. Das ist Erkennung, keine Verhinderung.

Wächst das Wählerverzeichnis während der Stimmabgabe, wird ein Ausweichring angelegt und bei seiner Erstellung veröffentlicht. Jeder Ring lässt sich auf der Registerseite als JSON herunterladen, mit seinem Hashwert und seinen Schlüsseln in derselben Reihenfolge wie in seinem Block.

Teilnahmeliste

Wer teilgenommen hat, einmalig veröffentlicht.

Die Teilnahmeliste wird als einmalige Momentaufnahme im Abschlussblock veröffentlicht, sobald das Wählerverzeichnis endgültig ist. Während der Stimmabgabe zeigt die Registerseite nichts davon: Keine Teilnahmezeile teilt sich je ein Veröffentlichungsfenster mit einem Stimmzettel.

Eine Zeile pro Wähler

voter_id UUID v4, zufällig
Die einzige Kennung der Zeile; die Zeilen sind nach voter_id sortiert. In allen Wahlen einer Gruppe identisch.
key_provisioning_mode server_generated | organizer_imported | voter_enrolled
Die Herkunft des Schlüssels: von der Plattform erzeugt, vom Organisator importiert oder vom Wähler selbst hinterlegt.
has_voted boolescher Wert
Abgestimmt oder nicht.
ring_id UUID oder null
Der Ring, in dem der Wähler abgestimmt hat, oder null, wenn er nicht abgestimmt hat: die Verbindung Wähler → Ring, auf der die Prüfung pro Ring beruht.
distribution_count Ganzzahl ≥ 0
Die Anzahl der verteilten Wahlschlüssel: standardmäßig höchstens 3, mehr nur, wenn der Organisator zusätzliche gewährt, was sichtbar bleibt. Die einzelnen Verteilungen werden nicht aufgeschlüsselt.
weight Ganzzahl ≥ 1
Das Gewicht (etwa Miteigentumsanteile), immer vorhanden, 1 ohne Stimmgewichtung: der Wert, gegen den das im Stimmzettel signierte Gewicht geprüft wird.

Das Wählerverzeichnis zum Ende der Stimmabgabe enthält auch die Wähler, die während der Stimmabgabe hinzugefügt wurden: Seine Größe minus initial_electoral_roll_size ergibt, wie viele es sind, nie aber, welche. Der Abschlussblock enthält außerdem die Summen: Blöcke, Stimmzettel, Ringe, Wähler, abgegebenes Gewicht.

Namentliche Teilnahmeliste: eine Option

Sie ist standardmäßig deaktiviert. Der Organisator kann sie beim Start aktivieren, und die Wähler werden darauf hingewiesen; bei nicht anonymer Stimmabgabe ist sie zwingend. Nur die Zeilen der Wähler, die abgestimmt haben, erhalten dann zwei zusätzliche Felder.

voter_name Zeichenkette
Der Name im Klartext, so wie der Organisator ihn beim Import angegeben hat.
email_digest 64 Hex-Zeichen
SHA3-256(election_id ‖ normalisierte E-Mail-Adresse), Hex in Kleinbuchstaben: ein Hashwert, der nur für diese Wahl gilt.
  • Wer nicht abgestimmt hat, wird nie genannt. Diese Zeilen bleiben pseudonym: Die Option zeigt, wer abgestimmt hat, nie, wer sich enthalten hat.
  • Offengelegt wird die Teilnahme, nicht der Stimmzettel. Für sich genommen verknüpft die Option einen Namen mit der Tatsache, abgestimmt zu haben, nie mit einem Stimmzettel. Zusammen mit der nicht anonymen Stimmabgabe, bei der die Wähler-ID im signierten Stimmzettel steht, entsteht die Verknüpfung Stimmzettel → Wähler-ID → Name.
  • Ein schwacher Hashwert, bewusst gewählt. Das Salt (election_id) ist öffentlich, und eine E-Mail-Adresse lässt sich erraten: Wer eine Adresse kennt, kann die Teilnahme ihres Inhabers bestätigen und über mehrere Wahlen hinweg verknüpfen. Der Hashwert dient der Kontrolle des Verzeichnisses, nicht dem Schutz, und bleibt ein personenbezogenes Datum.
Stimmzettel

Was abgestimmt wurde, ohne Wer und Wann.

Ein Datensatz pro Stimmzettel, sortiert nach Schlüsselabbild: eine deterministische, aus dem Inhalt abgeleitete Reihenfolge, die nichts mit der Eingangsreihenfolge zu tun hat.

Ein Datensatz pro Stimmzettel

ring_id UUID
Der Ring, mit dessen Schlüsseln sich die Signatur prüfen lässt.
payload JSON-Zeichenkette
Die signierten Nutzdaten, unverändert, Byte für Byte: Version, Wahl, Inhalt des Stimmzettels, Gewicht und bei nicht anonymer Stimmabgabe die Wähler-ID.
signature blsag_…
Die Ringsignatur (bLSAG) über die Nutzdaten.
key_image ki_…
Das Schlüsselabbild: Derselbe Schlüssel ergibt in einer Wahl immer dasselbe Abbild, ohne zu verraten, welcher Schlüssel des Rings signiert hat.
Spezifikation des signierten Stimmzettels
  • Veröffentlichung in Stapeln. Die Stimmzettel werden in Stapeln von mindestens 600 veröffentlicht, in einem zufällig gewählten Zeitfenster; ein zu kleiner Stapel wartet auf den nächsten. Beim Ende der Stimmabgabe wird alles veröffentlicht; der letzte Stapel kann weniger als 600 Stimmzettel enthalten. Eine Wahl mit weniger als 600 Wählern veröffentlicht ihre Stimmzettel daher beim Ende der Stimmabgabe.
  • Eine Regel für Seite und Kette. Registerseite und Blockchain lesen dasselbe Flag, is_chain_published: Sie zeigen immer genau dieselbe Menge an Stimmzetteln. Während der Stimmabgabe zeigt die Seite die Anzahl der eingegangenen Stimmzettel, die auf Veröffentlichung warten, ohne deren Inhalt.
  • Den eigenen Stimmzettel vor der Veröffentlichung finden. Die Suche nach Schlüsselabbild (POST-Anfrage mit Ratenbegrenzung) findet auch einen Stimmzettel, der eingegangen, aber noch nicht veröffentlicht ist. Ein Schlüsselabbild lässt sich nicht erraten: Nur wer den Prüfbeleg besitzt, kann es eingeben. Die öffentliche Liste zeigt dagegen nur veröffentlichte Stimmzettel.
  • Eine Seite pro veröffentlichtem Stimmzettel. Nutzdaten, Signatur, Schlüsselabbild und Hashwert seines Rings. Die ID des Stimmzettels, die die Seite anzeigt, ist eine zufällige UUID v4; sie steht in keinem Block.
Zeitplan

Wann welcher Teil erscheint.

Vor der Eröffnung der Stimmabgabe ist nichts öffentlich. Danach wächst das Register nur noch, bis das Ende der Stimmabgabe es abschließt.

Je nach Status der Wahl

Draft, Enrolment, Opening Vorbereitung
Nichts ist öffentlich. Bei Opening werden die Definition und die beim Start angelegten Ringe fixiert und versiegelt.
Open Stimmabgabe offen
Die Registerseite ist online: Definition, Ringe, in Stapeln veröffentlichte Stimmzettel, Anzahl der Stimmzettel, die auf Veröffentlichung warten, Suche nach Schlüsselabbild. Ein Ausweichring erscheint bei seiner Erstellung. Keine Teilnahmeliste.
Closed Stimmabgabe geschlossen
Der letzte Stapel Stimmzettel, dann der Abschlussblock: vollständige Teilnahmeliste und Summen. Danach kann kein Block mehr folgen.
Published Ergebnis veröffentlicht
Der Organisator veröffentlicht das Ergebnis: Ergebnisseite und CEF-Download.
Archived Archiviert
Das Register bleibt schreibgeschützt einsehbar; das Ergebnis wird nicht mehr öffentlich angezeigt.
Cancelled Annulliert
Alle öffentlichen Ansichten werden entfernt, die Registerseite weist darauf hin. Es wird kein Abschlussblock erzeugt: Bereits veröffentlichte Blöcke bleiben gültig, die Kette endet.

Das veröffentlichte Ergebnis

  • Nie ein Block. Das Ergebnis wird aus der Definition und den veröffentlichten Stimmzetteln neu berechnet; es gehört nicht zu den Daten der Kette.
  • Methode und Versionen gespeichert. Das Ergebnis speichert die verwendete Methode, die Version der Bibliothek CondorcetPHP und die Version des Auszählungsvertrags, damit eine Nachzählung genau dieselbe Semantik nachvollzieht. Die Ergebnisseite zeigt die Methode und die Version der Bibliothek an.
  • Die Stimmzettel im CEF-Format. Auf der Ergebnisseite herunterladbar. Die Datei dient nur der Bequemlichkeit: Sie lässt sich allein aus dem Register rekonstruieren, und ein Prüfer kann sie zum Vergleich neu erzeugen.
  • Die Gewählten. Die ersten Plätze der neu berechneten Rangfolge, so viele, wie seats angibt, und nicht mehr.
Spezifikation der Auszählung und Nachzählung
Seite & Blockchain

Dieselben Daten, zwei Lesarten.

Die Registerseite ist die wichtigste Ansicht der veröffentlichten Daten, paginiert und durchsuchbar, aber nicht unveränderlich. Die Blockchain ist ein Weg, dieselben Daten zu verbreiten: per Hash verkettete, von der Plattform signierte JSON-Dateien, die jeder herunterladen und aufbewahren kann. Die Seite bindet sie als Unterabschnitt ein.

Öffentliche Adressen pro Wahl

/elections/{election}/register
Die Registerseite: Status der Wahl, Zähler, Teilnahmeliste, Ringe, Suche, Stimmzettel, Blockchain.
POST /elections/{election}/register/lookup
Die Suche nach einem Stimmzettel per Schlüsselabbild, mit Ratenbegrenzung; das Schlüsselabbild erscheint nie in einer URL.
/elections/{election}/register/ballots/{ballot}
Die Seite eines veröffentlichten Stimmzettels.
/elections/{election}/register/rings/{ring}/keys
Ein Ring als JSON: election_id, ring_id, ring_number, ring_digest, public_keys.
/elections/{election}/results
Das Ergebnis, nur im Status Published.
/elections/{election}/results/ballots.cef
Die Stimmzettel im CEF-Format, unter derselben Bedingung.
/elections/{election}/chain
Das Manifest der Blockchain, das zu jedem Block und seinen Sidecar-Dateien führt.

Diese Adressen haben kein Sprachpräfix und werden von Suchmaschinen nicht indexiert. Es gibt sie, solange die Wahl ein öffentliches Register hat, von Open bis Archived.

Was die Blockchain hinzufügt

  • Dieselben Daten. Vier Blocktypen (configuration, rings, votes, closure), die genau den auf dieser Seite beschriebenen Inhalt tragen.
  • Integrität. Jeder Block enthält den SHA3-512-Hash des vorherigen und eine abgetrennte Signatur der Plattform: Eine nachträgliche Änderung bricht die Kette für jeden späteren Beobachter.
  • Unveränderlichkeit, die man prüfen muss. Die Signatur beweist die Herkunft, nicht die Unveränderlichkeit: Die Plattform besitzt ihren Schlüssel. Erst die von Dritten aufbewahrten Kopien und die Bitcoin-Verankerung über OpenTimestamps, die die Bytes jedes Blocks datiert, machen ein Umschreiben erkennbar.
  • Ohne API. Statische Dateien, cachebar und archivierbar, die jeder spiegeln kann.
Spezifikation der Blockchain
Prüfungen

Was jeder allein anhand des Registers prüfen kann.

Ohne der Plattform zu vertrauen, nur mit den veröffentlichten Daten.

  1. 1 Jeder Stimmzettel ist von einem Mitglied seines Rings signiert. Für jeden Stimmzettel die Prüfung der Ringsignatur auf (Nutzdaten, ID der Wahl, Signatur, Schlüsselabbild, Ring) wiederholen.
  2. 2 Ein Schlüssel, ein Stimmzettel. Alle Schlüsselabbilder der Wahl sind verschieden: Kein Schlüssel wurde zweimal verwendet. Da ein Wähler mehrere Schlüssel erhalten haben kann, ergibt sich erst zusammen mit den Prüfungen 3 und 4 ein Stimmzettel pro Wähler.
  3. 3 Kein Stimmzettel in einen Ring eingeschleust. Für jeden Ring ist die Anzahl der Stimmzettel gleich der Anzahl der Zeilen in der Teilnahmeliste, deren Abstimmungsring dieser Ring ist.
  4. 4 Nicht mehr Stimmzettel als Wähler. Die Gesamtzahl der Stimmzettel übersteigt nicht die Anzahl der Zeilen mit has_voted: Diese Schranke ist der maßgebliche Schutz gegen das Einschleusen zusätzlicher Stimmzettel. Bei Stimmgewichtung bilden die signierten Gewichte und die Gewichte der Wähler in der Teilnahmeliste dieselbe Multimenge, mit der Summe voted_weight.
  5. 5 Die Nachzählung. Die Nutzdaten in CEF serialisieren und mit CondorcetPHP oder einer beliebigen CEF-Implementierung auszählen, unter den Bedingungen, die sich aus den veröffentlichten Stimmzettelregeln ergeben: Man erhält dieselbe Rangfolge und dieselben Zahlen gewerteter, leerer und ungültiger Stimmzettel.
  6. 6 Die Gewählten. Die ersten Plätze der neu berechneten Rangfolge ablesen, so viele, wie seats angibt.

Was jeder Wähler zusätzlich prüfen kann

  • Seine Zeile in der Teilnahmeliste. Über seine Wähler-ID: abgestimmt oder nicht, Anzahl der erhaltenen Schlüssel. Eine in seinem Namen erfundene Aktivität fällt auf.
  • Sein Ring. Der Ring-Hashwert in seinem Prüfbeleg, von seinem Browser berechnet, muss dem Wert entsprechen, den das Register veröffentlicht.
  • Sein Stimmzettel. Mit dem Schlüsselabbild aus seinem Prüfbeleg findet er seinen Stimmzettel und prüft dessen Inhalt Byte für Byte, sogar vor der Veröffentlichung.

Die zentrale Garantie ist die feststehende Liste der signierten Stimmzettel: Prüfungen 1 bis 4, dazu die Integrität der Kette. Die Nachzählung ist eine Gegenprüfung: Kämen zwei Implementierungen zu verschiedenen Ergebnissen, läge ein Fehler in einer Berechnungssoftware vor, kein Mangel der Überprüfbarkeit.

Prüfverfahren
Grenzen

Was das Register nicht sagt.

Was es bewusst verschweigt, was es nicht beweisen kann und was es durchscheinen lässt.

Was es nicht offenlegt

  • Keine Zeitstempel. Kein veröffentlichter Datensatz trägt ein Datum; die technischen Zeitangaben bleiben in der Datenbank.
  • Keine Eingangsreihenfolge. Die Stimmzettel sind nach Schlüsselabbild sortiert, die Teilnahmeliste nach Wähler-ID: zwei verschiedene Sortierschlüssel ohne Bezug zur zeitlichen Abfolge.
  • Keine Verbindung zwischen Wähler und Stimmzettel. Die Teilnahmeliste wird erst beim Ende der Stimmabgabe veröffentlicht, nie in Zeitfenstern: Ihre Zeilen lassen sich zeitlich nicht mit den Stimmzetteln abgleichen. Nur die nicht anonyme Stimmabgabe stellt diese Verbindung her, wenn der Organisator sie wählt.
  • Standardmäßig keine Identität. Ohne namentliche Teilnahmeliste und ohne nicht anonyme Stimmabgabe enthält das Register keine Namensangaben; die Zuordnung von Wähler-ID zu Identität kennen nur die Plattform und der Organisator.
  • Keine optische Gestaltung. Logo, Fotos der Kandidaten, Dankesnachricht: weder veröffentlicht noch gehasht.

Was es nicht beweisen kann oder durchscheinen lässt

  • Der Moment der Stimmabgabe. Dass der Server einen Wähler nicht beobachtet hat, während er abstimmte: In diesem Moment ist die Plattform ein vertrauenswürdiger Dritter.
  • Eine erfundene Teilnahme. Dass eine Zeile „hat abgestimmt“ nicht für jemanden erfunden wurde, der gar nicht abgestimmt hat: Das kann nur dieser Wähler feststellen.
  • Wer im Ring signiert hat. Konstruktionsbedingt.
  • Eine grobe Reihenfolge. Die votes-Blöcke folgen aufeinander: Jeder Stimmzettel eines Blocks wurde abgegeben, bevor der nächste Block versiegelt wurde, mit einer Granularität von mindestens 600 Stimmzetteln. Ebenso zeigt ein später veröffentlichter Ausweichring, dass seine Stimmzettel später kamen.
  • Kleine Ringe und seltene Gewichte. In einem Ring, in dem nur ein Wähler abgestimmt hat, ist seine Wähler-ID mit seinem Stimmzettel verknüpft, bei namentlicher Teilnahmeliste auch sein Name. Der Organisator, der den Namen hinter jeder Wähler-ID kennt, kann diese Verknüpfung unabhängig vom Schlüsselmodus herstellen. Bei anonymer Stimmabgabe mit Stimmgewichtung verrät ein nahezu einmaliges Gewicht seinen Wähler.
  • Eingetragene Wähler ohne Schlüssel. In einer Wahl, in der die Wähler ihren Schlüssel selbst hinterlegen müssen, kann ein eingetragener Wähler, der keinen hinterlegt hat, nicht abstimmen und erscheint derzeit nicht in der veröffentlichten Teilnahmeliste.
  • Die Unveränderlichkeit der Seite. Die Registerseite kann sich ändern; die Unveränderlichkeit wird an der Blockchain geprüft, soweit Dritte Kopien davon aufbewahrt haben.

Legen Sie fest, was Condorcet.Vote auf seinen öffentlichen Seiten misst. Ihre Auswahl wird auf diesem Gerät gespeichert und lässt sich jederzeit ändern.

Notwendig Immer aktiv

Sprache, Design und Speicherung dieser Auswahl.