Timestamp GIT

← Alle Beiträge

2026-10-11

Automatisches nächtliches Git-Commit-Anchoring in Bitcoin, ohne manuelle Schritte

Automatisches nächtliches Git-Commit-Anchoring in Bitcoin, ohne manuelle Schritte
timestamp git blockchain proof

Automatische nächtliche Verankerung von Git-Commits in Bitcoin, ohne manuelle Schritte

Die häufigste Art, wie Teams Commits „mit einem Zeitstempel versehen", ist, dass ein Mensch daran denken muss.

Jemand schließt ein Feature ab, erinnert sich, dass der Commit verankert werden sollte, führt den OpenTimestamps-Workflow von Hand aus — auf die umständliche Art — und speichert die Quittung irgendwo. Zwei Wochen später erinnert sich niemand mehr, ob die Quittung für diesen Dienstag existiert. Ein anderer Entwickler stößt dazu, kennt das Ritual nicht, und sechs Monate an Commits bleiben ungestempelt.

Das ist die Falle des manuellen Zeitstempelns: eine Nachweisabdeckung, die vom Gedächtnis abhängt. In einer Demo funktioniert das gut und zerfällt über ein Team, einen Sprint-Rhythmus und ein Jahr mit Personalwechsel hinweg. Die automatische nächtliche Verankerung von Git-Commits in Bitcoin dreht das Problem um: Die Verankerung ist keine Aufgabe mehr, die eine Person ausführt, sondern eine Eigenschaft deines Repositorys. Du installierst einmal eine GitHub App, und jeder Commit wird gebündelt und verankert, während du schläfst.

Dieser Artikel führt dich durch diesen automatisierten Weg von Anfang bis Ende — Einrichtung, Pipeline, Monitoring, Self-Hosting — und ist für Entwickler und Compliance-Verantwortliche geschrieben, denen wichtig ist, dass der Nachweis ein Audit übersteht, und nicht, dass sie einen Cron-Job babysitten.

Die Falle des manuellen Zeitstempelns (und wie Automatisierung sie beseitigt)

Manuelles Stempeln von Commits hat drei Fehlerquellen, und alle drei sind struktureller und nicht persönlicher Natur:

  • Abhängigkeit vom Gedächtnis. Jemand muss sich daran erinnern, das Tooling im richtigen Moment auszuführen, idealerweise bevor die Arbeit öffentlich wird. Zu spät ist für Prior-Art-Zwecke dasselbe wie nie.
  • Stille Fehler. Wenn ein manueller Lauf fehlschlägt — Netzwerkaussetzer, abgelaufener Kalender, falsches Verzeichnis — stürzt nichts ab. Du hast einfach eine Lücke in der Abdeckung, die du ein Jahr später entdeckst, während des Streitfalls, für den du den Nachweis gebraucht hättest.
  • Quittungs-Wildwuchs. Quittungen landen auf Laptops, in Slack-Threads, auf einem geteilten Laufwerk, das niemandem gehört. Ein Nachweis, den du nicht finden kannst, ist ein Nachweis, den du nicht hast.

Nichts davon skaliert. Ein Solo-Entwickler mag das Ritual ein paar Monate am Leben halten. Ein Team von zehn wird es nicht tun, und eine Agentur, die Kundenarbeit über Dutzende Repos hinweg betreibt, hat keine Chance. Jede verpasste Nacht ist ein dauerhaftes Loch in der Aufzeichnung, denn du kannst einen Hash, der nie erfasst wurde, nicht nachträglich verankern.

Timestamp GIT ist die verwaltete Alternative ohne Einrichtungsaufwand: eine GitHub App, die Commit-Hashes automatisch erfasst, sie bündelt und sie jede Nacht über das OpenTimestamps-Protokoll in der Bitcoin-Blockchain verankert. Keine CLI-Tools, keine manuellen Quittungen, nichts auf den Rechnern der Entwickler installiert. Du bekommst die kryptografische Eigenschaft — ein unveränderliches, unabhängig überprüfbares Datum — ohne das zugrunde liegende Protokoll selbst zu betreiben.

Zwei tiefergehende Betrachtungen findest du an anderer Stelle in diesem Blog: How to Verify a Git Repository’s Bitcoin Timestamp behandelt die Verifizierungsseite, und Git Commit Timestamp Proof for Patent Disputes behandelt den rechtlichen Rahmen. Dieser Artikel bleibt bei der Automatisierung selbst.

Einmalige Einrichtung: Installiere die GitHub App und vergiss sie

Die Einrichtung ist eine einzige Aktion, einmal pro Repository oder einmal pro Organisation durchgeführt.

  1. Installiere die Timestamp GIT GitHub App im Repository (oder in der gesamten Organisation, damit neue Repos standardmäßig abgedeckt sind).
  2. Wähle das Quell-Repository, das deinen Code enthält.
  3. Wähle das Ziel-Repository, in das die Nachweise geschrieben werden — entweder dasselbe Repo auf einem dedizierten Branch oder ein separates Shadow-Repository.

Das ist die gesamte Konfiguration. Es gibt keine Anforderungen an Entwicklerrechner: keinen Daemon, keinen Hook, den jeder Engineer installieren muss, keine Onboarding-Checkliste. Neue Mitarbeiter sind mit ihrem ersten Commit abgedeckt, weil die Abdeckung eine Repository-Eigenschaft ist, keine persönliche.

Das Berechtigungsmodell. Der Standardmodus benötigt Lesezugriff auf das Quell-Repository sowie Lese-/Schreibzugriff auf das Ziel-Repository. Die Nur-Lese-Anforderung existiert, weil GitHubs Berechtigungssystem keinen Scope nur für Commit-Hashes bietet — Lesezugriff auf die Quelle ist die minimale Gewährung, die es der App erlaubt, den HEAD-Commit-Hash zu sehen. Sie liest auch nur diesen Hash.

Wenn selbst ein Hash deine Umgebung nicht verlassen darf, ersetzt der Enterprise-ZK-Modus das Polling der App durch eine 12-zeilige GitHub Action, die auf deiner eigenen Infrastruktur läuft und nichts außer dem Commit-Hash an die Timestamp GIT API überträgt. In diesem Modus benötigt der Dienst nur Lese-/Schreibzugriff auf das Ziel-Repository und überhaupt keinen Lesezugriff auf das Quell-Repository — stattdessen installierst du die Action.

So oder so ist die Garantie dieselbe: Wir sehen, kopieren oder speichern niemals deinen tatsächlichen Quellcode. Nur der Hash ist jemals im Spiel.

In der automatisierten Pipeline: Vom Commit zur Bitcoin-Verankerung

Nach der Installation läuft die Pipeline ohne Eingreifen. Hier ist, was zwischen deinem git push und einem unveränderlichen Nachweis in deinem Repository passiert.

1. Commit-Erkennung. Im Standardmodus erkennt die GitHub App neue Commits über Webhooks. Im Enterprise-ZK-Modus überträgt deine GitHub Action den Commit-Hash an die API. Beide Wege erzeugen dasselbe Artefakt: eine Liste von Commit-Hashes.

2. Hash-Warteschlange. Eingehende Hashes landen in einem In-Memory-Key-Value-Store, der rein zum Bündeln dient. Das ist der Wartebereich — Commits sammeln sich hier bis zum nächsten Batch-Fenster.

3. Mitternachts-Cron-Worker. Jede Nacht nimmt ein Worker jeden ausstehenden Hash und:

  • gruppiert sie pro Repository,
  • schreibt eine Manifest-Datei (.txt) für jedes Repo,
  • baut einen Merkle-Baum nativ über den Batch,
  • erstellt OpenTimestamps-Nachweise unter Verwendung öffentlicher OTS-Kalender,
  • verankert die Merkle-Wurzel in der Bitcoin-Blockchain.

Das Bündeln ist es, was das günstig und kontinuierlich macht. Ob du an diesem Tag einen Commit oder vierhundert gepusht hast, die Kosten und der Rhythmus sind dieselben.

4. Nachweiszustellung. Das Manifest und die .ots-Quittungsdateien werden automatisch zurück in dein Repository gepusht — auf einen dedizierten timestamps-Branch oder in dein Shadow-Repository.

Es gibt ein Timing-Detail, das man einplanen sollte: Die Bestätigung in der Bitcoin-Blockchain dauert mehrere Stunden, normalerweise etwa drei. Heute gepushte Commits werden also heute Nacht in die Warteschlange gestellt, über Nacht verankert, und die Nachweisdateien erscheinen ein paar Stunden später. Du wartest nicht darauf; du findest sie einfach am nächsten Morgen dort.

Das Ergebnis ist pro Tag und pro Repo eine manipulationssichere Kette: deine Commit-Hashes → Manifest → Merkle-Baum → Merkle-Wurzel → OpenTimestamps-Nachweis → Bitcoin-Block.

Monitoring und Fehlerbehandlung: Die Kette ununterbrochen halten

Automatisierung, die du nicht überwachst, ist nur eine schöner aussehende Version der manuellen Falle. Timestamp GIT stellt öffentliche Status-Endpunkte bereit, damit du die Kette selbst überprüfen kannst, ohne Dashboard-Login:

# Last anchored Bitcoin block info for a repo
curl -s https://timestampgit.dev/api/statusLast/{user}/{repo}

# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/{user}/{repo}

# Combined summary, used for Shields.io badges
curl -s https://timestampgit.dev/api/statusSummary/{user}/{repo}

Eine einfache Kontinuitätsprüfung, die in jeden Scheduler passt: Rufe statusLast einmal täglich auf, speichere die Rohantwort und alarmiere, wenn sie sich seit gestern nicht geändert hat. Wenn keine neue Verankerung gelandet ist, hast du die Lücke noch in derselben Woche entdeckt statt im selben Jahrzehnt.

Wenn du das lieber nicht selbst bauen möchtest, erledigt das öffentliche Status-Dashboard unter https://timestampgit.dev/status/{user}/{repo} die Arbeit visuell — Nachweislebensdauer, frühestes Verankerungsdatum, tägliche Regelmäßigkeit, die Bitcoin-Block- und Transaktionsdaten hinter jeder Verankerung sowie eine Kalender-Heatmap, die verpasste Nächte sofort sichtbar macht. Von derselben Seite kannst du das Audit-CSV und ein PDF-Zertifikat herunterladen.

Private Repositories bleiben privat. Status-URLs für private Repos tragen einen verschlüsselten HMAC, der spezifisch für die Serverinstanz ist, sodass nur autorisierte Nutzer den Status dieser Repositories lesen können. Die Nachweise sind im Bitcoin-Sinne weiterhin öffentlich überprüfbar — der Hash ist on-chain —, aber die umgebenden Metadaten sind kein offenes Buch.

Verifizierungs-Badges. Für öffentliche Repos rendern einbettbare Badges deinen Verifizierungsstatus direkt im README, mit einem Link, dem jeder folgen kann, um den Zeitstempel auf der Website zu überprüfen. Das Badge macht den Nachweis für einen Kunden, einen Käufer oder die Gegenseite sichtbar, ohne dass du irgendetwas vorlegen musst.

Wenn die App sich neu verbindet. Wenn ein Repo getrennt und wieder verbunden wird, liefert die verbundene Seite das Badge-Einbettungs-Widget mit einer Live-Vorschau, damit du erneut überprüfen kannst, dass die Verknüpfung intakt ist.

Best Practices für zuverlässige nächtliche Verankerung

  • Setze einmal pro Woche einen Menschen auf die Heatmap. Nächtliche Automatisierung beseitigt die tägliche Aufgabe, nicht die Verantwortlichkeit. Ein fünfminütiger wöchentlicher Blick auf das Status-Dashboard fängt alles ab, was ein Alarm übersehen könnte.
  • Alarmiere bei Abwesenheit, nicht nur bei Fehlern. Der gefährliche Zustand ist Stille. Alarmiere, wenn das Verankerungsdatum aufhört, sich weiterzubewegen.
  • Nutze einen dedizierten timestamps-Branch oder ein Shadow-Repository. Nachweise aus deinem Standard-Branch herauszuhalten bedeutet kein Merge-Rauschen, keine versehentliche Beeinträchtigung der CI und einen Audit-Trail, den ein Prüfer durchsuchen kann, ohne deine Anwendung zu klonen.
  • Bette Badges dort ein, wo Käufer hinsehen. Im README, nahe dem Lizenz-Header. Öffentlicher Existenznachweis ist günstige Glaubwürdigkeit.
  • Exportiere das Audit-Ledger nach Plan. Ziehe das CSV regelmäßig und archiviere es zusammen mit deinen Compliance-Unterlagen, und generiere ein PDF-Zertifikat für jeden Release-Meilenstein. Compliance-Teams wollen ein Dokument mit einem Datum darauf; gib ihnen eines, bevor sie fragen.
  • Halte die „Wer kann was sehen"-Geschichte schriftlich fest. Dokumentiere deinen Modus — Standard oder Enterprise ZK — und die genau gewährten Berechtigungen. Wenn die Beschaffung oder die Rechtsabteilung fragt, beantwortest du eine Frage, die du bereits beantwortet hast.

Self-Hosting für air-gapped Umgebungen: Docker-Compose-Schnellstart

Wenn deine Vorgaben einen verwalteten Dienst ausschließen — regulierte Umgebungen, air-gapped Netzwerke, strenge Datenresidenz-Regeln —, ist Timestamp GIT als Docker-Image verfügbar, das dieselbe automatisierte Pipeline auf deiner eigenen Infrastruktur ausführt.

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

Starte es:

docker compose pull
docker compose up -d
docker compose logs -f timestampgit

Die Anwendung ist nach dem Start unter http://localhost:8080 verfügbar. Beim ersten Start führt dich ein Einrichtungsassistent durch die Verbindung deiner GitHub App und die Konfiguration deiner Instanz.

Zur Evaluierung ist eine zeitlich begrenzte Demo-Lizenz verfügbar: Reiche das Anfrageformular auf der Docker License page mit deinem Namen, deiner Firma, deiner E-Mail und optional deiner Telefonnummer ein, und du kannst eine Demo-Lizenzdatei herunterladen, um loszulegen.

Self-Hosting gibt dir maximale Sicherheit und Kontrolle bei demselben nächtlichen Bündelungs- und Verankerungsverhalten — der Merkle-Baum, die OTS-Nachweise und die .ots-Dateien, die zurück in deine Repositories geschrieben werden.

FAQ

Muss ich irgendwelche Befehle ausführen oder Tools auf meinem Rechner installieren? Nein. Timestamp GIT ist ein verwalteter Dienst: Du installierst die GitHub App einmal, und jeder Commit wird jede Nacht automatisch verankert. Auf den Rechnern der Entwickler wird nichts installiert.

Wie lange dauert es, bis ein Commit in Bitcoin verankert ist? Der nächtliche Cron-Worker bündelt Commits und verankert die Merkle-Wurzel über OpenTimestamps in Bitcoin. Die Bestätigung dauert typischerweise etwa 3 Stunden, danach werden die .ots-Nachweisdateien zurück in dein Repository gepusht.

Kann ich den Zeitstempel unabhängig überprüfen? Ja. Du kannst die .ots-Datei herunterladen und Standard-OpenTimestamps-Verifizierungstools gegen die Bitcoin-Blockchain verwenden, oder die öffentliche Verifizierungsseite unter https://timestampgit.dev/verification/{user}/{repo}/{date} nutzen, die jeden Schritt der mehrstufigen Merkle-Kettenprüfung lokal in deinem Browser ausführt — niemand sieht, was du verifizierst.

Was, wenn ich meinen Quellcode vollständig privat halten muss? Nutze den Enterprise-ZK-Modus: Eine GitHub Action auf deiner Infrastruktur überträgt nur den Commit-Hash an die Timestamp GIT API, sodass deine Quelle deine Umgebung nie verlässt. Alternativ kannst du es mit Docker selbst hosten, um volle Kontrolle zu haben.

Die Verankerung ist nur so gut wie ihre Regelmäßigkeit

Ein Zeitstempel, den du einmal erstellt hast, beweist eine Sache über einen Moment. Ein Zeitstempel, der jede Nacht automatisch erstellt wird, beweist, dass ein Repository in einem bestimmten Zustand auf einer kontinuierlichen Zeitachse existierte — und das ist die Version, die standhält, wenn dich jemand achtzehn Monate später herausfordert. Manuelles Stempeln kann diese Aufzeichnung nicht erzeugen, denn die Aufzeichnung wird durch die Tage definiert, die du nicht verpasst hast.

Timestamp GIT ist genau dafür gebaut: Installiere die GitHub App in deinem Repo oder deiner Organisation, wähle, wo die Nachweise landen, und lass den nächtlichen Worker deine Commit-Hashes bündeln, in einen Merkle-Baum packen und in Bitcoin verankern. Verifiziere mit einem Badge, einem Dashboard oder den .ots-Dateien selbst. Wenn du es lieber in deinem eigenen Netzwerk betreiben möchtest, deckt die Docker-Self-Hosted-Lizenz das ab.

Installiere es einmal. Dann hör auf, darüber nachzudenken.

Verwandte Beiträge

EU label: AI-generated content