Автоматизация временных меток Bitcoin для каждого Git-коммита
Ручная простановка временных меток имеет тот же режим отказа, что и ручное резервное копирование: всё работает идеально, пока не наступает неделя, когда вы заняты. А неделя, когда вы заняты, — это ровно та неделя, когда вы выпускаете функцию, которую позже вам нужно будет доказать, что вы выпустили.
Эта статья о том, как убрать человека из этого цикла. Не «не забудьте поставить метку перед слиянием», не пункт в чек-листе вашего релизного регламента — а однократная установка, которая превращает каждый коммит в отслеживаемом репозитории в доказательство, сгруппированное в Merkle-дерево и привязанное к Bitcoin, автоматически, каждую ночь, независимо от того, думает ли кто-то в команде о защите интеллектуальной собственности или нет.
Если вы всё ещё решаете, важна ли криптографическая доказанность приоритета в вашей ситуации, см. Prove Prior Art Before You File: A Founder’s Guide. Эта статья предполагает, что вы уже решили, и теперь хотите, чтобы это работало на автопилоте.
Ловушка ручной простановки временных меток (и почему автоматизация побеждает)
Сделать это вручную выглядит обманчиво просто. На практике ручной рабочий процесс означает, что кто-то в команде должен:
- Помнить о необходимости ставить метку после каждого значимого коммита — до того, как ветка будет переписана, схлопнута или принудительно запушена.
- Управлять ключевым материалом и файлами доказательств локально, в месте, которое переживёт потерю ноутбука и смену персонала.
- Хранить полученные квитанции где-то надёжно, с версионированием и возможностью найти их через два года во время due diligence.
- Повторять для каждого коммита, в каждом репозитории, всегда.
Именно на последнем пункте ручные процессы и умирают. Покрытие получается непоследовательным, а непоследовательное покрытие хуже, чем кажется: в споре пробел в цепочке доказательств даёт повод утверждать, что этот коммит — тот самый важный — был исключением. Один забытый пуш в пятницу после обеда может превратить чистую хронологию в знак вопроса.
Лежащий в основе протокол OpenTimestamps действительно хорошо спроектирован, и вы можете управлять им самостоятельно с помощью сырого инструментария командной строки и ручной привязки к Bitcoin — тяжёлым путём, за свой счёт и своё время. Для команды, которая выпускает релизы ежедневно и не имеет выделенного криптоспециалиста, это проект по сопровождению, замаскированный под средство безопасности.
Автоматизация побеждает, потому что превращает повторяющееся решение в однократную настройку. Установите GitHub App один раз, и с этого момента каждый коммит в отслеживаемый репозиторий захватывается, ставится в очередь, группируется, привязывается и возвращается в ваш репозиторий без какого-либо участия разработчика.
Однократная настройка: установите GitHub App и забудьте
Настройка — самая короткая часть этой статьи, и в этом весь смысл.
- Установите GitHub App Timestamp GIT. Выберите один репозиторий или предоставьте доступ всей организации — каждый отслеживаемый репозиторий получает собственные независимые доказательства.
- Выберите источник и цель. App читает хеши коммитов из исходного репозитория и записывает доказательства в целевой репозиторий — либо в выделенную ветку
timestampsв том же репозитории, либо в отдельный теневой репозиторий. - Подтвердите разрешения. Стандартному режиму нужен доступ только на чтение к исходному репозиторию, потому что в модели разрешений GitHub нет области «только хеши коммитов». Доступ на запись нужен к целевому репозиторию, чтобы доказательства можно было закоммитить обратно. Вот и вся поверхность разрешений.
На машины разработчиков ничего не устанавливается. Ни CLI-инструментов, ни pre-commit хуков, ни ключевых файлов для распространения, ни шага онбординга для новых сотрудников. Разработчики продолжают выполнять git commit и git push точно как раньше.
Для организаций, которые не хотят, чтобы хостинговый сервис вообще имел доступ на чтение к исходному коду, есть режим Enterprise ZK: короткий GitHub Action (12 строк) выполняется в вашей собственной инфраструктуре и отправляет в API только хеш коммита, так что исходный код никогда не покидает вашу среду. В этом режиме App не нуждается в доступе на чтение к исходному репозиторию — вы просто устанавливаете Action. Большинство команд начинают со стандартного управляемого режима и рассматривают ZK-режим как опцию для своих наиболее чувствительных репозиториев. Полное описание разрешений есть в Set Up IP Protection With a Single GitHub App Install.
Внутри автоматизированного конвейера: от коммита до привязки к Bitcoin
После установки конвейер работает по собственному расписанию. Вот что происходит между вашим git push и проверяемым доказательством:
- Обнаружение коммитов. GitHub App подхватывает новые коммиты через вебхуки. В режиме Enterprise ZK вместо этого ваш GitHub Action отправляет хеши коммитов в API.
- Очередь хешей. Хеши коммитов попадают в хранилище «ключ-значение» в памяти, ожидая ночной пакетной обработки. Обратите внимание, что сюда приходит: хеши, а не код.
- Полуночный cron-воркер. Воркер просыпается, группирует все ожидающие хеши и записывает один файл манифеста
.txtна репозиторий. - Построение Merkle-дерева. Воркер строит Merkle-дерево непосредственно по дневному пакету, затем генерирует доказательства OpenTimestamps по публичным календарям OTS.
- Привязка к Bitcoin. Корень Merkle-дерева привязывается к блоку Bitcoin. Подтверждение обычно занимает около трёх часов, поэтому доставка доказательств происходит через несколько часов после запуска пакета.
- Доставка доказательств. Манифест и файлы квитанций
.otsавтоматически коммитятся обратно в ваш целевой репозиторий.
Два свойства этого дизайна важнее механики:
- Zero-knowledge по построению. Сервис никогда не видит, не копирует и не хранит ваш исходный код. Он работает с хешами коммитов и корнем Merkle-дерева. Состояние вашего репозитория никогда не попадает в конвейер.
- Независимость от поставщика. Доказательства опираются только на SHA-256 и данные блоков Bitcoin. Если Timestamp GIT завтра исчезнет, квитанции в вашем репозитории останутся проверяемыми по блокчейну Bitcoin с помощью стандартного инструментария OpenTimestamps. Для повседневной работы вы будете использовать страницу проверки или API — см. How to Verify a Bitcoin Timestamp Proof for Your Code.
Мониторинг и обработка сбоев: как убедиться, что каждый коммит привязан
Автоматизация, которую вы не мониторите, — это просто cron-задача с надеждой. Timestamp GIT предоставляет достаточно поверхности, чтобы сделать покрытие наблюдаемым.
Панель статуса. У каждого отслеживаемого репозитория есть публичная страница статуса по адресу https://timestampgit.dev/status/{user}/{repo}, показывающая долговечность доказательств, самую раннюю дату привязки, ежедневную регулярность, данные блока и транзакции Bitcoin, календарную тепловую карту привязанных дней и загружаемые экспорты для аудита.
Встраиваемые бейджи. Бейджи Shields.io можно сразу добавить в ваш README, а markdown-сниппеты генерируются сразу после подключения репозитория. Любой может перейти по ссылке и публично проверить временную метку.
API для пользовательских оповещений. Опрашивайте статус и сверяйте счётчики из собственного инструментария:
# Latest anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api | jq
# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api | jq
# Combined summary (what the badge uses)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api | jq
Минимальная ночная проверка, которая выявляет пробел до того, как он станет проблемой с доказательствами:
import datetime, requests
REPO = "https://timestampgit.dev/api"
USER, SLUG = "acme", "payments-api"
summary = requests.get(f"{REPO}/statusSummary/{USER}/{SLUG}", timeout=30).json()
last = requests.get(f"{REPO}/statusLast/{USER}/{SLUG}", timeout=30).json()
# Alert if nothing has been anchored in the last 48 hours
print("summary:", summary)
print("last anchor:", last)
Направьте это в свой канал оповещений, и цикл замкнётся — пропущенный день станет уведомлением, а не открытием во время due diligence.
Сценарии сбоев. Вебхуки теряются, календари иногда падают, сети дают сбои. Поскольку хеши лежат в очереди, а не штампуются на месте, непривязанный хеш просто переходит в следующий ночной пакет. Ничего не теряется; это откладывается. Видимый симптом — пропущенный день на тепловой карте или застывшее значение statusLast, что как раз и ловят проверки выше.
Экспорты для соответствия требованиям. Для аудитов выгружайте полный реестр в виде CSV или PDF-сертификата за день:
curl -sO https://timestampgit.dev/api/audit/acme/payments-api
curl -sO https://timestampgit.dev/api/report/acme/payments-api/2026-11-22
Приватные репозитории добавляют к URL статуса зашифрованный HMAC, так что только авторизованные пользователи могут читать их статус — HMAC специфичен для экземпляра сервера.
Лучшие практики автоматической простановки временных меток
- Следите за веткой timestamps, а не только за панелью. Появление новых манифестов и файлов
.ots— это ваша объективная истина о том, что доставка сработала от начала до конца. - По возможности используйте выделенный целевой репозиторий для доказательств. Это сохраняет историю исходников чистой и упрощает передачу доказательств юристам без экспорта вашей кодовой базы.
- Проверяйте периодически, а не один раз. Запланируйте ежеквартальную проверку через публичную страницу проверки или
/api/verify/{user}/{repo}/{date}. Все вычисления при проверке происходят локально в браузере — никто не видит, что вы проверяете. - Закрепляйте покрытие в процессе, а не в памяти. Если репозиторий критичен для бизнеса, устанавливайте App на всю организацию, а не по одному репозиторию; режим отказа выборочной установки — репозиторий, о котором никто не помнит, что его нужно подключить.
- Сопоставляйте развёртывание с вашей моделью угроз. Для изолированных сред или сред с максимальной безопасностью Timestamp GIT работает как self-hosted 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. Временная демо-лицензия доступна через форму запроса на странице Docker License (имя, компания, email, необязательный телефон).
FAQ
Нужно ли устанавливать какое-либо ПО на машины моих разработчиков? Нет. Timestamp GIT работает полностью через GitHub App или GitHub Action. Разработчики просто коммитят как обычно; автоматизация делает всё остальное.
Что произойдёт, если коммит сделан после ночного отсечения? Он будет включён в пакет следующей ночи. Система ставит в очередь все ожидающие хеши и привязывает их вместе.
Можно ли автоматизировать простановку временных меток для нескольких репозиториев? Да. Вы можете установить GitHub App на несколько репозиториев или на всю организацию, и каждый репозиторий получит собственные доказательства.
Как проверить, что коммит получил временную метку? Вы можете использовать публичную страницу проверки или API, чтобы проверить Merkle-доказательство по блокчейну Bitcoin. Бейджи также показывают статус.
Что произойдёт, если я запушу несколько коммитов за день? Все они собираются в дневной пакет, сворачиваются в одно Merkle-дерево и привязываются вместе в рамках одной транзакции Bitcoin. При этом вы всё равно получаете манифесты по репозиториям, так что отдельные хеши коммитов остаются отслеживаемыми внутри пакета.
Можно ли ставить временные метки на коммиты из приватных репозиториев? Да — приватные репозитории поддерживаются на плане Pro Agency ($49/мес) и на Enterprise ZK ($199/мес, GitHub Actions). Публичные репозитории бесплатны на уровне Open Source.
Сколько времени занимает привязка коммита? Обычно несколько часов после запуска ночного пакета. Само подтверждение Bitcoin обычно занимает около трёх часов, так что доказательства попадают в ваш репозиторий через несколько часов после полуночи.
Проверяемо ли доказательство без Timestamp GIT? Да. Доказательства опираются только на SHA-256 и данные блоков Bitcoin, поэтому их можно независимо проверить по блокчейну — никаких проприетарных технологий и никакой привязки к поставщику.
Заключение
Ценность доказательства приоритета проистекает из покрытия, а покрытие — из автоматизации. Процесс простановки временных меток, который зависит от того, помнит ли человек запустить что-то, будет иметь дыры, а дыры — это то, что ищет процессуальный оппонент.
Timestamp GIT берёт на себя протокол OpenTimestamps за вас: установите GitHub App один раз, позвольте ночному cron привязывать каждый коммит к Bitcoin, следите за бейджами и эндпоинтами статуса и храните квитанции .ots в репозитории, который вы контролируете. Настройка занимает минуты; после этого единственная постоянная задача — взглянуть на оповещение, которое не должно срабатывать никогда.
Начните с бесплатного уровня Open Source на публичном репозитории или подключите приватный на Pro Agency и дайте первому пакету запуститься сегодня ночью. Для более широкого взгляда на то, сколько это стоит по сравнению с собственной разработкой, прочитайте Code Timestamping Costs Compared: Managed vs DIY.
Похожие статьи
- Code Timestamping Costs Compared: Managed vs DIY
- Set Up IP Protection With a Single GitHub App Install
- How to Verify a Bitcoin Timestamp Proof for Your Code