SHA256
68 lines
4.7 KiB
Markdown
68 lines
4.7 KiB
Markdown
# TEXT_CHANNEL_META: профиль канала
|
||
|
||
`TEXT_CHANNEL_META` — скрытый технический `TEXT`-блок для полного снимка профиля канала после создания.
|
||
|
||
## Блок
|
||
|
||
- `msg_type = 1`
|
||
- `subType = 90`
|
||
- `msgVersion = 1`
|
||
- body использует тот же бинарный формат line-текста, что и `TEXT_POST`: line-поля + `textLen` + UTF-8 текст.
|
||
|
||
Блок пишется только в линию канала владельца. В обычной ленте сообщений он не отображается как пользовательский пост.
|
||
|
||
Первый снимок профиля публичного канала хранится прямо в `TECH_CREATE_CHANNEL.channelDescription` тем же текстовым форматом. Отдельный `TEXT_CHANNEL_META` при создании нового публичного канала UI не пишет.
|
||
|
||
## Текстовый формат
|
||
|
||
В начале текста могут идти технические теги, после них обычный текст описания:
|
||
|
||
```text
|
||
<S:title;v=1;Название канала>
|
||
<S:ava;v=2;sz=248193;pr=JEKNVnkbo3jma5nREBBJCDoXFVeKkD56V3xKrvRmWxFG;ar=AbCdEf...>
|
||
Описание канала.
|
||
```
|
||
|
||
Поддерживаемые теги:
|
||
|
||
- `<S:title;v=1;...>` — человекочитаемое имя канала.
|
||
- `<S:ava;v=2;sz=...;pr=...;ar=...>` — аватар канала: PR/Base58 в R2 либо PR/Base58 + нативный Arweave TX ID (`ar` — необязательное поле).
|
||
|
||
## Правила
|
||
|
||
- Каждый `TEXT_CHANNEL_META` задаёт полный снимок состояния профиля канала.
|
||
- Старые meta-блоки остаются в блокчейне как история, но текущее состояние берётся из последнего валидного meta-блока.
|
||
- Если `title` отсутствует, используется техническое имя канала.
|
||
- Если `avatar` отсутствует, аватар считается сброшенным.
|
||
- Если описание после тегов отсутствует, описание считается пустым.
|
||
- `meta_updated_at_ms` равен времени самого валидного meta-блока.
|
||
|
||
## Ограничения
|
||
|
||
- Длина `title` — максимум 50 Unicode code points.
|
||
- В `title` запрещены `<`, `>`, `;`, табуляция, перевод строки и `\0`.
|
||
- Длина описания — максимум 250 Unicode code points.
|
||
- `avatar.ar` — Arweave transaction id из 43 символов.
|
||
- `avatar.pr` — Base58 от 32 байт BitTorrent v2 Pieces Root (без hex и Base64URL).
|
||
- `avatar.sz` — положительный размер файла в байтах.
|
||
|
||
Если meta-блок невалиден, сервер не применяет его целиком.
|
||
|
||
## UI
|
||
|
||
- При создании публичного канала UI записывает человекочитаемое имя, аватар и описание в `TECH_CREATE_CHANNEL.channelDescription`.
|
||
- При создании канала UI показывает системную карточку `Создан канал ...`.
|
||
- При записи `TEXT_CHANNEL_META` UI показывает системную карточку `Изменён профиль канала`.
|
||
- У системных карточек нет лайка, ответа, репоста, редактирования и других действий обычного сообщения.
|
||
- По клику на системную карточку показываются аватар, человекочитаемое имя и описание на момент этого события.
|
||
|
||
## Замена старых команд
|
||
|
||
Команда `/.desc` больше не используется и не применяется сервером. Описание канала меняется только через `TEXT_CHANNEL_META`.
|
||
|
||
## Версии
|
||
|
||
- Новый UI пишет `<S:ava;v=2;sz=...;pr=...>` с **регистрозависимым** Base58. Старые аватары v1 с SHA-256/hex не отображаются и не мигрируются автоматически.
|
||
- При перестроении индекса старый тег v1 пропускается, но сам старый канал и его текст сохраняются.
|
||
- Поле `ar` при наличии остаётся оригинальным Arweave Transaction ID (Base64URL), его не перекодируем.
|