Автоматизация проставления временных меток Bitcoin для каждого коммита в GitHub
Вы решили, что ваши коммиты заслуживают криптографического доказательства существования. Отлично. Теперь наступает скучная часть: делать это снова завтра, и послезавтра, для каждого репозитория, к которому прикасается ваша команда.
Именно на этом этапе большинство инициатив по проставлению временных меток тихо умирают. Не потому, что идея неверна, а потому, что рутинная работа — пакетирование хешей коммитов, отправка их в календарный сервис, нянченье с файлом доказательства, коммит его обратно — не выдерживает столкновения с реальным спринтом. Если вы хотите автоматизировать проставление временных меток в блокчейне для репозиториев GitHub, временная метка должна быть побочным эффектом git push, а не задачей, которую кто-то вспоминает сделать по пятницам.
Эта статья проходит автоматизированный путь от начала до конца: одна установка, ночной конвейер, к которому вы никогда не прикасаетесь, и мониторинг, который сообщает вам, действительно ли доказательства попали в Bitcoin.
Почему ручное проставление временных меток не масштабируется
Сложный способ проставить временную метку коммиту — делать это вручную каждый раз. Вам придётся отвечать за:
- Решение, какие коммиты стоит штамповать (все, в чём и проблема).
- Самостоятельное пакетирование хешей, чтобы не создавать одну транзакцию Bitcoin на каждый коммит.
- Отправку в публичный календарь и отслеживание ожидающего доказательства до его подтверждения.
- Сохранение полученного файла доказательства в надёжном месте, связанном с нужным коммитом.
- Повторение всего этого завтра, и после каждого force-push, хотфикса и merge train.
Даже в виде скрипта это работа на полставки. Кто-то должен отвечать за скрипт, cron-раннер, место хранения и инцидент «почему пропало доказательство за прошлую неделю». И как только этот человек меняет команду, конвейер гниёт.
Сам протокол OpenTimestamps по-настоящему элегантен — о том, как он работает, можно прочитать в OpenTimestamps Alternative: Managed GitHub App for Every Commit. Эта статья о другой проблеме: как заставить его работать без присмотра, вечно.
Цель — настроить и забыть: каждый коммит в отслеживаемый репозиторий привязывается каждую ночь, без вмешательства разработчика и без чего-либо установленного на чьём-либо ноутбуке.
Разовая настройка: установка GitHub App
Timestamp GIT — это управляемый сервис, построенный вокруг GitHub App. Настройка занимает минуты и выполняется один раз на аккаунт или организацию.
1. Установите приложение. Из панели управления Timestamp GIT установите GitHub App на свой личный аккаунт или организацию.
2. Выберите репозитории. Выберите либо все репозитории, либо конкретное подмножество. Выбор можно изменить позже без переустановки.
3. Подтвердите разрешения. Модель разрешений намеренно узкая:
| Доступ | Область | Зачем |
|---|---|---|
| Только чтение | Исходный репозиторий | В системе разрешений GitHub нет области «только хеш коммита», поэтому приложению нужен доступ на чтение, чтобы видеть хеши HEAD-коммитов |
| Чтение и запись | Целевой репозиторий | Доказательства записываются обратно в виде файлов манифеста и квитанций .ots в выделенную ветку или теневой репозиторий |
4. Уходите. Не нужно добавлять YAML, ротировать секреты или устанавливать CLI. Ваши разработчики продолжают коммитить точно так же, как сейчас; приложение реагирует на вебхуки в фоне.
Если ваши репозитории публичные, тариф Open Source покрывает это из коробки. Приватные репозитории начинаются с тарифа Pro Agency — разбор цен описывает, какой тариф подходит какой команде.
Более строгая альтернатива: режим Enterprise ZK
Стандартный режим требует доступа на чтение к вашему исходному репозиторию. Если ваша политика это запрещает — или вы просто не хотите, чтобы какая-либо третья сторона могла читать ваш код — режим Enterprise ZK меняет направление. Вместо вытягивания ваша сторона отправляет: GitHub Action из 12 строк работает на вашей собственной инфраструктуре и отправляет в API Timestamp GIT только хеш коммита. Ваш исходный код никогда не покидает вашу среду, и сервису вообще не нужен доступ на чтение к исходному репозиторию. Доступ на запись нужен только целевому репозиторию (куда записываются доказательства).
Автоматизированный конвейер: от коммита до Bitcoin
Вот что происходит после настройки, без каких-либо действий с вашей стороны.
1. Обнаружение коммитов. Новые коммиты поступают либо через вебхуки GitHub App (стандартный режим), либо через хеши, отправленные вашим GitHub Action (режим Enterprise ZK).
2. Очередь хешей. Хеши коммитов попадают в хранилище «ключ-значение» в памяти и ждут ночного пакета. Обратите внимание, чего в этом хранилище нет: вашего кода. Только хеши.
3. Ночной cron-воркер. Раз в ночь воркер:
- Группирует все ожидающие хеши.
- Строит манифест для каждого репозитория (
.txt). - Строит дерево Меркла непосредственно по пакету.
- Генерирует доказательства OpenTimestamps по публичным календарям OTS.
- Привязывает корень дерева Меркла к блокчейну Bitcoin.
4. Доставка доказательств. Манифест и файлы квитанций .ots отправляются обратно в ваш репозиторий — либо в выделенную ветку timestamps рядом с вашим кодом, либо в отдельный теневой репозиторий.
Ожидания по времени. Bitcoin не подтверждает мгновенно. Транзакция привязки обычно подтверждается примерно за три часа, так что ожидайте появления доказательств через несколько часов после полуночи UTC. Если вы проверяете в 00:05 UTC и ничего не видите, ничего не сломано.
API для пользовательских сценариев
Конвейер работает сам по себе, но API позволяет встроить данные доказательств в ваши собственные инструменты. Все эндпоинты аутентифицируются там, где это указано.
# Последний привязанный блок Bitcoin для репозитория (публичный)
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api
# Общее количество проштампованных коммитов (публичное)
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api
# Сводка, удобная для Shields.io
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api
# Полные данные цепочки Меркла за конкретный день, для локальной проверки
curl -s https://timestampgit.dev/api/verify/acme/payments-api/2026-10-25
# Журнал аудита в формате CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/acme/payments-api
# PDF-сертификат за одну дату
curl -s -o certificate.pdf https://timestampgit.dev/api/report/acme/payments-api/2026-10-25
Установки Enterprise ZK также используют эндпоинт коммитов с аутентификацией по HMAC, где {hash} — это значение HMAC, возвращённое подписанным URL, который запрашивает ваш Action:
curl -X POST \
"https://timestampgit.dev/api/timestamp/acme/payments-api/timestamps/<hmac>/<commitId>"
Вот и вся поверхность интеграции. Нет вызова «запустить пакет», который нужно планировать — пакетирование это работа сервиса.
Мониторинг и обработка сбоев
Автоматизация, за которой вы не следите, — это просто оптимизм. Timestamp GIT даёт вам три независимых способа убедиться, что конвейер здоров.
Публичная панель статуса
Каждый репозиторий получает публичную панель по адресу /status/{user}/{repo}, показывающую:
- Долговечность доказательств и самую раннюю дату привязки — насколько далеко назад простирается ваша цепочка доказательств.
- Ежедневную регулярность в виде календарной тепловой карты, так что пропущенная ночь видна сразу.
- Данные блока и транзакции Bitcoin для каждой привязки.
Значки проверки
Встройте значок Shields.io в ваш README, чтобы сделать доказательство публичным:

Страница /connected/{user}/{repo} даёт вам виджет для встраивания значка с живым предпросмотром, включая фрагмент markdown. Для приватных репозиториев URL статуса содержат зашифрованный HMAC, специфичный для экземпляра сервера — статус остаётся видимым только тем, у кого есть подписанная ссылка.
Самопроверка работоспособности
Поскольку эндпоинты статуса — это обычный JSON, небольшой скрипт в вашем собственном CI поймает остановившийся конвейер раньше, чем аудитор:
import requests
BASE = "https://timestampgit.dev"
USER, REPO = "acme", "payments-api"
r = requests.get(f"{BASE}/api/statusLast/{USER}/{REPO}", timeout=15)
r.raise_for_status()
last = r.json() # информация о последнем привязанном блоке Bitcoin для этого репозитория
print(last)
# Сравните с сохранённым вчерашним значением в вашей задаче, чтобы обнаружить остановившийся пакет.
Что если ночной пакет не завершился? Наблюдаемый сигнал во всех случаях одинаков: на тепловой карте появляется пробел, а последний привязанный блок перестаёт продвигаться. Поскольку привязка пакетируется по дням, пропущенный запуск виден в течение 24 часов, а не во время аудита — и поскольку очередь хешей и манифесты привязаны к датам, повторный запуск создаёт отдельное, датированное доказательство, а не неоднозначное. Сначала проверьте панель, затем ветку timestamps репозитория, чтобы убедиться, были ли записаны манифест и квитанции.
Журнал аудита
Для проверок на соответствие требованиям основную работу выполняют два артефакта:
GET /api/audit/{user}/{repo}— полный журнал в формате CSV.GET /api/report/{user}/{repo}/{date}— PDF-сертификат за одну дату.
А когда кто-то хочет проверить математику, а не доверять PDF, страница /verification/{user}/{repo}/{date} пошагово проходит по многоуровневой цепочке Меркла. Все эти вычисления происходят локально в браузере — ничего из того, что вы проверяете, не отправляется на сервер.
Лучшие практики автоматизированного проставления временных меток
Как только конвейер запущен, несколько привычек сохраняют полезность доказательств:
- Коммитьте рано и часто. Каждый коммит — это точка данных для prior art. Сквошивание месяца работы в один коммит прямо перед подачей даёт вам одну привязку вместо сорока.
- Держите доказательства в отдельной ветке. Автоматическая ветка
timestampsпишется машиной; её отделение от функциональных веток сохраняет читаемостьgit logи избегает шума слияний. - Проверяйте периодически, а не только во время спора. Раз в квартал выборочно проверяйте недавнюю дату через веб-верификатор. Обнаружить сломанную цепочку проверки во время судебного разбирательства — плохой момент для такого открытия.
- Прикладывайте доказательства к релизам. Прикрепляйте манифест и квитанции за дату релиза к артефактам релиза и ссылайтесь на дату в юридической документации.
- Помечайте всё, что может стать патентом. Коммиты фиксируются автоматически; как только вы начинаете обсуждать патентоспособную идею, убедитесь, что работа закоммичена, а не лежит в локальной ветке.
Автоматизация с самостоятельным размещением через Docker
Управляемый хостинг — вариант по умолчанию, но некоторые среды не могут его использовать: изолированные сети, строгие требования к местонахождению данных или внутренняя политика, запрещающая любому внешнему сервису касаться метаданных репозитория.
Для них Timestamp GIT поставляется как Docker-образ. Автоматизация идентична — то же ночное пакетирование, построение дерева Меркла и привязка к Bitcoin, только работающее в вашей инфраструктуре.
Быстрый старт с 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 — имя, компания, email и необязательный номер телефона. Файл демонстрационной лицензии с ограниченным сроком доступен для скачивания, и вы загружаете его на этапе настройки локальной установки.
FAQ
Нужно ли мне запускать какие-либо команды или устанавливать инструменты на машинах разработчиков? Нет. Timestamp GIT работает полностью через GitHub App. После установки каждый коммит в отслеживаемый репозиторий автоматически получает временную метку каждую ночь. Никаких CLI-инструментов, никаких команд OpenTimestamps, никаких ручных шагов.
Сколько времени занимает проставление временной метки коммиту? Коммиты пакетируются и привязываются раз в ночь. Транзакция Bitcoin обычно подтверждается примерно за 3 часа, поэтому доказательства обычно доступны через несколько часов после полуночи UTC.
Могу ли я проверить временную метку независимо, не доверяя Timestamp GIT?
Да. Файлы квитанций .ots можно проверить с помощью стандартных инструментов OpenTimestamps по блокчейну Bitcoin. Доказательство опирается только на SHA-256 и данные блоков Bitcoin, поэтому вы можете проверить его офлайн, даже если наш сервис исчезнет.
Что если мне нужно полностью сохранить конфиденциальность исходного кода? Используйте режим Enterprise ZK: GitHub Action на вашей инфраструктуре отправляет в наш API только хеш коммита. У нас никогда нет доступа на чтение к вашему исходному коду. В качестве альтернативы разместите сервис самостоятельно через Docker для полного контроля.
Касается ли конвейер проставления временных меток моего исходного кода? Нет. Стандартный режим читает хеши коммитов; режим Enterprise ZK вообще никогда не видит содержимое вашего репозитория. Сервис всегда работает только с хешами SHA-256 и данными блоков Bitcoin.
Временная метка, о которой не нужно думать
Ценность криптографического prior art исходит из охвата, а не из одного впечатляющего доказательства. Один проштампованный коммит с героического дня не доказывает почти ничего; восемнадцать месяцев ночных привязок доказывают хронологию. Это проблема объёма, а проблемы объёма решаются автоматизацией.
В этом весь смысл Timestamp GIT: установите GitHub App один раз, выберите репозитории и позвольте ночной задаче сделать остальное. Доказательства попадают в ветку timestamps, значки — в ваш README, а CSV аудита на месте, когда его запросит юридический отдел. Если вам нужна изоляция, режим Enterprise ZK или Docker приведёт вас туда без отказа от автоматизации.
Установите приложение, сделайте коммит и проверьте панель завтра утром.
Похожие статьи
- Git Commit Timestamp Service Pricing: Which Tier Fits Your Team
- What Does a Bitcoin Timestamp Prove About Your Code?
- Are GitHub Commit Timestamps Admissible in Court?