Timestamp GIT

← Tous les articles

2026-10-11

Ancrage automatique nocturne des commits Git sur Bitcoin, zéro étape manuelle

Ancrage automatique nocturne des commits Git sur Bitcoin, zéro étape manuelle
timestamp git blockchain proof

Ancrage automatique nocturne des commits Git dans Bitcoin, zéro étape manuelle

La façon la plus courante pour les équipes d’« horodater » un commit est qu’un humain se souvienne de le faire.

Quelqu’un termine une fonctionnalité, se rappelle que le commit devrait être ancré, et exécute le workflow OpenTimestamps à la main — de la manière la plus pénible — puis sauvegarde le reçu quelque part. Deux semaines plus tard, personne ne se souvient si le reçu de ce mardi existe. Un autre développeur rejoint l’équipe, ne connaît pas le rituel, et six mois de commits passent sans être horodatés.

C’est le piège de l’horodatage manuel : une couverture de preuve qui dépend de la mémoire. Cela fonctionne très bien dans une démo et s’effondre à l’échelle d’une équipe, d’un rythme de sprint et d’une année de turnover. L’ancrage automatique nocturne des commits Git dans Bitcoin inverse le problème : l’ancrage cesse d’être une tâche qu’une personne exécute pour devenir une propriété de votre dépôt. Vous installez une GitHub App une seule fois, et chaque commit est regroupé et ancré pendant que vous dormez.

Cet article parcourt ce chemin automatisé de bout en bout — configuration, pipeline, supervision, auto-hébergement — et s’adresse aux développeurs et aux responsables conformité qui se soucient que la preuve survive à un audit, pas de surveiller une tâche cron.

Le piège de l’horodatage manuel (et comment l’automatisation l’élimine)

Horodater manuellement des commits présente trois modes de défaillance, et tous les trois sont structurels plutôt que personnels :

  • Dépendance à la mémoire. Quelqu’un doit se souvenir d’exécuter l’outillage au bon moment, idéalement avant que le travail ne soit public. En retard équivaut à jamais pour ce qui est de l’antériorité.
  • Défaillances silencieuses. Quand une exécution manuelle échoue — hoquet réseau, calendrier expiré, mauvais répertoire — rien ne plante. Vous avez simplement une lacune dans la couverture que vous découvrez un an plus tard, pendant le litige pour lequel vous aviez besoin de la preuve.
  • Dispersion des reçus. Les reçus finissent sur des ordinateurs portables, dans des fils Slack, dans un lecteur partagé que personne ne possède. Une preuve que vous ne pouvez pas retrouver est une preuve que vous n’avez pas.

Rien de tout cela ne passe à l’échelle. Un développeur solo pourra maintenir le rituel pendant quelques mois. Une équipe de dix ne le fera pas, et une agence gérant le travail de clients sur des dizaines de dépôts n’a aucune chance. Chaque nuit manquée est un trou permanent dans l’historique, car vous ne pouvez pas ancrer rétroactivement un hash qui n’a jamais été capturé.

Timestamp GIT est l’alternative managée sans configuration : une GitHub App qui capture automatiquement les hashs de commits, les regroupe et les ancre dans la blockchain Bitcoin via le protocole OpenTimestamps chaque nuit. Aucun outil en ligne de commande, aucun reçu manuel, rien d’installé sur les machines des développeurs. Vous obtenez la propriété cryptographique — une date immuable et vérifiable indépendamment — sans exécuter vous-même le protocole sous-jacent.

Deux analyses plus approfondies sont disponibles ailleurs sur ce blog : How to Verify a Git Repository’s Bitcoin Timestamp couvre le volet vérification, et Git Commit Timestamp Proof for Patent Disputes couvre le cadre juridique. Cet article reste centré sur l’automatisation elle-même.

Configuration unique : installez la GitHub App et oubliez-la

La configuration est une action unique, effectuée une fois par dépôt ou une fois par organisation.

  1. Installez la GitHub App Timestamp GIT sur le dépôt (ou sur toute l’organisation, afin que les nouveaux dépôts soient couverts par défaut).
  2. Choisissez le dépôt source qui contient votre code.
  3. Choisissez le dépôt cible où les preuves seront écrites — soit le même dépôt sur une branche dédiée, soit un dépôt fantôme séparé.

C’est toute la configuration. Aucune exigence sur les machines des développeurs : pas de démon, pas de hook que chaque ingénieur doit installer, pas de checklist d’intégration. Les nouvelles recrues sont couvertes dès leur premier commit, car la couverture est une propriété du dépôt, pas une propriété personnelle.

Le modèle de permissions. Le mode Standard nécessite un accès en lecture seule au dépôt source, plus un accès en lecture-écriture au dépôt cible. L’exigence de lecture seule existe parce que le système de permissions de GitHub n’offre pas de portée limitée au seul hash de commit — l’accès en lecture au dépôt source est l’autorisation minimale qui permet à l’App de voir le hash du commit HEAD. Elle ne lit jamais que ce hash.

Si même un hash ne doit pas quitter votre environnement, le mode Enterprise ZK remplace l’interrogation de l’App par une GitHub Action de 12 lignes qui s’exécute sur votre propre infrastructure et ne pousse rien d’autre que le hash de commit vers l’API Timestamp GIT. Dans ce mode, le service n’a 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 — vous installez l’Action à la place.

Dans les deux cas, la garantie est la même : nous ne voyons, ne copions ni ne stockons jamais votre code source réel. Seul le hash entre en jeu.

À l’intérieur du pipeline automatisé : du commit à l’ancrage Bitcoin

Une fois installé, le pipeline fonctionne sans intervention. Voici ce qui se passe entre votre git push et une preuve immuable déposée dans votre dépôt.

1. Détection des commits. En mode Standard, la GitHub App détecte les nouveaux commits via des webhooks. En mode Enterprise ZK, votre GitHub Action pousse le hash de commit vers l’API. L’un ou l’autre chemin produit le même artefact : une liste de hashs de commits.

2. File d’attente des hashs. Les hashs entrants arrivent dans un magasin clé-valeur en mémoire utilisé uniquement pour le regroupement. C’est la salle d’attente — les commits s’y accumulent jusqu’à la prochaine fenêtre de lot.

3. Worker cron de minuit. Chaque nuit, un worker prend chaque hash en attente et :

  • les regroupe par dépôt,
  • écrit un fichier manifeste (.txt) pour chaque dépôt,
  • construit un arbre de Merkle nativement sur le lot,
  • crée des preuves OpenTimestamps à l’aide des calendriers OTS publics,
  • ancre la racine de Merkle dans la blockchain Bitcoin.

Le regroupement par lots est ce qui rend cela peu coûteux et continu. Que vous ayez poussé un commit ou quatre cents ce jour-là, le coût et la cadence sont les mêmes.

4. Livraison des preuves. Le manifeste et les fichiers de reçu .ots sont repoussés automatiquement dans votre dépôt — sur une branche timestamps dédiée ou dans votre dépôt fantôme.

Il y a un détail de timing à anticiper : la confirmation dans la blockchain Bitcoin prend plusieurs heures, généralement environ trois. Ainsi, les commits poussés aujourd’hui sont mis en file ce soir, ancrés pendant la nuit, et les fichiers de preuve apparaissent quelques heures plus tard. Vous n’attendez pas ; vous les trouvez simplement là le lendemain matin.

Le résultat, par jour et par dépôt, est une chaîne à l’épreuve des falsifications : vos hashs de commits → manifeste → arbre de Merkle → racine de Merkle → preuve OpenTimestamps → bloc Bitcoin.

Supervision et gestion des défaillances : garder la chaîne intacte

Une automatisation que vous ne supervisez pas n’est qu’une version plus jolie du piège manuel. Timestamp GIT expose des endpoints de statut publics afin que vous puissiez vérifier la chaîne vous-même, sans connexion à un tableau de bord :

# Last anchored Bitcoin block info for a repo
curl -s https://timestampgit.dev/api/statusLast/{user}/{repo}

# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/{user}/{repo}

# Combined summary, used for Shields.io badges
curl -s https://timestampgit.dev/api/statusSummary/{user}/{repo}

Une vérification de continuité simple qui s’adapte à n’importe quel ordonnanceur : appelez statusLast une fois par jour, stockez la réponse brute, et déclenchez une alerte si elle n’a pas changé depuis la veille. Si aucun nouvel ancrage n’est arrivé, vous avez détecté la lacune la même semaine au lieu de la même décennie.

Si vous préférez ne pas construire cela vous-même, le tableau de bord de statut public à https://timestampgit.dev/status/{user}/{repo} fait le travail visuellement — longévité des preuves, date du premier ancrage, régularité quotidienne, les données de bloc et de transaction Bitcoin derrière chaque ancrage, et une carte de chaleur calendaire qui rend les nuits manquées immédiatement évidentes. Depuis la même page, vous pouvez télécharger le CSV d’audit et un certificat PDF.

Les dépôts privés restent privés. Les URL de statut des dépôts privés portent un HMAC chiffré spécifique à l’instance serveur, de sorte que seuls les utilisateurs autorisés peuvent lire le statut de ces dépôts. Les preuves restent publiquement vérifiables au sens Bitcoin — le hash est on-chain — mais les métadonnées environnantes ne sont pas un livre ouvert.

Badges de vérification. Pour les dépôts publics, des badges intégrables affichent votre statut de vérification directement dans le README, avec un lien que n’importe qui peut suivre pour vérifier l’horodatage sur le site. Le badge rend la preuve visible pour un client, un acquéreur ou la partie adverse, sans que vous ayez à produire quoi que ce soit.

Quand l’App se reconnecte. Si un dépôt est déconnecté puis reconnecté, la page de connexion vous fournit le widget d’intégration du badge avec un aperçu en direct, afin que vous puissiez revérifier que le lien est intact.

Bonnes pratiques pour un ancrage nocturne fiable

  • Placez un humain sur la carte de chaleur une fois par semaine. L’automatisation nocturne supprime la tâche quotidienne, pas la responsabilité. Un coup d’œil hebdomadaire de cinq minutes au tableau de bord de statut rattrape tout ce qu’une alerte pourrait manquer.
  • Alertez sur l’absence, pas seulement sur les erreurs. L’état dangereux est le silence. Alertez quand la date d’ancrage cesse d’avancer.
  • Utilisez une branche timestamps dédiée ou un dépôt fantôme. Garder les preuves hors de votre branche par défaut signifie pas de bruit de fusion, pas d’interférence accidentelle avec la CI, et une piste d’audit qu’un relecteur peut parcourir sans cloner votre application.
  • Intégrez les badges là où les acheteurs regardent. Dans le README, près de l’en-tête de licence. Une preuve publique d’existence est une crédibilité à faible coût.
  • Exportez le registre d’audit selon un calendrier. Récupérez régulièrement le CSV et archivez-le avec vos documents de conformité, et générez un certificat PDF pour chaque jalon de version. Les équipes de conformité veulent un document avec une date dessus ; donnez-leur-en un avant qu’elles ne le demandent.
  • Consignez par écrit l’histoire du « qui peut voir quoi ». Documentez votre mode — Standard ou Enterprise ZK — et les permissions exactes accordées. Quand les achats ou le juridique posent la question, vous répondez à une question à laquelle vous avez déjà répondu.

Auto-hébergement pour environnements isolés : démarrage rapide avec Docker Compose

Si vos contraintes excluent un service managé — environnements réglementés, réseaux isolés, règles strictes de résidence des données — Timestamp GIT est disponible sous forme d’image Docker exécutant le même pipeline automatisé sur votre propre 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

Lancez-le :

docker compose pull
docker compose up -d
docker compose logs -f timestampgit

L’application est disponible à 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.

Pour l’évaluation, une licence de démonstration à durée limitée est disponible : soumettez le formulaire de demande sur la page Docker License avec votre nom, votre entreprise, votre e-mail et éventuellement votre numéro de téléphone, et vous pourrez télécharger un fichier de licence de démonstration pour commencer.

L’auto-hébergement vous offre une sécurité et un contrôle maximaux avec le même comportement de regroupement et d’ancrage nocturne — l’arbre de Merkle, les preuves OTS et les fichiers .ots réécrits dans vos dépôts.

FAQ

Dois-je exécuter des commandes ou installer des outils sur ma machine ? Non. Timestamp GIT est un service managé : vous installez la GitHub App une fois, et chaque commit est automatiquement ancré chaque nuit. Rien n’est installé sur les machines des développeurs.

Combien de temps faut-il pour qu’un commit soit ancré dans Bitcoin ? Le worker cron nocturne regroupe les commits et ancre la racine de Merkle dans Bitcoin via OpenTimestamps. La confirmation prend généralement environ 3 heures, après quoi les fichiers de preuve .ots sont repoussés dans votre dépôt.

Puis-je vérifier l’horodatage de manière indépendante ? Oui. Vous pouvez télécharger le fichier .ots et utiliser les outils de vérification OpenTimestamps standard contre la blockchain Bitcoin, ou utiliser la page de vérification publique à https://timestampgit.dev/verification/{user}/{repo}/{date}, qui exécute chaque étape de la vérification de la chaîne de Merkle à plusieurs niveaux localement dans votre navigateur — personne ne voit ce que vous vérifiez.

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 hash de commit vers l’API Timestamp GIT, de sorte que votre source ne quitte jamais votre environnement. Vous pouvez aussi vous auto-héberger avec Docker pour un contrôle total.

L’ancrage ne vaut que par sa régularité

Un horodatage que vous avez fait une fois prouve une chose à propos d’un moment. Un horodatage fait chaque nuit, automatiquement, prouve qu’un dépôt a existé dans un état précis sur une chronologie continue — et c’est la version qui tient quand quelqu’un vous conteste dix-huit mois plus tard. L’horodatage manuel ne peut pas produire cet historique, car l’historique est défini par les jours que vous n’avez pas manqués.

Timestamp GIT est conçu exactement pour cela : installez la GitHub App sur votre dépôt ou votre organisation, choisissez où les preuves atterrissent, et laissez le worker nocturne regrouper, construire l’arbre de Merkle et ancrer vos hashs de commits dans Bitcoin. Vérifiez avec un badge, un tableau de bord ou les fichiers .ots eux-mêmes. Si vous préférez l’exécuter à l’intérieur de votre propre réseau, la licence Docker auto-hébergée vous couvre.

Installez-le une fois. Puis cessez d’y penser.

Articles liés

EU label: AI-generated content