Automatisez l’horodatage Bitcoin pour chaque commit GitHub
Vous avez décidé que vos commits méritent une preuve cryptographique d’existence. Bien. Vient maintenant la partie ennuyeuse : recommencer demain, et après-demain, pour chaque dépôt que votre équipe touche.
C’est là que la plupart des efforts d’horodatage meurent discrètement. Non pas parce que l’idée est mauvaise, mais parce que la corvée manuelle — regrouper les hachages de commits, les soumettre à un service de calendrier, surveiller un fichier de preuve, le committer en retour — ne survit pas au contact d’un vrai sprint. Si vous voulez automatiser l’horodatage blockchain pour les dépôts GitHub, l’horodatage doit être un effet de bord de git push, pas une tâche dont quelqu’un doit se souvenir le vendredi.
Cet article parcourt le chemin automatisé de bout en bout : une installation, un pipeline nocturne que vous ne touchez jamais, et une supervision qui vous dit si les preuves ont réellement atterri dans Bitcoin.
Pourquoi l’horodatage manuel ne passe pas à l’échelle
La manière difficile d’horodater un commit est de le faire à la main à chaque fois. Vous seriez responsable de :
- Décider quels commits méritent d’être horodatés (ils le méritent tous, c’est bien là le problème).
- Regrouper vous-même les hachages pour ne pas créer une transaction Bitcoin par commit.
- Soumettre à un calendrier public et suivre la preuve en attente jusqu’à sa confirmation.
- Stocker le fichier de preuve résultant quelque part de durable et lié au bon commit.
- Répéter toute l’opération demain, et après chaque force-push, correctif urgent et train de merges.
Même scripté, c’est un travail à temps partiel. Quelqu’un doit s’occuper du script, du planificateur cron, de l’emplacement de stockage, et de l’incident « pourquoi la preuve de la semaine dernière manque ». Et dès que cette personne change d’équipe, le pipeline pourrit.
Le protocole OpenTimestamps brut est vraiment élégant — vous pouvez lire son fonctionnement dans Alternative à OpenTimestamps : une GitHub App managée pour chaque commit. Cet article traite de l’autre problème : le faire tourner sans surveillance, pour toujours.
L’objectif est de tout configurer une fois pour toutes : chaque commit d’un dépôt surveillé est ancré chaque nuit, sans intervention d’un développeur et sans rien installer sur l’ordinateur de qui que ce soit.
Configuration initiale : installez la GitHub App
Timestamp GIT est un service managé construit autour d’une GitHub App. La configuration prend quelques minutes et se fait une fois par compte ou organisation.
1. Installez l’app. Depuis le tableau de bord Timestamp GIT, installez la GitHub App sur votre compte personnel ou votre organisation.
2. Sélectionnez les dépôts. Choisissez tous les dépôts ou un sous-ensemble précis. Vous pourrez ajuster la sélection plus tard sans réinstaller.
3. Confirmez les permissions. Le modèle de permissions est volontairement restreint :
| Accès | Portée | Pourquoi |
|---|---|---|
| Lecture seule | Dépôt source | Le système de permissions GitHub n’a pas de portée « hachage de commit uniquement », donc l’app a besoin d’un accès en lecture pour voir les hachages des commits HEAD |
| Lecture-écriture | Dépôt cible | Les preuves sont réécrites sous forme de fichiers manifeste et de reçus .ots sur une branche dédiée ou un dépôt miroir |
4. Laissez tourner. Il n’y a pas de YAML à ajouter, pas de secret à faire tourner, pas de CLI à installer. Vos développeurs continuent de committer exactement comme aujourd’hui ; l’app réagit aux webhooks en arrière-plan.
Si vos dépôts sont publics, l’offre Open Source couvre cela d’emblée. Les dépôts privés commencent à l’offre Pro Agency — le détail des tarifs explique quelle offre convient à quelle forme d’équipe.
L’alternative plus stricte : le mode Enterprise ZK
Le mode standard nécessite un accès en lecture à votre dépôt source. Si votre politique l’interdit — ou si vous ne voulez simplement pas qu’un tiers puisse lire votre code — le mode Enterprise ZK inverse la direction. Au lieu de tirer, c’est votre côté qui pousse : une GitHub Action de 12 lignes s’exécute sur votre propre infrastructure et n’envoie que le hachage du commit à l’API Timestamp GIT. Votre source ne quitte jamais votre environnement, et le service n’a besoin d’aucun accès en lecture au dépôt source. Seul le dépôt cible (où les preuves sont écrites) nécessite un accès en écriture.
Le pipeline automatisé : du commit à Bitcoin
Voici ce qui se passe après la configuration, sans que vous fassiez quoi que ce soit.
1. Détection des commits. Les nouveaux commits arrivent soit via les webhooks de la GitHub App (mode standard), soit via les hachages poussés par votre GitHub Action (mode Enterprise ZK).
2. File d’attente des hachages. Les hachages de commits arrivent dans un magasin clé-valeur en mémoire et attendent le lot nocturne. Notez ce qui n’est pas dans ce magasin : votre code. Uniquement des hachages.
3. Worker cron de minuit. Une fois par nuit, un worker :
- Regroupe tous les hachages en attente.
- Construit un manifeste par dépôt (
.txt). - Construit un arbre de Merkle nativement sur le lot.
- Génère des preuves OpenTimestamps auprès des calendriers OTS publics.
- Ancre la racine de Merkle dans la blockchain Bitcoin.
4. Livraison des preuves. Le manifeste et les fichiers de reçus .ots sont repoussés dans votre dépôt — soit sur une branche timestamps dédiée à côté de votre code, soit dans un dépôt miroir séparé.
Attentes de délai. Bitcoin ne confirme pas instantanément. La transaction d’ancrage est généralement confirmée en environ trois heures, donc attendez-vous à voir les preuves apparaître quelques heures après minuit UTC. Si vous vérifiez à 00:05 UTC et ne voyez rien, rien ne cloche.
La surface d’API pour les workflows personnalisés
Le pipeline tourne tout seul, mais l’API vous permet de brancher les données de preuve dans vos propres outils. Tous les points de terminaison sont authentifiés lorsque c’est indiqué.
# Dernier bloc Bitcoin ancré pour un dépôt (public)
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api
# Nombre total de commits horodatés (public)
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api
# Résumé combiné, pratique pour Shields.io
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api
# Données complètes de la chaîne de Merkle pour un jour donné, pour vérification locale
curl -s https://timestampgit.dev/api/verify/acme/payments-api/2026-10-25
# Registre d'audit au format CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/acme/payments-api
# Certificat PDF pour une date
curl -s -o certificate.pdf https://timestampgit.dev/api/report/acme/payments-api/2026-10-25
Les installations Enterprise ZK utilisent aussi le point de terminaison de commit authentifié par HMAC, où {hash} est la valeur HMAC renvoyée par l’URL signée que votre Action demande :
curl -X POST \
"https://timestampgit.dev/api/timestamp/acme/payments-api/timestamps/<hmac>/<commitId>"
C’est toute la surface d’intégration. Il n’y a pas d’appel « démarrer un lot » à planifier — le regroupement est le travail du service.
Supervision et gestion des échecs
Une automatisation que vous ne supervisez pas n’est qu’un optimisme. Timestamp GIT vous offre trois moyens indépendants de confirmer que le pipeline est sain.
Le tableau de bord public de statut
Chaque dépôt dispose d’un tableau de bord public à l’adresse /status/{user}/{repo} affichant :
- La longévité des preuves et la date d’ancrage la plus ancienne — jusqu’où remonte votre chaîne de preuve.
- La régularité quotidienne, rendue sous forme de carte thermique calendaire, pour qu’une nuit manquée soit visuellement évidente.
- Les données de bloc et de transaction Bitcoin pour chaque ancrage.
Badges de vérification
Intégrez un badge Shields.io dans votre README pour rendre la preuve publique :

La page /connected/{user}/{repo} vous fournit un widget d’intégration de badge avec aperçu en direct, y compris l’extrait markdown. Pour les dépôts privés, les URL de statut portent un HMAC chiffré propre à l’instance serveur — le statut reste visible uniquement pour ceux qui possèdent le lien signé.
Contrôle de santé auto-hébergé
Comme les points de terminaison de statut sont du JSON simple, un petit script dans votre propre CI détecte un pipeline bloqué avant qu’un auditeur ne le fasse :
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.
Et si un lot nocturne ne se termine pas ? Le signal observable est le même dans tous les cas : la carte thermique montre un trou et le dernier bloc ancré cesse d’avancer. Comme l’ancrage est regroupé par jour, une exécution manquée est visible en 24 heures plutôt qu’au moment de l’audit — et comme la file d’attente des hachages et les manifestes sont indexés par date, une ré-exécution produit une preuve datée et distincte plutôt qu’ambiguë. Vérifiez d’abord le tableau de bord, puis la branche timestamps du dépôt pour confirmer si le manifeste et les reçus ont été écrits.
La piste d’audit
Pour les revues de conformité, deux artefacts font le gros du travail :
GET /api/audit/{user}/{repo}— le registre complet au format CSV.GET /api/report/{user}/{repo}/{date}— un certificat PDF pour une seule date.
Et quand quelqu’un veut vérifier les calculs plutôt que faire confiance à un PDF, la page /verification/{user}/{repo}/{date} déroule la chaîne de Merkle à plusieurs niveaux étape par étape. Tout ce calcul se fait localement dans le navigateur — rien de ce que vous vérifiez n’est envoyé au serveur.
Bonnes pratiques pour l’horodatage automatisé
Une fois le pipeline en marche, quelques habitudes gardent la preuve utile :
- Commitez tôt et souvent. Chaque commit est un point de données pour l’antériorité. Écraser un mois de travail en un seul commit juste avant un dépôt vous donne un ancrage au lieu de quarante.
- Gardez les preuves sur leur propre branche. La branche
timestampsautomatisée est écrite par la machine ; la garder séparée des branches de fonctionnalités rendgit loglisible et évite le bruit de merge. - Vérifiez périodiquement, pas seulement en cas de litige. Contrôlez une date récente via le vérificateur web chaque trimestre. Découvrir une chaîne de vérification cassée pendant un procès est un mauvais moment pour la découvrir.
- Livrez les preuves avec les releases. Joignez le manifeste et les reçus de la date de votre release à vos artefacts de release, et référencez la date dans votre documentation juridique.
- Taguez tout ce que vous pourriez breveter. Les commits sont capturés automatiquement ; dès que vous commencez à discuter d’une idée brevetable, assurez-vous que le travail est commité plutôt que de rester dans une branche locale.
Automatisation auto-hébergée avec Docker
L’hébergement managé est la solution par défaut, mais certains environnements ne peuvent pas l’utiliser : réseaux isolés, exigences strictes de résidence des données, ou politique interne interdisant à tout service externe de toucher aux métadonnées des dépôts.
Pour ceux-là, Timestamp GIT est livré sous forme d’image Docker. L’automatisation est identique — le même regroupement nocturne, la même construction d’arbre de Merkle et le même ancrage Bitcoin, simplement exécutés dans votre infrastructure.
Une configuration Docker Compose de démarrage rapide ressemble à ceci :
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
L’application est disponible à l’adresse http://localhost:8080 une fois démarrée. Au premier lancement, un assistant de configuration vous guide pour connecter votre GitHub App et configurer l’instance.
Pour évaluer avant de vous engager, demandez une licence de démonstration à durée limitée depuis la page Docker License — nom, entreprise, e-mail et numéro de téléphone facultatif. Un fichier de licence de démonstration à durée limitée est disponible au téléchargement, et vous le téléversez lors de la phase de configuration on-premises.
FAQ
Dois-je exécuter des commandes ou installer des outils sur les machines de mes développeurs ? Non. Timestamp GIT fonctionne entièrement via la GitHub App. Une fois installée, chaque commit d’un dépôt surveillé est automatiquement horodaté chaque nuit. Pas d’outils CLI, pas de commandes OpenTimestamps, pas d’étapes manuelles.
Combien de temps faut-il pour qu’un commit soit horodaté ? Les commits sont regroupés et ancrés une fois par nuit. La transaction Bitcoin est généralement confirmée en environ 3 heures, donc les preuves sont habituellement disponibles quelques heures après minuit UTC.
Puis-je vérifier l’horodatage indépendamment sans faire confiance à Timestamp GIT ?
Oui. Les fichiers de reçus .ots peuvent être vérifiés à l’aide des outils OpenTimestamps standards contre la blockchain Bitcoin. La preuve repose uniquement sur SHA-256 et les données de blocs Bitcoin, vous pouvez donc vérifier hors ligne même si notre service disparaît.
Et si je dois garder mon code source totalement privé ? Utilisez le mode Enterprise ZK : une GitHub Action sur votre infrastructure ne pousse que le hachage du commit vers notre API. Nous n’avons jamais d’accès en lecture à votre code source. Vous pouvez aussi vous auto-héberger avec Docker pour un contrôle total.
Le pipeline d’horodatage touche-t-il mon code source ? Non. Le mode standard lit les hachages de commits ; le mode Enterprise ZK ne voit jamais du tout le contenu de votre dépôt. Le service ne manipule jamais que des hachages SHA-256 et des données de blocs Bitcoin.
L’horodatage auquel vous n’avez pas à penser
La valeur de l’antériorité cryptographique vient de la couverture, pas d’une seule preuve impressionnante. Un commit horodaté issu d’un après-midi héroïque ne prouve presque rien ; dix-huit mois d’ancrages nocturnes prouvent une chronologie. C’est un problème de volume, et les problèmes de volume se résolvent par l’automatisation.
C’est tout l’argument de Timestamp GIT : installez la GitHub App une fois, choisissez vos dépôts, et laissez la tâche nocturne faire le reste. Les preuves atterrissent sur une branche timestamps, les badges atterrissent dans votre README, et le CSV d’audit est là quand le service juridique le demande. Si vous avez besoin d’isolement, le mode Enterprise ZK ou Docker vous y amène sans renoncer à l’automatisation.
Installez l’app, poussez un commit, et consultez le tableau de bord demain matin.
Articles liés
- Tarifs du service d’horodatage de commits Git : quelle offre convient à votre équipe
- Que prouve un horodatage Bitcoin sur votre code ?
- Les horodatages de commits GitHub sont-ils recevables devant un tribunal ?