Timestamp GIT

← All posts

2026-11-19

Как проверить доказательство временной метки Bitcoin для вашего кода

Как проверить доказательство временной метки Bitcoin для вашего кода
timestamp git blockchain proof

Как проверить доказательство временной метки Bitcoin для вашего кода

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

Хорошая новость: с Timestamp GIT проверка — это не исследовательский проект. GitHub App ежедневно привязывает ваши хеши коммитов, а проверка доказательства занимает один клик, один URL или один curl. В этой статье разобраны точные пути проверки, что означают результаты и где скрываются пограничные случаи.

Почему проверка важна: от доверия к доказательству

Есть разница между утверждением и доказательством:

  • Утверждение — это «мы написали это в марте». Оно живёт в базе данных, которую вы контролируете и можете редактировать.
  • Доказательство — это «этот конкретный хеш коммита был включён в дерево Меркла, корень которого встроен в блок Bitcoin N». Любой может его пересчитать.

Для соответствия требованиям, аудитов и судебных разбирательств у доказательства есть одно дополнительное требование: оно должно быть воспроизводимым и независимым от поставщика. Если ваше доказательство проверяется только пока работают серверы конкретной компании, это не доказательство, а подписка.

Архитектура Timestamp GIT это учитывает. Квитанция .ots плюс публичные данные блоков Bitcoin — это и есть всё доказательство. В пути проверки нет проприетарного компонента, и ничего не нужно устанавливать на машины ваших разработчиков. Эта статья сосредоточена на этапе проверки; если вы всё ещё решаете, стоит ли вообще ставить временные метки, стратегические аргументы изложены в нашем руководстве основателя по предшествующему уровню техники.

Что на самом деле содержит доказательство временной метки Bitcoin

Доказательство за один день состоит из двух артефактов, хранящихся в выделенной ветке timestamps или в теневом репозитории, чтобы они версионировались вместе с вашим кодом:

  1. Файл манифеста (.txt) со списком хешей коммитов, собранных для этого репозитория в этот день.
  2. Файл квитанции .ots, содержащий путь Меркла, который связывает ваш хеш с корнем Меркла, привязанным к Bitcoin.

Цепочка выглядит так:

commit hash ─┐
commit hash ─┼─ Merkle tree ─ Merkle root ─ Bitcoin transaction ─ block
commit hash ─┘        │
                 .ots receipt (Merkle path from your hash to the root)

При проверке важны два свойства:

  • Манифест доказывает, какие хеши были включены.
  • Квитанция .ots доказывает, когда корень Меркла попал в цепочку.

Поскольку привязка использует только протокол OpenTimestamps и ничего проприетарного, доказательство переживёт нас: это SHA-256 плюс данные блоков Bitcoin, проверяемые офлайн, навсегда.

Пошагово: проверка доказательства временной метки с помощью Timestamp GIT

1. Начните со значка в вашем README

Каждый отслеживаемый репозиторий может отображать значок проверки Shields.io. Это живой указатель, а не статичное изображение: он ведёт на публичную страницу статуса этого репозитория. Вы генерируете фрагмент для встраивания на странице подключённого репозитория (https://timestampgit.dev/connected/{user}/{repo}), которая показывает живой предпросмотр перед вставкой.

<!-- Paste the snippet generated at /connected/{user}/{repo} -->
[![Timestamp GIT status](BADGE_URL_FROM_CONNECTED_PAGE)](https://timestampgit.dev/status/OWNER/REPO)

Когда проверяющий нажимает на значок, он попадает на доказательства, а не на маркетинговую страницу.

2. Прочитайте страницу статуса репозитория

Откройте:

https://timestampgit.dev/status/{user}/{repo}

Эта публичная панель даёт удобную для аудита сводку:

  • Долговечность доказательств — насколько глубоко уходит ваша история привязок.
  • Самая ранняя дата привязки — первый день, когда ваши хеши попали в Bitcoin.
  • Ежедневная регулярность — доказательство того, что ночная задача действительно выполнялась день за днём.
  • Данные о блоках и транзакциях Bitcoin для привязок.
  • Тепловая карта календаря, чтобы пропуски были визуально очевидны.
  • Загрузки: аудиторский CSV и PDF-сертификат.

Для аудитора тепловой карты вместе с CSV обычно достаточно для первой проверки. Пропущенные квадраты — это то, что нужно расследовать.

3. Проверьте конкретный день локально

Для доказательства на уровне даты откройте:

https://timestampgit.dev/verification/{user}/{repo}/{date}

Эта страница проходит по цепочке Меркла шаг за шагом и выполняет вычисления локально в вашем браузере. Ничего из того, что вы проверяете, не передаётся — свойство нулевого разглашения относится и к проверке, а не только к приёму данных.

Это важнее, чем кажется. Проверяющий на соответствие может проверить доказательство, касающееся конфиденциальных внутренних репозиториев, не передавая поставщику никакой дополнительной информации.

4. Получите цепочку Меркла через API

Если вы предпочитаете проверять программно (или хранить доказательства в собственной системе соответствия), API возвращает полные данные цепочки Меркла за конкретный день:

curl -s "https://timestampgit.dev/api/verify/OWNER/REPO/2026-11-18" | jq

Вы также можете получить последний привязанный блок и текущее количество коммитов:

curl -s "https://timestampgit.dev/api/statusLast/OWNER/REPO" | jq
curl -s "https://timestampgit.dev/api/statusCount/OWNER/REPO" | jq

Никаких CLI-инструментов, команд протокола или кошелькового ПО. Вся тяжёлая работа — обнаружение коммитов через вебхук GitHub App, пакетирование, построение дерева Меркла и привязка к Bitcoin — уже произошла за ночь.

Чтение результатов — и пограничные случаи

Действительное доказательство означает нечто узкое и сильное: этот хеш коммита существовал в момент временной метки этого блока Bitcoin или раньше. Оно не говорит вам, что код хорош, что каждую строку написали вы или кто её набрал. Авторство за пределами хеша — отдельный вопрос; наш разбор того, выдерживают ли временные метки коммитов Git роль доказательства, освещает это различие.

Другие вещи, которые стоит иметь в виду:

  • Разброс временных меток блоков. Временные метки блоков Bitcoin могут немного отклоняться от реального времени. Доказательство остаётся криптографически сильным независимо от этого, потому что сам блок неизменяем — никто не может перемайнить историю, чтобы сдвинуть вашу привязку.
  • Отсутствие доказательства за дату. Доказательства записываются через несколько часов после полуночи: cron-воркер пакетирует хеши, строит дерево Меркла, отправляет его в публичные календари OTS, а затем ждёт подтверждения Bitcoin — обычно около трёх часов. Доказательство за день может просто ещё не быть записано. Если прошло больше времени, проверьте, действительно ли репозиторий отслеживался в этот период.
  • Приватные репозитории. URL статуса для приватных репозиториев содержат зашифрованный HMAC, и только обладатели этого URL могут видеть статус. Сама проверка по-прежнему выполняется локально в браузере.
  • Самостоятельно размещённые экземпляры. Каждый экземпляр генерирует свой собственный HMAC. Если вы переносите значок с SaaS-экземпляра на собственное развёртывание в Docker, перегенерируйте ссылку значка — HMAC одного экземпляра не пройдёт проверку на другом.

Проверка без SaaS: самостоятельный Docker и офлайн-проверки

Для изолированных сред или обстановки с повышенной паранойей 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, если вы хотите оценить продукт перед покупкой.

Самостоятельный хостинг не меняет математику проверки. Файлы .ots и данные блоков Bitcoin — те же артефакты, и они проверяются офлайн. Вы можете пойти полностью ручным путём и передать файл .ots стандартным инструментам проверки OpenTimestamps против локального узла Bitcoin — это сложный путь, и он работает именно потому, что доказательство не зависит от поставщика. Просмотрщик и API продукта просто превращают это в дело одного клика вместо проекта на выходные.

Автоматизация проверки для соответствия требованиям

Если проверка — это пункт в ежеквартальном обзоре, автоматизируйте её:

  • Экспортируйте реестр. GET /api/audit/{user}/{repo} возвращает полный аудиторский реестр в формате CSV — именно тот артефакт, который ваш аудитор хочет видеть в архиве.
  • Генерируйте сертификаты по дням. GET /api/report/{user}/{repo}/{date} создаёт PDF-сертификат за конкретную дату, что полезно, когда одно доказательство нужно приложить к договору или судебному иску.
  • Опрашивайте на свежесть. Короткая cron-задача на вашей стороне отлавливает тот режим отказа, который имеет значение: тихую остановку привязки.
#!/usr/bin/env bash
set -euo pipefail

REPOS=("acme/api" "acme/web" "acme/infra")

for repo in "${REPOS[@]}"; do
  printf '%-14s ' "$repo"
  curl -s "https://timestampgit.dev/api/statusLast/${repo}" | jq -c '.'
done

Запускайте её ежедневно; если последний привязанный блок перестал продвигаться, вы узнаете об этом раньше аудитора.

  • Отображайте статус публично. Встройте значок Shields.io, чтобы нижестоящие пользователи и клиенты могли видеть статус проверки, ничего у вас не запрашивая.

Для команд, которым нужно максимальное разделение, планы Enterprise ZK поставляются с коротким GitHub Action, который выполняется в вашем собственном CI и передаёт только хеши коммитов — модель привязки и проверки остаётся прежней, а проверка по-прежнему выполняется локально.

FAQ

Нужно ли мне запускать какие-либо команды OpenTimestamps для проверки доказательства?

Нет. Timestamp GIT предоставляет веб-страницу проверки и REST API, которые выполняют всю проверку. Вы также можете скачать файл .ots и использовать стандартные инструменты проверки, если предпочитаете, но это не обязательно.

Сколько времени нужно, чтобы доказательство стало проверяемым?

Доказательства привязываются каждую ночь и подтверждаются в блокчейне Bitcoin через несколько часов — обычно около трёх. У коммита, сделанного сегодня, будет проверяемое доказательство уже на следующий день.

Могу ли я проверить доказательство для приватного репозитория?

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

Что если Timestamp GIT исчезнет? Смогу ли я всё ещё проверить?

Да. Доказательство не зависит от поставщика: оно опирается только на SHA-256 и данные блоков Bitcoin. Вы можете проверить файл .ots офлайн стандартными инструментами OpenTimestamps, даже если наш сервис исчезнет.

Заключение

Проверка — это момент, когда простановка временных меток перестаёт быть хорошей идеей и становится защитимым доказательством. Рабочий процесс короток: нажмите на значок, прочитайте страницу статуса, откройте представление проверки на уровне дня или обратитесь к /api/verify/{user}/{repo}/{date} и проверьте цепочку Меркла сами. Каждый путь заканчивается в одном и том же месте — хеш коммита, существовавший до определённого блока Bitcoin, доказуемый навсегда, без доверия к чьей-либо базе данных.

Если вы ещё не начали, настройка — это скучная часть: установите GitHub App на репозиторий и дайте ночной задаче поработать. К завтрашнему дню у вас будет первое проверяемое доказательство. Перейдите на timestampgit.dev, чтобы подключить свой первый репозиторий.

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

EU label: AI-generated content