Bitcoin-Zeitstempel für jeden GitHub-Commit automatisieren
Sie haben entschieden, dass Ihre Commits einen kryptografischen Existenznachweis verdienen. Gut. Jetzt kommt der langweilige Teil: das Ganze morgen und übermorgen zu wiederholen, für jedes Repository, das Ihr Team anfasst.
Genau hier sterben die meisten Zeitstempel-Bemühungen leise. Nicht, weil die Idee falsch wäre, sondern weil die manuelle Plackerei – Commit-Hashes bündeln, sie an einen Kalenderdienst übermitteln, eine Proof-Datei hüten, sie zurückschreiben – den Kontakt mit einem echten Sprint nicht übersteht. Wenn Sie Blockchain-Zeitstempel für GitHub-Repositories automatisieren wollen, muss der Zeitstempel ein Nebeneffekt von git push sein, keine Aufgabe, an die sich jemand freitags erinnern muss.
Dieser Artikel führt Sie durch den automatisierten Weg von Anfang bis Ende: eine Installation, eine nächtliche Pipeline, die Sie nie anfassen, und Monitoring, das Ihnen sagt, ob die Proofs tatsächlich in Bitcoin gelandet sind.
Warum manuelles Zeitstempeln nicht skaliert
Der beschwerliche Weg, einen Commit zu zeitstempeln, besteht darin, es jedes Mal von Hand zu tun. Sie wären verantwortlich für:
- Die Entscheidung, welche Commits es wert sind, gestempelt zu werden (alle sind es, und genau das ist das Problem).
- Das Bündeln der Hashes selbst, damit Sie nicht eine Bitcoin-Transaktion pro Commit erzeugen.
- Die Übermittlung an einen öffentlichen Kalender und die Verfolgung des ausstehenden Proofs bis zur Bestätigung.
- Die Speicherung der resultierenden Proof-Datei an einem dauerhaften Ort, verknüpft mit dem richtigen Commit.
- Die Wiederholung des Ganzen morgen und nach jedem Force-Push, Hotfix und Merge-Train.
Selbst skriptgesteuert ist das ein Teilzeitjob. Jemand muss sich um das Skript, den Cron-Runner, den Speicherort und den Vorfall „warum fehlt der Proof von letzter Woche" kümmern. Und sobald diese Person das Team wechselt, verrottet die Pipeline.
Das rohe OpenTimestamps-Protokoll ist wirklich elegant – wie es funktioniert, lesen Sie in OpenTimestamps Alternative: Managed GitHub App for Every Commit. In diesem Artikel geht es um das andere Problem: es unbeaufsichtigt und für immer laufen zu lassen.
Das Ziel ist Einrichten und Vergessen: Jeder Commit in ein überwachtes Repository wird nächtlich verankert, ohne Eingreifen von Entwicklern und ohne dass irgendjemand etwas auf seinem Laptop installieren muss.
Einmalige Einrichtung: Die GitHub App installieren
Timestamp GIT ist ein Managed Service rund um eine GitHub App. Die Einrichtung dauert Minuten und erfolgt einmal pro Konto oder Organisation.
1. Die App installieren. Installieren Sie die GitHub App über das Timestamp GIT Dashboard in Ihrem persönlichen Konto oder Ihrer Organisation.
2. Repositories auswählen. Wählen Sie entweder alle Repositories oder eine bestimmte Teilmenge. Sie können die Auswahl später anpassen, ohne neu zu installieren.
3. Berechtigungen bestätigen. Das Berechtigungsmodell ist bewusst eng gefasst:
| Zugriff | Umfang | Warum |
|---|---|---|
| Nur Lesen | Quell-Repository | Das GitHub-Berechtigungssystem kennt keinen Scope „nur Commit-Hash", daher benötigt die App Lesezugriff, um die HEAD-Commit-Hashes zu sehen |
| Lesen und Schreiben | Ziel-Repository | Proofs werden als Manifest-Dateien und .ots-Belege auf einem dedizierten Branch oder in einem Shadow-Repository zurückgeschrieben |
4. Zurücklehnen. Es gibt keine YAML zum Hinzufügen, kein Secret zum Rotieren, keine CLI zum Installieren. Ihre Entwickler committen genau wie bisher; die App reagiert im Hintergrund auf Webhooks.
Wenn Ihre Repositories öffentlich sind, deckt der Open-Source-Tarif dies von Haus aus ab. Private Repositories beginnen beim Pro-Agency-Tarif – die Preisübersicht zeigt, welcher Tarif zu welcher Teamform passt.
Die strengere Alternative: Enterprise-ZK-Modus
Der Standardmodus erfordert Lesezugriff auf Ihr Quell-Repository. Wenn Ihre Richtlinien das verbieten – oder Sie einfach nicht wollen, dass ein Dritter Ihren Code lesen kann – dreht der Enterprise-ZK-Modus die Richtung um. Statt zu ziehen, schiebt Ihre Seite: Eine 12-zeilige GitHub Action läuft auf Ihrer eigenen Infrastruktur und sendet nur den Commit-Hash an die Timestamp GIT API. Ihr Quellcode verlässt nie Ihre Umgebung, und der Dienst benötigt überhaupt keinen Lesezugriff auf das Quell-Repository. Nur das Ziel-Repository (in das Proofs geschrieben werden) benötigt Schreibzugriff.
Die automatisierte Pipeline: Vom Commit zu Bitcoin
Folgendes passiert nach der Einrichtung, ohne dass Sie etwas tun.
1. Commit-Erkennung. Neue Commits kommen entweder über die Webhooks der GitHub App (Standardmodus) oder über Hashes an, die Ihre GitHub Action pusht (Enterprise-ZK-Modus).
2. Hash-Warteschlange. Commit-Hashes landen in einem In-Memory-Key-Value-Store und warten auf den nächtlichen Batch. Beachten Sie, was nicht in diesem Store liegt: Ihr Code. Nur Hashes.
3. Mitternachts-Cron-Worker. Einmal pro Nacht erledigt ein Worker Folgendes:
- Er gruppiert alle ausstehenden Hashes.
- Er erstellt ein Manifest pro Repository (
.txt). - Er baut einen Merkle-Baum nativ über den Batch.
- Er erzeugt OpenTimestamps-Proofs gegen öffentliche OTS-Kalender.
- Er verankert die Merkle-Wurzel in der Bitcoin-Blockchain.
4. Proof-Zustellung. Die Manifest- und .ots-Belegdateien werden in Ihr Repository zurückgepusht – entweder auf einem dedizierten timestamps-Branch neben Ihrem Code oder in ein separates Shadow-Repository.
Erwartetes Timing. Bitcoin bestätigt nicht sofort. Die Verankerungstransaktion wird typischerweise in etwa drei Stunden bestätigt, rechnen Sie also damit, dass Proofs einige Stunden nach Mitternacht UTC erscheinen. Wenn Sie um 00:05 UTC nachsehen und nichts sehen, ist nichts falsch.
Die API-Oberfläche für eigene Workflows
Die Pipeline läuft von selbst, aber die API ermöglicht es Ihnen, Proof-Daten in Ihre eigenen Tools einzubinden. Alle Endpunkte sind, wo angegeben, authentifiziert.
# Last anchored Bitcoin block for a repository (public)
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api
# Total stamped commits (public)
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api
# Combined summary, handy for Shields.io
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api
# Full Merkle chain data for a specific day, for local verification
curl -s https://timestampgit.dev/api/verify/acme/payments-api/2026-10-25
# Audit ledger as CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/acme/payments-api
# PDF certificate for one date
curl -s -o certificate.pdf https://timestampgit.dev/api/report/acme/payments-api/2026-10-25
Enterprise-ZK-Installationen nutzen außerdem den HMAC-authentifizierten Commit-Endpunkt, wobei {hash} der HMAC-Wert ist, den die signierte URL zurückgibt, die Ihre Action anfordert:
curl -X POST \
"https://timestampgit.dev/api/timestamp/acme/payments-api/timestamps/<hmac>/<commitId>"
Das ist die gesamte Integrationsfläche. Es gibt keinen „Batch starten"-Aufruf, den man planen müsste – das Bündeln ist Aufgabe des Dienstes.
Monitoring und Fehlerbehandlung
Automatisierung, die man nicht überwacht, ist nur Optimismus. Timestamp GIT bietet Ihnen drei unabhängige Möglichkeiten, zu bestätigen, dass die Pipeline gesund ist.
Das öffentliche Status-Dashboard
Jedes Repository erhält ein öffentliches Dashboard unter /status/{user}/{repo}, das Folgendes zeigt:
- Proof-Langlebigkeit und das früheste Ankerdatum – wie weit Ihr Beweiskette zurückreicht.
- Tägliche Regelmäßigkeit, dargestellt als Kalender-Heatmap, sodass eine verpasste Nacht visuell offensichtlich ist.
- Bitcoin-Block- und Transaktionsdaten für jeden Anker.
Verifizierungs-Badges
Binden Sie ein Shields.io-Badge in Ihre README ein, um den Proof öffentlich zu machen:

Die Seite /connected/{user}/{repo} bietet Ihnen ein Badge-Einbettungs-Widget mit Live-Vorschau, einschließlich des Markdown-Snippets. Bei privaten Repositories tragen die Status-URLs einen verschlüsselten HMAC, der für die jeweilige Serverinstanz spezifisch ist – der Status bleibt nur für Personen sichtbar, die den signierten Link haben.
Selbstgehosteter Health-Check
Da die Status-Endpunkte reines JSON liefern, fängt ein kleines Skript in Ihrer eigenen CI eine stockende Pipeline ab, bevor es ein Auditor tut:
import requests
BASE = "https://timestampgit.dev"
USER, REPO = "acme", "payments-api"
r = requests.get(f"{BASE}/api/statusLast/{USER}/{REPO}", timeout=15)
r.raise_for_status()
last = r.json() # last anchored Bitcoin block info for this repository
print(last)
# Compare against yesterday's stored value in your own job to detect a stalled batch.
Was, wenn ein nächtlicher Batch nicht abgeschlossen wird? Das beobachtbare Signal ist in jedem Fall dasselbe: Die Heatmap zeigt eine Lücke, und der zuletzt verankerte Block bleibt stehen. Da die Verankerung tageweise gebündelt wird, ist ein verpasster Lauf innerhalb von 24 Stunden sichtbar statt erst zur Audit-Zeit – und da die Hash-Warteschlange und die Manifeste nach Datum geschlüsselt sind, erzeugt ein erneuter Lauf einen eindeutigen, datierten Proof statt eines mehrdeutigen. Prüfen Sie zuerst das Dashboard und dann den timestamps-Branch des Repositories, um zu bestätigen, ob Manifest und Belege geschrieben wurden.
Der Audit-Trail
Für Compliance-Prüfungen erledigen zwei Artefakte die Hauptarbeit:
GET /api/audit/{user}/{repo}– das vollständige Ledger als CSV.GET /api/report/{user}/{repo}/{date}– ein PDF-Zertifikat für ein einzelnes Datum.
Und wenn jemand die Rechnung prüfen möchte, statt einem PDF zu vertrauen, führt die Seite /verification/{user}/{repo}/{date} die mehrstufige Merkle-Kette Schritt für Schritt durch. All diese Berechnungen finden lokal im Browser statt – nichts von dem, was Sie verifizieren, wird an den Server gesendet.
Best Practices für automatisiertes Zeitstempeln
Sobald die Pipeline läuft, halten ein paar Gewohnheiten die Beweise nützlich:
- Früh und oft committen. Jeder Commit ist ein Datenpunkt für Prior Art. Einen Monat Arbeit kurz vor einer Anmeldung in einen Commit zu squashen, gibt Ihnen einen Anker statt vierzig.
- Proofs auf einem eigenen Branch halten. Der automatisierte
timestamps-Branch wird maschinell geschrieben; ihn getrennt von Feature-Branches zu halten, bewahrtgit loglesbar und vermeidet Merge-Rauschen. - Regelmäßig verifizieren, nicht erst im Streitfall. Prüfen Sie jedes Quartal stichprobenartig ein aktuelles Datum über den Web-Verifier. Eine kaputte Verifikationskette während eines Rechtsstreits zu entdecken, ist ein schlechter Zeitpunkt dafür.
- Proofs mit Releases ausliefern. Hängen Sie Manifest und Belege für Ihr Release-Datum an Ihre Release-Artefakte an und verweisen Sie in Ihrer rechtlichen Dokumentation auf das Datum.
- Alles taggen, was Sie patentieren könnten. Commits werden automatisch erfasst; sobald Sie eine patentierbare Idee diskutieren, stellen Sie sicher, dass die Arbeit committet ist und nicht in einem lokalen Branch liegt.
Selbstgehostete Automatisierung mit Docker
Managed Hosting ist der Standard, aber manche Umgebungen können es nicht nutzen: air-gapped Netzwerke, strenge Anforderungen an den Datenstandort oder interne Richtlinien, die jeden externen Dienst verbieten, der Repository-Metadaten anfasst.
Für diese Fälle liefert Timestamp GIT ein Docker-Image. Die Automatisierung ist identisch – dasselbe nächtliche Bündeln, dieselbe Merkle-Baum-Konstruktion und dieselbe Bitcoin-Verankerung, nur in Ihrer Infrastruktur.
Ein Schnellstart-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 Anwendung ist unter http://localhost:8080 verfügbar, sobald sie läuft. Beim ersten Start führt Sie ein Einrichtungsassistent durch die Verbindung Ihrer GitHub App und die Konfiguration der Instanz.
Um vor der Festlegung zu testen, fordern Sie eine zeitlich begrenzte Demo-Lizenz über die Docker-Lizenzseite an – Name, Firma, E-Mail und optional eine Telefonnummer. Eine zeitlich begrenzte Demo-Lizenzdatei steht zum Download bereit, die Sie während der On-Premises-Einrichtungsphase hochladen.
FAQ
Muss ich Befehle ausführen oder Tools auf den Rechnern meiner Entwickler installieren? Nein. Timestamp GIT funktioniert vollständig über die GitHub App. Nach der Installation wird jeder Commit in ein überwachtes Repository nächtlich automatisch zeitgestempelt. Keine CLI-Tools, keine OpenTimestamps-Befehle, keine manuellen Schritte.
Wie lange dauert es, bis ein Commit zeitgestempelt ist? Commits werden einmal pro Nacht gebündelt und verankert. Die Bitcoin-Transaktion wird typischerweise innerhalb von etwa 3 Stunden bestätigt, daher sind Proofs normalerweise einige Stunden nach Mitternacht UTC verfügbar.
Kann ich den Zeitstempel unabhängig verifizieren, ohne Timestamp GIT zu vertrauen?
Ja. Die .ots-Belegdateien können mit Standard-OpenTimestamps-Tools gegen die Bitcoin-Blockchain verifiziert werden. Der Proof stützt sich nur auf SHA-256 und Bitcoin-Blockdaten, sodass Sie ihn auch offline verifizieren können, selbst wenn unser Dienst verschwindet.
Was, wenn ich meinen Quellcode vollständig privat halten muss? Nutzen Sie den Enterprise-ZK-Modus: Eine GitHub Action auf Ihrer Infrastruktur pusht nur den Commit-Hash an unsere API. Wir haben nie Lesezugriff auf Ihren Quellcode. Alternativ können Sie mit Docker selbst hosten, um die volle Kontrolle zu behalten.
Greift die Zeitstempel-Pipeline auf meinen Quellcode zu? Nein. Der Standardmodus liest Commit-Hashes; der Enterprise-ZK-Modus sieht Ihre Repository-Inhalte überhaupt nie. Der Dienst verarbeitet ausschließlich SHA-256-Hashes und Bitcoin-Blockdaten.
Der Zeitstempel, über den Sie nicht nachdenken müssen
Der Wert kryptografischer Prior Art kommt aus der Abdeckung, nicht aus einem einzelnen beeindruckenden Proof. Ein gestempelter Commit aus einem heldenhaften Nachmittag beweist fast nichts; achtzehn Monate nächtlicher Anker beweisen eine Zeitlinie. Das ist ein Mengenproblem, und Mengenprobleme werden durch Automatisierung gelöst.
Das ist das gesamte Argument für Timestamp GIT: Installieren Sie die GitHub App einmal, wählen Sie Ihre Repositories aus und lassen Sie den nächtlichen Job den Rest erledigen. Proofs landen auf einem timestamps-Branch, Badges landen in Ihrer README, und die Audit-CSV ist da, wenn die Rechtsabteilung fragt. Wenn Sie Isolation benötigen, bringen Sie der Enterprise-ZK-Modus oder Docker dorthin, ohne die Automatisierung aufzugeben.
Installieren Sie die App, pushen Sie einen Commit und prüfen Sie morgen früh das Dashboard.
Verwandte Beiträge
- Git Commit Timestamp Service Pricing: Which Tier Fits Your Team
- What Does a Bitcoin Timestamp Prove About Your Code?
- Are GitHub Commit Timestamps Admissible in Court?