Timestamp GIT

← All posts

2026-10-22

Автоматическая простановка временных меток Git: привязка коммитов к Биткоину

Автоматическая простановка временных меток Git: привязка коммитов к Биткоину
timestamp git blockchain proof

Автоматическое проставление временных меток Git: привязка коммитов к Биткоину

Если ваша защита приоритета зависит от того, что кто-то не забудет запустить инструмент после каждого коммита, у вас нет защиты приоритета — у вас есть привычка. А привычки ломаются за неделю до аудита, во время аврала с релизом или сразу после того, как человек, который «всегда это делал», переходит в другую команду.

Ручное проставление временных меток имеет предсказуемый цикл сбоев. Вы делаете коммит, затем вспоминаете, что нужно поставить метку. Копируете квитанцию куда-то, где она не потеряется. Делаете это снова завтра, и послезавтра, для каждого важного репозитория — и в момент, когда вы в спринте с множеством веток, цикл незаметно останавливается. Один репозиторий масштабируется. Пять репозиториев с тремя контрибьюторами в каждом — нет.

Эта статья о том, как полностью устранить этот цикл: автоматическое проставление временных меток Git в Биткоине, где единственное повторяющееся действие — это коммит, который вы и так собирались сделать.

Вы можете сделать это сложным путём, запуская инструменты OpenTimestamps самостоятельно и нянчась с файлами квитанций. Timestamp GIT существует, чтобы вам не пришлось этого делать. Это управляемый сервис, который полностью скрывает протокол: установите GitHub App один раз, и каждый коммит в отслеживаемый репозиторий автоматически привязывается к Биткоину каждую ночь. Никаких CLI-инструментов, никаких команд протокола, никакого ежедневного чек-листа. Само руководство по установке — в GitHub App Blockchain Timestamp Setup: Install Once, Timestamp Forever — эта статья посвящена тому, что происходит после установки.

Повторяющаяся ручная задача, которую можно устранить

Прежде чем остановиться на автоматизации, стоит точно назвать то, что уходит из вашей недели:

  • Ритуал на каждый коммит. Что-то должно запускаться после каждого коммита, заслуживающего доказательства. Это человек в цикле, на каждом коммите, навсегда.
  • Разбросанные квитанции. Файлы доказательств оказываются в личной папке, на общем диске или в ветке Slack. Через полгода никто не может сопоставить квитанцию с датой или репозиторием.
  • Угасание покрытия. Вы защищаете флагманский репозиторий. Репозиторий внутренних инструментов, клиентская библиотека, сервис с коммерческой тайной — никто их не помечает, а именно они часто оказываются важными в споре.
  • Незаметные пробелы. Пропуск одного дня невидим, пока вам не понадобится доказательство, — а это худшее возможное время, чтобы обнаружить дыру в своей хронологии.

«Что автоматизировано» здесь узко и конкретно. Вы один раз устанавливаете GitHub App на репозитории, которые хотите отслеживать. С этого момента каждый коммит обнаруживается, группируется и привязывается к блокчейну Биткоина каждую ночь без действий разработчика. Разработчики продолжают коммитить точно так же, как сегодня. На их машинах ничего не нужно устанавливать, никаких pre-commit хуков, никакого нового рабочего процесса для изучения.

В этом разница между процессом и фоновым свойством ваших репозиториев.

Разовая настройка: установите GitHub App и забудьте

Timestamp GIT даёт вам два способа подключить репозиторий, и оба — разовая настройка.

Стандартный режим (GitHub App). Установите GitHub App на репозитории, которые хотите отслеживать. Он автоматически читает только хеш HEAD-коммита каждого отслеживаемого репозитория. Доказательства записываются в выделенную ветку Git — либо в тот же репозиторий, что и источник, либо в отдельный.

Модель разрешений стоит понимать ясно, потому что она меньше, чем люди ожидают:

  • Доступ только для чтения к исходному репозиторию. В системе разрешений GitHub нет области «только хеш коммита», поэтому доступ только для чтения — это минимум, который App может запросить, чтобы видеть хеш HEAD.
  • Доступ для чтения и записи к целевому репозиторию, куда отправляются файлы манифеста и квитанций.

Корпоративный режим ZK. GitHub Action из 12 строк выполняется на вашей собственной инфраструктуре и отправляет в API Timestamp GIT только хеш коммита. Такая конфигурация требует доступа для чтения и записи только к целевому репозиторию — доступ для чтения к исходному репозиторию не нужен, и ваш исходный код никогда не покидает вашу среду.

Какой бы режим вы ни выбрали, опыт разработчика для вашей команды одинаков: ничего не нужно устанавливать на машинах разработчиков, никаких изменений в том, как кто-либо создаёт ветки, коммитит или сливает изменения.

Если вам нужно развернуть самостоятельно. Для максимальной безопасности или изолированных сред Timestamp GIT также доступен как Docker-образ. Быстрый старт с Docker Compose выглядит так:

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

Приложение доступно по адресу http://localhost:8080 после запуска, а мастер настройки проведёт вас через подключение вашего GitHub App и настройку экземпляра при первом запуске. Лицензирование, форма запроса демонстрационной лицензии и полное руководство по самостоятельному развёртыванию — в Self-Hosted Git Timestamps: Docker Setup & License Guide.

Автоматизированный конвейер: от коммита до привязки к Биткоину

После подключения конвейер работает без вас. Вот фактическая последовательность.

1. Обнаружение коммита. Либо GitHub App обнаруживает новые коммиты через вебхуки, либо — в корпоративном режиме ZK — ваш GitHub Action отправляет хеши коммитов в API.

2. Очередь хешей. Хеши коммитов попадают в хранилище «ключ-значение» в памяти для группировки. Больше ничего не хранится, потому что больше ничего и не отправлялось.

3. Ночной cron-воркер. Каждую ночь воркер:

  • Группирует все ожидающие хеши
  • Создаёт файлы манифестов (.txt) для каждого репозитория
  • Строит дерево Меркла нативно
  • Создаёт доказательства OpenTimestamps с использованием публичных календарей OTS
  • Привязывает корень Меркла к блокчейну Биткоина

4. Доставка доказательств. Файлы манифеста и квитанций .ots отправляются обратно в ваш репозиторий в выделенную ветку временных меток или теневой репозиторий.

Весь поток выглядит так:

commit ──▶ hash queue ──▶ midnight cron ──▶ Merkle root ──▶ Bitcoin block
                                                 │
                                                 └──▶ manifest.txt + .ots receipt
                                                              │
                                                              ▼
                                                  timestamps branch / shadow repo

В корпоративном режиме ZK ваш GitHub Action взаимодействует с ZK Commit API, который аутентифицируется с помощью HMAC из подписанного URL, возвращаемого API для вашего репозитория:

# The signed URL (and its HMAC) is returned by the API for your repo.
# {target} is the destination repo, {hash} is the HMAC from that URL.
curl -X POST \
  "https://timestampgit.dev/api/timestamp/acme/payments-api/timestamps/<hmac>/<commitHash>/<commitId>"

Ожидание по времени. Подтверждение в Биткоине занимает несколько часов — обычно около 3 — поэтому запись доказательств завершается через несколько часов после ночного запуска, а не ровно в полночь. Если вы проверите ветку временных меток в 00:05 и ничего не увидите, это ожидаемое поведение, а не сбой.

Мониторинг и обработка сбоев

Автоматизация, которую вы не можете наблюдать, неотличима от автоматизации, которая перестала работать. Timestamp GIT предоставляет публичные эндпоинты статуса, чтобы вы могли следить за конвейером без входа в систему:

# Last anchored Bitcoin block
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api

# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api

# Combined summary (Shields.io friendly)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api

Бейджи. Встраиваемые бейджи верификации доступны для вашего README, так что статус привязки виден любому, кто просматривает репозиторий. Любой может перейти по ссылке бейджа, чтобы проверить временную метку — есть выделенный просмотрщик и PDF-отчёт. Приватные репозитории тоже поддерживаются: к их URL статуса добавляется зашифрованный HMAC, специфичный для экземпляра сервера, так что статус видят только авторизованные пользователи.

Дашборд статуса репозитория. По адресу /status/{user}/{repo} вы получаете долговечность доказательств, самую раннюю дату привязки, ежедневную регулярность, данные о блоках и транзакциях Биткоина, а также календарную тепловую карту — самый быстрый способ визуально заметить пробел в покрытии.

Эндпоинты аудита и отчётности. Когда вам нужны доказательства, а не дашборд:

# Full audit ledger as CSV
curl -sO https://timestampgit.dev/api/audit/acme/payments-api

# PDF certificate for one specific date
curl -sO https://timestampgit.dev/api/report/acme/payments-api/2026-10-21

Когда ночь выглядит пропущенной, действуйте в таком порядке:

  1. Проверьте statusLast и statusCount. Если последняя привязка на несколько часов старше ожидаемого, подтверждение может всё ещё выполняться.
  2. Убедитесь, что GitHub App по-прежнему имеет доступ к репозиторию. Удалённый App, отозванное разрешение или переименованный репозиторий незаметно остановят обнаружение.
  3. В корпоративном режиме ZK проверьте историю запусков Action на вашей стороне — отправка в API это единственное звено, которое может сломаться локально.
  4. Перепроверьте после завершения подтверждения в Биткоине, прежде чем предполагать, что что-то потеряно.

Лучшие практики автоматического проставления временных меток

  • Отслеживайте каждый важный репозиторий, а не только флагманский. Покрытие — это вся ценность автоматизации; один защищённый репозиторий всё равно оставляет остальную вашу работу незащищённой.
  • Делайте коммиты осмысленными. Автоматизация ставит метки на то, что вы коммитите, поэтому гигиена коммитов всё ещё формирует историю, которую рассказывает ваша привязанная хронология. Сто коммитов «wip» доказывают меньше, чем чистая, описательная история.
  • Поместите бейдж в README и храните CSV аудита и PDF-отчёты по датам вместе с вашими записями об интеллектуальной собственности. Именно эти артефакты вы передаёте аудитору или процессуальному оппоненту.
  • Проверяйте независимо, когда это важно. Скачайте файл .ots и проверьте его стандартными инструментами OpenTimestamps против Биткоина. Доказательство по своей конструкции не зависит от вендора — оно использует только SHA-256 и данные блоков Биткоина. Пошаговое руководство — в How to Verify a Bitcoin Timestamp Proof Locally.
  • Помните о гарантии нулевого знания. Помечаются только хеши коммитов, никогда исходный код, поэтому автоматизация по всем репозиториям ничуть не расширяет вашу экспозицию — это тот же хеш, есть у вас один репозиторий или пятьдесят.

FAQ

Читает или хранит ли автоматическое проставление временных меток Git мой исходный код?

Нет. Timestamp GIT обрабатывает только хеши коммитов. В стандартном режиме GitHub App читает хеш HEAD-коммита, а в корпоративном режиме ZK GitHub Action на вашей инфраструктуре отправляет в API только хеш. Ваш исходный код никогда не покидает вашу среду в режиме ZK и никогда не копируется и не хранится сервисом.

Через сколько после коммита подтверждается привязка к Биткоину?

Коммиты группируются и привязываются ночным cron-воркером. Подтверждение в Биткоине занимает несколько часов, обычно около 3 часов, поэтому файлы квитанций .ots и манифеста появляются в вашей ветке временных меток или теневом репозитории через несколько часов после ночного запуска.

Что произойдёт с моими доказательствами, если Timestamp GIT закроется?

Доказательства остаются действительными. Они полагаются только на SHA-256 и данные блоков Биткоина через протокол OpenTimestamps, поэтому любой может скачать файл .ots и проверить его независимо против блокчейна Биткоина с помощью стандартных инструментов OpenTimestamps — никаких проприетарных технологий, никакой привязки к вендору.

Можно ли использовать автоматическое проставление временных меток с приватными репозиториями?

Да. Приватные репозитории поддерживаются, а к URL статуса добавляется зашифрованный HMAC, специфичный для экземпляра сервера, так что статус могут видеть только авторизованные пользователи. Публичные бейджи верификации и дашборд статуса работают одинаково после предоставления доступа.

Заключение: настройте один раз — доказывайте навсегда

Сдвиг здесь невелик по усилиям и велик по последствиям. Вы перестаёте поддерживать ежедневную рутину и начинаете владеть свойством ваших репозиториев: каждый коммит, привязанный к Биткоину, автоматически, каждую ночь, с квитанцией, которую можно передать юристу, аудитору или суду. Доказательство встроено в Биткоин, готово для суда и проверяемо любым без проприетарных инструментов — и всё это обеспечивается на бэкенде Timestamp GIT, а не вашими разработчиками.

Если ваша команда вообще не может использовать управляемый сервис, вариант с самостоятельным развёртыванием в Docker покрывает среды максимальной безопасности и изолированные среды с помощью конфигурации Compose, показанной выше.

Установите GitHub App на свой первый репозиторий сегодня, и пусть конвейер отработает этой ночью. Завтра проверьте statusLast — у вас будет привязка, на создание которой иначе вы бы потратили год, пытаясь не забыть.

Похожие статьи

EU label: AI-generated content