Timestamp GIT

← All posts

2026-10-28

Timestamp GIT или OpenTimestamps CLI: что подходит вашей команде?

Timestamp GIT или OpenTimestamps CLI: что подходит вашей команде?
timestamp git blockchain proof

Timestamp GIT против OpenTimestamps CLI: что подходит вашей команде?

Вы уже приняли интересное решение: ваша история Git будет привязана к блокчейну Bitcoin, чтобы через месяцы или годы вы могли доказать, что коммит существовал в конкретную дату. Хороший выбор.

Скучное — и гораздо более дорогое — решение впереди. Кто будет обслуживать конвейер?

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

Решение о покупке: ручной CLI против управляемой автоматизации

Протокол OpenTimestamps открыт и бесплатен. Ничто не мешает вам обернуть его в собственные скрипты: собирать хеши, пакетировать их, создавать квитанции, хранить их где-то надёжно и надеяться, что кто-то вспомнит проверить, что каждое доказательство в итоге подтвердилось в блоке Bitcoin.

Это «надеяться, что кто-то вспомнит» — суть проблемы. Конвейер проставления меток времени несложно запустить и на удивление трудно годами поддерживать в корректном состоянии. Привязка к Bitcoin асинхронна — доказательство не становится окончательным в момент создания; подтверждение в блоке занимает часы. Кто-то должен отслеживать ожидающие доказательства, перепроверять их, сохранять результаты и поддерживать работу всей системы при смене персонала.

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

Компромисс симметричен и честен:

  • CLI: максимальный контроль, нулевая стоимость лицензии, весь операционный риск на вас.
  • Timestamp GIT: меньше контроля над внутренностями, предсказуемая стоимость, операционный риск (и скучные части) на стороне вендора.

Это сравнение остаётся на операционном и комплаенс-уровне. Если вам нужна теория протокола, сначала прочитайте What Does a Bitcoin Timestamp Prove About Your Code? — остальная часть этой статьи предполагает, что вы знаете, зачем вам нужны доказательства, а не как работает хеширование.

Ландшафт: какие варианты существуют для проставления меток времени на коммиты Git?

На практике встречаются три реалистичных схемы:

1. OpenTimestamps CLI (сделай сам). Бесплатный инструментарий с открытым исходным кодом для создания и проверки доказательств меток времени на файлах. Это по-настоящему хорошее ПО, и это тот же протокол, на котором строят все остальные. Но он не знает, что такое Git. Вы пишете связующий код: скрипт, который извлекает хеши коммитов, пакетирует их, вызывает инструментарий, загружает полученные квитанции .ots куда-то надёжно, и второй процесс, который отслеживает каждое доказательство, пока оно не попадёт в блок Bitcoin. Это трудный путь, и это постоянная статья расходов на сопровождение.

2. Timestamp GIT (управляемый). SaaS с GitHub App. Он читает хеш HEAD-коммита отслеживаемых репозиториев, пакетирует все ожидающие хеши от всех клиентов в полночь, строит дерево Меркла для каждого репозитория и привязывает корень Меркла к Bitcoin через протокол OpenTimestamps. Манифест и квитанции .ots отправляются обратно в ваш собственный репозиторий — либо в выделенную ветку timestamps, либо в отдельный теневой репозиторий. Сверху — значки верификации, публичная панель статуса, экспорт аудита в CSV/PDF и REST API.

3. Гибрид. Управляемый сервис для непрерывного покрытия всего, что выпускается, плюс ручной процесс для случайных артефактов вне Git (проектный документ, спецификация, прошивка). Это распространено и разумно. Доказательства совместимы; ничего не ломается при смешивании.

Стоит сказать прямо: вы не можете проставить метки времени на историю Git задним числом и получить ту же ценность. Доказательства важнее всего, когда они непрерывны и скучны, охватывают каждый коммит, включая тот, который окажется важным восемнадцать месяцев спустя в патентном споре.

Критерии выбора: как оценивать варианты

На практике это решают пять критериев. Оцените оба варианта по каждому, прежде чем смотреть на ценник.

Простота настройки. Путь с CLI означает скриптинг, проектирование хранения доказательств и решения о том, на какие календарные серверы OpenTimestamps вы полагаетесь. Заложите дни на первую версию и постоянное время на дрейф. Timestamp GIT устанавливается как GitHub App: подключите репозиторий — готово. В режиме Standard ему нужен доступ только на чтение к исходному репозиторию (в GitHub нет области «только хеш коммита») и доступ на чтение и запись к репозиторию, где хранятся доказательства. На машины разработчиков ничего не устанавливается.

Автоматизация. С CLI метки времени ставятся, когда запускается ваш скрипт — то есть cron-задание, шаг CI или человек. С Timestamp GIT полуночный cron-воркер группирует все ожидающие хеши, записывает манифесты по репозиториям, строит дерево Меркла, создаёт доказательства и привязывает корень. Подтверждение Bitcoin обычно занимает около трёх часов, поэтому квитанции появляются через несколько часов после полуночи, без участия человека.

Безопасность и приватность. Самодельные конвейеры держат всё внутри, но вы также владеете каждым режимом отказа. Timestamp GIT по дизайну работает по принципу нулевого знания: он никогда не видит, не копирует и не хранит исходный код — только хеши коммитов. Два режима развёртывания покрывают весь спектр:

  • Режим Standard (GitHub App): автоматический, только чтение исходников, чтение и запись в целевой репозиторий доказательств.
  • Режим Enterprise ZK: GitHub Action из 12 строк работает на вашей инфраструктуре и отправляет в API только хеш коммита, поэтому сервису никогда не нужен доступ на чтение к исходному репозиторию.

Для изолированных или максимально защищённых сред лицензия на самостоятельный хостинг в Docker запускает то же приложение внутри вашей собственной сети.

Интеграция и аудируемость. CLI даёт вам сырые файлы .ots и оставляет отчётность вам. Timestamp GIT даёт встраиваемые значки для README, публичную панель статуса по каждому репозиторию (долговечность доказательств, самая ранняя дата привязки, ежедневная регулярность, данные о блоках и транзакциях Bitcoin, календарная тепловая карта), загружаемый CSV для аудита, PDF-сертификаты по каждой дате и страницу верификации, где вся цепочка Меркла вычисляется локально в браузере.

Стоимость. CLI бесплатен по лицензии и дорог в инженерных часах — и эти часы повторяются. Timestamp GIT имеет тарифы: Open Source (бесплатно, публичные репозитории), Pro Agency ($49/мес, приватные репозитории), Enterprise ZK ($199/мес, GitHub Actions). Docker-образ лицензируется отдельно, доступна демо-лицензия с ограниченным сроком по запросу. Подробный разбор — в Git Commit Timestamp Service Pricing: Which Tier Fits Your Team.

Сравнение бок о бок: Timestamp GIT против OpenTimestamps CLI

Критерий OpenTimestamps CLI Timestamp GIT
Трудозатраты на настройку Дни на скриптинг: извлечение хешей, пакетирование, хранение доказательств, настройка календарей Установите GitHub App, выберите репозитории. Ноль изменений кода, ничего на машинах разработчиков
Уровень автоматизации То, что вы запланируете — cron, CI или ручные запуски Автоматическая ночная привязка через полуночный cron-воркер
Модель безопасности Полный контроль; ваша инфраструктура, ваши решения по ключам и хранению Нулевое знание: только хеши. Standard (GitHub App) или Enterprise ZK (GitHub Action из 12 строк); Docker для изолированных сред
Доставка доказательств Файлы, которые вы сами создаёте и храните Манифест .txt + квитанции .ots, отправляемые в ветку timestamps или теневой репозиторий
Методы верификации Стандартные инструменты верификации OpenTimestamps, запускаемые вами Локальная страница верификации Меркла в браузере, ссылки на значки, PDF-отчёт — плюс стандартные инструменты OTS, если хотите
Аудит и отчётность Стройте сами Панель статуса, CSV для аудита, PDF-сертификат, REST API
Цены Бесплатный инструмент; повторяющиеся инженерные часы Open Source бесплатно · Pro Agency $49/мес · Enterprise ZK $199/мес · лицензия Docker
Поддержка Ваша собственная команда Управляемый вендором сервис; самостоятельный хостинг поставляется с мастером настройки и документацией
Привязка к вендору Отсутствует по определению Отсутствует: стандартные доказательства .ots, привязанные к Bitcoin, проверяемые офлайн

Два уточнения, важных для проверяющих по комплаенсу.

Во-первых, оба пути дают один и тот же класс доказательств: доказательство, привязанное к блоку Bitcoin, проверяемое по публичным данным блокчейна. Timestamp GIT добавляет удобные слои — значки, панели, сертификаты, API — а не иное криптографическое обязательство.

Во-вторых, это означает отсутствие привязки к вендору. Если вендор завтра исчезнет, доказательства в вашем репозитории останутся проверяемыми офлайн с использованием данных блоков Bitcoin. Вы также можете перепроверить их через собственный API продукта:

# Latest anchored block + totals for a repo (public)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-service

# Full Merkle chain data for a specific day, for local verification
curl -s https://timestampgit.dev/api/verify/acme/payments-service/2026-10-14

# Download the complete audit ledger as CSV
curl -LO https://timestampgit.dev/api/audit/acme/payments-service

# PDF certificate for one date
curl -LO https://timestampgit.dev/api/report/acme/payments-service/2026-10-14

Значки — самый дешёвый сигнал комплаенса, который вы можете внедрить. GET /api/badgeLink/{user}/{repo} возвращает URL-адреса значков плюс готовый к вставке блок Markdown для вашего README, так что любой, кто просматривает репозиторий, может перейти на публичную страницу статуса. Приватные репозитории получают зашифрованный HMAC, добавляемый к их URL-адресам и привязанный к экземпляру сервера, так что только авторизованные люди могут читать статус.

Вердикт: кому что выбрать?

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

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

Выбирайте 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 и настройку экземпляра.

Практичный путь миграции: начните с бесплатного тарифа Open Source для публичных репозиториев, убедитесь, что ночные квитанции действительно попадают в вашу ветку timestamps, затем переходите на Pro Agency, когда в область охвата войдут приватные репозитории.

FAQ

Могу ли я использовать Timestamp GIT и OpenTimestamps CLI вместе?

Да. Timestamp GIT создаёт стандартные файлы доказательств .ots, совместимые с протоколом OpenTimestamps. Вы можете проверять доказательства Timestamp GIT с помощью стандартных инструментов верификации OpenTimestamps, если предпочитаете, но это не обязательно — Timestamp GIT предоставляет собственную панель верификации и PDF-сертификаты.

Привязывает ли меня Timestamp GIT к проприетарному формату?

Нет. Timestamp GIT привязывает доказательства к блокчейну Bitcoin через протокол OpenTimestamps. Доказательства не зависят от вендора и могут быть проверены офлайн с использованием данных блоков Bitcoin. Вы не привязаны к вендору.

Как Timestamp GIT работает с приватными репозиториями?

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

Есть ли вариант самостоятельного хостинга для Timestamp GIT?

Да. Timestamp GIT предлагает Docker-образ для самостоятельного хостинга, идеальный для изолированных или высокозащищённых сред. Быстрый старт с Docker Compose включает образ Timestamp GIT (rue1401/timestampgit:prod) и образ Valkey (valkey/valkey:8). Демо-лицензия с ограниченным сроком доступна по запросу.

Какой вариант дешевле для команды из пяти человек?

Зависит от того, что вы считаете. У CLI нет лицензионного сбора, но инженерные часы повторяются каждый месяц, и конвейер должен переживать смену персонала. Сравните это с Pro Agency за $49/мес для приватных репозиториев — и помните, что результат в виде доказательств — это один и тот же класс доказательств в обоих случаях.

Заключение

OpenTimestamps CLI — правильный ответ, когда требование — контроль, и у вас есть люди, чтобы его поддерживать. Для большинства команд требование на самом деле — покрытие: каждый коммит, каждую ночь, без того, чтобы кто-то помнил о необходимости что-то запустить. Это операционная задача, и именно её создан поглощать Timestamp GIT — установите GitHub App один раз, позвольте полуночному воркеру привязать ваши хеши коммитов к Bitcoin, и выпускайте значок, когда доказательство уже в вашем репозитории.

Установите GitHub App на тестовый репозиторий сегодня и проверьте завтра утром, что квитанции на месте. Этот пятиминутный эксперимент скажет вам больше, чем любая сравнительная таблица.

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

EU label: AI-generated content