UI: добавить вложения Arweave в каналы

2026-07-30 11:04:50 +04:00
parent c7684d6fe1
commit e9e6628b21
10 changed files with 974 additions and 29 deletions
@@ -36,3 +36,34 @@ TEXT-тип хранит сообщения и редактирования.
 - Для `TEXT_EDIT_POST` и `TEXT_EDIT_REPLY` допустим `textLen=0`.
 - Такой edit трактуется как логическое удаление содержимого сообщения.
 - Для удаления используется именно edit-блок; отдельного `DELETE`-подтипа нет.
+
+## Вложения в текстовых сообщениях (`SHiNE:attach v=1`)
+
+Для `TEXT_POST`, `TEXT_REPLY`, `TEXT_EDIT_POST` и `TEXT_EDIT_REPLY` клиент может хранить вложения как технические строки в начале обычного `text`.
+
+Бинарный формат `TextBody` не меняется: вложения являются частью UTF-8 текста.
+
+Один блок вложения:
+
+```text
+<SHiNE:attach;v=1;name=report.pdf;size=845221;sha256=0123...;ar=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA>
+```
+
+Несколько вложений идут подряд в самом начале текста, по одному блоку на строку. После последнего блока идёт обычный пользовательский текст.
+
+Обязательные поля:
+
+- `v=1`
+- `name` - имя файла, закодированное через `encodeURIComponent`
+- `size` - размер файла в байтах
+- `sha256` - SHA-256 исходного файла в hex
+- `ar` - короткий Arweave Transaction ID, без полного URL
+
+Правила клиента:
+
+- если сообщение начинается с одного или нескольких валидных `<SHiNE:attach;...>` блоков, новый клиент скрывает эти блоки и показывает карточки вложений;
+- если блок битый, клиент может игнорировать только этот блок и продолжить разбор остальных;
+- старые клиенты без поддержки вложений могут показывать технические строки как обычный текст;
+- пустой пользовательский текст допустим, если перед ним есть хотя бы один валидный attach-блок.
+
+Файлы хранятся вне блокчейна, в Arweave. В блокчейне остаются только `txId`, имя, размер и SHA-256.
@@ -1,5 +1,12 @@
 # История изменений документации блокчейна

+## 2026-07-30 10:31:26 +0400
+- Базовый коммит-ориентир: `c7684d6`.
+- Для `TEXT_POST`, `TEXT_REPLY`, `TEXT_EDIT_POST` и `TEXT_EDIT_REPLY` зафиксирован клиентский формат вложений `SHiNE:attach v=1`.
+- Бинарный `TextBody` не изменён: вложения записываются техническими строками в начале UTF-8 `text`.
+- Вложение хранит `name`, `size`, `sha256` и короткий Arweave `txId` в поле `ar`; имя файла кодируется через `encodeURIComponent`.
+- В `docs/Blockchain/11_TEXT_Blocks.md` добавлены правила совместимости, отображения и допустимости пустого пользовательского текста при наличии вложений.
+
 ## 2026-07-14 20:43:43 +0400
 - Базовый коммит-ориентир: `118be41`.
 - В `docs/ИТХ/Спецификация_ИТХ_v1.md` изменён магик файла чекпоинта: