SHA256
51 lines
7.7 KiB
Markdown
51 lines
7.7 KiB
Markdown
# Личные сообщения 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.shineup.me/<Base58(SHA-256(ciphertext))>`;
|
||
- AES-key, IV, исходное имя, MIME, размер и URL находятся в `<S:file...>` внутри 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 не изменяются.
|
||
|
||
## Информационное сообщение о шифровании в начале 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 и криптографический протокол.
|
||
|
||
Текст уведомления RU восстановлен по утверждённой пользователем редакции от 13.11.2026: «Ваша переписка защищена сквозным шифрованием»; остальной текст RU/EN находится только в `shine-UI/js/i18n/locales/{ru,en}.json`. Для предотвращения повторной подмены RU-редакция зафиксирована тестом `shine-UI/tests/dm-security-notice.test.mjs`. Текст о перешифровке в интерфейсе воспроизводит утверждённую пользователем формулировку. Техническое ограничение: текущий протокол при ротации client key перешифровывает локальные копии `type=1/2` на access-сервере владельца, а не гарантирует перешифровку всех когда-либо созданных копий сообщения (подробности — в `Протокол_DM_v1.md`). Перед публичным релизом желательно уточнить формулировку на уровне продукта.
|