Comment vérifier une preuve d’horodatage Bitcoin dans votre navigateur
Une preuve d’horodatage ne vaut quelque chose qu’à l’instant où quelqu’un la vérifie. Jusque-là, ce n’est qu’un fichier au nom séduisant — un reçu .ots qui traîne dans une branche, un badge dans un README, un PDF que personne n’a ouvert. La question qui décide si votre antériorité résistera à un contrôle juridique, à un litige de paiement ou à un audit de due diligence est précise : un tiers peut-il confirmer que ce hash de commit exact existait avant une date donnée, sans demander au fournisseur de s’en porter garant ?
C’est ce que résout la vérification dans le navigateur. Cet article détaille la vérification de bout en bout d’une preuve Timestamp GIT — ce que contiennent les artefacts, quelles pages et quels points de terminaison utiliser, et comment lire le résultat lorsqu’il est valide, en attente ou en échec. Ce n’est pas une leçon sur les transactions Bitcoin ; tout l’intérêt du workflow géré est que vous ne touchez jamais à cette couche.
Pourquoi la vérification dans le navigateur compte
La vérification est le moment où un horodatage cryptographique cesse d’être une affirmation pour devenir une preuve. Tout ce qui précède — le hachage des commits, le regroupement des manifestes, l’ancrage d’une racine de Merkle dans Bitcoin — n’est que de la mécanique. La preuve se vérifie à l’autre bout, ou pas.
Deux propriétés font du navigateur le bon endroit pour ce contrôle :
Le calcul reste local. Les pages de vérification de Timestamp GIT exécutent chaque étape de la chaîne de Merkle dans votre navigateur. Personne ne voit quel dépôt, quelle date ou quel commit vous vérifiez. Pour un fournisseur, ce serait une conception étrange ; pour un système de preuve à divulgation nulle de connaissance, c’est la seule correcte. Vous vérifiez une preuve, vous ne demandez pas un verdict.
Aucune installation, aucune confiance aveugle. Les équipes de conformité et les conseils externes ne vont pas git clone une branche et compiler des outils. Ils ont besoin d’un contrôle indépendant et reproductible qui donne la même réponse à chaque fois. Une URL et un navigateur suffisent. Un point de terminaison d’API public aussi, si vous préférez scripter le contrôle dans la CI.
Cela compte parce que l’alternative — faire confiance au tableau de bord d’un fournisseur — est précisément ce dont vous cherchez à vous affranchir. Voir Git Commit Timestamps Aren’t Tamper-Proof — What Is pour comprendre pourquoi les journaux internes sont d’emblée écartés lors des audits.
Ce que contient réellement une preuve d’horodatage Bitcoin
Avant de vérifier quoi que ce soit, sachez ce que vous avez entre les mains. Une preuve Timestamp GIT pour un jour donné se compose de trois artefacts superposés :
- Manifeste quotidien — un simple fichier
.txtlistant les hash de commits ancrés ce jour-là pour un dépôt donné. Il contient des hash, jamais de code. - Reçu
.ots— une preuve OpenTimestamps qui relie le hash SHA-256 du manifeste à un bloc Bitcoin spécifique. - Chaîne de Merkle — la structure qui relie les deux. Votre hash de commit individuel est une feuille, le manifeste est le niveau supérieur, et la racine de Merkle est la valeur unique qui est intégrée dans Bitcoin.
Vérifier signifie donc gravir cette chaîne dans le bon sens : prenez votre hash de commit, combinez-le avec ses voisins comme spécifié par le manifeste, produisez le hash du manifeste, puis vérifiez le reçu .ots par rapport à l’en-tête du bloc Bitcoin.
La propriété essentielle est que le reçu est indépendant du fournisseur. Il n’utilise que SHA-256 et les données publiques des blocs Bitcoin. Si Timestamp GIT disparaissait demain, le reçu se vérifierait toujours par rapport à la blockchain avec des outils ouverts. Ce n’est pas un argument marketing — c’est une contrainte du format de preuve, et c’est pourquoi la vérification dans le navigateur peut être honnête.
Ces fichiers résident dans une branche timestamps dédiée (ou un dépôt miroir séparé), de sorte qu’ils sont versionnés aux côtés de votre code sans jamais exposer le contenu des sources.
Étape par étape : vérifier une preuve dans votre navigateur
Voici le parcours complet, de « j’ai un dépôt » à « voici l’artefact qu’un auditeur peut conserver ».
1. Commencez par la page de statut du dépôt
Ouvrez la page de statut publique du dépôt :
https://timestampgit.dev/status/{user}/{repo}
C’est votre vue d’ensemble, et elle répond à la plupart des premières questions : la longévité de la preuve (jusqu’où remonte la chaîne), la date du premier ancrage, si l’ancrage a été quotidien et régulier, ainsi que les données de bloc et de transaction Bitcoin pour chaque jour. Une carte de chaleur calendaire rend les lacunes visibles d’un coup d’œil, avec en plus des téléchargements du registre d’audit complet (CSV) et d’un certificat PDF.
Si vous n’avez besoin que d’un résumé lisible par machine, les points de terminaison de statut publics renvoient les mêmes chiffres essentiels :
curl -s https://timestampgit.dev/api/statusLast/acme/payments-service
curl -s https://timestampgit.dev/api/statusCount/acme/payments-service
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-service
2. Ouvrez la page de vérification pour une date spécifique
Pour un contrôle de preuve réel, rendez-vous à la date qui vous intéresse :
https://timestampgit.dev/verification/{user}/{repo}/{date}
La page vous guide à travers chaque niveau de la chaîne de Merkle, étape par étape — du hash de commit au manifeste, du manifeste à la racine de Merkle, de la racine de Merkle au bloc Bitcoin. Chaque hash est recalculé dans votre navigateur. Rien de votre contrôle n’est transmis, ce qui le rend utilisable pour des dépôts confidentiels.
C’est la page à envoyer à un avocat. Elle ne nécessite ni compte, ni CLI, ni explication de ce qu’est OpenTimestamps.
3. Utilisez le badge comme point d’entrée public
Les badges intégrables sont la version à faible friction de la même chose. Ajoutez-en un à votre README et n’importe qui — auditeur, acquéreur, conseil adverse — peut cliquer vers la vérification sans connaître la structure de votre dépôt.
Le widget d’intégration de badge à /connected/{user}/{repo} vous donne un aperçu en direct ainsi que l’extrait Markdown. Le badge lui-même s’appuie sur le point de terminaison de résumé, il reflète donc de vraies données ancrées plutôt qu’une image statique.
Les badges relèvent d’une décision de divulgation, pas de sécurité : ils exposent le fait que vous horodatez, pas ce que vous avez écrit.
4. Vérifiez par programmation avec l’API publique
Pour les pipelines CI ou un script de conformité, récupérez les données de la chaîne de Merkle et vérifiez localement :
curl -s "https://timestampgit.dev/api/verify/acme/payments-service/2026-10-14" \
-o chain.json
La réponse contient la chaîne complète pour ce jour. Votre script recalcule ensuite les hash lui-même — les mêmes calculs que la page du navigateur :
// Node 18+ — recompute each Merkle step locally, never trust the server's answer
import { createHash } from "node:crypto";
const sha256 = (hex) =>
createHash("sha256").update(Buffer.from(hex, "hex")).digest("hex");
const chain = JSON.parse(await readFile("chain.json", "utf8"));
// Walk leaf -> root. Each step concatenates the current hash with its sibling,
// hashes the pair, and continues. The final value must equal the anchored root.
let current = sha256(commitSha);
for (const step of chain.steps) {
const [left, right] = step.order === "lr" ? [current, step.sibling] : [step.sibling, current];
current = sha256(left + right);
}
console.log(current === chain.merkleRoot ? "PROOF OK" : "PROOF MISMATCH");
L’intérêt de le faire vous-même est qu’un contrôle scripté constitue une preuve reproductible du contrôle, et qu’il ne dépend pas du rendu correct d’un tableau de bord.
5. Téléchargez le certificat PDF
Lorsque vous avez besoin de quelque chose à joindre à un e-mail ou à un contrat, la page de statut propose un certificat PDF par date, également disponible directement :
https://timestampgit.dev/api/report/{user}/{repo}/{date}
Et pour le registre complet plutôt qu’un seul jour :
curl -s https://timestampgit.dev/api/audit/acme/payments-service -o audit.csv
Interpréter les résultats et gérer les cas limites
Une preuve valide a une signification précise, et plus étroite qu’on ne le suppose.
- Ce que dit une preuve valide : ce hash de commit existait au moment de ce bloc Bitcoin ou avant. Rien de plus, rien de moins. Elle ne dit pas que le code compile, qu’il est original ou qu’il est bon. L’antériorité porte sur l’existence et la datation.
- Ce que signifie « en attente » : le worker nocturne regroupe les hash après minuit, construit l’arbre de Merkle et ancre la racine. La confirmation Bitcoin prend ensuite plusieurs heures — normalement environ 3 heures — et les fichiers de preuve sont réécrits dans votre dépôt une fois confirmés. Les commits du jour n’auront généralement pas de preuve définitive avant le lendemain.
- Dépôts privés : les URL de statut des dépôts privés incluent un HMAC chiffré propre à l’instance serveur, de sorte que seuls les utilisateurs autorisés peuvent lire le statut. La vérification s’exécute toujours localement dans le navigateur, et le reçu
.otset le manifeste sous-jacents peuvent être contrôlés sans exposer le contenu du dépôt. - Si une preuve échoue : vérifiez d’abord les évidences — bon dépôt, bonne date, bon manifeste. Un reçu
.otsne se vérifie que par rapport au hash de manifeste pour lequel il a été créé ; l’associer au manifeste d’un autre jour échouera correctement, mais de façon déroutante. - Environnements isolés (air-gapped) : la licence Docker auto-hébergée exécute toute la pile — y compris l’interface de vérification et l’API — sur votre propre infrastructure, de sorte que la vérification ne quitte jamais votre réseau.
Comment Timestamp GIT rend la vérification automatique
Si tout ce qui précède tient en une page et non en un projet de week-end, c’est parce que l’ancrage est entièrement géré. Vous installez l’application GitHub une fois sur un dépôt surveillé, et chaque commit est ancré automatiquement dans Bitcoin chaque nuit. Aucun outil CLI, aucune étape de protocole manuelle, rien à exécuter sur les machines des développeurs — ce qui explique aussi pourquoi le workflow ne dépend de la mémoire de personne.
Derrière cela, le pipeline regroupe les hash de commits dans une file d’attente, les groupe à minuit en fichiers de manifeste par dépôt, construit un arbre de Merkle, crée des preuves OpenTimestamps par rapport aux calendriers publics, et ancre la racine dans Bitcoin. Les fichiers de preuve sont ensuite poussés vers une branche timestamps ou un dépôt miroir. Pour les équipes qui ont besoin que le code source reste totalement hors de portée du service, le mode Enterprise ZK utilise une GitHub Action de 12 lignes qui ne pousse que les hash de commits depuis votre propre infrastructure — le service produit des preuves vérifiables sans accès en lecture au dépôt source.
Si vous avez besoin d’une vérification auto-hébergée, 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 ; un assistant de configuration au premier lancement vous guide pour connecter votre application GitHub et configurer l’instance. Une licence de démonstration à durée limitée pour l’évaluation est disponible sur la page Docker License.
FAQ
Dois-je installer un logiciel pour vérifier une preuve d’horodatage Bitcoin ?
Non. Les pages de vérification de Timestamp GIT s’exécutent entièrement dans votre navigateur, et les points de terminaison d’API publics renvoient les données de la chaîne de Merkle pour des contrôles locaux. Vous pouvez aussi télécharger le reçu .ots et le vérifier hors ligne avec les outils OpenTimestamps standard si vous préférez.
Puis-je vérifier une preuve sans faire confiance à Timestamp GIT ?
Oui. La preuve ne repose que sur SHA-256 et les données des blocs Bitcoin, elle est donc indépendante du fournisseur. Vous pouvez vérifier le reçu .ots par rapport à la blockchain Bitcoin avec des outils ouverts, même si Timestamp GIT n’existe plus.
Et si la transaction Bitcoin de ma preuve n’est pas encore confirmée ? La confirmation Bitcoin prend généralement environ 3 heures. Tant que la transaction n’est pas confirmée dans un bloc, la preuve est en attente ; après confirmation, elle devient immuable et peut être vérifiée dans votre navigateur.
Comment vérifier une preuve pour un dépôt privé ?
Les URL de statut des dépôts privés incluent un HMAC chiffré, de sorte que seuls les utilisateurs autorisés peuvent les consulter. Vous pouvez aussi télécharger le reçu .ots et le manifeste depuis la branche timestamps et les vérifier localement sans exposer les données du dépôt.
Conclusion
La vérification dans le navigateur est ce qui transforme un horodatage d’un enregistrement interne en quelque chose que vous pouvez remettre à quelqu’un qui ne vous fait pas confiance — le seul public qui compte dans un litige. Le contrôle prend une URL, une date et quelques secondes de hachage local, et il produit une réponse ancrée dans Bitcoin plutôt que dans la base de données d’un fournisseur.
Si vous n’avez pas encore mis cela en place, la séquence est courte : connectez un dépôt à Timestamp GIT via l’application GitHub, laissez la tâche nocturne ancrer vos commits, puis ouvrez la page de statut et vérifiez une date de bout en bout. Cette unique vérification réussie fait la différence entre « nous avons des journaux » et « nous avons une preuve ». Si vous voulez d’abord la configuration sans CLI, lisez ensuite How to Timestamp Git Commits Without the Command Line.
Articles similaires
- How to Timestamp Git Commits Without the Command Line
- Timestamp GIT Alternatives: What to Compare First
- Git Commit Timestamps Aren’t Tamper-Proof — What Is