Вложения файлов со своего сервера доступа пользователя

This commit is contained in:
AidarKC
2026-10-07 11:42:12 +03:00
parent b1c42efa82
commit 7b8e178723
33 changed files with 1960 additions and 496 deletions
+16 -6
View File
@@ -111,16 +111,16 @@ Login/fork для edit не подписываются: edit может ссыл
Бинарный формат `TextBody` не меняется: вложения являются частью UTF-8 текста.
Один блок вложения:
Arweave-вложение:
```text
<S:att;v=1;nm=report.pdf;sz=845221;sha256=0123...;ar=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA>
```
Для файлов с отдельным превью клиент может использовать расширенный вариант:
Вложение на сервере доступа автора:
```text
<S:att;v=1;nm=video.mp4;sz=5820193;sha256=bbbb...;ar=CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC;preAr=DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD;preSha256=eeee...>
<S:att;v=1;nm=report.pdf;sz=845221;sha256=0123...>
```
Несколько вложений идут подряд в самом начале текста, по одному блоку на строку. После последнего блока идёт обычный пользовательский текст.
@@ -131,8 +131,18 @@ Login/fork для edit не подписываются: edit может ссыл
- `nm` - имя файла, закодированное через `encodeURIComponent`
- `sz` - размер файла в байтах
- `sha256` - SHA-256 исходного файла в hex
- `ar` - короткий Arweave Transaction ID, без полного URL
- при наличии превью дополнительно могут присутствовать `preAr` и `preSha256`
Опциональное поле:
- `ar` - короткий Arweave Transaction ID, без полного URL.
Правило источника файла:
- `ar` присутствует -> файл хранится в Arweave;
- `ar` отсутствует -> файл хранится как public file на текущем сервере доступа автора и читается по `/files/<sha256>`;
- адрес сервера доступа в attach-блок не записывается.
Отдельные preview-файлы сейчас **не поддерживаются и не являются частью текущего протокола**. Поля `preAr`, `preSha256`, `previewAr`, `previewSha256` новые клиенты создавать не должны. Изображения и видео отображаются из исходного файла.
Правила клиента:
@@ -141,4 +151,4 @@ Login/fork для edit не подписываются: edit может ссыл
- старые клиенты без поддержки вложений могут показывать технические строки как обычный текст;
- пустой пользовательский текст допустим, если перед ним есть хотя бы один валидный attach-блок.
Файлы хранятся вне блокчейна, в Arweave. В блокчейне остаются только `txId`, имя, размер, SHA-256 и, при наличии отдельного preview-файла, `preAr/preSha256`.
Сам файл всегда хранится вне блокчейна. В блокчейне остаются имя, размер, SHA-256 и, только для Arweave-вложения, `ar`.