Timestamp GIT

← Alle Beiträge

2026-10-22

Automatisiertes Git-Timestamping: Commits in Bitcoin verankern

Automatisiertes Git-Timestamping: Commits in Bitcoin verankern
timestamp git blockchain proof

Automatisiertes Git-Timestamping: Commits in Bitcoin verankern

Wenn dein Prior-Art-Schutz davon abhängt, dass jemand daran denkt, nach jedem Commit ein Tool auszuführen, dann hast du keinen Prior-Art-Schutz — du hast eine Gewohnheit. Und Gewohnheiten brechen in der Woche vor einem Audit, während eines Release-Stresses oder genau dann, wenn die Person, die „das immer gemacht hat", das Team wechselt.

Manuelles Timestamping hat eine vorhersehbare Fehlerschleife. Du committest, dann erinnerst du dich ans Stempeln. Du kopierst die Bescheinigung irgendwohin, wo sie nicht verloren geht. Du machst es morgen wieder, und übermorgen, für jedes Repository, das zählt — und sobald du in einem Sprint mit vielen Branches steckst, hört die Schleife stillschweigend auf. Ein Repository skaliert. Fünf Repositories mit je drei Mitwirkenden nicht.

In diesem Artikel geht es darum, diese Schleife vollständig zu beseitigen: automatisiertes Git-Timestamping auf Bitcoin, bei dem die einzige wiederkehrende Aktion ein Commit ist, den du ohnehin gemacht hättest.

Du kannst das auf die harte Tour machen, indem du die OpenTimestamps-Tools selbst ausführst und Bescheinigungsdateien hütest. Timestamp GIT existiert, damit du das nicht musst. Es ist ein Managed Service, der das Protokoll vollständig verbirgt: Installiere die GitHub App einmal, und jeder Commit in einem überwachten Repository wird jede Nacht automatisch in Bitcoin verankert. Keine CLI-Tools, keine Protokollbefehle, keine tägliche Checkliste. Die Installationsanleitung selbst findest du unter GitHub App Blockchain Timestamp Setup: Install Once, Timestamp Forever — dieser Artikel konzentriert sich darauf, was nach der Installation passiert.

Die repetitive manuelle Aufgabe, die du eliminieren kannst

Bevor du dich für die Automatisierung entscheidest, lohnt es sich, genau zu benennen, was aus deiner Woche entfernt wird:

  • Ein Ritual pro Commit. Nach jedem Commit, der einen Nachweis verdient, muss etwas ausgeführt werden. Das ist ein Mensch im Ablauf, bei jedem Commit, für immer.
  • Wildwuchs bei Bescheinigungen. Nachweisdateien landen in einem persönlichen Ordner, einem Shared Drive oder einem Slack-Thread. Sechs Monate später kann niemand mehr eine Bescheinigung einem Datum oder einem Repository zuordnen.
  • Abnehmende Abdeckung. Du schützt das Flaggschiff-Repository. Das interne Tooling-Repository, die Client-Bibliothek, der Trade-Secret-Service — die stempelt niemand, und genau die sind in einem Streitfall häufig entscheidend.
  • Stille Lücken. Ein einzelner fehlender Tag bleibt unsichtbar, bis du den Nachweis brauchst — der denkbar schlechteste Zeitpunkt, um ein Loch in deiner Zeitlinie zu entdecken.

Was hier „automatisiert" bedeutet, ist eng und konkret. Du installierst die GitHub App einmal in den Repositories, die du überwachen möchtest. Von da an wird jeder Commit erkannt, gebündelt und jede Nacht in der Bitcoin-Blockchain verankert — ohne Entwickleraktion. Entwickler committen genau so weiter wie bisher. Auf ihren Rechnern muss nichts installiert werden, kein Pre-Commit-Hook, kein neuer Workflow zum Erlernen.

Das ist der Unterschied zwischen einem Prozess und einer Hintergrundeigenschaft deiner Repositories.

Einmalige Einrichtung: Installiere die GitHub App und vergiss sie

Timestamp GIT bietet dir zwei Möglichkeiten, ein Repository zu verbinden — beide sind einmalige Konfiguration.

Standardmodus (GitHub App). Installiere die GitHub App in den Repositories, die du überwachen möchtest. Sie liest automatisch nur den HEAD-Commit-Hash jedes überwachten Repositorys. Nachweise werden in einen dedizierten Git-Branch geschrieben — entweder im selben Repository wie die Quelle oder in einem separaten.

Das Berechtigungsmodell lohnt sich, klar zu verstehen, denn es ist weniger, als die Leute erwarten:

  • Lesezugriff auf das Quell-Repository. Das GitHub-Berechtigungssystem kennt keinen Scope „nur Commit-Hash", daher ist Lesezugriff das Minimum, das die App anfordern kann, um den HEAD-Hash zu sehen.
  • Lese-/Schreibzugriff auf das Ziel-Repository, in das die Manifest- und Bescheinigungsdateien gepusht werden.

Enterprise-ZK-Modus. Eine 12-zeilige GitHub Action läuft auf deiner eigenen Infrastruktur und pusht nur den Commit-Hash an die Timestamp GIT API. Diese Konfiguration erfordert Lese-/Schreibzugriff nur auf das Ziel-Repository — kein Lesezugriff auf das Quell-Repository ist nötig, und deine Quelle verlässt nie deine Umgebung.

Welchen Modus du auch wählst, die Entwicklererfahrung für dein Team ist identisch: nichts auf Entwicklerrechnern zu installieren, keine Änderungen daran, wie jemand brancht, committet oder mergt.

Wenn du selbst hosten musst. Für maximale Sicherheit oder air-gapped Umgebungen ist Timestamp GIT auch als Docker-Image verfügbar. 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 Anwendung ist nach dem Start unter http://localhost:8080 erreichbar, und ein Einrichtungsassistent führt dich beim ersten Start durch die Verbindung deiner GitHub App und die Konfiguration deiner Instanz. Lizenzierung, das Demo-Lizenz-Anfrageformular und die vollständige Self-Hosted-Anleitung findest du in Self-Hosted Git Timestamps: Docker Setup & License Guide.

Die automatisierte Pipeline: Vom Commit zum Bitcoin-Anker

Einmal verbunden, läuft die Pipeline ohne dich. Hier ist die tatsächliche Abfolge.

1. Commit-Erkennung. Entweder erkennt die GitHub App neue Commits über Webhooks, oder — im Enterprise-ZK-Modus — deine GitHub Action pusht Commit-Hashes an die API.

2. Hash-Warteschlange. Commit-Hashes landen in einem In-Memory-Key-Value-Store zum Bündeln. Nichts anderes wird gespeichert, weil nichts anderes gesendet wurde.

3. Der Mitternachts-Cron-Worker. Jede Nacht erledigt ein Worker Folgendes:

  • Er gruppiert alle ausstehenden Hashes
  • Er erstellt Manifest-Dateien pro Repository (.txt)
  • Er baut einen Merkle-Baum nativ auf
  • Er erstellt OpenTimestamps-Nachweise mithilfe öffentlicher OTS-Kalender
  • Er verankert die Merkle-Wurzel in der Bitcoin-Blockchain

4. Nachweiszustellung. Die Manifest- und .ots-Bescheinigungsdateien werden zurück in dein Repository gepusht — in einen dedizierten Timestamps-Branch oder ein Shadow-Repository.

Der gesamte Ablauf sieht so aus:

commit ──▶ hash queue ──▶ midnight cron ──▶ Merkle root ──▶ Bitcoin block
                                                 │
                                                 └──▶ manifest.txt + .ots receipt
                                                              │
                                                              ▼
                                                  timestamps branch / shadow repo

Im Enterprise-ZK-Modus spricht deine GitHub Action mit der ZK Commit API, die mit einem HMAC aus der signierten URL authentifiziert wird, die die API für dein Repository zurückgibt:

# The signed URL (and its HMAC) is returned by the API for your repo.
# {target} is the destination repo, {hash} is the HMAC from that URL.
curl -X POST \
  "https://timestampgit.dev/api/timestamp/acme/payments-api/timestamps/<hmac>/<commitHash>/<commitId>"

Erwartung an das Timing. Die Bitcoin-Bestätigung dauert mehrere Stunden — normalerweise etwa 3 —, sodass das Schreiben der Nachweise einige Stunden nach dem nächtlichen Lauf abgeschlossen ist, nicht punkt Mitternacht. Wenn du um 00:05 in deinen Timestamps-Branch schaust und nichts siehst, ist das erwartetes Verhalten, kein Fehler.

Überwachung und Fehlerbehandlung

Automatisierung, die du nicht beobachten kannst, ist nicht von einer Automatisierung zu unterscheiden, die aufgehört hat zu funktionieren. Timestamp GIT stellt öffentliche Status-Endpunkte bereit, damit du die Pipeline beobachten kannst, ohne dich anzumelden:

# Last anchored Bitcoin block
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api

# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api

# Combined summary (Shields.io friendly)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api

Badges. Einbettbare Verifizierungs-Badges sind für deine README verfügbar, sodass der Ankerstatus für jeden sichtbar ist, der das Repository durchstöbert. Jeder kann dem Badge-Link folgen, um den Zeitstempel zu verifizieren — es gibt einen dedizierten Viewer und einen PDF-Bericht. Private Repositories werden ebenfalls unterstützt: Ihre Status-URLs hängen einen verschlüsselten HMAC an, der spezifisch für die Serverinstanz ist, sodass nur autorisierte Nutzer den Status sehen können.

Repository-Status-Dashboard. Unter /status/{user}/{repo} erhältst du die Langlebigkeit der Nachweise, das früheste Ankerdatum, die tägliche Regelmäßigkeit, Bitcoin-Block- und Transaktionsdaten sowie eine Kalender-Heatmap — der schnellste Weg, eine Lücke in der Abdeckung visuell zu erkennen.

Audit- und Reporting-Endpunkte. Wenn du Belege statt eines Dashboards brauchst:

# Full audit ledger as CSV
curl -sO https://timestampgit.dev/api/audit/acme/payments-api

# PDF certificate for one specific date
curl -sO https://timestampgit.dev/api/report/acme/payments-api/2026-10-21

Wenn eine Nacht fehlzulaufen scheint, arbeite es in dieser Reihenfolge ab:

  1. Prüfe statusLast und statusCount. Wenn der letzte Anker mehrere Stunden älter ist als erwartet, kann die Bestätigung einfach noch laufen.
  2. Stelle sicher, dass die GitHub App noch Repository-Zugriff hat. Eine deinstallierte App, eine widerrufene Berechtigung oder ein umbenanntes Repository stoppen die Erkennung stillschweigend.
  3. Prüfe im Enterprise-ZK-Modus den Ausführungsverlauf der Action auf deiner Seite — der Push an die API ist die einzige Verbindung, die lokal brechen kann.
  4. Prüfe erneut, nachdem die Bitcoin-Bestätigung abgeschlossen ist, bevor du annimmst, dass etwas verloren ist.

Best Practices für automatisiertes Timestamping

  • Überwache jedes Repository, das zählt, nicht nur das Flaggschiff. Die Abdeckung ist der ganze Wert der Automatisierung; ein einzelnes geschütztes Repository lässt den Rest deiner Arbeit weiterhin ungeschützt.
  • Halte Commits aussagekräftig. Die Automatisierung stempelt, was du committest, also prägt Commit-Hygiene weiterhin die Geschichte, die deine verankerte Historie erzählt. Hundert „wip"-Commits beweisen weniger als eine saubere, beschreibende Historie.
  • Setze das Badge in die README und bewahre die Audit-CSV und die PDF-Berichte pro Datum bei deinen IP-Unterlagen auf. Diese Artefakte sind es, die du einem Auditor oder der Gegenseite aushändigst.
  • Verifiziere unabhängig, wenn es darauf ankommt. Lade die .ots-Datei herunter und prüfe sie mit Standard-OpenTimestamps-Tools gegen Bitcoin. Der Nachweis ist von Natur aus anbieterunabhängig — er nutzt nur SHA-256 und Bitcoin-Blockdaten. Die Schritt-für-Schritt-Anleitung findest du in How to Verify a Bitcoin Timestamp Proof Locally.
  • Denk an die Zero-Knowledge-Garantie. Nur Commit-Hashes werden gestempelt, niemals Quellcode, sodass die Automatisierung über alle Repositories hinweg deine Exposition überhaupt nicht vergrößert — es ist derselbe Hash, ob du ein Repository hast oder fünfzig.

FAQ

Liest oder speichert automatisiertes Git-Timestamping jemals meinen Quellcode?

Nein. Timestamp GIT verarbeitet nur Commit-Hashes. Im Standardmodus liest die GitHub App den HEAD-Commit-Hash, und im Enterprise-ZK-Modus pusht eine GitHub Action auf deiner Infrastruktur nur den Hash an die API. Dein Quellcode verlässt im ZK-Modus nie deine Umgebung und wird vom Dienst niemals kopiert oder gespeichert.

Wie lange nach meinem Commit wird der Bitcoin-Anker bestätigt?

Commits werden von einem nächtlichen Cron-Worker gebündelt und verankert. Die Bitcoin-Bestätigung dauert mehrere Stunden, normalerweise etwa 3 Stunden, sodass die .ots-Bescheinigung und die Manifest-Dateien einige Stunden nach dem nächtlichen Lauf in deinem Timestamps-Branch oder Shadow-Repository erscheinen.

Was passiert mit meinen Nachweisen, wenn Timestamp GIT abgeschaltet wird?

Die Nachweise bleiben gültig. Sie stützen sich über das OpenTimestamps-Protokoll nur auf SHA-256 und Bitcoin-Blockdaten, sodass jeder die .ots-Datei herunterladen und sie unabhängig gegen die Bitcoin-Blockchain mit Standard-OpenTimestamps-Tools verifizieren kann — keine proprietäre Technologie, kein Lock-in.

Kann ich automatisiertes Timestamping mit privaten Repositories nutzen?

Ja. Private Repositories werden unterstützt, und Status-URLs hängen einen verschlüsselten HMAC an, der spezifisch für die Serverinstanz ist, sodass nur autorisierte Nutzer den Status einsehen können. Öffentliche Verifizierungs-Badges und das Status-Dashboard funktionieren genauso, sobald Zugriff gewährt wurde.

Fazit: Einmal einrichten, für immer beweisen

Der Wandel ist klein im Aufwand und groß in der Konsequenz. Du hörst auf, eine tägliche Pflicht zu pflegen, und beginnst, eine Eigenschaft deiner Repositories zu besitzen: jeder Commit, in Bitcoin verankert, automatisch, jede Nacht, mit einer Bescheinigung, die du einem Anwalt, einem Auditor oder einem Gericht aushändigen kannst. Der Nachweis ist in Bitcoin eingebettet, gerichtstauglich und von jedem ohne proprietäre Tools verifizierbar — und all das wird im Backend von Timestamp GIT gesteuert, nicht von deinen Entwicklern.

Wenn dein Team überhaupt keinen Managed Service nutzen kann, deckt die Docker-Self-Hosted-Option mit dem oben gezeigten Compose-Setup Umgebungen mit maximaler Sicherheit und air-gapped Umgebungen ab.

Installiere die GitHub App noch heute in deinem ersten Repository und lass die Pipeline heute Nacht laufen. Prüfe morgen statusLast — du wirst einen Anker haben, für den du sonst ein Jahr damit verbracht hättest, dich daran zu erinnern, ihn zu erstellen.

Verwandte Beiträge

EU label: AI-generated content