Как самостоятельно проверить метку времени Git-коммита
Метка времени, которую вы не можете проверить сами, — это не доказательство, а обещание поставщика. Эта разница становится критичной в тот момент, когда кто-то другой просит вас доказать, когда существовал ваш код: аудитор по комплаенсу, оппонент в патентном споре или покупатель, проводящий технический due diligence.
Эта статья показывает, как независимо проверить метку времени Git-коммита с помощью артефактов и инструментов Timestamp GIT: публичной страницы статуса, браузерной страницы проверки Merkle, REST API, значков верификации и загружаемых отчётов. Ни одна строка исходного кода не должна покидать ваш репозиторий, и никому — включая поставщика — не нужно доверять, чтобы результат оставался действительным.
Почему независимая проверка важна
Любая криптографическая метка времени настолько надёжна, насколько вы способны проверить её на своих условиях.
- Проверка не должна зависеть от того, жив ли поставщик. Доказательства Timestamp GIT опираются исключительно на SHA-256 и данные блоков Bitcoin. Вы можете проверить их офлайн, даже если сервиса больше не существует.
- Регуляторы, аудиторы и суды ожидают воспроизводимых доказательств. «Так показала панель управления» — это не доказательство. А корень Merkle, совпадающий с блоком Bitcoin, — да.
- Due diligence задаёт неудобные вопросы. Во время поглощения или раунда финансирования зрелость ИС изучается. Возможность передать проверяемую цепочку доказательств сильно отличается от передачи скриншота.
- Ваш исходный код остаётся приватным. Для проверки нужны ровно две вещи: файлы доказательств (манифест и
.ots-квитанция) и публичные данные блокчейна. Не ваша реализация, не ваши коммерческие секреты.
Остальная часть статьи — это практический чек-лист.
Как выглядит доказательство Timestamp GIT
Один день коммитов порождает небольшой, чётко определённый набор артефактов:
- Ежедневный файл манифеста (
.txt), содержащий хеши коммитов, собранные для этого репозитория в этот день. - Корень Merkle, вычисленный по манифесту. Корень — это единственное значение, представляющее каждый коммит в пакете.
- Файл
.ots-квитанции — доказательство OpenTimestamps, которое криптографически связывает этот корень Merkle с конкретным блоком Bitcoin.
Эти артефакты находятся в выделенной ветке timestamps или теневом репозитории, намеренно отделённых от вашего исходного кода. В этом и смысл: доказательство путешествует независимо от кода, который оно защищает.
Помимо файлов, запись включает высоту блока Bitcoin и ID транзакции, которые закрепили пакет. Именно эти два значения позволяют любому — вам, юристу, внешнему аудитору — подтвердить, что данные существовали на момент майнинга блока.
Пошагово: проверка с помощью инструментов Timestamp GIT
Метки времени создаются автоматически: установите GitHub App один раз, подключите репозиторий, и каждый коммит закрепляется каждую ночь без ручных действий. Проверка — это то, где вы берёте управление на себя, и у вас есть пять способов это сделать.
1. Публичная страница статуса
Откройте https://timestampgit.dev/status/{user}/{repo}. Эта панель показывает:
- долговечность доказательств и самую раннюю дату закрепления,
- ежедневную регулярность (календарная тепловая карта делает пробелы очевидными),
- высоту блока Bitcoin и ID транзакции для каждого закрепления.
Это самая быстрая проверка на вменяемость. Если контрагент сомневается в непрерывности, тепловая карта — это ответ.
2. Браузерная страница проверки
Для конкретного дня перейдите на https://timestampgit.dev/verification/{user}/{repo}/{date}. Эта страница проходит по многоуровневой цепочке Merkle шаг за шагом и выполняет все вычисления локально в вашем браузере — zero-knowledge. Никто не видит, что вы проверяете, что полезно, когда сам репозиторий конфиденциален.
Это та страница, которую стоит открыть перед аудитором, потому что каждый уровень цепочки показан, а не обобщён.
3. API проверки
Когда проверку нужно автоматизировать или заархивировать, получите сырую цепочку:
curl -s "https://timestampgit.dev/api/verify/acme-corp/payments-api/2026-10-05" \
-H "Accept: application/json" | jq .
Ответ содержит полные данные цепочки Merkle для метки времени этого дня, чтобы вы могли пересчитать её локально, а не доверять отрисованной странице.
4. Значки верификации
На странице подключения репозитория вы получаете встраиваемый значок Shields.io вместе с markdown-сниппетом. Вставьте его в свой README:
[](BADGE_LINK)
Любой, кто нажмёт на значок, попадёт на страницу проверки для вашего репозитория. Это публичное, всегда актуальное заявление о доказательстве существования — и поскольку ссылка ведёт к проверяемым данным, а не к статичному изображению, это не просто украшение.
5. Отчёты и экспорты для аудита
Две конечные точки покрывают бумажную сторону:
# Per-day PDF certificate
curl -sL "https://timestampgit.dev/api/report/acme-corp/payments-api/2026-10-05" \
-o certificate-2026-10-05.pdf
# Full audit ledger as CSV
curl -sL "https://timestampgit.dev/api/audit/acme-corp/payments-api" \
-o audit-ledger.csv
PDF — это то, что вы прикладываете к судебному документу. CSV — это то, что вы загружаете во внутренний архив аудита или в таблицу, которую передаёте команде due diligence.
Обратите внимание, что приватные репозитории добавляют к своим URL зашифрованный HMAC, поэтому только авторизованные пользователи могут открыть их страницы статуса и проверки. Доказательство в основе не меняется — оно по-прежнему закреплено в Bitcoin и по-прежнему проверяемо любым, у кого есть файл доказательства.
Интерпретация результатов проверки и крайние случаи
Успешная проверка означает одну конкретную вещь: корень Merkle, который вы пересчитали по манифесту, совпадает со значением, закреплённым в блоке Bitcoin, на который ссылается .ots-квитанция. Это совпадение доказывает, что набор хешей коммитов существовал не позднее метки времени этого блока. Неважно, кто выполняет проверку и где.
Четыре крайних случая стоит знать, прежде чем обещать кому-либо результат проверки:
- Текущий день, вероятно, ещё не проверяем. Закрепление выполняется ночью, а подтверждение Bitcoin занимает несколько часов (обычно около 3 часов). Доказательства для сегодняшних коммитов может ещё не существовать, а вчерашний пакет может всё ещё ожидать подтверждения. Планируйте аудиты с учётом этого окна.
- Приватные репозитории требуют HMAC. Проверка работает точно так же, как для публичных репозиториев, но URL несёт зашифрованный HMAC, специфичный для экземпляра сервера. Нет HMAC — нет страницы статуса.
- Метка времени доказывает существование, а не авторство. Доказательство говорит, что хеш коммита существовал в определённое время. Оно само по себе не устанавливает, кто написал код или что код нов. Используйте его как доказательство prior art, а не как замену цепочке правового титула.
- Любой может проверить, даже без Timestamp GIT. Поскольку доказательство построено на открытых стандартах, достаточно мотивированный инженер может проверить
.ots-файл стандартными инструментами OpenTimestamps против блокчейна Bitcoin. Это фича: она означает, что ваши доказательства переживут поставщика.
Проверка без SaaS: сложный путь (и почему он вам не нужен)
В принципе вы могли бы собрать этот конвейер сами — запустить инструменты OpenTimestamps, опрашивать узлы Bitcoin, вручную сверять доказательства Merkle. На практике это означает поддержку инфраструктуры и экспертизы для задачи, которая не является вашим продуктом.
Timestamp GIT существует, чтобы вам не приходилось этого делать. Установите GitHub App один раз на отслеживаемом репозитории, и каждый коммит автоматически закрепляется в Bitcoin каждую ночь — без CLI, без ручных действий, без знаний протокола. Проверка тогда — это ссылка, значок или вызов API. Для организаций, которым нужно держать всё на своём оборудовании, доступен self-hosting в виде Docker-образа:
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 и настройку экземпляра при первом запуске.
Автоматизация проверки в вашем рабочем процессе
Ручная проверка подходит для споров. Для постоянного комплаенса автоматизируйте её.
Ставьте шлюз на статус закрепления в вашем CI/CD. Конечная точка сводки специально для этого и создана:
curl -sf "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api" -o summary.json
cat summary.json
Небольшой скрипт проверки превращает её в шлюз сборки:
import json
import sys
import urllib.request
URL = "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api"
with urllib.request.urlopen(URL) as response:
summary = json.load(response)
print(json.dumps(summary, indent=2))
# Fail loudly if the summary reports no anchored Bitcoin block yet.
if not any("block" in key.lower() for key in summary):
sys.exit("No Bitcoin anchor reported for this repository yet.")
Встройте его в запланированный workflow, чтобы отсутствующее закрепление становилось тикетом, а не сюрпризом во время аудита:
name: Timestamp anchor check
on:
schedule:
- cron: "0 8 * * *"
workflow_dispatch:
jobs:
verify-anchor:
runs-on: ubuntu-latest
steps:
- name: Check anchor status
run: |
curl -sf "https://timestampgit.dev/api/statusSummary/${{ github.repository_owner }}/${{ github.event.repository.name }}" \
-o summary.json
cat summary.json
Архивируйте доказательства по расписанию. Выгружайте CSV аудита ежемесячно и храните его в вашей системе учёта:
curl -sL "https://timestampgit.dev/api/audit/acme-corp/payments-api" \
-o "audit-ledger-$(date +%Y-%m).csv"
Публикуйте значок. Это стоит одной строки в вашем README и даёт контрагентам способ самостоятельно проверить ваши заявления.
Если сохранение содержимого репозитория вне сервиса является требованием, режим развёртывания Enterprise ZK запускает короткий GitHub Action на вашей собственной инфраструктуре, который отправляет хеши коммитов в API Timestamp GIT. Проверка работает так же; меняется только путь поступления данных.
FAQ
Нужно ли доверять Timestamp GIT, чтобы проверить метку времени?
Нет. Доказательство опирается исключительно на SHA-256 и данные блоков Bitcoin. Вы можете проверить его независимо, используя .ots-файл и стандартные инструменты OpenTimestamps против блокчейна Bitcoin, даже если Timestamp GIT больше не существует.
Сколько времени занимает, пока метка времени коммита станет проверяемой? После ночного процесса закрепления доказательство записывается в ваш репозиторий. Подтверждение Bitcoin обычно занимает около 3 часов, после чего метка времени неизменна и проверяема.
Могу ли я проверить метку времени для приватного репозитория? Да. Приватные репозитории используют зашифрованный HMAC, добавляемый к URL, поэтому только авторизованные пользователи могут получить доступ к странице статуса и инструментам проверки. Лежащее в основе доказательство по-прежнему закреплено в Bitcoin и может быть проверено любым, у кого есть файл доказательства.
Какие инструменты предоставляет Timestamp GIT для проверки? Публичную страницу статуса, браузерную страницу проверки, которая вычисляет всё локально, конечные точки REST API для данных цепочки Merkle и отчётов аудита, а также встраиваемые значки Shields.io. Все они созданы для независимой проверки без участия поставщика.
Заключение
Независимая проверка — это то, что отличает метку времени от маркетингового заявления. С Timestamp GIT вы получаете цепочку доказательств со страницы статуса, пересчитываете путь Merkle в браузере, автоматизируете ту же проверку в CI и экспортируете PDF-сертификат для дела — и всё это без раскрытия единой строки исходного кода.
Если вы хотите, чтобы это работало на ваших репозиториях, управляемый сервис — это разовая настройка: установите GitHub App, подключите репозиторий и позвольте ночному закреплению сделать остальное. Для требований изолированных или самостоятельно размещённых сред лицензия на self-hosted Docker покрывает и этот путь. Начните на timestampgit.dev и проверьте репозиторий сами.
Похожие статьи
- Automatic Nightly Git Commit Anchoring to Bitcoin, Zero Manual Steps
- Code Timestamping Service Pricing for Private Repos
- OpenTimestamps Alternatives: Managed Git Timestamping