Timestamp GIT

← Tous les articles

2026-11-06

OpenTimestamps sans CLI : horodatage Bitcoin géré

OpenTimestamps sans CLI : horodatage Bitcoin géré
timestamp git blockchain proof

OpenTimestamps sans la CLI : l’horodatage Bitcoin géré

Si vous avez déjà cherché à prouver qu’un morceau de code existait à une date précise, vous avez probablement croisé OpenTimestamps. Vous avez aussi probablement croisé la partie que personne ne met dans le titre : la ligne de commande, les calendriers, les fichiers .ots, et ce vague sentiment qu’il vous faut maintenant comprendre les transactions Bitcoin.

Cet article est OpenTimestamps expliqué sans la CLI. Non pas parce que le protocole est mauvais — il est vraiment excellent — mais parce que la ligne de commande est un détail d’implémentation, pas une obligation. Il existe une voie gérée où une GitHub App surveille votre dépôt et ancre chaque commit dans Bitcoin pendant que vous dormez. Vous l’installez une fois. Vous ne tapez jamais la moindre commande d’horodatage.

Nous allons voir ce que fait réellement OpenTimestamps, pourquoi l’analogie avec le notaire colle presque parfaitement, ce qui se passe sous le capot chaque nuit, et les idées reçues qui empêchent les équipes de l’adopter. La mécanique brute du protocole est traitée ici comme un contexte ; l’accent porte sur le flux de travail automatisé et ce qu’il vous apporte.

Qu’est-ce qu’OpenTimestamps sans la CLI ?

OpenTimestamps est un protocole permettant de prouver que des données existaient à un moment donné ou avant celui-ci. Il y parvient en agrégeant les données dans un arbre de Merkle, en hachant la racine, et en inscrivant cette racine dans un bloc Bitcoin. Comme les blocs Bitcoin sont immuables et répliqués mondialement, l’ancrage devient un registre public d’existence, inviolable et vérifiable.

La CLI n’est qu’une interface parmi d’autres vers ce protocole. Un service web, une GitHub App ou un worker planifié peuvent faire exactement la même chose — et le faire mieux, car le regroupement par lots et la gestion des calendriers sont précisément les tâches où l’humain est mauvais.

L’approche gérée ressemble à ceci : vous installez la GitHub App Timestamp GIT sur un dépôt. À partir de là, chaque commit est détecté automatiquement, regroupé chaque nuit, et ancré dans Bitcoin via OpenTimestamps. Les preuves reviennent dans votre dépôt sous forme de fichiers de reçu et de manifestes. Aucune commande, aucun outil local, aucun nœud Bitcoin.

Pour être explicite sur le périmètre : cet article explique le concept et le flux de travail géré. Il ne vous guide pas à travers les opérations brutes du protocole. Si vous voulez approfondir des sujets connexes, consultez comment vérifier une preuve d’horodatage Bitcoin dans votre navigateur et pourquoi votre journal Git n’est pas une preuve.

Une analogie simple : le notaire pour votre code

Imaginez un notaire. Vous lui remettez un document. Il ne le lit pas. Il calcule un sceau inviolable sur ce document, l’horodate, et consigne ce sceau dans un registre public que chacun peut consulter. Plus tard, si quelqu’un conteste la date, vous produisez le document, recalculez le sceau, et pointez l’entrée du registre.

OpenTimestamps, c’est ce notaire, avec deux améliorations :

  • Le « document » est un hash, pas votre code. Git produit déjà un hash unidirectionnel unique (SHA-1 ou SHA-256) pour chaque commit, représentant l’état exact de votre dépôt à cet instant. Ce hash est l’empreinte. Timestamp GIT ne manipule jamais que l’empreinte.
  • Le registre est la blockchain Bitcoin. Au lieu du registre relié d’un notaire dans une armoire, le sceau est consigné dans un bloc que des milliers de nœuds indépendants répliquent. Personne — ni vous, ni nous, ni une injonction judiciaire — ne peut le réécrire.

La troisième amélioration est celle qui compte au quotidien : avec Timestamp GIT, le notaire vous rend visite automatiquement chaque nuit. Sans rendez-vous, sans file d’attente, sans paperasse. Vous commitez du code ; l’horodatage se fait selon un calendrier auquel vous ne pensez jamais.

Comment ça fonctionne sous le capot (brièvement)

Trois étapes, et seule celle du milieu implique quoi que ce soit qui ressemble à de l’infrastructure.

Étape 1 — L’empreinte. Quand vous commitez, Git génère un hash unique pour ce commit. Timestamp GIT ne collecte que ces hashs. Votre code source n’est jamais lu, copié ni stocké.

Étape 2 — L’ancrage. Un worker cron de minuit regroupe tous les hashs en attente, construit un arbre de Merkle natif par dépôt, crée un fichier manifeste .txt, et ancre la racine de Merkle dans Bitcoin via les calendriers publics OpenTimestamps.

Étape 3 — La preuve. Le manifeste et les fichiers de reçu .ots sont poussés dans votre dépôt — dans une branche dédiée aux horodatages ou dans un dépôt miroir séparé. De là, chacun peut vérifier hors ligne par rapport aux données des blocs Bitcoin.

Deux détails opérationnels à connaître :

  • La confirmation Bitcoin prend plusieurs heures, généralement environ trois. L’écriture des preuves s’achève donc quelques heures après le lot nocturne, pas instantanément.
  • La vérification est indépendante du fournisseur. La preuve ne repose que sur SHA-256 et les données des blocs Bitcoin. Aucun format propriétaire, aucun verrouillage.

Voici, conceptuellement, la forme de ce que produit un lot nocturne :

timestamps/
├── 2026-11-05/
│   ├── manifest.txt        # commit hashes for the day
│   └── manifest.txt.ots    # OpenTimestamps receipt for the Merkle root
└── 2026-11-06/
    ├── manifest.txt
    └── manifest.txt.ots

Les reçus sont l’artefact que vous conservez. Tout le reste n’est que confort.

Pourquoi l’horodatage géré compte

Faire tourner le protocole soi-même est possible. C’est aussi un projet de maintenance : fiabilité des calendriers, logique de regroupement, gestion des confirmations Bitcoin, stockage des reçus, et une histoire de vérification pour les auditeurs. Pour la plupart des équipes, c’est une distraction par rapport au produit réel.

Un service géré élimine ces pièces mobiles :

  • Aucune connaissance du protocole requise. Vous n’avez pas besoin d’apprendre les serveurs de calendrier, les preuves de Merkle ou la structure des transactions Bitcoin. La voie difficile existe ; vous êtes autorisé à l’éviter.
  • Des preuves recevables en justice et indépendantes du fournisseur. La preuve vit dans Bitcoin, pas dans notre base de données. Chacun peut la vérifier sans nous faire confiance.
  • Intégration au flux de travail. Installez la GitHub App une fois. Chaque commit suivant est ancré automatiquement. Aucune habitude à changer, rien à installer sur les machines des développeurs.
  • Surface de conformité. Des badges de vérification publics pour les fichiers README, des CSV d’audit téléchargeables et des certificats PDF par date donnent aux auditeurs quelque chose de concret à examiner.

Pour les agences et les indépendants, ce dernier point fait un vrai travail lors des litiges de paiement et des revendications de paternité. Pour les entreprises, c’est un bouclier contre les trolls de brevets qui revendiquent des droits sur des choses déjà en production dans des systèmes internes.

Idées reçues courantes sur OpenTimestamps

« Il faut être expert en Bitcoin. » Vous devez faire confiance aux mathématiques, pas à l’expertise. Avec un service géré, la complexité est prise en charge : le regroupement, l’ancrage et la livraison des preuves se font selon un calendrier. Vous interagissez avec un tableau de bord et une branche de votre dépôt.

« L’horodatage expose mon code source. » Non. Seuls les hashs de commit sont ancrés. Le service ne voit, ne copie ni ne stocke jamais votre code — le principe de connaissance zéro est architectural, pas une promesse contractuelle. En mode Enterprise ZK, la soumission du hash s’exécute comme une GitHub Action sur votre propre infrastructure, ne poussant que le hash vers l’API, si bien que le service n’a aucun accès en lecture au dépôt source.

« Les preuves ne valent que ce que vaut le fournisseur. » Les preuves sont natives de Bitcoin. Vous pouvez télécharger les fichiers de reçu .ots et les vérifier hors ligne à l’aide de la vérification OpenTimestamps standard par rapport à la blockchain. Si Timestamp GIT disparaissait demain, vos preuves resteraient valides.

« C’est cher et lent. » Le regroupement quotidien permet à de nombreux commits de partager un seul ancrage Bitcoin, ce qui explique pourquoi l’économie fonctionne. La confirmation prend quelques heures — acceptable pour une preuve d’antériorité, qui se juge en mois et en années, pas en minutes.

Premiers pas sans la CLI

Il existe deux modes de déploiement, et aucun ne nécessite de terminal sur les machines des développeurs.

Mode standard (GitHub App). Installez la GitHub App sur les dépôts que vous souhaitez surveiller. Elle lit automatiquement le hash du commit HEAD et écrit les preuves dans une branche dédiée — soit dans le même dépôt, soit dans un dépôt cible séparé. Le modèle de permissions de GitHub exige au minimum un accès en lecture seule au dépôt source (il n’existe pas de permission limitée au hash de commit), plus un accès en lecture-écriture au dépôt cible.

Mode Enterprise ZK. Une GitHub Action de 12 lignes s’exécute sur votre infrastructure et ne pousse que le hash de commit vers l’API Timestamp GIT. Ici, vous n’avez besoin que d’un accès en lecture-écriture au dépôt cible, et d’aucun accès en lecture au dépôt source. Choisissez ce mode quand même la visibilité des hashs doit rester à l’intérieur de votre périmètre.

Dans les deux cas, la séquence après l’installation est sans surprise : les commits sont détectés, les hashs sont mis en file, le worker nocturne les ancre, et les preuves apparaissent dans votre branche d’horodatages quelques heures après la confirmation Bitcoin.

Auto-hébergement avec Docker

Pour les environnements isolés ou à sécurité maximale, Timestamp GIT est distribué 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

Lancez-le :

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 l’instance. Une licence de démonstration à durée limitée pour l’évaluation peut être demandée depuis la page Docker License avec votre nom, votre entreprise, votre e-mail et, en option, votre numéro de téléphone ; le fichier de licence est téléchargeable immédiatement.

Ce que vous obtenez une fois en marche

  • Un tableau de bord de statut public par dépôt : longévité des preuves, date d’ancrage la plus ancienne, régularité quotidienne, données de bloc et de transaction Bitcoin, une carte de chaleur calendaire, et un CSV d’audit et un certificat PDF téléchargeables.
  • Des badges de vérification pour votre README, avec un lien que chacun peut suivre pour vérifier l’horodatage. Les dépôts privés ajoutent un HMAC chiffré à l’URL afin que seuls les utilisateurs autorisés voient le statut.
  • Un vérificateur dans le navigateur qui effectue localement la vérification de la chaîne de Merkle à plusieurs niveaux, si bien que personne ne voit ce que vous vérifiez.
  • Une API REST si vous voulez scripter les vérifications de statut : /api/statusLast/{user}/{repo}, /api/statusCount/{user}/{repo}, /api/audit/{user}/{repo}, et autres.
# Check the last anchored Bitcoin block for a repo
curl https://timestampgit.dev/api/statusLast/youruser/yourrepo

Les offres correspondent à vos besoins de confidentialité : Open Source pour les dépôts publics, Pro Agency pour les dépôts privés, et Enterprise ZK pour l’isolation basée sur GitHub Action. Les détails sont sur la page de tarification.

FAQ

Dois-je installer un logiciel ou exécuter des commandes pour utiliser OpenTimestamps avec Timestamp GIT ?

Non. Timestamp GIT est une GitHub App gérée. Vous l’installez une fois, et elle horodate automatiquement vos commits chaque nuit. Aucun outil CLI à installer, aucune commande à exécuter.

Comment Timestamp GIT garantit-il la confidentialité de mon code source ?

Timestamp GIT fonctionne selon un principe de connaissance zéro : il ne traite que les hashs de commit Git, jamais votre code source réel. En mode Enterprise ZK, même les hashs sont poussés depuis votre infrastructure via une GitHub Action, si bien que le service n’a jamais d’accès en lecture à votre dépôt.

Puis-je vérifier les horodatages de façon indépendante sans faire confiance à Timestamp GIT ?

Oui. Les preuves sont ancrées dans la blockchain Bitcoin à l’aide du protocole OpenTimestamps. Vous pouvez télécharger les fichiers de reçu .ots et les vérifier hors ligne à l’aide de la vérification OpenTimestamps standard, ou utiliser le vérificateur intégré dans le navigateur qui s’exécute localement.

Que se passe-t-il si Timestamp GIT cesse son activité ?

Vos preuves restent valides car elles sont inscrites dans la blockchain Bitcoin. La vérification ne repose que sur Bitcoin et SHA-256, vous pouvez donc continuer à prouver l’existence de votre code de façon indépendante.

Conclusion

OpenTimestamps résout un vrai problème — prouver que des données existaient à un moment précis — et il le résout avec rien d’autre que du hachage et Bitcoin. La ligne de commande n’a jamais été l’essentiel. Ce n’était que la première interface.

L’interface gérée est mieux adaptée à la façon dont les équipes travaillent réellement : installez une GitHub App, continuez à commiter, et laissez une tâche nocturne ancrer les hashs. Vous obtenez des reçus .ots, une branche de manifestes, des badges de vérification, des CSV d’audit et des certificats PDF — le tout adossé à des preuves qui survivent au fournisseur.

Si vous voulez la version automatisée, installez Timestamp GIT sur un dépôt et commitez quelque chose. C’est toute la configuration. Le notaire se présente ce soir.

EU label: AI-generated content