So verifizieren Sie einen Bitcoin-Zeitstempel-Nachweis für Ihren Code
Ein Zeitstempel-Nachweis, den Sie nicht selbst prüfen können, ist nur ein Anbieterversprechen mit besserem Branding. Früher oder später wird jemand – ein Anwalt in einem Patentstreit, ein Auditor während der Due Diligence oder ein CTO, der vermutet, dass Ihre „unabhängige Implementierung" nicht unabhängig war – von Ihnen verlangen, zu zeigen, dass ein bestimmter Commit-Hash an einem bestimmten Datum existierte. Dieser Moment ist der Verifikationsschritt, und es ist derjenige, den die meisten Teams nie proben.
Die gute Nachricht: Mit Timestamp GIT ist die Verifikation kein Forschungsprojekt. Die GitHub App verankert Ihre Commit-Hashes nächtlich, und die Prüfung eines Nachweises erfordert einen Klick, eine URL oder ein curl. Dieser Artikel führt durch die genauen Verifikationswege, was die Ergebnisse bedeuten und wo die Sonderfälle lauern.
Warum Verifikation zählt: Vom Vertrauen zum Beweis
Es gibt einen Unterschied zwischen einer Behauptung und einem Beweis:
- Eine Behauptung lautet „wir haben das im März geschrieben". Sie lebt in einer Datenbank, die Sie kontrollieren und bearbeiten können.
- Ein Beweis lautet „dieser spezifische Commit-Hash war in einem Merkle-Baum enthalten, dessen Wurzel in Bitcoin-Block N eingebettet ist". Jeder kann ihn nachrechnen.
Für Compliance, Audits und Rechtsstreitigkeiten hat ein Beweis eine zusätzliche Anforderung: Er muss wiederholbar und unabhängig vom Anbieter sein. Wenn Ihr Nachweis nur verifiziert, solange die Server eines bestimmten Unternehmens laufen, ist er kein echter Beweis – er ist ein Abonnement.
Das Design von Timestamp GIT berücksichtigt dies. Der .ots-Beleg plus öffentliche Bitcoin-Blockdaten sind der gesamte Nachweis. Es gibt keine proprietäre Komponente im Verifikationspfad und nichts, was auf den Rechnern Ihrer Entwickler installiert werden muss. Dieser Artikel konzentriert sich auf den Verifikationsschritt; wenn Sie noch entscheiden, ob Sie überhaupt Zeitstempel setzen sollten, finden Sie die strategische Begründung in unserem Gründerleitfaden zu Prior Art.
Was ein Bitcoin-Zeitstempel-Nachweis tatsächlich enthält
Ein Nachweis für einen einzelnen Tag besteht aus zwei Artefakten, die in einem dedizierten timestamps-Branch oder einem Shadow-Repository gespeichert werden, damit sie zusammen mit Ihrem Code versioniert werden:
- Eine Manifestdatei (
.txt), die die für dieses Repository an diesem Tag gesammelten Commit-Hashes auflistet. - Eine
.ots-Belegdatei mit dem Merkle-Pfad, der Ihren Hash bis zur in Bitcoin verankerten Merkle-Wurzel verknüpft.
Die Kette sieht so aus:
commit hash ─┐
commit hash ─┼─ Merkle tree ─ Merkle root ─ Bitcoin transaction ─ block
commit hash ─┘ │
.ots receipt (Merkle path from your hash to the root)
Zwei Eigenschaften sind bei der Verifikation wichtig:
- Das Manifest beweist, welche Hashes enthalten waren.
- Der
.ots-Beleg beweist, wann die Merkle-Wurzel in die Chain gelangte.
Da die Verankerung ausschließlich das OpenTimestamps-Protokoll und nichts Proprietäres verwendet, überlebt der Nachweis uns: Es ist SHA-256 plus Bitcoin-Blockdaten, offline verifizierbar, für immer.
Schritt für Schritt: Einen Zeitstempel-Nachweis mit Timestamp GIT verifizieren
1. Beginnen Sie mit dem Badge in Ihrer README
Jedes überwachte Repository kann ein Shields.io-Verifikations-Badge anzeigen. Es ist ein Live-Zeiger, kein statisches Bild: Es verlinkt auf die öffentliche Statusseite für dieses Repository. Sie erzeugen den Embed-Snippet auf der repository-verbundenen Seite (https://timestampgit.dev/connected/{user}/{repo}), die eine Live-Vorschau anzeigt, bevor Sie ihn einfügen.
<!-- Paste the snippet generated at /connected/{user}/{repo} -->
[](https://timestampgit.dev/status/OWNER/REPO)
Wenn ein Prüfer auf das Badge klickt, landet er bei den Beweisen – nicht auf einer Marketingseite.
2. Lesen Sie die Repository-Statusseite
Öffnen Sie:
https://timestampgit.dev/status/{user}/{repo}
Dieses öffentliche Dashboard liefert Ihnen die auditfreundliche Zusammenfassung:
- Proof longevity – wie weit Ihre Verankerungshistorie zurückreicht.
- Earliest anchor date – der erste Tag, an dem Ihre Hashes Bitcoin erreichten.
- Daily regularity – der Nachweis, dass der nächtliche Job tatsächlich Tag für Tag lief.
- Bitcoin-Block- und Transaktionsdaten für die Anker.
- Eine Kalender-Heatmap, damit Lücken visuell offensichtlich sind.
- Downloads: die Audit-CSV und ein PDF-Zertifikat.
Für einen Auditor reichen die Heatmap plus die CSV in der Regel für einen ersten Durchgang. Fehlende Kästchen sind das, was untersucht werden muss.
3. Verifizieren Sie einen bestimmten Tag lokal
Für einen Nachweis auf Tagesebene öffnen Sie:
https://timestampgit.dev/verification/{user}/{repo}/{date}
Diese Seite durchläuft die Merkle-Kette Schritt für Schritt und führt die Berechnung lokal in Ihrem Browser durch. Nichts von dem, was Sie verifizieren, wird übertragen – die Zero-Knowledge-Eigenschaft gilt auch für die Verifikation, nicht nur für die Erfassung.
Das ist wichtiger, als es klingt. Ein Compliance-Prüfer kann einen Nachweis für sensible interne Repositories prüfen, ohne dem Anbieter zusätzliche Informationen auszuhändigen.
4. Rufen Sie die Merkle-Kette über die API ab
Wenn Sie lieber programmatisch verifizieren (oder die Beweise in Ihrem eigenen Compliance-System speichern) möchten, liefert die API die vollständigen Merkle-Kettendaten für einen bestimmten Tag:
curl -s "https://timestampgit.dev/api/verify/OWNER/REPO/2026-11-18" | jq
Sie können auch den zuletzt verankerten Block und die laufende Commit-Anzahl abrufen:
curl -s "https://timestampgit.dev/api/statusLast/OWNER/REPO" | jq
curl -s "https://timestampgit.dev/api/statusCount/OWNER/REPO" | jq
Keine CLI-Tools, keine Protokollbefehle, keine Wallet-Software. Die Schwerarbeit – Commit-Erkennung über den GitHub-App-Webhook, Batching, Merkle-Baum-Konstruktion und Bitcoin-Verankerung – ist bereits über Nacht erledigt worden.
Die Ergebnisse lesen – und die Sonderfälle
Ein gültiger Nachweis bedeutet etwas Enges und Starkes: Dieser Commit-Hash existierte zum oder vor dem Zeitstempel dieses Bitcoin-Blocks. Er sagt Ihnen nicht, dass der Code gut ist, dass Sie jede Zeile geschrieben haben oder wer sie getippt hat. Autorschaft jenseits des Hashes ist eine separate Frage – unsere Analyse, ob Git-Commit-Zeitstempel als Beweis standhalten, behandelt diese Unterscheidung.
Weitere Dinge, die Sie beachten sollten:
- Varianz der Block-Zeitstempel. Bitcoin-Block-Zeitstempel können leicht von der Wanduhrzeit abweichen. Der Nachweis bleibt dennoch kryptografisch stark, weil der Block selbst unveränderlich ist – niemand kann die Historie neu minen, um Ihren Anker zu verschieben.
- Fehlender Nachweis für ein Datum. Nachweise werden einige Stunden nach Mitternacht geschrieben: Der Cron-Worker bündelt Hashes, baut den Merkle-Baum, übermittelt ihn an öffentliche OTS-Kalender und wartet dann auf die Bitcoin-Bestätigung – normalerweise etwa drei Stunden. Ein Nachweis für einen Tag ist möglicherweise einfach noch nicht geschrieben. Wenn er älter ist, prüfen Sie, ob das Repository in diesem Zeitfenster tatsächlich überwacht wurde.
- Private Repositories. Status-URLs für private Repos tragen einen verschlüsselten HMAC, und nur Inhaber dieser URL können den Status sehen. Die Verifikation selbst erfolgt weiterhin lokal im Browser.
- Selbst gehostete Instanzen. Jede Instanz generiert ihren eigenen HMAC. Wenn Sie ein Badge von einer SaaS-Instanz zu Ihrer eigenen Docker-Bereitstellung migrieren, generieren Sie den Badge-Link neu – ein HMAC einer Instanz wird auf einer anderen nicht validiert.
Verifizieren ohne SaaS: Docker-Self-Hosting und Offline-Prüfungen
Für air-gapped oder besonders paranoid ausgestattete Umgebungen wird Timestamp GIT als Docker-Image ausgeliefert. Ein Quick-Start-Docker-Compose-Setup sieht so aus:
services:
timestampgit:
image: rue1401/timestampgit:prod
ports:
- "8080:8080"
volumes:
- ./data:/app/data
restart: unless-stopped
valkey:
image: valkey/valkey:8
restart: unless-stopped
Dann:
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
Die App ist unter http://localhost:8080 verfügbar, und ein Einrichtungsassistent beim ersten Start führt Sie durch die Verbindung Ihrer GitHub App und die Konfiguration der Instanz. Eine zeitlich begrenzte Demo-Lizenz ist auf der Docker-Lizenzseite erhältlich, wenn Sie vor der Festlegung evaluieren möchten.
Self-Hosting ändert nichts an der Verifikationsmathematik. Die .ots-Dateien und Bitcoin-Blockdaten sind dieselben Artefakte, und sie verifizieren offline. Sie können vollständig manuell vorgehen und die .ots-Datei mit Standard-OpenTimestamps-Verifikationstools gegen einen lokalen Bitcoin-Node prüfen – das ist der harte Weg, und er funktioniert gerade deshalb, weil der Nachweis anbieterunabhängig ist. Der Viewer und die API des Produkts machen daraus lediglich eine Ein-Klick-Angelegenheit statt eines Wochenendprojekts.
Verifikation für Compliance automatisieren
Wenn Verifikation ein Häkchen in einer Quartalsprüfung ist, automatisieren Sie sie:
- Exportieren Sie das Ledger.
GET /api/audit/{user}/{repo}liefert das vollständige Audit-Ledger als CSV – das Artefakt, das Ihr Auditor tatsächlich im Aktenschrank haben will. - Generieren Sie Zertifikate pro Tag.
GET /api/report/{user}/{repo}/{date}erzeugt ein PDF-Zertifikat für ein bestimmtes Datum, nützlich, wenn ein einzelner Nachweis einem Vertrag oder einer Streitbeilegung beigefügt werden muss. - Pollen Sie auf Aktualität. Ein kurzer Cron-Job auf Ihrer Seite fängt den Fehlermodus ab, der zählt: dass die Verankerung stillschweigend aufhört.
#!/usr/bin/env bash
set -euo pipefail
REPOS=("acme/api" "acme/web" "acme/infra")
for repo in "${REPOS[@]}"; do
printf '%-14s ' "$repo"
curl -s "https://timestampgit.dev/api/statusLast/${repo}" | jq -c '.'
done
Führen Sie ihn täglich aus; wenn der zuletzt verankerte Block aufhört, sich weiterzubewegen, wissen Sie es vor einem Auditor.
- Zeigen Sie den Status öffentlich an. Betten Sie das Shields.io-Badge ein, damit nachgelagerte Nutzer und Kunden den Verifikationsstatus sehen können, ohne Sie um etwas bitten zu müssen.
Für Teams, die maximale Trennung wünschen, liefern Enterprise-ZK-Pläne eine kurze GitHub Action, die in Ihrer eigenen CI läuft und nichts außer Commit-Hashes überträgt – das Verankerungs- und Verifikationsmodell bleibt gleich, und die Verifikation erfolgt weiterhin lokal.
FAQ
Muss ich OpenTimestamps-Befehle ausführen, um einen Nachweis zu verifizieren?
Nein. Timestamp GIT bietet eine webbasierte Verifikationsseite und eine REST-API, die die gesamte Prüfung übernehmen. Sie können die .ots-Datei auch herunterladen und Standard-Verifikationstools verwenden, wenn Sie das bevorzugen, aber es ist nicht erforderlich.
Wie lange dauert es, bis ein Nachweis verifizierbar wird?
Nachweise werden nächtlich verankert und nach einigen Stunden in der Bitcoin-Blockchain bestätigt – typischerweise etwa drei Stunden. Ein heute gemachter Commit hat bis zum nächsten Tag einen verifizierbaren Nachweis.
Kann ich einen Nachweis für ein privates Repository verifizieren?
Ja, aber Statusseiten privater Repositories erfordern einen verschlüsselten HMAC, der an die URL angehängt wird. Autorisierte Nutzer können darauf zugreifen, und die Verifikation selbst erfolgt weiterhin lokal in Ihrem Browser.
Was ist, wenn Timestamp GIT verschwindet? Kann ich trotzdem verifizieren?
Ja. Der Nachweis ist anbieterunabhängig: Er stützt sich nur auf SHA-256 und Bitcoin-Blockdaten. Sie können die .ots-Datei auch dann offline mit Standard-OpenTimestamps-Tools verifizieren, wenn unser Dienst nicht mehr existiert.
Fazit
Die Verifikation ist der Punkt, an dem Zeitstempel aufhören, eine nette Idee zu sein, und zu belastbaren Beweisen werden. Der Workflow ist kurz: Klicken Sie auf das Badge, lesen Sie die Statusseite, öffnen Sie die Verifikationsansicht auf Tagesebene oder rufen Sie /api/verify/{user}/{repo}/{date} auf und prüfen Sie die Merkle-Kette selbst. Jeder Weg endet am selben Punkt – ein Commit-Hash, der vor einem bestimmten Bitcoin-Block existierte, für immer beweisbar, ohne irgendjemandes Datenbank vertrauen zu müssen.
Wenn Sie noch nicht begonnen haben, ist das Setup der langweilige Teil: Installieren Sie die GitHub App auf einem Repository und lassen Sie den nächtlichen Job laufen. Morgen haben Sie Ihren ersten verifizierbaren Nachweis. Gehen Sie zu timestampgit.dev, um Ihr erstes Repo zu verbinden.
Verwandte Beiträge
- Prior Art beweisen, bevor Sie einreichen: Ein Gründerleitfaden
- Die besten Tools zum Zeitstempeln von Quellcode für Auditoren
- Halten Git-Commit-Zeitstempel als Beweis stand?