Zum Inhalt springen
Condorcet.vote Alpha
← Technische Dokumentation

Zeitstempel mit OpenTimestamps

Jeder Block wird über OpenTimestamps in der Bitcoin-Blockchain verankert: ein von der Plattform unabhängiger Nachweis, dass seine exakten Bytes spätestens zu einem bestimmten Zeitpunkt existierten.

Die Blockchain ist das Zusatzprotokoll, mit dem jeder die Integrität und Unveränderlichkeit des öffentlichen Registers kontrollieren kann. Die Verankerung über OpenTimestamps ist der Teil davon, der belegt, wann jeder Block existierte. Sie setzt kein Vertrauen in die Plattform oder ihre Schlüssel voraus: Die .ots-Datei wird mit den üblichen OpenTimestamps-Werkzeugen gegen den Block geprüft.

Protokoll v1

Warum eine externe Verankerung

Ein Datum, das die Plattform nicht rückdatieren kann.

Die Signatur der Plattform beweist, dass ein Block von ihr stammt, aber nicht, dass die Geschichte nicht umgeschrieben wurde. Eine externe Verankerung außerhalb der Reichweite ihrer Schlüssel schließt einen Teil dieser Lücke.

  • Eine Signatur macht nichts unveränderlich. Die Plattform besitzt ihren Signaturschlüssel: Sie könnte eine umgeschriebene Kette neu signieren, und jeder ihrer Blöcke bestünde die Prüfung weiterhin.
  • Das Datum einer Signatur ist eine Behauptung. signed_at ist der Erstellungszeitpunkt, den der Unterzeichner selbst in die Signatur schreibt: Mit einem kompromittierten Schlüssel lässt sich eine Signatur innerhalb seines Gültigkeitszeitraums rückdatieren.
  • Ein Bitcoin-Block lässt sich nicht rückdatieren. Eine Bitcoin-Attestierung ist keine Behauptung der Plattform: Sie beweist, dass die exakten Bytes des Blocks spätestens zum attestierten Bitcoin-Block existierten, unabhängig von den Schlüsseln der Plattform. Damit begrenzt sie den Zeitraum, in dem ein kompromittierter Schlüssel rückdatieren kann.
  • Eine Ergänzung zu unabhängigen Kopien. Die Unveränderlichkeit beruht in der Praxis auf den Kopien der veröffentlichten Blöcke, die jeder aufbewahren kann. Die Verankerung fügt einen Existenznachweis durch Dritte hinzu: Eine umgeschriebene Geschichte kann keine rückdatierten Attestierungen erhalten.
Was gestempelt wird

Der SHA-256 der Datei, wie sie veröffentlicht ist.

Jeder Block erhält unabhängig von seinem Typ (configuration, rings, votes, closure) einen eigenen Nachweis. Der Block wird beim Versiegeln an die OpenTimestamps-Kalenderserver übermittelt, direkt nachdem seine Verankerungszeile in der Datenbank gespeichert wurde. Das Commitment bezieht sich auf die veröffentlichte Datei selbst: Der Nachweis wird gegen den heruntergeladenen Block geprüft und braucht sonst nichts.

sha256({n}.json) SHA-256 · Commitment
Der einfache SHA-256 der Bytes der Blockdatei: genau die Bytes, die gespeichert, ausgeliefert, gehasht und signiert werden.
nonce entfällt
Bewusst ohne den bei OpenTimestamps üblichen Datenschutz-Nonce übermittelt, da die Bytes ohnehin öffentlich sind: Das Commitment bei den Kalendern ist gleich sha256({n}.json), und jedes übliche OpenTimestamps-Werkzeug prüft den Nachweis ohne Vertrauen in die Plattform.
SHA3-512 Verkettungs-Hash
Nicht zu verwechseln: Der Hash eines Blocks in der Kette (content_hash, previous_hash des nächsten Blocks) bleibt der SHA3-512 der Datei. Der SHA-256 dient nur als OpenTimestamps-Commitment.
Ablauf

Von pending zu completed.

Ein OpenTimestamps-Nachweis wird in zwei Schritten vervollständigt: Die Kalender legen sich sofort fest, Bitcoin bestätigt später, meist innerhalb weniger Stunden. Der Status des Nachweises ist die einzige veränderliche Angabe eines Blocks, und er ändert sich nur einmal, in eine Richtung.

  1. 1

    Übermittlung beim Versiegeln.

    Die Plattform übermittelt das Commitment an die öffentlichen OpenTimestamps-Kalenderserver und legt den erhaltenen Nachweis neben dem Block ab. Die Übermittlung erfolgt nach dem Best-Effort-Prinzip: Ein Ausfall der Kalender verzögert die Veröffentlichung des Blocks nicht und lässt sie auch nicht scheitern. Die .ots-Datei des Blocks fehlt dann bis zum nächsten Abgleich.

  2. 2

    pending: Die Kalender haben sich festgelegt.

    Der Nachweis enthält die Commitments der Kalender, aber noch keine Bitcoin-Attestierung. Er lässt sich bereits herunterladen, belegt aber noch kein Datum in Bitcoin.

  3. 3

    Ein stündlicher Abgleich.

    Jede Stunde wird jeder Block, der noch pending ist, erneut aufgegriffen. Ein fehlender Nachweis wird aus den gespeicherten Bytes neu übermittelt; die Verankerung beginnt dann mit dieser neuen Übermittlung. Bei einem Block, der vor mehr als 4 Stunden veröffentlicht wurde (der typischen Dauer einer Bitcoin-Bestätigung), werden die Kalender abgefragt. Dieser Stundenrhythmus ersetzt eine eigene Strategie für Wiederholungsversuche.

  4. 4

    completed: Bitcoin hat bestätigt.

    Sobald die Kalender die Bitcoin-Attestierung liefern, ersetzt der ergänzte Nachweis die gespeicherte .ots-Datei, und der Status des Blocks wechselt auf completed. Er kehrt nie zu pending zurück.

Die .ots-Datei

Eine dritte Datei neben dem Block und seiner Signatur.

Der Nachweis wird in jedem Stand zusammen mit dem Block {n}.json und dessen Signatur {n}.json.sig ausgeliefert; sein Status steht im Manifest der Wahl. Diese Dateien existieren, solange die Wahl ein öffentliches Register hat, von der Eröffnung bis zur Archivierung. Bei einer annullierten Wahl werden sie entfernt.

/elections/{election}/chain/{n}.json.ots Öffentliche Route
Leitet auf die gespeicherte Datei weiter. Wird im ausstehenden wie im vervollständigten Stand ausgeliefert: Ein Nachweis im Status pending enthält bereits die Commitments der Kalender.
{election}/{election}_{n}.json.ots Gespeicherte Datei
Neben dem Block abgelegt und mit der Kennung der Wahl benannt: Eine von ihrer URL getrennte Kopie bleibt zuordenbar.
ots_url · ots_status Manifest
Für jeden Block nennt das Manifest (/elections/{election}/chain) die direkte URL des Nachweises und seinen Status, pending oder completed. Die Registerseite zeigt denselben Stand bei jedem .ots-Download an: „wartet auf Bitcoin-Verankerung“ oder „in Bitcoin verankert“.
pending → completed Einmal ersetzt
Die .ots-Datei ist nicht fixiert: Der ergänzte Nachweis ersetzt den ausstehenden, damit Downloads und Spiegel immer den vollständigsten erhalten. Der Block selbst ändert sich nie. In der Datenbank ist der Status die einzige Spalte, die die append-only geführte Blocktabelle ändern lässt, und das nur in diese Richtung.
{n}.json.ots Zugriff
Die .ots-Nachweise bleiben wie das Manifest und die JSON-Blöcke für alle Wahlen herunterladbar, unabhängig vom Angebot. Nur der Download der .sig-Signaturen ist Offiziellen Wahlen vorbehalten, und das nur in der Oberfläche.
Prüfung

ots verify, gegen die heruntergeladene Datei.

Die Plattform meldet den Stand des Nachweises, prüft selbst aber nichts gegen die Bitcoin-Blockchain: Das ist Aufgabe des Prüfers, mit den üblichen OpenTimestamps-Werkzeugen. Im vollständigen Prüfverfahren ist dieser Schritt optional.

  1. 1

    Block und Nachweis abrufen.

    Die Datei {n}.json und ihren Nachweis {n}.json.ots, aus dem öffentlichen Register der Wahl oder über die URLs im Manifest. Der im Manifest angegebene Status ist eine Aussage der Plattform; maßgeblich ist allein die Prüfung.

  2. 2

    Nachweis gegen die Datei prüfen.

    ots verify -f {n}.json {n}.json.ots. Da das Commitment der einfache SHA-256 der Datei ist, spielen keine Daten der Plattform hinein: Eine um ein einziges Byte veränderte Datei passt nicht mehr zum Nachweis.

  3. 3

    Ausstehenden Nachweis erneut abrufen.

    Ein Nachweis im Status pending verweist noch auf keinen Bitcoin-Block. Da die gespeicherte Datei durch den vervollständigten Nachweis ersetzt wird, genügt es, sie erneut herunterzuladen, sobald der Status auf completed steht, meist einige Stunden nach der Veröffentlichung des Blocks.

Was das beweist: Ein vervollständigter Nachweis, dessen Prüfung gelingt, belegt, dass der Block Byte für Byte spätestens zum attestierten Bitcoin-Block existierte, unabhängig von den Schlüsseln der Plattform.

Das vollständige Prüfverfahren
Zeitstempel · Shell
# der Status jedes Nachweises (ots_status), im Manifest
curl -s https://condorcet.vote/elections/{election}/chain

# Block n und sein Nachweis (die Routen leiten auf die gespeicherten Dateien weiter)
curl -sL -o {n}.json https://condorcet.vote/elections/{election}/chain/{n}.json
curl -sL -o {n}.json.ots https://condorcet.vote/elections/{election}/chain/{n}.json.ots

# das Commitment: der einfache SHA-256 der Datei
openssl dgst -sha256 {n}.json

# der Nachweis gegen die Datei
ots verify -f {n}.json {n}.json.ots
ElephStamp, unsere OpenTimestamps-Bibliothek Condorcet.Vote hat mit ElephStamp eine eigene OpenTimestamps-Bibliothek entwickelt: die vollständigste und modernste, die es gibt, Open Source (MIT-Lizenz), nutzbar als PHP-Bibliothek oder über die Kommandozeile. Ihre .ots-Nachweise sind Byte für Byte zu 100 % kompatibel mit dem offiziellen Python-Client: Unsere Nachweise lassen sich mit beiden prüfen. ElephStamp auf GitHub
Grenzen

Was die Verankerung nicht beweist.

Die Verankerung beweist, wann bestimmte Bytes existierten. Sie ergänzt die übrigen Prüfungen, ersetzt sie aber nicht.

  • Ein spätester Zeitpunkt, kein genaues Datum. Ein vervollständigter Nachweis belegt, dass der Block spätestens zum attestierten Bitcoin-Block existierte. Ein Nachweis, der noch pending ist, belegt dagegen überhaupt kein Datum in Bitcoin.
  • Nicht die Richtigkeit des Inhalts. Die Verankerung betrifft Bytes, gleich welche. Ob Stimmzettel, Teilnahmegrenzen und Ergebnis stimmen, wird mit dem Prüfverfahren kontrolliert.
  • Nicht die Authentizität. Der Nachweis ist unabhängig von den Schlüsseln der Plattform und sagt daher nichts darüber, wer den Block erstellt hat. Das ist Aufgabe der OpenPGP-Signatur, die mit den veröffentlichten Prüfschlüsseln geprüft wird.
  • Nicht die Eindeutigkeit der Geschichte. Eine umgeschriebene Geschichte kann keine rückdatierten Attestierungen erhalten. Die Verankerung allein beweist aber nicht, dass eine bestimmte Geschichte die einzige veröffentlichte ist: Gegen das Umschreiben schützen weiterhin die unabhängigen Kopien.
  • Kein qualifizierter Zeitstempel. Ein Zeitstempel nach RFC 3161 von einem Zeitstempeldienst, mit Beweiskraft nach eIDAS, bleibt eine mögliche Ergänzung; derzeit wird er nicht angeboten.

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.