SHA256
36 lines
4.2 KiB
Markdown
36 lines
4.2 KiB
Markdown
# Вложения в TEXT-сообщениях (`S:att;v=1`)
|
||
|
||
Технический префикс в UTF-8 `text` для `TEXT_POST`, `TEXT_REPLY`, `TEXT_EDIT_POST`, `TEXT_EDIT_REPLY`. Бинарный формат TEXT не меняется. До 10 вложений в начале сообщения, затем обычный текст; порядок сохраняется.
|
||
|
||
## Канонический формат (2026-11)
|
||
|
||
```text
|
||
<S:att;v=1;nm=photo.jpg;sz=248193;pr=BASE58_ROOT;mm=image/jpeg>
|
||
<S:att;v=1;nm=video.mp4;sz=15000000;pr=BASE58_ROOT;mm=video/mp4;ar=TXID>
|
||
Текст публикации
|
||
```
|
||
|
||
- `v` — версия (1).
|
||
- `nm` — имя файла в `encodeURIComponent`.
|
||
- `sz` — размер подготовленных байтов в десятичном виде.
|
||
- `pr` — **BitTorrent v2 Pieces Root (32 байта), Base58**, не SHA-256 целого файла; текущий стандарт новых вложений.
|
||
- `mm` — необязательный MIME, в формате `type/subtype`; неизвестный — `application/octet-stream`.
|
||
- `ar` — необязательный Arweave Transaction ID, нативный формат Arweave.
|
||
- `sha256` — исторический lowercase hex SHA-256 для старых тегов/объектов; новые записи его не создают.
|
||
|
||
`ar` присутствует → получить файл через Arweave gateway. Нет `ar`, есть `pr` → `https://files.<домен access-сервера автора>/<pr>`. Исторический `sha256` без `pr`/`ar` → прежний `/files/<sha256>` access-сервера автора. `storage=r2` и абсолютные URL в тег не записываются.
|
||
|
||
Идентификаторы новых аватаров — тоже **Base58(PR)**, но формат аватара отдельный: `<S:ava;v=2;sz=N;pr=ROOT[;ar=TXID]>`. Формат v1/SHA-256 аватаров больше не создаётся; миграция v41 не конвертирует старые значения.
|
||
|
||
## Отображение и безопасность
|
||
|
||
Клиент берёт тип по `mm` (при его наличии), иначе пытается использовать расширение `nm`. Для HTTP-открытия URL без расширения R2 также хранит `Content-Type` в метаданных объекта. Изображения загружаются `loading="lazy"`; публичные видео не получают `src`, пока не приблизились к экрану (`IntersectionObserver` с fallback). Встроенное отображение использует исходный файл, дополнительных preview-объектов нет.
|
||
|
||
HTML, SVG, XHTML, JavaScript, XML по расширению или MIME выводятся карточками с подтверждением перед переходом из UI. Пользователь может отменить открытие; прямые ссылки R2/Arweave обходят это предупреждение. Это не изменение доступа, криптографии или правила хранения и **не даёт защиты от вредоносного содержимого на уровне HTTP**.
|
||
|
||
Публичные вложения сохраняются на R2 либо в Arweave без автоматического удаления; DM-вложения используют отдельный протокол, см. `docs/Personal_Messages/Файлы_DM_v3_R2.md`. Редактирование текста сохраняет технические attach-блоки и не переносит объекты между хранилищами.
|
||
|
||
## Совместимость
|
||
|
||
Парсер терпимо читает старое поле `sha256` и префиксы `<SHiNE:attach>`/`<S:attach>`, если данные сохранились. Массовая миграция не выполняется. Экспериментальные `preAr`, `preSha256`, `previewAr`, `previewSha256`, `width`, `duration`, `thumbnail` не входят в протокол.
|