Bitcoin-Zeitstempel für jeden Git-Commit automatisieren
Manuelles Zeitstempeln hat denselben Fehlermodus wie manuelle Backups: Es funktioniert perfekt – bis zu der Woche, in der Sie beschäftigt sind. Und die Woche, in der Sie beschäftigt sind, ist genau die Woche, in der Sie das Feature ausliefern, von dem Sie später beweisen müssen, dass Sie es ausgeliefert haben.
In diesem Artikel geht es darum, den Menschen aus dieser Schleife herauszunehmen. Nicht „denken Sie daran, vor dem Merge zu stempeln“, kein Checklistenpunkt in Ihrem Release-Runbook – sondern eine einmalige Installation, die jeden Commit in einem überwachten Repository automatisch, jede Nacht, in einen Merkle-gebündelten, Bitcoin-verankerten Nachweis verwandelt, egal ob jemand im Team gerade an IP-Schutz denkt oder nicht.
Wenn Sie noch entscheiden, ob kryptografischer Stand-der-Technik-Nachweis für Ihre Situation relevant ist, lesen Sie Prove Prior Art Before You File: A Founder’s Guide. Dieser Artikel setzt voraus, dass Sie sich entschieden haben und es nun im Autopilot-Betrieb laufen lassen möchten.
Die Falle des manuellen Zeitstempelns (und warum Automatisierung gewinnt)
Das von Hand zu erledigen, sieht täuschend einfach aus. In der Praxis bedeutet ein manueller Workflow, dass jemand im Team Folgendes tun muss:
- Daran denken, nach jedem aussagekräftigen Commit einen Zeitstempel zu setzen – bevor der Branch umgeschrieben, gesquasht oder force-gepusht wird.
- Schlüsselmaterial und Nachweisdateien lokal an einem Ort verwalten, der Laptop-Ausfälle und Personalwechsel übersteht.
- Die resultierenden Belege irgendwo dauerhaft, versioniert und zwei Jahre später bei der Due Diligence auffindbar speichern.
- Dies für jeden Commit, in jedem Repository, für immer wiederholen.
Am letzten Punkt sterben manuelle Prozesse. Die Abdeckung ist inkonsistent, und inkonsistente Abdeckung ist schlimmer, als es klingt: In einem Streitfall lädt eine Lücke in Ihrer Beweiskette zu dem Argument ein, dass dieser Commit – der, auf den es ankommt – die Ausnahme war. Ein vergessener Push an einem Freitagnachmittag kann aus einer sauberen Zeitlinie ein Fragezeichen machen.
Das zugrunde liegende OpenTimestamps-Protokoll ist wirklich gut durchdacht, und Sie können es selbst mit rohen Kommandozeilen-Tools und manueller Bitcoin-Verankerung betreiben – auf die harte Tour, auf Ihre eigenen Kosten und Ihre eigene Zeit. Für ein Team, das täglich ausliefert und keine dedizierte Krypto-Person hat, ist das ein Wartungsprojekt, das sich als Sicherheitskontrolle verkleidet.
Automatisierung gewinnt, weil sie eine wiederkehrende Entscheidung in eine einmalige Konfiguration verwandelt. Installieren Sie einmal eine GitHub App, und von diesem Moment an wird jeder Commit in das überwachte Repository erfasst, in die Warteschlange gestellt, gebündelt, verankert und ohne dass ein Entwickler irgendetwas anfassen muss, in Ihr Repo zurückgeschrieben.
Einmalige Einrichtung: GitHub App installieren und vergessen
Die Einrichtung ist der kürzeste Teil dieses Artikels – und das ist der Punkt.
- Installieren Sie die Timestamp GIT GitHub App. Wählen Sie ein einzelnes Repository oder gewähren Sie sie Ihrer gesamten Organisation – jedes überwachte Repo erhält seine eigenen unabhängigen Nachweise.
- Wählen Sie Quelle und Ziel. Die App liest Commit-Hashes aus Ihrem Quell-Repository und schreibt Nachweise in ein Ziel-Repository, entweder einen dedizierten
timestamps-Branch im selben Repo oder ein separates Shadow-Repo. - Bestätigen Sie die Berechtigungen. Der Standardmodus benötigt Lesezugriff auf das Quell-Repo, da GitHubs Berechtigungsmodell keinen Scope „nur Commit-Hashes“ kennt. Schreibzugriff wird auf dem Ziel-Repo benötigt, damit Nachweise zurückcommittet werden können. Das ist die gesamte Berechtigungsoberfläche.
Auf den Rechnern der Entwickler wird nichts installiert. Keine CLI-Tools, keine Pre-Commit-Hooks, keine Schlüsseldateien zum Verteilen, kein Onboarding-Schritt für neue Mitarbeitende. Entwickler führen git commit und git push genau wie zuvor aus.
Für Organisationen, die nicht möchten, dass der gehostete Dienst überhaupt Lesezugriff auf den Quellcode hat, gibt es den Enterprise-ZK-Modus: Eine kurze GitHub Action (12 Zeilen) läuft in Ihrer eigenen Infrastruktur und sendet nur den Commit-Hash an die API, sodass der Quellcode Ihre Umgebung nie verlässt. In diesem Modus benötigt die App keinen Lesezugriff auf das Quell-Repo – Sie installieren einfach die Action. Die meisten Teams beginnen mit dem standardmäßigen Managed-Modus und betrachten den ZK-Modus als Option für ihre sensibelsten Repositories. Die vollständige Berechtigungsanleitung finden Sie unter Set Up IP Protection With a Single GitHub App Install.
In der automatisierten Pipeline: Vom Commit zum Bitcoin-Anker
Nach der Installation läuft die Pipeline nach ihrem eigenen Zeitplan. Folgendes passiert zwischen Ihrem git push und einem verifizierbaren Nachweis:
- Commit-Erkennung. Die GitHub App erfasst neue Commits über Webhooks. Im Enterprise-ZK-Modus pusht Ihre GitHub Action stattdessen Commit-Hashes an die API.
- Hash-Warteschlange. Commit-Hashes landen in einem In-Memory-Key-Value-Store und warten auf den nächtlichen Batch. Beachten Sie, was hier ankommt: Hashes, kein Code.
- Mitternachts-Cron-Worker. Ein Worker wacht auf, gruppiert alle ausstehenden Hashes und schreibt eine Manifest-
.txt-Datei pro Repository. - Merkle-Tree-Aufbau. Der Worker baut nativ einen Merkle-Tree über den Batch des Tages und generiert dann OpenTimestamps-Nachweise gegen öffentliche OTS-Kalender.
- Bitcoin-Verankerung. Die Merkle-Wurzel wird in einen Bitcoin-Block verankert. Die Bestätigung dauert typischerweise etwa drei Stunden, sodass die Nachweiszustellung einige Stunden nach dem Batch-Lauf erfolgt.
- Nachweiszustellung. Das Manifest und die
.ots-Belegdateien werden automatisch in Ihr Ziel-Repository zurückcommittet.
Zwei Eigenschaften dieses Designs sind wichtiger als die Mechanik:
- Zero-Knowledge durch Konstruktion. Der Dienst sieht, kopiert oder speichert Ihren Quellcode nie. Er verarbeitet Commit-Hashes und eine Merkle-Wurzel. Ihr Repository-Zustand gelangt nie in die Pipeline.
- Anbieterunabhängigkeit. Die Nachweise beruhen allein auf SHA-256 und Bitcoin-Blockdaten. Wenn Timestamp GIT morgen verschwinden würde, blieben die Belege in Ihrem Repo mit Standard-OpenTimestamps-Tools gegen die Bitcoin-Blockchain überprüfbar. Für die tägliche Arbeit nutzen Sie stattdessen die Verifizierungsseite oder die API – siehe How to Verify a Bitcoin Timestamp Proof for Your Code.
Überwachung und Fehlerbehandlung: Sicherstellen, dass jeder Commit verankert wird
Automatisierung, die Sie nicht überwachen, ist nur ein hoffnungsvoller Cron-Job. Timestamp GIT bietet genügend Oberfläche, um die Abdeckung beobachtbar zu machen.
Status-Dashboard. Jedes überwachte Repo hat eine öffentliche Statusseite unter https://timestampgit.dev/status/{user}/{repo}, die die Lebensdauer der Nachweise, das früheste Ankerdatum, die tägliche Regelmäßigkeit, die Bitcoin-Block- und Transaktionsdaten, eine Kalender-Heatmap der verankerten Tage und herunterladbare Audit-Exporte anzeigt.
Einbettbare Badges. Shields.io-Badges können direkt in Ihre README eingefügt werden, mit Markdown-Snippets, die direkt nach dem Verbinden des Repositorys generiert werden. Jeder kann durchklicken, um den Zeitstempel öffentlich zu verifizieren.
API für benutzerdefinierte Alarmierung. Abfragen Sie den Status und gleichen Sie Zählungen aus Ihren eigenen Tools ab:
# Latest anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api | jq
# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api | jq
# Combined summary (what the badge uses)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api | jq
Ein minimaler nächtlicher Check, der eine Lücke meldet, bevor sie zum Beweisproblem wird:
import datetime, requests
REPO = "https://timestampgit.dev/api"
USER, SLUG = "acme", "payments-api"
summary = requests.get(f"{REPO}/statusSummary/{USER}/{SLUG}", timeout=30).json()
last = requests.get(f"{REPO}/statusLast/{USER}/{SLUG}", timeout=30).json()
# Alert if nothing has been anchored in the last 48 hours
print("summary:", summary)
print("last anchor:", last)
Richten Sie das auf Ihren Alarmierungskanal, und Sie haben den Kreis geschlossen – ein verpasster Tag wird zu einer Benachrichtigung statt zu einer Entdeckung während der Due Diligence.
Fehlerszenarien. Webhooks gehen verloren, Kalender fallen gelegentlich aus, und Netzwerke haben Aussetzer. Weil Hashes in einer Warteschlange liegen, statt inline gestempelt zu werden, rollt ein nicht verankerter Hash einfach in den nächsten nächtlichen Batch. Nichts geht verloren; es wird aufgeschoben. Das sichtbare Symptom ist ein fehlender Tag auf der Heatmap oder ein stagnierender statusLast-Wert – genau das, was die obigen Checks abfangen.
Compliance-Exporte. Für Audits ziehen Sie das vollständige Ledger als CSV oder ein Tageszertifikat als PDF:
curl -sO https://timestampgit.dev/api/audit/acme/payments-api
curl -sO https://timestampgit.dev/api/report/acme/payments-api/2026-11-22
Private Repositories hängen einen verschlüsselten HMAC an ihre Status-URLs an, sodass nur autorisierte Benutzer ihren Status lesen können – der HMAC ist spezifisch für die Serverinstanz.
Best Practices für automatisiertes Zeitstempeln
- Beobachten Sie den timestamps-Branch, nicht nur das Dashboard. Neue Manifeste und
.ots-Dateien, die auftauchen, sind Ihre Ground Truth dafür, dass die Zustellung von Ende zu Ende funktioniert hat. - Verwenden Sie nach Möglichkeit ein dediziertes Ziel-Repository für Nachweise. Das hält Ihre Quell-Historie sauber und macht es einfach, die Beweise an die Rechtsabteilung zu übergeben, ohne Ihre Codebasis zu exportieren.
- Verifizieren Sie regelmäßig, nicht nur einmal. Planen Sie einen vierteljährlichen Check gegen die öffentliche Verifizierungsseite oder
/api/verify/{user}/{repo}/{date}. Die gesamte Verifizierungsberechnung erfolgt lokal im Browser – niemand sieht, was Sie verifizieren. - Verankern Sie die Abdeckung in Ihrem Prozess, nicht in Ihrem Gedächtnis. Wenn ein Repo geschäftskritisch ist, installieren Sie die App organisationsweit statt Repo für Repo; der Fehlermodus selektiver Installation ist ein Repository, an dessen Onboarding sich niemand erinnert.
- Passen Sie das Deployment an Ihr Bedrohungsmodell an. Für air-gapped oder Umgebungen mit maximaler Sicherheit läuft Timestamp GIT als selbst gehostetes Docker-Image. 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
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
Die Instanz ist unter http://localhost:8080 verfügbar, und ein Erststart-Assistent führt Sie durch das Verbinden Ihrer GitHub App. Eine zeitlich begrenzte Demo-Lizenz ist über das Anfrageformular auf der Docker-License-Seite erhältlich (Name, Firma, E-Mail, optional Telefon).
FAQ
Muss ich Software auf den Rechnern meiner Entwickler installieren? Nein. Timestamp GIT funktioniert vollständig über eine GitHub App oder eine GitHub Action. Entwickler committen wie gewohnt; die Automatisierung erledigt den Rest.
Was passiert, wenn ein Commit nach dem nächtlichen Stichtag erfolgt? Er wird in den Batch der nächsten Nacht aufgenommen. Das System stellt alle ausstehenden Hashes in die Warteschlange und verankert sie gemeinsam.
Kann ich das Zeitstempeln für mehrere Repositories automatisieren? Ja. Sie können die GitHub App auf mehreren Repositories oder einer gesamten Organisation installieren, und jedes Repo erhält seine eigenen Nachweise.
Wie überprüfe ich, ob ein Commit mit einem Zeitstempel versehen wurde? Sie können die öffentliche Verifizierungsseite oder die API nutzen, um den Merkle-Nachweis gegen die Bitcoin-Blockchain zu prüfen. Auch Badges zeigen den Status an.
Was passiert, wenn ich an einem Tag mehrere Commits pushe? Alle werden im Batch des Tages gesammelt, in einen einzigen Merkle-Tree gefaltet und gemeinsam unter einer Bitcoin-Transaktion verankert. Sie erhalten weiterhin Manifeste pro Repo, sodass einzelne Commit-Hashes innerhalb des Batches nachvollziehbar bleiben.
Kann ich Commits aus privaten Repositories mit einem Zeitstempel versehen? Ja – private Repositories werden im Pro-Agency-Plan (49 $/Monat) und bei Enterprise ZK (199 $/Monat, GitHub Actions) unterstützt. Öffentliche Repositories sind im Open-Source-Tarif kostenlos.
Wie lange dauert es, bis ein Commit verankert ist? Typischerweise einige Stunden nach dem nächtlichen Batch-Lauf. Die Bitcoin-Bestätigung selbst dauert normalerweise etwa drei Stunden, sodass Nachweise einige Stunden nach Mitternacht in Ihrem Repository eintreffen.
Ist der Nachweis ohne Timestamp GIT verifizierbar? Ja. Nachweise beruhen nur auf SHA-256 und Bitcoin-Blockdaten und können daher unabhängig gegen die Blockchain geprüft werden – keine proprietäre Technologie und kein Lock-in.
Fazit
Der Wert eines Stand-der-Technik-Nachweises kommt aus der Abdeckung, und die Abdeckung kommt aus der Automatisierung. Ein Zeitstempel-Prozess, der davon abhängt, dass sich jemand daran erinnert, etwas auszuführen, wird Löcher haben – und Löcher sind genau das, wonach die Gegenseite sucht.
Timestamp GIT übernimmt das OpenTimestamps-Protokoll für Sie: Installieren Sie die GitHub App einmal, lassen Sie den nächtlichen Cron jeden Commit in Bitcoin verankern, beobachten Sie die Badges und Status-Endpunkte und bewahren Sie die .ots-Belege in einem Repo auf, das Sie kontrollieren. Die Einrichtung dauert Minuten; danach besteht die einzige laufende Aufgabe darin, einen Blick auf einen Alarm zu werfen, der nie auslösen sollte.
Beginnen Sie mit dem kostenlosen Open-Source-Tarif in einem öffentlichen Repository oder verbinden Sie ein privates im Pro-Agency-Tarif und lassen Sie den ersten Batch heute Nacht laufen. Für einen breiteren Blick darauf, was das im Vergleich zum Eigenbau kostet, lesen Sie Code Timestamping Costs Compared: Managed vs DIY.
Verwandte Beiträge
- Code Timestamping Costs Compared: Managed vs DIY
- Set Up IP Protection With a Single GitHub App Install
- How to Verify a Bitcoin Timestamp Proof for Your Code