Comment vérifier localement une preuve d’horodatage Bitcoin
Vous avez un fichier .ots qui traîne dans une branche de timestamps, et un avocat, un auditeur ou votre propre esprit sceptique veut savoir : est-ce que cela prouve réellement quelque chose, ou est-ce simplement un fichier qu’un prestataire vous a remis ?
Cette question est tout l’enjeu de l’horodatage cryptographique. Une preuve que seul l’émetteur peut valider n’est pas une preuve — c’est une promesse. Cet article explique comment vérifier localement une preuve d’horodatage Bitcoin, étape par étape, à l’aide des outils de vérification intégrés de Timestamp GIT. Aucun outil en ligne de commande requis, aucune confiance en nos serveurs requise, et — si vous voulez aller plus loin — aucune dépendance à l’existence même de Timestamp GIT.
Pourquoi la vérification locale est importante
La plupart des attestations logicielles sont des documents du type « faites-moi confiance ». Un prestataire signe un PDF affirmant « oui, ce commit existait à cette date ». Si le prestataire disparaît, est racheté, ou change discrètement ses clés de signature, votre preuve s’affaiblit. La preuve ne vous a jamais vraiment appartenu.
Les preuves ancrées dans Bitcoin fonctionnent différemment. Timestamp GIT intègre les hachages de commits dans la blockchain Bitcoin via le protocole OpenTimestamps, en utilisant des calendriers OTS publics. Le chemin de vérification n’utilise que SHA-256 et les données de blocs Bitcoin — aucune cryptographie propriétaire, aucune recette secrète. Cela signifie que :
- La preuve survit au prestataire. Même si Timestamp GIT disparaissait demain, le reçu
.otset le bloc Bitcoin qu’il référence restent vérifiables par n’importe qui. - La vérification est locale par défaut. Le vérificateur web de Timestamp GIT exécute l’intégralité du calcul dans votre navigateur. Personne ne voit ce que vous vérifiez, et aucune réponse serveur n’est nécessaire pour aboutir à une conclusion.
- Les équipes de conformité l’acceptent. Lors d’un audit juridique, « nos journaux internes l’affirment » est souvent rejeté comme partial. Un chemin de Merkle qui se termine dans un en-tête de bloc Bitcoin spécifique relève d’une autre catégorie de preuve.
En bref : toute la valeur de la preuve d’existence s’effondre si la vérification exige de faire confiance à l’émetteur. Ce n’est pas le cas ici.
Si vous voulez le contexte conceptuel sur pourquoi l’antériorité a besoin d’un ancrage cryptographique, cela est traité dans Qu’est-ce que l’antériorité cryptographique ? Un guide pour les équipes logicielles. Cet article porte sur l’acte mécanique de vérification.
À quoi ressemble une preuve Timestamp GIT
Lorsque vous installez la GitHub App et connectez un dépôt, chaque commit est intégré dans un lot nocturne. Voici ce que vous obtenez :
- Un fichier de reçu
.ots. Une preuve cryptographique compacte qu’un hachage de commit Git donné — ou plutôt, la racine de Merkle couvrant le lot de hachages d’une journée — existait à un moment précis. - Un fichier manifeste
.txtpar dépôt. La liste des hachages de commits regroupés pour cette journée. - Une branche de timestamps dédiée ou un dépôt fantôme. Les preuves sont repoussées dans votre propre infrastructure, soit dans le dépôt source, soit dans un dépôt cible séparé.
Chaque preuve correspond à un lot quotidien. Le pipeline regroupe tous les hachages de commits en attente, construit nativement un arbre de Merkle, crée des preuves OpenTimestamps auprès des calendriers OTS publics, et ancre la racine de Merkle dans une transaction Bitcoin.
Le fichier .ots est autonome aux fins de vérification : il contient le chemin de Merkle depuis votre hachage de commit jusqu’à la racine ancrée, plus une référence à l’en-tête de bloc Bitcoin qui contient l’ancre. Vous n’avez pas besoin de la base de données de Timestamp GIT pour le vérifier.
Une note sur le timing qui déroute souvent : la confirmation Bitcoin prend plusieurs heures — généralement environ 3. L’étape d’écriture de la preuve intervient donc quelques heures après l’exécution du cron worker de minuit. Un commit récent n’est pas immédiatement vérifiable. Voir Interprétation des résultats et cas limites ci-dessous.
Étape par étape : vérifier votre preuve localement
Étape 1 : récupérer le fichier .ots
Il est déjà dans votre dépôt. Cherchez dans la branche de timestamps, ou dans le dépôt fantôme si vous avez configuré les preuves pour qu’elles vivent séparément de la source. Vous pouvez aussi le récupérer depuis le tableau de bord Timestamp GIT via votre liste de dépôts.
Étape 2 : utiliser le vérificateur basé sur navigateur
Rendez-vous sur la page de vérification de votre dépôt et de votre date :
https://timestampgit.dev/verification/{user}/{repo}/{date}
Il s’agit d’une vérification étape par étape, multi-niveaux, de la chaîne de Merkle. Chaque calcul de hachage se fait localement dans votre navigateur — la page n’envoie vos données nulle part, et personne ne voit ce que vous vérifiez. Vous verrez la chaîne se dérouler depuis votre hachage de commit, à travers les nœuds de Merkle intermédiaires, jusqu’à la racine et la référence au bloc Bitcoin.
C’est la voie que la plupart des développeurs et des réviseurs de conformité devraient emprunter. Aucun outil CLI requis, aucun nœud Bitcoin requis.
Étape 3 (facultative) : vérifier avec les outils OpenTimestamps standards
Le format .ots est ouvert. Si votre processus exige une chaîne d’outils totalement indépendante — ou si vous le préférez simplement — vous pouvez prendre le fichier de reçu et le vérifier contre la blockchain Bitcoin à l’aide des outils de vérification OpenTimestamps standards et d’un nœud Bitcoin ou d’un client léger. C’est la « méthode difficile », et elle est complètement facultative. La preuve est indépendante du prestataire par conception : seuls SHA-256 et les données de blocs Bitcoin sont impliqués.
Étape 4 : confirmer le résultat
Une vérification réussie vous donne deux résultats concrets :
- La hauteur de bloc Bitcoin où votre racine de Merkle a été ancrée.
- L’horodatage du bloc, qui établit la borne supérieure du moment où votre hachage de commit a pu exister.
Voilà votre preuve : non pas « Timestamp GIT l’affirme », mais « ce hachage est prouvablement contenu dans un arbre de Merkle dont la racine est inscrite dans le bloc Bitcoin N ».
Utiliser les outils de vérification intégrés de Timestamp GIT
Au-delà du vérificateur par date, trois outils méritent d’être connus.
La page de statut publique
https://timestampgit.dev/status/{user}/{repo}
Il s’agit d’un tableau de bord public montrant la longévité des preuves, votre date d’ancrage la plus ancienne, la régularité quotidienne, les données de bloc et de transaction Bitcoin derrière chaque ancre, et une carte de chaleur calendaire de la couverture. Si vous faites une diligence raisonnable sur un dépôt — le vôtre ou celui de quelqu’un d’autre — commencez ici. Elle expose aussi un CSV d’audit téléchargeable et un certificat PDF.
La page de vérification
Traitée ci-dessus, mais il vaut la peine de la rappeler comme outil principal :
https://timestampgit.dev/verification/{user}/{repo}/{date}
Vérification de la chaîne de Merkle, dans le navigateur, pour l’horodatage d’un jour précis.
Badges et certificats
Des badges intégrables sont disponibles pour votre README afin d’afficher publiquement le statut de vérification. N’importe qui peut cliquer sur le lien attaché au badge et vérifier l’horodatage via le site web. Pour les dossiers d’audit, téléchargez le certificat PDF pour une date spécifique.
Si votre dépôt est privé, notez que les dépôts privés ajoutent un HMAC chiffré à l’URL — le HMAC est spécifique à l’instance serveur, de sorte que seuls les utilisateurs autorisés peuvent voir le statut de ce dépôt. Votre flux de vérification reste inchangé ; l’URL est simplement restreinte.
Interprétation des résultats et cas limites
Ce que signifie réellement une vérification réussie
Elle prouve que le hachage de commit existait au plus tard à l’horodatage du bloc Bitcoin. Pas « exactement à », et pas « le code a été écrit à ce moment-là » — elle prouve que le hachage existait au plus tard à ce bloc. Aux fins d’antériorité, c’est exactement l’affirmation dont vous avez besoin : vous disposiez de cet artefact à la date X ou avant.
Preuves en attente
Si vous consultez un dépôt le lendemain matin d’un commit et que la preuve semble incomplète, c’est normal. Le cron worker nocturne regroupe les hachages, construit l’arbre et l’ancre ; la confirmation Bitcoin prend ensuite quelques heures (normalement environ 3). Une fois confirmé, l’horodatage est immuable. Attendez, puis revérifiez — rien n’est cassé.
La frontière du zero-knowledge
La vérification opère sur les hachages de commits, jamais sur votre code source. Timestamp GIT ne voit, ne copie ni ne stocke jamais votre source réelle. La preuve confirme qu’un hachage existait ; elle ne révèle rien sur le contenu du code. C’est délibéré, et c’est pourquoi le même flux de vérification fonctionne pour les dépôts à code fermé et à secrets industriels.
Quand les choses tournent mal
- Fichier
.otsmanquant — récupérez-le depuis la branche de timestamps, le dépôt fantôme, ou votre tableau de bord. - Reçu corrompu — retéléchargez-le depuis le dépôt ou le tableau de bord ; les données ancrées côté Bitcoin ne sont pas affectées, donc une copie fraîche du reçu restaure la vérification.
Équipes qui veulent encore moins d’exposition
La GitHub App gérée de Timestamp GIT est la voie sans configuration — accès en lecture seule au dépôt source, lecture-écriture au dépôt cible, et les preuves arrivent automatiquement. Pour les équipes qui ne veulent pas que le service lise ne serait-ce qu’un hachage de commit, le mode Enterprise ZK emprunte une autre voie : une GitHub Action de 12 lignes s’exécute sur votre infrastructure et ne pousse que le hachage de commit vers l’API Timestamp GIT. Votre source ne quitte jamais votre environnement.
Automatiser la vérification pour la conformité
Les vérifications manuelles conviennent pour un audit ponctuel. Si vous gérez une conformité continue, intégrez-la dans la CI ou vos outils internes.
Récupérer les données de vérification via l’API
La chaîne de Merkle complète pour un jour spécifique :
curl -s "https://timestampgit.dev/api/verify/acme-corp/payments-api/2026-09-14" \
-o verify-2026-09-14.json
Points de terminaison de statut publics (aucune authentification requise) :
# Last anchored Bitcoin block info
curl -s "https://timestampgit.dev/api/statusLast/acme-corp/payments-api"
# Total stamped commit count
curl -s "https://timestampgit.dev/api/statusCount/acme-corp/payments-api"
# Combined summary, useful for Shields.io badges
curl -s "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api"
Récupérer les registres d’audit et les certificats
# Full audit ledger as CSV
curl -s "https://timestampgit.dev/api/audit/acme-corp/payments-api" -o audit.csv
# PDF certificate for a single date
curl -s "https://timestampgit.dev/api/report/acme-corp/payments-api/2026-09-14" \
-o certificate-2026-09-14.pdf
Un garde-fou CI minimal — faire échouer le build si l’ancre la plus récente est obsolète — ressemble à ceci :
#!/usr/bin/env bash
set -euo pipefail
REPO_PATH="acme-corp/payments-api"
LAST=$(curl -s "https://timestampgit.dev/api/statusLast/${REPO_PATH}")
BLOCK=$(echo "$LAST" | python3 -c "import sys,json; print(json.load(sys.stdin).get('blockHeight',''))")
if [ -z "$BLOCK" ]; then
echo "No anchored Bitcoin block found for ${REPO_PATH}. Check nightly anchoring."
exit 1
fi
echo "Latest anchor confirmed in Bitcoin block ${BLOCK}"
Vérification en environnement isolé avec Docker
Pour une sécurité maximale et les environnements isolés, Timestamp GIT est disponible 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
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
L’application est disponible à l’adresse http://localhost:8080 après le démarrage. Au premier lancement, un assistant de configuration vous guide pour connecter votre GitHub App et configurer votre instance. Une licence de démonstration à durée limitée peut être demandée depuis la page Docker License avec votre nom, votre entreprise, votre e-mail et un numéro de téléphone facultatif, et le fichier de licence de démonstration est téléchargeable une fois délivré.
FAQ
Dois-je exécuter des outils en ligne de commande pour vérifier une preuve Timestamp GIT ? Non. Timestamp GIT fournit un vérificateur web qui effectue tous les calculs localement dans votre navigateur. Vous pouvez aussi utiliser les outils OpenTimestamps standards si vous préférez, mais ce n’est pas obligatoire.
Combien de temps faut-il pour qu’une preuve devienne vérifiable ? Après l’ancrage nocturne, il faut quelques heures (généralement environ 3) pour que la transaction Bitcoin soit confirmée. Une fois confirmée, la preuve est immédiatement vérifiable.
Puis-je vérifier une preuve sans faire confiance à Timestamp GIT ?
Oui. Le fichier .ots contient toutes les données cryptographiques nécessaires, et vous pouvez le vérifier contre la blockchain Bitcoin à l’aide d’outils open source. Le vérificateur de Timestamp GIT s’exécute aussi localement, donc aucune confiance en nos serveurs n’est nécessaire.
Que faire si je perds le fichier .ots ?
Vous pouvez le récupérer depuis la branche de timestamps ou le dépôt fantôme de votre dépôt. Si vous êtes un utilisateur de Timestamp GIT, vous pouvez aussi le télécharger depuis votre tableau de bord.
Conclusion
La vérification locale, c’est la différence entre « une entreprise me l’a affirmé » et « je l’ai vérifié moi-même contre la blockchain Bitcoin ». Avec Timestamp GIT, la partie vérification prend quatre étapes et zéro outil CLI : récupérez le fichier .ots, ouvrez la page de vérification, lisez la hauteur de bloc, terminé. Le gros du travail — détection des commits, regroupement nocturne, construction de l’arbre de Merkle, soumission aux calendriers OTS, ancrage Bitcoin et renvoi des preuves dans votre dépôt — se fait automatiquement une fois la GitHub App installée.
Commencez sur timestampgit.dev, installez la GitHub App sur un dépôt, et vérifiez votre première preuve demain. Pour les dépôts privés et les workflows de conformité continue, les offres Pro Agency et Enterprise ZK couvrent le reste.
Articles similaires
- GitHub App qui horodate automatiquement les commits
- Comment les freelances peuvent prouver la propriété du code avant un litige
- Qu’est-ce que l’antériorité cryptographique ? Un guide pour les équipes logicielles