SHA256
87 lines
5.2 KiB
Markdown
87 lines
5.2 KiB
Markdown
# TEXT блоки (`type=1`, `version=1`)
|
|
|
|
TEXT-тип хранит сообщения и редактирования.
|
|
|
|
## Подтипы
|
|
|
|
1. `subType=10` — `TEXT_POST`
|
|
- пост в линии канала;
|
|
- содержит line-поля + текст.
|
|
|
|
2. `subType=11` — `TEXT_EDIT_POST`
|
|
- редактирование поста;
|
|
- line-поля + target на оригинальный POST + новый текст.
|
|
|
|
3. `subType=20` — `TEXT_REPLY`
|
|
- ответ на сообщение;
|
|
- target (`toBlockchainName`, `toBlockGlobalNumber`, `toBlockHash32`) + текст.
|
|
|
|
4. `subType=21` — `TEXT_EDIT_REPLY`
|
|
- редактирование ответа;
|
|
- target на исходный REPLY + новый текст.
|
|
- допускается пустой `text` для логического удаления сообщения (без физического удаления блока).
|
|
|
|
5. `subType=30` — `TEXT_REPOST`
|
|
- репост сообщения в линию канала;
|
|
- содержит line-поля + target на оригинальное сообщение + текст комментария;
|
|
- на текущем этапе продуктовой логики репост не редактируется (версии не накапливаются);
|
|
- временно отключён для записи через `AddBlock` до будущей реализации репостов.
|
|
|
|
6. `subType=70` — `TEXT_CHANNEL_META`
|
|
- скрытый технический снимок профиля канала;
|
|
- содержит line-поля + текст с тегами `SHiNE:title`/`SHiNE:avatar` и описанием;
|
|
- не отображается как обычное сообщение ленты;
|
|
- применяется сервером к текущему состоянию канала.
|
|
|
|
Подробная спецификация: [16_TEXT_Channel_Meta.md](./16_TEXT_Channel_Meta.md).
|
|
|
|
## Правило для edit
|
|
|
|
`EDIT_POST` и `EDIT_REPLY` должны ссылаться на **оригинальный** блок, а не на предыдущий edit.
|
|
|
|
## Пустой text в edit
|
|
|
|
- Для `TEXT_EDIT_POST` и `TEXT_EDIT_REPLY` допустим `textLen=0`.
|
|
- Такой edit трактуется как логическое удаление содержимого сообщения.
|
|
- Для удаления используется именно edit-блок; отдельного `DELETE`-подтипа нет.
|
|
|
|
## Вложения в текстовых сообщениях (`SHiNE:attach v=1/v=2`)
|
|
|
|
Для `TEXT_POST`, `TEXT_REPLY`, `TEXT_EDIT_POST` и `TEXT_EDIT_REPLY` клиент может хранить вложения как технические строки в начале обычного `text`.
|
|
|
|
Подробная спецификация: [15_TEXT_Attachments.md](./15_TEXT_Attachments.md).
|
|
|
|
Бинарный формат `TextBody` не меняется: вложения являются частью UTF-8 текста.
|
|
|
|
Один блок вложения:
|
|
|
|
```text
|
|
<SHiNE:attach;v=1;name=report.pdf;size=845221;sha256=0123...;ar=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA>
|
|
```
|
|
|
|
Для файлов с отдельным превью клиент может использовать расширенный вариант:
|
|
|
|
```text
|
|
<SHiNE:attach;v=2;name=video.mp4;size=5820193;sha256=bbbb...;ar=CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC;previewAr=DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD;previewSha256=eeee...>
|
|
```
|
|
|
|
Несколько вложений идут подряд в самом начале текста, по одному блоку на строку. После последнего блока идёт обычный пользовательский текст.
|
|
|
|
Обязательные поля:
|
|
|
|
- `v=1` или `v=2`
|
|
- `name` - имя файла, закодированное через `encodeURIComponent`
|
|
- `size` - размер файла в байтах
|
|
- `sha256` - SHA-256 исходного файла в hex
|
|
- `ar` - короткий Arweave Transaction ID, без полного URL
|
|
- для `v=2` дополнительно могут присутствовать `previewAr` и `previewSha256`
|
|
|
|
Правила клиента:
|
|
|
|
- если сообщение начинается с одного или нескольких валидных `<SHiNE:attach;...>` блоков, новый клиент скрывает эти блоки и показывает карточки вложений;
|
|
- если блок битый, клиент может игнорировать только этот блок и продолжить разбор остальных;
|
|
- старые клиенты без поддержки вложений могут показывать технические строки как обычный текст;
|
|
- пустой пользовательский текст допустим, если перед ним есть хотя бы один валидный attach-блок.
|
|
|
|
Файлы хранятся вне блокчейна, в Arweave. В блокчейне остаются только `txId`, имя, размер, SHA-256 и, при наличии отдельного preview-файла, `previewAr/previewSha256`.
|