Comment vérifier une preuve d’horodatage Bitcoin pour votre code
Une preuve d’horodatage que vous ne pouvez pas vérifier vous-même n’est qu’une promesse de fournisseur avec un meilleur marketing. Tôt ou tard, quelqu’un — un avocat dans un litige de brevet, un auditeur lors d’une due diligence, ou un CTO qui soupçonne que votre « implémentation indépendante » ne l’était pas — vous demandera de démontrer qu’un hash de commit donné existait à une date donnée. Ce moment, c’est l’étape de vérification, et c’est celle que la plupart des équipes ne répètent jamais.
La bonne nouvelle : avec Timestamp GIT, la vérification n’est pas un projet de recherche. La GitHub App ancre vos hashs de commit chaque nuit, et vérifier une preuve prend un clic, une URL ou un curl. Cet article détaille les parcours de vérification exacts, ce que signifient les résultats, et où se cachent les cas limites.
Pourquoi la vérification compte : de la confiance à la preuve
Il y a une différence entre une affirmation et une preuve :
- Une affirmation, c’est « nous avons écrit ceci en mars ». Elle vit dans une base de données que vous contrôlez et qui peut être modifiée.
- Une preuve, c’est « ce hash de commit spécifique a été inclus dans un arbre de Merkle dont la racine est intégrée dans le bloc Bitcoin N ». N’importe qui peut la recalculer.
Pour la conformité, les audits et les litiges, une preuve a une exigence supplémentaire : elle doit être reproductible et indépendante du fournisseur. Si votre preuve ne se vérifie que tant que les serveurs d’une entreprise spécifique sont en ligne, ce n’est pas vraiment une preuve — c’est un abonnement.
La conception de Timestamp GIT en tient compte. Le reçu .ots plus les données publiques des blocs Bitcoin constituent l’intégralité de la preuve. Il n’y a aucun composant propriétaire dans le parcours de vérification, et rien à installer sur les machines de vos développeurs. Cet article reste centré sur l’étape de vérification ; si vous hésitez encore s’il faut horodater, l’argument stratégique se trouve dans notre guide du fondateur sur l’antériorité.
Ce que contient réellement une preuve d’horodatage Bitcoin
Une preuve pour une journée donnée se compose de deux artefacts, stockés dans une branche timestamps dédiée ou un dépôt miroir afin qu’ils soient versionnés aux côtés de votre code :
- Un fichier manifeste (
.txt) listant les hashs de commit collectés pour ce dépôt ce jour-là. - Un fichier de reçu
.otscontenant le chemin de Merkle qui relie votre hash à la racine de Merkle ancrée dans Bitcoin.
La chaîne ressemble à ceci :
commit hash ─┐
commit hash ─┼─ Merkle tree ─ Merkle root ─ Bitcoin transaction ─ block
commit hash ─┘ │
.ots receipt (Merkle path from your hash to the root)
Deux propriétés comptent lorsque vous vérifiez :
- Le manifeste prouve quels hashs ont été inclus.
- Le reçu
.otsprouve quand la racine de Merkle est entrée dans la chaîne.
Parce que l’ancrage utilise le protocole OpenTimestamps et rien d’autre de propriétaire, la preuve nous survit : c’est du SHA-256 plus des données de blocs Bitcoin, vérifiable hors ligne, pour toujours.
Étape par étape : vérifier une preuve d’horodatage avec Timestamp GIT
1. Commencez par le badge dans votre README
Chaque dépôt surveillé peut afficher un badge de vérification Shields.io. C’est un pointeur actif, pas une image statique : il renvoie vers la page de statut publique de ce dépôt. Vous générez l’extrait à intégrer sur la page de connexion du dépôt (https://timestampgit.dev/connected/{user}/{repo}), qui affiche un aperçu en direct avant que vous ne le colliez.
<!-- Paste the snippet generated at /connected/{user}/{repo} -->
[](https://timestampgit.dev/status/OWNER/REPO)
Lorsqu’un relecteur clique sur le badge, il arrive sur les preuves — pas sur une page marketing.
2. Lisez la page de statut du dépôt
Ouvrez :
https://timestampgit.dev/status/{user}/{repo}
Ce tableau de bord public vous donne le résumé adapté à l’audit :
- Longévité des preuves — jusqu’où remonte votre historique d’ancrage.
- Date du premier ancrage — le premier jour où vos hashs ont atteint Bitcoin.
- Régularité quotidienne — la preuve que la tâche nocturne s’est réellement exécutée, jour après jour.
- Données de blocs et de transactions Bitcoin pour les ancrages.
- Une carte de chaleur calendaire pour que les lacunes soient visuellement évidentes.
- Téléchargements : le CSV d’audit et un certificat PDF.
Pour un auditeur, la carte de chaleur plus le CSV suffisent généralement pour une première passe. Les cases manquantes sont ce qu’il faut examiner.
3. Vérifiez une journée spécifique localement
Pour une preuve au niveau d’une date, ouvrez :
https://timestampgit.dev/verification/{user}/{repo}/{date}
Cette page parcourt la chaîne de Merkle étape par étape et effectue le calcul localement dans votre navigateur. Rien de ce que vous vérifiez n’est transmis — la propriété de connaissance nulle s’applique aussi à la vérification, pas seulement à l’ingestion.
Cela compte plus qu’il n’y paraît. Un réviseur de conformité peut vérifier une preuve impliquant des dépôts internes sensibles sans fournir aucune information supplémentaire au fournisseur.
4. Récupérez la chaîne de Merkle via l’API
Si vous préférez vérifier par programmation (ou stocker la preuve dans votre propre système de conformité), l’API renvoie les données complètes de la chaîne de Merkle pour une journée spécifique :
curl -s "https://timestampgit.dev/api/verify/OWNER/REPO/2026-11-18" | jq
Vous pouvez également récupérer le dernier bloc ancré et le nombre de commits en cours :
curl -s "https://timestampgit.dev/api/statusLast/OWNER/REPO" | jq
curl -s "https://timestampgit.dev/api/statusCount/OWNER/REPO" | jq
Aucun outil CLI, aucune commande de protocole, aucun logiciel de portefeuille. Le gros du travail — détection des commits via le webhook de la GitHub App, regroupement, construction de l’arbre de Merkle et ancrage dans Bitcoin — a déjà eu lieu pendant la nuit.
Lire les résultats — et les cas limites
Une preuve valide signifie quelque chose de précis et de fort : ce hash de commit existait au moment de l’horodatage de ce bloc Bitcoin ou avant. Elle ne vous dit pas que le code est bon, que vous avez écrit chaque ligne, ni qui l’a tapé. L’auteur au-delà du hash est une question distincte — notre analyse de la solidité des horodatages de commit Git comme preuve couvre cette distinction.
Autres points à garder en tête :
- Variation de l’horodatage des blocs. Les horodatages des blocs Bitcoin peuvent légèrement dériver par rapport à l’heure réelle. La preuve reste cryptographiquement solide malgré tout, car le bloc lui-même est immuable — personne ne peut re-miner l’historique pour déplacer votre ancrage.
- Preuve manquante pour une date. Les preuves sont écrites quelques heures après minuit : le worker cron regroupe les hashs, construit l’arbre de Merkle, le soumet aux calendriers OTS publics, puis attend la confirmation Bitcoin — normalement environ trois heures. Une preuve pour une journée peut simplement ne pas encore être écrite. Si elle est plus ancienne que cela, vérifiez si le dépôt était réellement surveillé pendant cette fenêtre.
- Dépôts privés. Les URL de statut des dépôts privés portent un HMAC chiffré, et seuls les détenteurs de cette URL peuvent voir le statut. La vérification elle-même se fait toujours localement dans le navigateur.
- Instances auto-hébergées. Chaque instance génère son propre HMAC. Si vous migrez un badge d’une instance SaaS vers votre propre déploiement Docker, régénérez le lien du badge — un HMAC d’une instance ne sera pas validé sur une autre.
Vérifier sans le SaaS : auto-hébergement Docker et contrôles hors ligne
Pour les environnements isolés ou à haute paranoïa, Timestamp GIT est livré sous forme d’image Docker. 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
Puis :
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
L’application est disponible à l’adresse http://localhost:8080, et un assistant de configuration au premier lancement vous guide pour connecter votre GitHub App et configurer l’instance. Une licence de démonstration à durée limitée est disponible sur la page Docker License si vous souhaitez évaluer avant de vous engager.
L’auto-hébergement ne change pas les mathématiques de la vérification. Les fichiers .ots et les données de blocs Bitcoin sont les mêmes artefacts, et ils se vérifient hors ligne. Vous pouvez tout faire manuellement et fournir le fichier .ots aux outils de vérification OpenTimestamps standard face à un nœud Bitcoin local — c’est la méthode difficile, et elle fonctionne précisément parce que la preuve est indépendante du fournisseur. La visionneuse et l’API du produit en font simplement une affaire d’un clic au lieu d’un projet de week-end.
Automatiser la vérification pour la conformité
Si la vérification est une case à cocher dans une revue trimestrielle, automatisez-la :
- Exportez le registre.
GET /api/audit/{user}/{repo}renvoie le registre d’audit complet au format CSV — l’artefact que votre auditeur veut réellement dans la salle d’archives. - Générez des certificats par jour.
GET /api/report/{user}/{repo}/{date}produit un certificat PDF pour une date spécifique, utile lorsqu’une preuve unique doit être jointe à un contrat ou à un dépôt de litige. - Interrogez la fraîcheur. Une courte tâche cron de votre côté capte le mode de défaillance qui compte : l’arrêt silencieux de l’ancrage.
#!/usr/bin/env bash
set -euo pipefail
REPOS=("acme/api" "acme/web" "acme/infra")
for repo in "${REPOS[@]}"; do
printf '%-14s ' "$repo"
curl -s "https://timestampgit.dev/api/statusLast/${repo}" | jq -c '.'
done
Exécutez-la quotidiennement ; si le dernier bloc ancré cesse d’avancer, vous le savez avant un auditeur.
- Affichez le statut publiquement. Intégrez le badge Shields.io pour que les utilisateurs en aval et les clients puissent voir le statut de vérification sans rien vous demander.
Pour les équipes qui veulent une séparation maximale, les offres Enterprise ZK fournissent une courte GitHub Action qui s’exécute dans votre propre CI et ne transmet que des hashs de commit — le modèle d’ancrage et de vérification reste le même, et la vérification se fait toujours localement.
FAQ
Dois-je exécuter des commandes OpenTimestamps pour vérifier une preuve ?
Non. Timestamp GIT fournit une page de vérification web et une API REST qui gèrent l’intégralité du contrôle. Vous pouvez aussi télécharger le fichier .ots et utiliser les outils de vérification standard si vous préférez, mais ce n’est pas obligatoire.
Combien de temps faut-il pour qu’une preuve devienne vérifiable ?
Les preuves sont ancrées chaque nuit et confirmées dans la blockchain Bitcoin après quelques heures — généralement environ trois heures. Un commit effectué aujourd’hui aura une preuve vérifiable dès le lendemain.
Puis-je vérifier une preuve pour un dépôt privé ?
Oui, mais les pages de statut des dépôts privés nécessitent un HMAC chiffré ajouté à l’URL. Les utilisateurs autorisés peuvent y accéder, et la vérification elle-même se fait toujours localement dans votre navigateur.
Et si Timestamp GIT disparaît ? Puis-je encore vérifier ?
Oui. La preuve est indépendante du fournisseur : elle repose uniquement sur SHA-256 et les données de blocs Bitcoin. Vous pouvez vérifier le fichier .ots hors ligne avec les outils OpenTimestamps standard même si notre service n’existe plus.
Conclusion
La vérification est le moment où l’horodatage cesse d’être une bonne idée pour devenir une preuve défendable. Le flux de travail est court : cliquez sur le badge, lisez la page de statut, ouvrez la vue de vérification au niveau du jour, ou appelez /api/verify/{user}/{repo}/{date} et vérifiez vous-même la chaîne de Merkle. Chaque parcours aboutit au même endroit — un hash de commit qui existait avant un bloc Bitcoin spécifique, prouvable pour toujours, sans faire confiance à la base de données de quiconque.
Si vous n’avez pas encore commencé, la configuration est la partie ennuyeuse : installez la GitHub App sur un dépôt et laissez la tâche nocturne s’exécuter. Vous aurez votre première preuve vérifiable dès demain. Rendez-vous sur timestampgit.dev pour connecter votre premier dépôt.
Articles connexes
- Prouvez l’antériorité avant de déposer : le guide du fondateur
- Meilleurs outils pour horodater le code source à l’intention des auditeurs
- Les horodatages de commit Git tiennent-ils comme preuve ?