Files
SHiNE-server/docs/Blockchain/15_TEXT_Attachments.md
T

4.1 KiB
Raw Blame History

Вложения в TEXT-сообщениях (S:att;v=1)

Технический префикс в UTF-8 text для TEXT_POST, TEXT_REPLY, TEXT_EDIT_POST, TEXT_EDIT_REPLY. Бинарный формат TEXT не меняется. До 10 вложений в начале сообщения, затем обычный текст; порядок сохраняется.

Канонический формат (2026-11)

<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.shineup.me/<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 не входят в протокол.