OpenTimestamps без CLI: управляемая временная привязка в Bitcoin
Если вы когда-нибудь задумывались о том, как доказать, что фрагмент кода существовал в определённую дату, вы наверняка сталкивались с OpenTimestamps. Вы также наверняка сталкивались с тем, о чём никто не пишет в заголовках: командная строка, календари, файлы .ots и смутное ощущение, что теперь вам нужно разобраться в транзакциях Bitcoin.
Эта статья — объяснение OpenTimestamps без CLI. Не потому, что протокол плох — он действительно превосходен, — а потому, что командная строка является деталью реализации, а не обязательным требованием. Существует управляемый путь, при котором GitHub App следит за вашим репозиторием и привязывает каждый коммит к Bitcoin, пока вы спите. Вы устанавливаете его один раз. Вы никогда не вводите команду временной привязки.
Мы рассмотрим, что на самом деле делает OpenTimestamps, почему аналогия с нотариусом подходит почти идеально, что происходит под капотом каждую ночь и какие заблуждения мешают командам внедрять его. Механика протокола здесь рассматривается как фон; в центре внимания — автоматизированный рабочий процесс и то, что он вам даёт.
Что такое OpenTimestamps без CLI?
OpenTimestamps — это протокол для доказательства того, что некоторые данные существовали в определённый момент времени или раньше. Он делает это, агрегируя данные в дерево Меркла, хешируя корень и фиксируя этот корень в блоке Bitcoin. Поскольку блоки Bitcoin неизменяемы и глобально реплицируются, привязка становится публичной, защищённой от подделки записью о существовании.
CLI — всего лишь один из интерфейсов к этому протоколу. Веб-сервис, GitHub App или планировщик могут делать то же самое — и делать это лучше, потому что пакетирование и работа с календарями — это то, в чём люди плохи.
Управляемый подход выглядит так: вы устанавливаете GitHub App Timestamp GIT на репозиторий. С этого момента каждый коммит обнаруживается автоматически, пакетируется каждую ночь и привязывается к Bitcoin через OpenTimestamps. Доказательства возвращаются в ваш репозиторий в виде файлов квитанций и манифестов. Никаких команд, никаких локальных инструментов, никакой ноды Bitcoin.
Чтобы чётко обозначить рамки: эта статья объясняет концепцию и управляемый рабочий процесс. Она не проводит вас через операции с сырым протоколом. Если вы хотите углубиться в смежные темы, см. как проверить доказательство временной привязки Bitcoin в браузере и почему ваш Git log — не доказательство.
Простая аналогия: нотариус для вашего кода
Представьте нотариуса. Вы передаёте ему документ. Он его не читает. Он вычисляет защищённую от подделки печать, ставит на неё дату и записывает эту печать в публичный реестр, который может проверить любой. Позже, если кто-то оспорит дату, вы предъявляете документ, пересчитываете печать и указываете на запись в реестре.
OpenTimestamps — это такой нотариус с двумя улучшениями:
- «Документ» — это хеш, а не ваш код. Git уже создаёт уникальный односторонний хеш (SHA-1 или SHA-256) для каждого коммита, представляющий точное состояние вашего репозитория в тот момент. Этот хеш — отпечаток. Timestamp GIT работает только с отпечатком.
- Реестр — это блокчейн Bitcoin. Вместо прошнурованной книги нотариуса в шкафу печать записывается в блок, который реплицируют тысячи независимых нод. Никто — ни вы, ни мы, ни судебный приказ — не может её переписать.
Третье улучшение — то, что важно в повседневной работе: с Timestamp GIT нотариус приходит к вам автоматически каждую ночь. Без записи, без очереди, без бумажной волокиты. Вы коммитите код; привязка происходит по расписанию, о котором вы никогда не думаете.
Как это работает под капотом (кратко)
Три шага, и только средний включает что-то похожее на инфраструктуру.
Шаг 1 — Отпечаток. Когда вы делаете коммит, Git генерирует уникальный хеш для этого коммита. Timestamp GIT собирает только эти хеши. Ваш исходный код никогда не читается, не копируется и не хранится.
Шаг 2 — Привязка. Полуночный cron-воркер группирует все ожидающие хеши, строит нативное дерево Меркла для каждого репозитория, создаёт файл манифеста .txt и привязывает корень Меркла к Bitcoin с помощью публичных календарей OpenTimestamps.
Шаг 3 — Доказательство. Манифест и файлы квитанций .ots отправляются обратно в ваш репозиторий — в выделенную ветку timestamps или в отдельный теневой репозиторий. Оттуда любой может проверить их офлайн по данным блоков Bitcoin.
Две операционные детали, которые стоит знать:
- Подтверждение Bitcoin занимает несколько часов, обычно около трёх. Поэтому запись доказательств завершается через несколько часов после ночного пакета, а не мгновенно.
- Проверка не зависит от вендора. Доказательство опирается только на SHA-256 и данные блоков Bitcoin. Никакого проприетарного формата, никакой привязки к вендору.
Вот как концептуально выглядит результат ночного пакета:
timestamps/
├── 2026-11-05/
│ ├── manifest.txt # commit hashes for the day
│ └── manifest.txt.ots # OpenTimestamps receipt for the Merkle root
└── 2026-11-06/
├── manifest.txt
└── manifest.txt.ots
Квитанции — это артефакт, который вы сохраняете. Всё остальное — удобство.
Почему управляемая временная привязка важна
Запустить протокол самостоятельно возможно. Это также проект по сопровождению: надёжность календарей, логика пакетирования, обработка подтверждений Bitcoin, хранение квитанций и история проверки для аудиторов. Для большинства команд это отвлечение от самого продукта.
Управляемый сервис убирает эти движущиеся части:
- Знания протокола не требуются. Вам не нужно изучать серверы календарей, доказательства Меркла или структуру транзакций Bitcoin. Сложный путь существует; вам разрешено его пропустить.
- Доказательства, готовые для суда и не зависящие от вендора. Свидетельства живут в Bitcoin, а не в нашей базе данных. Любой может их проверить, не доверяя нам.
- Соответствие рабочему процессу. Установите GitHub App один раз. Каждый последующий коммит привязывается автоматически. Не нужно менять привычки, ничего не нужно устанавливать на машины разработчиков.
- Поверхность для комплаенса. Публичные бейджи проверки для README, загружаемые аудиторские CSV и PDF-сертификаты на каждую дату дают аудиторам что-то конкретное для изучения.
Для агентств и фрилансеров последний пункт реально работает во время споров об оплате и заявлений об авторстве. Для компаний это щит против патентных троллей, заявляющих права на то, что уже работает во внутренних системах.
Распространённые заблуждения об OpenTimestamps
«Нужно быть экспертом по Bitcoin». Вам нужно доверять математике, а не экспертизе. С управляемым сервисом сложность берётся на себя: пакетирование, привязка и доставка доказательств происходят по расписанию. Вы взаимодействуете с панелью управления и веткой в вашем репозитории.
«Временная привязка раскрывает мой исходный код». Нет. Привязываются только хеши коммитов. Сервис никогда не видит, не копирует и не хранит ваш код — принцип нулевого знания архитектурный, а не обещание в политике. В режиме Enterprise ZK отправка хеша выполняется как GitHub Action на вашей собственной инфраструктуре, передавая в API только хеш, так что сервис вообще не имеет доступа на чтение к исходному репозиторию.
«Доказательства надёжны лишь настолько, насколько надёжен вендор».
Доказательства нативны для Bitcoin. Вы можете скачать файлы квитанций .ots и проверить их офлайн с помощью стандартной проверки OpenTimestamps по блокчейну. Если Timestamp GIT исчезнет завтра, ваши доказательства останутся действительными.
«Это дорого и медленно». Ежедневное пакетирование означает, что множество коммитов делят одну привязку в Bitcoin, — поэтому экономика сходится. Подтверждение занимает несколько часов — это приемлемо для свидетельств о предшествующем уровне техники, которые оцениваются в месяцах и годах, а не в минутах.
Начало работы без CLI
Есть два режима развёртывания, и ни один из них не требует терминала на машинах разработчиков.
Стандартный режим (GitHub App). Установите GitHub App на репозитории, которые хотите отслеживать. Он автоматически читает хеш коммита HEAD и записывает доказательства в выделенную ветку — либо в том же репозитории, либо в отдельном целевом репозитории. Модель разрешений GitHub требует как минимум доступа на чтение к исходному репозиторию (разрешения только на хеш коммита не существует), а также доступа на чтение и запись к целевому репозиторию.
Режим Enterprise ZK. GitHub Action из 12 строк работает на вашей инфраструктуре и отправляет в API Timestamp GIT только хеш коммита. Здесь вам нужен доступ на чтение и запись только к целевому репозиторию и никакого доступа на чтение к исходному. Выбирайте этот вариант, когда даже видимость хеша должна оставаться внутри вашего периметра.
В любом случае последовательность после установки без событий: коммиты обнаруживаются, хеши ставятся в очередь, ночной воркер привязывает их, и доказательства появляются в вашей ветке timestamps через несколько часов после подтверждения Bitcoin.
Самостоятельный хостинг с 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 и, при желании, номер телефона; файл лицензии скачивается сразу.
Что вы получаете после запуска
- Публичная панель статуса для каждого репозитория: долговечность доказательств, самая ранняя дата привязки, ежедневная регулярность, данные блоков и транзакций Bitcoin, календарная тепловая карта, а также загружаемые аудиторские CSV и PDF-сертификат.
- Бейджи проверки для вашего README со ссылкой, по которой любой может проверить временную привязку. Для приватных репозиториев к URL добавляется зашифрованный HMAC, чтобы статус видели только авторизованные пользователи.
- Браузерный верификатор, который выполняет многоуровневую проверку цепочки Меркла локально, так что никто не видит, что вы проверяете.
- REST API, если вы хотите автоматизировать проверки статуса:
/api/statusLast/{user}/{repo},/api/statusCount/{user}/{repo},/api/audit/{user}/{repo}и другие.
# Check the last anchored Bitcoin block for a repo
curl https://timestampgit.dev/api/statusLast/youruser/yourrepo
Тарифы соответствуют тому, сколько приватности вам нужно: Open Source для публичных репозиториев, Pro Agency для приватных репозиториев и Enterprise ZK для изоляции на основе GitHub Action. Подробности на странице тарифов.
FAQ
Нужно ли устанавливать какое-либо ПО или выполнять команды, чтобы использовать OpenTimestamps с Timestamp GIT?
Нет. Timestamp GIT — управляемый GitHub App. Вы устанавливаете его один раз, и он автоматически проставляет временные привязки вашим коммитам каждую ночь. Не нужно устанавливать CLI-инструменты или выполнять команды.
Как Timestamp GIT гарантирует приватность моего исходного кода?
Timestamp GIT работает по принципу нулевого знания: он обрабатывает только хеши коммитов Git, но никогда ваш фактический исходный код. В режиме Enterprise ZK даже хеши отправляются из вашей инфраструктуры через GitHub Action, так что сервис никогда не имеет доступа на чтение к вашему репозиторию.
Могу ли я проверить временные привязки независимо, не доверяя Timestamp GIT?
Да. Доказательства привязаны к блокчейну Bitcoin с помощью протокола OpenTimestamps. Вы можете скачать файлы квитанций .ots и проверить их офлайн с помощью стандартной проверки OpenTimestamps или воспользоваться встроенным браузерным верификатором, который работает локально.
Что произойдёт, если Timestamp GIT прекратит существование?
Ваши доказательства останутся действительными, потому что они встроены в блокчейн Bitcoin. Проверка опирается только на Bitcoin и SHA-256, поэтому вы сможете и дальше независимо доказывать существование своего кода.
Заключение
OpenTimestamps решает реальную проблему — доказательство того, что данные существовали в определённое время, — и решает её с помощью одних лишь хеширования и Bitcoin. Командная строка никогда не была сутью. Она была лишь первым интерфейсом.
Управляемый интерфейс лучше соответствует тому, как команды работают на самом деле: установите GitHub App, продолжайте коммитить и позвольте ночной задаче привязывать хеши. Вы получаете квитанции .ots, ветку манифестов, бейджи проверки, аудиторские CSV и PDF-сертификаты — всё подкреплено доказательствами, которые переживут вендора.
Если вы хотите автоматизированную версию, установите Timestamp GIT на репозиторий и сделайте коммит. Это вся настройка. Нотариус придёт сегодня ночью.