Files
SHiNE-server/docs/Personal_Messages

Личные сообщения SHiNE

Эта папка содержит актуальную документацию по личным сообщениям SHiNE.

Точка входа:

  • docs/Personal_Messages/Протокол_DM_v1.md — логика протокола, роли API, серверное поведение, routing по access_servers
  • docs/Personal_Messages/Формат_DM_v1.md — точный бинарный формат контейнера SHiNE_DM
  • docs/Personal_Messages/Доставка_и_синхронизация_DM.md — доставка на единственный access-сервер, retry-воркер и UI-статусы
  • docs/Personal_Messages/Технические_вставки_DM_v1.md — формат специальных <S:...> вставок внутри plaintext DM после расшифровки
  • docs/Personal_Messages/Файлы_DM_v2.md — старый формат chunked-вложений с BitTorrent v2 (только чтение);
  • docs/Personal_Messages/Файлы_DM_v3_R2.md — новые chunked-вложения и голосовые в Cloudflare R2, AES-GCM, SHA-256/Base58
  • docs/API/18_DM_File_Storage_API.md — HTTP-хранилище зашифрованных файлов DM на access-сервере отправителя

Документы с версиями v1, v2 и v3 описывают разные уровни: v1 — контейнер и доставка сообщения, v2 — старый формат больших файлов, v3 — новые файлы в R2 без BitTorrent. Клиентская реализация находится в shine-UI/js/services/dm-file-service.js и dm-tech-blocks.js.

Правило сопровождения:

  • код DM и затронутые документы из списка выше должны обновляться синхронно; если байтовый контейнер не менялся, это нужно прямо указать в описании изменения;
  • если меняется поведение DM в коде, в том же наборе изменений обновляется и эта документация.
  • локальная таблица пользователей для DM считается кэшем, а источником истины остаётся Solana PDA; если серверная логика DM меняет правила lazy-import пользователей из PDA, это тоже обязательно фиксируется в документации.

Зашифрованные файлы DM

Официальный UI v3 отправляет файл как зашифрованные объекты R2 (чтение старого v1/v2 поддерживается):

  • файл шифруется в браузере AES-256-GCM;
  • новый ciphertext хранится в корзине shine-dm по адресу https://dm-files.<домен access-сервера отправителя>/<Base58(SHA-256(ciphertext))>;
  • AES-key, IV, ID ciphertext, исходное имя, MIME и размер находятся в <S:file...> (новые v3 без URL; старые URL читаются) внутри plaintext DM, а значит сами защищены существующим E2EE DM;
  • получатель скачивает новый ciphertext напрямую из R2, проверяет SHA-256, расшифровывает локально и только затем отдаёт Blob браузеру для сохранения под исходным именем;
  • сервер файлов ключ расшифрования не получает.

Формат бинарного контейнера SHiNE_DM при этом не меняется.

Key rotation и локальный архив DM

При смене client key старые type=1/2 локальные копии перешифровываются клиентом пакетами. Критерий незавершённой миграции — локальная копия была сохранена до cutoff входа в MESSAGE_MIGRATION и имеет reencryptedAtMs < cutoff. Повторная отправка на сервер собеседника не выполняется. Для перешифрованного входящего type=1 подпись принадлежит получателю; это локальная мигрированная копия, а не сохранённая подпись первоначального отправителя.

Клавиатура личной переписки

Обычный Enter в поле ввода личного сообщения отправляет непустой текст через существующий обработчик формы (включая ответы и редактирование); Shift+Enter, Ctrl+Enter, Alt+Enter и Meta+Enter вставляют перенос строки. Во время композиции IME отправка по Enter отключена. Это изменение относится только к UI; формат контейнера SHiNE_DM и серверный API не изменяются.

Внешние ссылки и уведомления о переводах

Обычные http://, https:// и www. ссылки в тексте DM остаются частью обычного текста и не меняют формат SHiNE_DM. При обычном нажатии UI предлагает скопировать ссылку или открыть её во внешнем браузере; внутренние ссылки SHiNE продолжают обрабатываться роутером приложения.

При переводе SOL/USDT собеседнику отправляется уведомление с подписью транзакции и ссылкой на Solana Explorer. Ссылка строится с текущим кластером (devnet или mainnet-beta), поэтому проверка открывает правильную сеть. Это также только UI-текст DM: серверный API, подпись и бинарный контейнер не изменяются.

При открытии личного чата UI прокручивает ленту к линии непрочитанных сообщений, если такие сообщения есть; при отсутствии непрочитанных — к последнему сообщению. При первичной загрузке истории это правило применяется после ответа сервера, а не только к сообщениям, уже находящимся в локальном кэше.

Информационное сообщение о шифровании в начале DM (13.11.2026)

Экран shine-UI/js/pages/chat-view.js добавляет в самое начало визуальной ленты каждого личного диалога серое пояснение по центру о сквозном шифровании, ключах, открытом коде и последствиях потери пароля. Текст локализован для RU/EN через screens.chat_view.security_notice.*, стили — в shine-UI/styles/features/chat.css.

Сообщение создаётся локально при отрисовке диалога и повторно добавляется при обновлении истории. Это не DM-сообщение, оно не отправляется собеседнику, не попадает в GetDirectMessages, не подписывается и не записывается в Arweave или блокчейн. Кнопок, галочек и обязательного подтверждения нет. Изменения не затрагивают бинарный формат SHiNE_DM, серверный API и криптографический протокол.

Текст о перешифровке в интерфейсе воспроизводит утверждённую пользователем формулировку. Техническое ограничение: текущий протокол при ротации client key перешифровывает локальные копии type=1/2 на access-сервере владельца, а не гарантирует перешифровку всех когда-либо созданных копий сообщения (подробности — в Протокол_DM_v1.md). Перед публичным релизом желательно уточнить формулировку на уровне продукта.

Федеративный файловый resolver (16.11.2026)

Новые вложения DM v3 не сохраняют полный URL в E2EE-технической вставке; адрес dm-files.<access-домен> восстанавливается по отправителю через общий HTTP API и RAM-кэш. У каждого access-сервера своя корзина R2. Время загрузки at позволяет показывать окончание 14-дневного срока без скачивания; старые v1/v2 сохраняют прежний протокол и правила хранения. Подробнее в Файлы_DM_v3_R2.md и docs/API/18_DM_File_Storage_API.md.

Вложения и запись голосового в UI (17.11.2026)

В личной переписке выбранные файлы остаются в очереди у поля ввода: можно дописать подпись, убрать файл и отправить всё одним сообщением. Текст показывается под вложением. У вложений DM v3 показывается оставшийся срок хранения на основе at (14 дней). Запись голосового начинается при нажатии микрофона: короткое нажатие закрепляет запись, удержание с отпусканием отправляет, движение вверх закрепляет, влево отменяет. В закреплённом режиме доступны пауза/продолжение, отправка и отмена. Текст в поле ввода переключает кнопку микрофона в кнопку отправки текста.

HTTP resolver /api/files/user-server обязан возвращать JSON через Jetty, поэтому Caddy должен направлять этот путь до SPA fallback. Если маршрута нет, клиент показывает ошибку каталога серверов без вывода HTML в интерфейс. Бинарный контейнер SHiNE_DM и серверный API этим изменением не меняются.