6.9 KiB
Личные сообщения SHiNE
Эта папка содержит актуальную документацию по личным сообщениям SHiNE.
Точка входа:
docs/Personal_Messages/Протокол_DM_v1.md— логика протокола, роли API, серверное поведение, routing поaccess_serversdocs/Personal_Messages/Формат_DM_v1.md— точный бинарный формат контейнераSHiNE_DMdocs/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 SHA-256/Merkle metadatadocs/API/18_DM_File_Storage_API.md— HTTP-хранилище зашифрованных файлов DM на access-сервере отправителя
Документы с версиями v1 и v2 описывают разные уровни: v1 — контейнер и доставка сообщения, v2 — формат больших файлов внутри зашифрованного содержимого DM. Реализация v2 находится в shine-UI/js/services/dm-file-service.js и dm-tech-blocks.js.
Правило сопровождения:
- код DM и затронутые документы из списка выше должны обновляться синхронно; если байтовый контейнер не менялся, это нужно прямо указать в описании изменения;
- если меняется поведение DM в коде, в том же наборе изменений обновляется и эта документация.
- локальная таблица пользователей для DM считается кэшем, а источником истины остаётся Solana PDA; если серверная логика DM меняет правила lazy-import пользователей из PDA, это тоже обязательно фиксируется в документации.
Зашифрованные файлы DM
Официальный UI v1 умеет отправлять файл как внешний зашифрованный объект:
- файл шифруется в браузере
AES-256-GCM; - ciphertext хранится только на access-сервере отправителя под именем
Base58(SHA-256(ciphertext)); - AES-key, IV, исходное имя, MIME, размер и URL находятся в
<S:file...>внутри plaintext DM, а значит сами защищены существующим E2EE DM; - получатель скачивает ciphertext с сервера отправителя, проверяет 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 не изменяются.
Информационное сообщение о шифровании в начале 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). Перед публичным релизом желательно уточнить формулировку на уровне продукта.