5.6 KiB
Вложения в TEXT-сообщениях (S:att;v=1 и v=2)
Технический префикс в UTF-8 text для TEXT_POST, TEXT_REPLY, TEXT_EDIT_POST, TEXT_EDIT_REPLY. Бинарный формат TEXT не меняется. До 10 вложений в начале сообщения, затем обычный текст; порядок сохраняется.
Канонический формат (2026-11, v=2)
<S:att;v=2;nm=photo.jpg;sz=248193;pr=BASE58_ROOT;mm=image/jpeg>
<S:att;v=2;nm=video.mp4;sz=15000000;pr=BASE58_ROOT;mm=video/mp4;ar=TXID>
Текст публикации
v— версия: 2 для новых публикаций, старыеv=1остаются читаемыми.nm— UTF-8 имя файла без массового URL-кодирования. Вv=2только служебные символы кодируются однобайтовыми ASCII-последовательностями:%→%25,;→%3B,=→%3D,<→%3C,>→%3E. Управляющие символы в именах не допускаются. Фактическая нормализация клиента заменяет\и/на_(старое правило).- Пример:
Водопад.mp4записывается какВодопад.mp4;Лето;фильм=1.mp4— какЛето%3Bфильм%3D1.mp4. - Парсер v=2 отвергает неизвестные и повторные ключи, неверное экранирование, ошибочный MIME, некорректную длину/идентификатор. Сервер/импортёр не должны доверять метаданным клиента и обязаны проверять формат при структурированном чтении. Блокчейн и исходный
textхранятся побайтово неизменными. 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-блоки и не переносит объекты между хранилищами.
Совместимость
Существующий v=1 использует encodeURIComponent/decodeURIComponent. Новые записи создаются в v=2, уже записанные блоки не переписываются. Парсер терпимо читает старое поле sha256 и префиксы <SHiNE:attach>/<S:attach>, если данные сохранились. Массовая миграция не выполняется. Экспериментальные preAr, preSha256, previewAr, previewSha256, width, duration, thumbnail не входят в протокол.