Timestamp GIT

← All posts

2026-11-05

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

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

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

Доказательство временной метки чего-то стоит только в тот момент, когда кто-то его проверяет. До этого это файл с красивым названием — квитанция .ots, лежащая в ветке, значок в README, PDF, который никто не открывал. Вопрос, от которого зависит, переживёт ли ваше prior art юридическую проверку, спор об оплате или аудит должной осмотрительности, узкий: может ли третья сторона подтвердить, что этот конкретный хеш коммита существовал до определённой даты, не прося поставщика поручиться за это?

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

Почему проверка в браузере важна

Проверка — это момент, когда криптографическая временная метка перестаёт быть заявлением и становится доказательством. Всё, что было до неё — хеширование коммитов, пакетирование манифестов, закрепление корня Меркла в Bitcoin — это механизмы. Доказательство либо проходит проверку на другом конце, либо нет.

Два свойства делают браузер правильным местом для такой проверки:

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

Без установки, без прыжка в неизвестность. Команды по комплаенсу и внешние юристы не будут делать git clone ветки и компилировать инструменты. Им нужна независимая, воспроизводимая проверка, дающая один и тот же ответ каждый раз. URL плюс браузер это обеспечивают. То же делает публичный эндпоинт API, если вы предпочитаете скриптовать проверку в CI.

Это важно, потому что альтернатива — доверять панели управления поставщика — это именно то, от чего вы пытаетесь уйти. См. Git Commit Timestamps Aren’t Tamper-Proof — What Is, чтобы понять, почему внутренние логи в принципе отклоняются на аудитах.

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

Прежде чем что-либо проверять, знайте, что у вас в руках. Доказательство Timestamp GIT за данный день состоит из трёх слоёв артефактов:

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

Таким образом, проверка означает подъём по этой цепочке в правильном направлении: взять ваш хеш коммита, объединить его с соседними элементами, как указано в манифесте, получить хеш манифеста, затем проверить квитанцию .ots по заголовку блока Bitcoin.

Критическое свойство в том, что квитанция независима от поставщика. Она использует только SHA-256 и публичные данные блоков Bitcoin. Если Timestamp GIT исчезнет завтра, квитанция всё равно пройдёт проверку по блокчейну с помощью открытых инструментов. Это не маркетинговое заявление — это ограничение на формат доказательства, и именно поэтому проверка в браузере может быть честной.

Эти файлы хранятся в отдельной ветке timestamps (или в отдельном теневом репозитории), поэтому они версионируются вместе с вашим кодом, никогда не раскрывая содержимое исходников.

Шаг за шагом: проверка доказательства в браузере

Вот полный путь от «у меня есть репозиторий» до «вот артефакт, который аудитор может сохранить».

1. Начните со страницы статуса репозитория

Откройте публичную страницу статуса репозитория:

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

Это ваш обзор, и он отвечает на большинство первых вопросов: долговечность доказательств (насколько далеко назад уходит цепочка), самая ранняя дата закрепления, было ли закрепление ежедневным и регулярным, а также данные о блоках и транзакциях Bitcoin для каждого дня. Есть календарная тепловая карта, чтобы пробелы были видны с первого взгляда, плюс загрузки полного журнала аудита (CSV) и PDF-сертификата.

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

curl -s https://timestampgit.dev/api/statusLast/acme/payments-service
curl -s https://timestampgit.dev/api/statusCount/acme/payments-service
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-service

2. Откройте страницу проверки для конкретной даты

Для фактической проверки доказательства перейдите к интересующей вас дате:

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

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

Это та страница, которую нужно отправить юристу. Она не требует аккаунта, CLI и объяснений того, что такое OpenTimestamps.

3. Используйте значок как публичную точку входа

Встраиваемые значки — это низкопороговая версия того же самого. Добавьте один в свой README, и любой — аудитор, покупатель, юрист противной стороны — сможет перейти к проверке, не зная структуры вашего репозитория.

Виджет встраивания значка по адресу /connected/{user}/{repo} даёт вам живой предпросмотр плюс фрагмент Markdown. Сам значок подкреплён эндпоинтом сводки, поэтому он отражает реальные закреплённые данные, а не статичное изображение.

Значки — это решение о раскрытии, а не о безопасности: они показывают что вы ставите временные метки, а не что вы написали.

4. Проверяйте программно через публичный API

Для CI-пайплайнов или скрипта комплаенса получите данные цепочки Меркла и проверьте локально:

curl -s "https://timestampgit.dev/api/verify/acme/payments-service/2026-10-14" \
  -o chain.json

Ответ содержит полную цепочку за этот день. Затем ваш скрипт сам пересчитывает хеши — та же математика, что выполняет страница в браузере:

// Node 18+ — recompute each Merkle step locally, never trust the server's answer
import { createHash } from "node:crypto";

const sha256 = (hex) =>
  createHash("sha256").update(Buffer.from(hex, "hex")).digest("hex");

const chain = JSON.parse(await readFile("chain.json", "utf8"));

// Walk leaf -> root. Each step concatenates the current hash with its sibling,
// hashes the pair, and continues. The final value must equal the anchored root.
let current = sha256(commitSha);
for (const step of chain.steps) {
  const [left, right] = step.order === "lr" ? [current, step.sibling] : [step.sibling, current];
  current = sha256(left + right);
}

console.log(current === chain.merkleRoot ? "PROOF OK" : "PROOF MISMATCH");

Смысл делать это самому в том, что скриптовая проверка — это воспроизводимое доказательство проверки, и она не зависит от того, правильно ли отрисовалась панель управления.

5. Скачайте PDF-сертификат

Когда нужно что-то приложить к письму или договору, страница статуса предлагает PDF-сертификат за конкретную дату, также доступный напрямую:

https://timestampgit.dev/api/report/{user}/{repo}/{date}

А для полного журнала, а не одного дня:

curl -s https://timestampgit.dev/api/audit/acme/payments-service -o audit.csv

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

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

  • Что говорит действительное доказательство: этот хеш коммита существовал в момент того блока Bitcoin или раньше. Ни больше, ни меньше. Оно не говорит, что код компилируется, что он оригинален или что он хорош. Prior art — это о существовании и времени.
  • Что означает «в ожидании»: ночной воркер пакетирует хеши после полуночи, строит дерево Меркла и закрепляет корень. Затем подтверждение Bitcoin занимает несколько часов — обычно около 3 часов — и файлы доказательств записываются обратно в ваш репозиторий после подтверждения. Коммиты за сегодня обычно не будут иметь окончательного доказательства до следующего дня.
  • Приватные репозитории: URL статуса для приватных репозиториев включают зашифрованный HMAC, специфичный для экземпляра сервера, поэтому только авторизованные пользователи могут читать статус. Проверка по-прежнему выполняется локально в браузере, а лежащие в основе квитанция .ots и манифест могут быть проверены без раскрытия содержимого репозитория.
  • Если доказательство не проходит проверку: сначала проверьте скучные вещи — правильный репозиторий, правильная дата и правильный манифест. Квитанция .ots проходит проверку только по тому хешу манифеста, для которого она была создана; сопоставление её с манифестом другого дня корректно и сбивающе с толку провалится.
  • Изолированные среды: лицензия Docker для самостоятельного размещения запускает весь стек — включая UI проверки и API — на вашей собственной инфраструктуре, поэтому проверка никогда не покидает вашу сеть.

Как Timestamp GIT делает проверку автоматической

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

За этим конвейер пакетирует хеши коммитов в очередь, группирует их в полночь в файлы манифестов по репозиториям, строит дерево Меркла, создаёт доказательства OpenTimestamps по публичным календарям и закрепляет корень в Bitcoin. Затем файлы доказательств отправляются обратно в ветку timestamps или теневой репозиторий. Для команд, которым нужно, чтобы исходники оставались полностью недосягаемыми для сервиса, режим Enterprise ZK использует GitHub Action из 12 строк, который отправляет только хеши коммитов из вашей собственной инфраструктуры — сервис создаёт проверяемые доказательства без доступа на чтение к исходному репозиторию.

Если вам нужна проверка с самостоятельным размещением, быстрый старт с 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.

FAQ

Нужно ли устанавливать какое-либо ПО для проверки доказательства временной метки Bitcoin? Нет. Страницы проверки Timestamp GIT работают полностью в вашем браузере, а публичные эндпоинты API возвращают данные цепочки Меркла для локальных проверок. Вы также можете скачать квитанцию .ots и проверить её офлайн стандартными инструментами OpenTimestamps, если предпочитаете.

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

Что, если транзакция Bitcoin для моего доказательства ещё не подтверждена? Подтверждение Bitcoin обычно занимает около 3 часов. Пока транзакция не подтверждена в блоке, доказательство находится в ожидании; после подтверждения оно становится неизменным и может быть проверено в вашем браузере.

Как проверить доказательство для приватного репозитория? URL статуса приватного репозитория включают зашифрованный HMAC, поэтому только авторизованные пользователи могут их просматривать. Вы также можете скачать квитанцию .ots и манифест из ветки timestamps и проверить их локально, не раскрывая данные репозитория.

Заключение

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

Если вы ещё не настроили это, последовательность короткая: подключите репозиторий к Timestamp GIT через GitHub App, дайте ночной задаче закрепить ваши коммиты, затем откройте страницу статуса и проверьте одну дату от начала до конца. Эта единственная успешная проверка — разница между «у нас есть логи» и «у нас есть доказательство». Если вы хотите сначала настроить всё без CLI, читайте далее How to Timestamp Git Commits Without the Command Line.

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

EU label: AI-generated content