Автоматическое ночное закрепление Git-коммитов в Bitcoin, без единого ручного шага
Самый распространённый способ, которым команды «ставят метку времени» на коммит, — это когда человек должен не забыть это сделать.
Кто-то завершает работу над функцией, вспоминает, что коммит нужно закрепить, и вручную запускает процесс OpenTimestamps — сложным путём — а затем сохраняет квитанцию где-нибудь. Через две недели уже никто не помнит, существует ли квитанция за тот вторник. Приходит другой разработчик, не знает этого ритуала, и полгода коммитов остаются без меток.
Это и есть ловушка ручного проставления меток времени: покрытие доказательствами, зависящее от памяти. В демо это работает прекрасно, но разваливается в масштабах команды, спринтерского ритма и года текучки кадров. Автоматическое ночное закрепление Git-коммитов в Bitcoin переворачивает проблему: закрепление перестаёт быть задачей, которую выполняет человек, и становится свойством вашего репозитория. Вы один раз устанавливаете GitHub App, и каждый коммит пакетируется и закрепляется, пока вы спите.
Эта статья проходит этот автоматизированный путь от начала до конца — настройка, конвейер, мониторинг, самостоятельный хостинг — и написана для разработчиков и специалистов по комплаенсу, которым важно, чтобы доказательство выдержало аудит, а не чтобы нянчиться с заданием cron.
Ловушка ручного проставления меток времени (и как автоматизация её устраняет)
У ручного проставления меток на коммиты есть три режима отказа, и все три структурные, а не личные:
- Зависимость от памяти. Кто-то должен вспомнить, что нужно запустить инструмент в нужный момент, желательно до того, как работа станет публичной. Поздно — то же самое, что никогда, с точки зрения prior art.
- Тихие сбои. Когда ручной запуск терпит неудачу — сбой сети, истёкший календарь, неверный каталог — ничего не падает. У вас просто образуется пробел в покрытии, который вы обнаружите год спустя, во время спора, для которого вам и нужно было доказательство.
- Разбросанные квитанции. Квитанции оказываются на ноутбуках, в ветках Slack, на общем диске, который никому не принадлежит. Доказательство, которое вы не можете найти, — это доказательство, которого у вас нет.
Ничто из этого не масштабируется. Разработчик-одиночка может поддерживать ритуал несколько месяцев. Команда из десяти человек — нет, а агентство, ведущее клиентские проекты в десятках репозиториев, не имеет ни единого шанса. Каждая пропущенная ночь — это необратимая дыра в записи, потому что вы не можете задним числом закрепить хеш, который никогда не был захвачен.
Timestamp GIT — это управляемая альтернатива с нулевой настройкой: GitHub App, который автоматически захватывает хеши коммитов, пакетирует их и каждую ночь закрепляет в блокчейне Bitcoin через протокол OpenTimestamps. Никаких CLI-инструментов, никаких ручных квитанций, ничего не устанавливается на машины разработчиков. Вы получаете криптографическое свойство — неизменяемую, независимо проверяемую дату — не запуская сам базовый протокол.
Два более глубоких разбора живут в других местах этого блога: How to Verify a Git Repository’s Bitcoin Timestamp охватывает сторону проверки, а Git Commit Timestamp Proof for Patent Disputes — юридическую сторону. Эта статья остаётся на самой автоматизации.
Разовая настройка: установите GitHub App и забудьте
Настройка — это одно действие, выполняемое один раз на репозиторий или один раз на организацию.
- Установите GitHub App Timestamp GIT на репозиторий (или на всю организацию, чтобы новые репозитории покрывались по умолчанию).
- Выберите исходный репозиторий, в котором хранится ваш код.
- Выберите целевой репозиторий, куда будут записываться доказательства — либо тот же репозиторий на выделенной ветке, либо отдельный теневой репозиторий.
Это вся конфигурация. Нет требований к машинам разработчиков: ни демона, ни хука, который должен установить каждый инженер, ни чек-листа для онбординга. Новые сотрудники покрываются с первого коммита, потому что покрытие — это свойство репозитория, а не личное.
Модель разрешений. Standard Mode требует доступ только для чтения к исходному репозиторию плюс доступ для чтения и записи к целевому репозиторию. Требование только для чтения существует потому, что система разрешений GitHub не предлагает область видимости только для хеша коммита — доступ на чтение к источнику является минимальным предоставлением, которое позволяет App видеть хеш коммита HEAD. Он читает только этот хеш.
Если даже хеш не должен покидать вашу среду, Enterprise ZK Mode заменяет опрос App на GitHub Action из 12 строк, который выполняется на вашей собственной инфраструктуре и отправляет в API Timestamp GIT только хеш коммита. В этом режиме сервису нужен доступ для чтения и записи только к целевому репозиторию и вообще никакого доступа на чтение к исходному репозиторию — вместо этого вы устанавливаете Action.
В любом случае гарантия одна и та же: мы никогда не видим, не копируем и не храним ваш фактический исходный код. В игре всегда только хеш.
Внутри автоматизированного конвейера: от коммита до закрепления в Bitcoin
После установки конвейер работает без вмешательства. Вот что происходит между вашим git push и неизменяемым доказательством, лежащим в вашем репозитории.
1. Обнаружение коммитов. В Standard Mode GitHub App обнаруживает новые коммиты через вебхуки. В Enterprise ZK Mode ваш GitHub Action отправляет хеш коммита в API. Любой из путей даёт один и тот же артефакт: список хешей коммитов.
2. Очередь хешей. Входящие хеши попадают в хранилище «ключ-значение» в памяти, используемое исключительно для пакетирования. Это зал ожидания — коммиты накапливаются здесь до следующего окна пакетирования.
3. Ночной cron-воркер. Каждую ночь воркер берёт каждый ожидающий хеш и:
- группирует их по репозиториям,
- записывает файл манифеста (
.txt) для каждого репозитория, - строит дерево Меркла непосредственно по пакету,
- создаёт доказательства OpenTimestamps с использованием публичных календарей OTS,
- закрепляет корень Меркла в блокчейне Bitcoin.
Пакетирование — это то, что делает процесс дешёвым и непрерывным. Отправили ли вы один коммит или четыреста за день, стоимость и периодичность одинаковы.
4. Доставка доказательств. Манифест и файлы квитанций .ots автоматически отправляются обратно в ваш репозиторий — на выделенную ветку timestamps или в ваш теневой репозиторий.
Есть одна деталь по времени, которую стоит учесть при планировании: подтверждение в блокчейне Bitcoin занимает несколько часов, обычно около трёх. Так что коммиты, отправленные сегодня, ставятся в очередь сегодня ночью, закрепляются за ночь, а файлы доказательств появляются несколько часов спустя. Вы не ждёте этого; вы просто находите их там на следующее утро.
Результат, за день и за репозиторий, — это цепочка с защитой от подделки: ваши хеши коммитов → манифест → дерево Меркла → корень Меркла → доказательство OpenTimestamps → блок Bitcoin.
Мониторинг и обработка сбоев: сохранение непрерывности цепочки
Автоматизация, которую вы не мониторите, — это просто более красивая версия ручной ловушки. Timestamp GIT предоставляет публичные эндпоинты статуса, чтобы вы могли проверить цепочку сами, без входа в панель управления:
# 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}
Простая проверка непрерывности, подходящая для любого планировщика: вызывайте statusLast раз в день, сохраняйте сырой ответ и подавайте сигнал, если он не изменился со вчерашнего дня. Если новое закрепление не появилось, вы поймали пробел на той же неделе, а не в том же десятилетии.
Если вы предпочитаете не строить это самостоятельно, публичная панель статуса по адресу https://timestampgit.dev/status/{user}/{repo} делает работу визуально — долговечность доказательств, самая ранняя дата закрепления, ежедневная регулярность, данные блока и транзакции Bitcoin за каждым закреплением, а также календарная тепловая карта, которая делает пропущенные ночи сразу очевидными. С той же страницы можно скачать аудиторский CSV и PDF-сертификат.
Приватные репозитории остаются приватными. URL-адреса статуса для приватных репозиториев содержат зашифрованный HMAC, специфичный для экземпляра сервера, поэтому только авторизованные пользователи могут читать статус этих репозиториев. Доказательства по-прежнему публично проверяемы в смысле Bitcoin — хеш находится в блокчейне — но окружающие метаданные не являются открытой книгой.
Значки верификации. Для публичных репозиториев встраиваемые значки отображают ваш статус верификации прямо в README, со ссылкой, по которой любой может перейти и проверить метку времени на сайте. Значок делает доказательство видимым для клиента, покупателя или противной стороны, без необходимости что-либо предъявлять.
Когда App переподключается. Если репозиторий отключён и подключён заново, страница подключения даёт вам виджет встраивания значка с живым предпросмотром, чтобы вы могли заново убедиться, что связь не нарушена.
Лучшие практики надёжного ночного закрепления
- Раз в неделю выделяйте человека на тепловую карту. Ночная автоматизация убирает ежедневную задачу, но не ответственность. Пятиминутный еженедельный взгляд на панель статуса ловит всё, что может пропустить оповещение.
- Оповещайте об отсутствии, а не только об ошибках. Опасное состояние — это тишина. Подавайте сигнал, когда дата закрепления перестаёт продвигаться.
- Используйте выделенную ветку
timestampsили теневой репозиторий. Держать доказательства вне вашей основной ветки означает отсутствие шума от слияний, отсутствие случайного вмешательства в CI и журнал аудита, который рецензент может просмотреть без клонирования вашего приложения. - Встраивайте значки туда, куда смотрят покупатели. В README, рядом с заголовком лицензии. Публичное доказательство существования — это дешёвая репутация.
- Экспортируйте журнал аудита по расписанию. Регулярно выгружайте CSV и архивируйте его вместе с материалами по комплаенсу, а также создавайте PDF-сертификат для каждой вехи релиза. Команды комплаенса хотят документ с датой на нём; дайте им его до того, как они попросят.
- Записывайте историю «кто что может видеть». Документируйте свой режим — Standard или Enterprise ZK — и точные предоставленные разрешения. Когда отдел закупок или юристы спросят, вы отвечаете на вопрос, на который уже ответили.
Самостоятельный хостинг для изолированных сред: быстрый старт с Docker Compose
Если ваши ограничения исключают управляемый сервис — регулируемые среды, изолированные сети, строгие правила резидентности данных — 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 и настройку вашего экземпляра.
Для оценки доступна ограниченная по времени демо-лицензия: отправьте форму запроса на странице Docker License с вашим именем, компанией, email и необязательным номером телефона, и вы сможете скачать файл демо-лицензии, чтобы начать.
Самостоятельный хостинг даёт вам максимальную безопасность и контроль с тем же ночным пакетированием и закреплением — дерево Меркла, доказательства OTS и файлы .ots, записываемые обратно в ваши репозитории.
FAQ
Нужно ли мне запускать какие-либо команды или устанавливать инструменты на моей машине? Нет. Timestamp GIT — это управляемый сервис: вы один раз устанавливаете GitHub App, и каждый коммит автоматически закрепляется каждую ночь. На машины разработчиков ничего не устанавливается.
Сколько времени занимает закрепление коммита в Bitcoin?
Ночной cron-воркер пакетирует коммиты и закрепляет корень Меркла в Bitcoin через OpenTimestamps. Подтверждение обычно занимает около 3 часов, после чего файлы доказательств .ots отправляются обратно в ваш репозиторий.
Могу ли я проверить метку времени независимо?
Да. Вы можете скачать файл .ots и использовать стандартные инструменты проверки OpenTimestamps против блокчейна Bitcoin, либо воспользоваться публичной страницей проверки по адресу https://timestampgit.dev/verification/{user}/{repo}/{date}, которая выполняет каждый шаг проверки многоуровневой цепочки Меркла локально в вашем браузере — никто не видит, что вы проверяете.
Что делать, если мне нужно полностью сохранить свой исходный код в тайне? Используйте режим Enterprise ZK: GitHub Action на вашей инфраструктуре отправляет в API Timestamp GIT только хеш коммита, поэтому ваш исходный код никогда не покидает вашу среду. В качестве альтернативы разверните самостоятельно с помощью Docker для полного контроля.
Закрепление хорошо настолько, насколько регулярно оно выполняется
Метка времени, которую вы поставили один раз, доказывает одну вещь об одном моменте. Метка времени, ставящаяся каждую ночь, автоматически, доказывает, что репозиторий существовал в определённом состоянии на непрерывной временной шкале — и именно эта версия выдерживает проверку, когда кто-то оспаривает её восемнадцать месяцев спустя. Ручное проставление меток не может создать такую запись, потому что запись определяется днями, которые вы не пропустили.
Timestamp GIT создан именно для этого: установите GitHub App на ваш репозиторий или организацию, выберите, куда попадают доказательства, и позвольте ночному воркеру пакетировать, строить дерево Меркла и закреплять ваши хеши коммитов в Bitcoin. Проверяйте с помощью значка, панели управления или самих файлов .ots. Если вы предпочитаете запускать это внутри своей собственной сети, лицензия на самостоятельный хостинг Docker вас покроет.
Установите один раз. Затем перестаньте об этом думать.
Похожие посты
- Code Timestamping Service Pricing for Private Repos
- OpenTimestamps Alternatives: Managed Git Timestamping
- Protecting Agency Code Deliverables With Blockchain Proof