Timestamp GIT

← All posts

2026-10-16

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

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

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

У вас есть файл .ots в ветке timestamps, и юрист, аудитор или ваш собственный скептически настроенный мозг хочет знать: это действительно что-то доказывает или это просто файл, который вам передал вендор?

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

Почему локальная проверка важна

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

Доказательства, привязанные к Bitcoin, работают иначе. Timestamp GIT встраивает хеши коммитов в блокчейн Bitcoin через протокол OpenTimestamps, используя публичные OTS-календари. Путь верификации использует только SHA-256 и данные блоков Bitcoin — никакой проприетарной криптографии, никаких секретных ингредиентов. Это означает:

  • Доказательство переживёт вендора. Даже если Timestamp GIT исчезнет завтра, квитанция .ots и блок Bitcoin, на который она ссылается, останутся проверяемыми для кого угодно.
  • Проверка по умолчанию локальная. Веб-верификатор Timestamp GIT выполняет все вычисления в вашем браузере. Никто не видит, что вы проверяете, и для получения результата не требуется ответ сервера.
  • Команды по комплаенсу это принимают. На юридическом аудите «наши внутренние логи так говорят» часто отметается как корыстное утверждение. Путь Меркла, завершающийся конкретным заголовком блока Bitcoin, — это доказательство совсем другой категории.

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

Если вам нужен концептуальный контекст о том, почему prior art нуждается в криптографической привязке, это раскрыто в статье What Is Cryptographic Prior Art? A Guide for Software Teams. Эта статья — о механическом акте проверки.

Как выглядит доказательство Timestamp GIT

Когда вы устанавливаете GitHub App и подключаете репозиторий, каждый коммит попадает в ночной пакет. Вот что вы получаете в итоге:

  • Файл-квитанция .ots. Компактное криптографическое доказательство того, что данный хеш Git-коммита — точнее, корень Меркла, покрывающий дневной пакет хешей, — существовал в определённый момент времени.
  • Файл-манифест .txt для каждого репозитория. Список хешей коммитов, сгруппированных в пакет за этот день.
  • Выделенная ветка timestamps или теневой репозиторий. Доказательства отправляются обратно в вашу собственную инфраструктуру — либо внутри исходного репозитория, либо в отдельном целевом репозитории.

Каждое доказательство соответствует дневному пакету. Конвейер группирует все ожидающие хеши коммитов, строит дерево Меркла нативно, создаёт доказательства OpenTimestamps против публичных OTS-календарей и привязывает корень Меркла к транзакции Bitcoin.

Файл .ots самодостаточен для целей проверки: он содержит путь Меркла от вашего хеша коммита до привязанного корня, а также ссылку на заголовок блока Bitcoin, содержащий привязку. Вам не нужна база данных Timestamp GIT, чтобы его проверить.

Одна деталь по таймингу, которая часто сбивает с толку: подтверждение Bitcoin занимает несколько часов — обычно около 3. Поэтому этап записи доказательства наступает через несколько часов после запуска полуночного cron-воркера. Свежий коммит не становится проверяемым мгновенно. См. Интерпретация результатов и краевые случаи ниже.

Пошагово: проверка вашего доказательства локально

Шаг 1: получите файл .ots

Он уже в вашем репозитории. Ищите в ветке timestamps или в теневом репозитории, если вы настроили хранение доказательств отдельно от исходного кода. Также его можно скачать из панели управления Timestamp GIT через список ваших репозиториев.

Шаг 2: воспользуйтесь браузерным верификатором

Перейдите на страницу верификации для вашего репозитория и даты:

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

Это пошаговая, многоуровневая проверка цепочки Меркла. Каждое вычисление хеша происходит локально в вашем браузере — страница никуда не отправляет ваши данные, и никто не видит, что вы проверяете. Вы увидите, как цепочка разворачивается от вашего хеша коммита через промежуточные узлы Меркла вверх к корню и ссылке на блок Bitcoin.

Это путь, которым стоит идти большинству разработчиков и проверяющих по комплаенсу. Никаких CLI-инструментов не требуется, биткоин-нода не требуется.

Шаг 3 (необязательно): проверка стандартными инструментами OpenTimestamps

Формат .ots открыт. Если ваш процесс требует полностью независимого инструментария — или вам просто так удобнее — вы можете взять файл-квитанцию и проверить его против блокчейна Bitcoin с помощью стандартных инструментов верификации OpenTimestamps и биткоин-ноды или лёгкого клиента. Это «сложный путь», и он совершенно необязателен. Доказательство по своей конструкции не зависит от вендора: задействованы только SHA-256 и данные блоков Bitcoin.

Шаг 4: подтвердите результат

Успешная проверка даёт два конкретных результата:

  • Высоту блока Bitcoin, в котором был привязан ваш корень Меркла.
  • Временную метку блока, которая устанавливает верхнюю границу того, когда ваш хеш коммита мог существовать.

Вот ваше доказательство: не «Timestamp GIT так говорит», а «этот хеш доказуемо содержится в дереве Меркла, корень которого зафиксирован в блоке Bitcoin N».

Использование встроенных инструментов верификации Timestamp GIT

Помимо верификатора по дате, есть три инструмента, о которых стоит знать.

Публичная страница статуса

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

Это публичная панель, показывающая долговечность доказательств, вашу самую раннюю дату привязки, ежедневную регулярность, данные блока и транзакции Bitcoin за каждой привязкой, а также календарную тепловую карту покрытия. Если вы проводите due diligence по репозиторию — своему или чужому, — начните отсюда. Она также предоставляет скачиваемый CSV-журнал аудита и PDF-сертификат.

Страница верификации

Описана выше, но стоит повторить как основной инструмент:

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

Проверка цепочки Меркла в браузере для временной метки одного конкретного дня.

Бейджи и сертификаты

Для вашего README доступны встраиваемые бейджи, публично отображающие статус верификации. Любой может кликнуть по ссылке, прикреплённой к бейджу, и проверить временную метку через сайт. Для пакетов аудита скачайте PDF-сертификат на конкретную дату.

Если ваш репозиторий приватный, учтите: приватные репозитории добавляют к URL зашифрованный HMAC — HMAC специфичен для экземпляра сервера, поэтому статус этого репозитория видят только авторизованные пользователи. Ваш процесс верификации не меняется; URL просто ограничен по области доступа.

Интерпретация результатов и краевые случаи

Что на самом деле означает успешная проверка

Она доказывает, что хеш коммита существовал в момент времени блока Bitcoin или раньше. Не «ровно в», и не «код был написан тогда» — она доказывает, что хеш существовал не позднее этого блока. Для целей prior art это ровно то утверждение, которое вам нужно: у вас был этот артефакт на дату X или раньше.

Ожидающие доказательства

Если вы проверяете репозиторий утром после коммита и доказательство выглядит незавершённым, это ожидаемо. Ночной cron-воркер группирует хеши, строит дерево и привязывает его; затем подтверждение Bitcoin занимает несколько часов (обычно около 3). После подтверждения временная метка неизменна. Подождите и проверьте снова — ничего не сломано.

Граница нулевого разглашения

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

Когда что-то идёт не так

  • Отсутствует файл .ots — получите его из ветки timestamps, теневого репозитория или вашей панели управления.
  • Повреждённая квитанция — скачайте заново из репозитория или панели управления; привязанные данные на стороне Bitcoin не затронуты, поэтому свежая копия квитанции восстанавливает верификацию.

Команды, которым нужна ещё меньшая экспозиция

Управляемый GitHub App от Timestamp GIT — это путь без настройки: доступ на чтение к исходному репозиторию, на чтение-запись к целевому репозиторию, и доказательства появляются автоматически. Для команд, которые не хотят, чтобы сервис читал даже хеш коммита, Enterprise ZK Mode идёт другим путём: GitHub Action из 12 строк выполняется на вашей инфраструктуре и отправляет в API Timestamp GIT только хеш коммита. Ваш исходный код никогда не покидает вашу среду.

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

Ручные проверки хороши для разового аудита. Если вы выстраиваете непрерывный комплаенс, встройте это в CI или ваши внутренние инструменты.

Получение данных верификации через API

Полная цепочка Меркла за конкретный день:

curl -s "https://timestampgit.dev/api/verify/acme-corp/payments-api/2026-09-14" \
  -o verify-2026-09-14.json

Публичные эндпоинты статуса (авторизация не нужна):

# Last anchored Bitcoin block info
curl -s "https://timestampgit.dev/api/statusLast/acme-corp/payments-api"

# Total stamped commit count
curl -s "https://timestampgit.dev/api/statusCount/acme-corp/payments-api"

# Combined summary, useful for Shields.io badges
curl -s "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api"

Получение журналов аудита и сертификатов

# Full audit ledger as CSV
curl -s "https://timestampgit.dev/api/audit/acme-corp/payments-api" -o audit.csv

# PDF certificate for a single date
curl -s "https://timestampgit.dev/api/report/acme-corp/payments-api/2026-09-14" \
  -o certificate-2026-09-14.pdf

Минимальный CI-предохранитель — провалить сборку, если последняя привязка устарела — выглядит так:

#!/usr/bin/env bash
set -euo pipefail

REPO_PATH="acme-corp/payments-api"
LAST=$(curl -s "https://timestampgit.dev/api/statusLast/${REPO_PATH}")

BLOCK=$(echo "$LAST" | python3 -c "import sys,json; print(json.load(sys.stdin).get('blockHeight',''))")

if [ -z "$BLOCK" ]; then
  echo "No anchored Bitcoin block found for ${REPO_PATH}. Check nightly anchoring."
  exit 1
fi

echo "Latest anchor confirmed in Bitcoin block ${BLOCK}"

Верификация в изолированной среде с 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, указав имя, компанию, email и, при желании, номер телефона; файл демо-лицензии можно скачать после выдачи.

FAQ

Нужно ли запускать какие-либо инструменты командной строки, чтобы проверить доказательство Timestamp GIT? Нет. Timestamp GIT предоставляет веб-верификатор, который выполняет все вычисления локально в вашем браузере. При желании вы также можете использовать стандартные инструменты OpenTimestamps, но это не обязательно.

Сколько времени нужно, чтобы доказательство стало проверяемым? После ночной привязки требуется несколько часов (обычно около 3), чтобы транзакция Bitcoin была подтверждена. После подтверждения доказательство сразу становится проверяемым.

Могу ли я проверить доказательство, не доверяя Timestamp GIT? Да. Файл .ots содержит все необходимые криптографические данные, и вы можете проверить его против блокчейна Bitcoin с помощью инструментов с открытым исходным кодом. Верификатор Timestamp GIT также работает локально, поэтому доверие к нашим серверам не требуется.

Что делать, если я потерял файл .ots? Вы можете получить его из ветки timestamps вашего репозитория или теневого репозитория. Если вы пользователь Timestamp GIT, его также можно скачать из вашей панели управления.

Заключение

Локальная проверка — это разница между «компания мне так сказала» и «я проверил это сам против блокчейна Bitcoin». С Timestamp GIT сама проверка занимает четыре шага и ноль CLI-инструментов: возьмите файл .ots, откройте страницу верификации, прочитайте высоту блока, готово. Тяжёлая работа — обнаружение коммитов, ночная пакетная обработка, построение дерева Меркла, отправка в OTS-календари, привязка к Bitcoin и отправка доказательств обратно в ваш репозиторий — происходит автоматически после установки GitHub App.

Начните с timestampgit.dev, установите GitHub App на один репозиторий и проверьте своё первое доказательство завтра. Для приватных репозиториев и рабочих процессов непрерывного комплаенса остальное покрывают планы Pro Agency и Enterprise ZK.

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

EU label: AI-generated content