feat: экспорт документов в .sig v2.0 + manifest.json (верификатор) #65

2026-06-03T08:03:48Z

claude commented

2026-06-03 08:03:48 +00:00

Что

Перевод экспорта документов на самодостаточный формат detached-подписи .sig v2.0 (вместо signature.txt v1.0.0) — для нового Верификатора документов (C9S/verificator).

Изменения

cooptypes (Cooperative.Document): канонический тип SigFile v2.0 + PackageManifest + OID-константы (secp256k1/SHA-256). Единый источник формата.
desktop (prepareDocumentArchive / prepareDocumentPackageArchive): архив кладёт <doc>.sig (JSON v2.0) со встроенным сертификатом подписанта; пакет — manifest.json + <doc>.sig на документ.

Ключевые решения

canonicalization: 'legacy-node-stringify' — реальные документы подписаны SDK через SHA-256(JSON.stringify(meta)). SDK на JCS не переключаем (хэши уходят в блокчейн); верификатор dual-mode валидирует legacy.
canonical (doc_hash/meta_hash/hash) кладём как есть из агрегата: doc_hash из фабрики в верхнем регистре (SHA-256 байтов PDF), meta_hash/hash из SDK в нижнем. Верификатор сверяет цепочку по этим строкам.
Подпись/хэши не пересчитываются — берём готовые из подписанного документа.

Риск

Минимальный: трогается только lib-функция экспорта (UI/вёрстка не затронуты) + аддитивный тип в cooptypes. signature.txt больше не пишется; уже скачанные архивы верификатор принимает как legacy.

Задача: [794-4] E2 — Верификатор документов v1.

## Что Перевод экспорта документов на самодостаточный формат detached-подписи `.sig` v2.0 (вместо `signature.txt` v1.0.0) — для нового **Верификатора документов** (C9S/verificator). ### Изменения - **cooptypes** (`Cooperative.Document`): канонический тип `SigFile` v2.0 + `PackageManifest` + OID-константы (secp256k1/SHA-256). Единый источник формата. - **desktop** (`prepareDocumentArchive` / `prepareDocumentPackageArchive`): архив кладёт `<doc>.sig` (JSON v2.0) со встроенным сертификатом подписанта; пакет — `manifest.json` + `<doc>.sig` на документ. ### Ключевые решения - `canonicalization: 'legacy-node-stringify'` — реальные документы подписаны SDK через `SHA-256(JSON.stringify(meta))`. SDK на JCS **не** переключаем (хэши уходят в блокчейн); верификатор dual-mode валидирует legacy. - `canonical` (`doc_hash`/`meta_hash`/`hash`) кладём **как есть** из агрегата: `doc_hash` из фабрики в верхнем регистре (SHA-256 байтов PDF), `meta_hash`/`hash` из SDK в нижнем. Верификатор сверяет цепочку по этим строкам. - Подпись/хэши не пересчитываются — берём готовые из подписанного документа. ### Риск Минимальный: трогается только lib-функция экспорта (UI/вёрстка не затронуты) + аддитивный тип в cooptypes. `signature.txt` больше не пишется; уже скачанные архивы верификатор принимает как legacy. Задача: [794-4] E2 — Верификатор документов v1.

claude added 2 commits 2026-06-03 08:03:48 +00:00

[794-4][@ant ] feat(cooptypes): канонический тип SigFile v2.0 + PackageManifest для верификатора — единый источник формата .sig (целостность+подпись+OID), чтобы desktop-экспорт и верификатор ссылались на один контракт 28ce608efe

[794-4][@ant ] feat(desktop): экспорт документов в .sig v2.0 + manifest.json вместо signature.txt — самодостаточный доказательный архив (canonical как есть, legacy-канонизация, встроенный сертификат) для верификатора

Typecheck / desktop (pull_request) Has been cancelled

Details

Typecheck / controller (pull_request) Has been cancelled

Details

067718cf1f

claude added 3 commits 2026-06-03 18:46:53 +00:00

[794-4][@ant ] feat(sdk): версия подписи 1.1.0 с детерминированной канонизацией meta (JCS RFC 8785) — meta_hash перестаёт зависеть от порядка ключей; 1.0.0 остаётся legacy; compareDocuments берёт версию из документа (бэкенд авто-корректен) 4a5f41d15e

[794-4][@ant ] feat(cooptypes): canonicalizationForVersion(version) — единый источник соответствия версия подписи → режим канонизации (.sig для desktop и верификатора) da55cbac08

[794-4][@ant ] feat(desktop): .sig пишет canonicalization по версии документа (1.1.0→jcs-1.0) + signed_at чистится до подписанного формата байт-в-байт