Files
SHiNE-server/docs/Personal_Messages
q f40353725e Ошибки действий: причина понятным текстом, неотправленное не висит «часиками»
- Чат, ошибка отправки: раньше «часики» оставались в ленте навсегда, а ниже появлялся пузырь
  «Ошибка отправки: Failed to fetch» от имени пользователя. Теперь временное сообщение
  убирается, текст возвращается в поле ввода, тост называет причину и предлагает «Повторить».
  Для уже загруженных файлов «Повторить» отправляет только сообщение с ключами, без новой
  загрузки. Неудачная пересылка тоже не оставляет «часиков» в целевом чате.
- Ошибка начала звонка – тостом с причиной («Нет доступа к микрофону или камере…»), а не
  пузырём «[Звонок] Ошибка запуска: NotAllowedError…» в переписке; то же для записи голосового.
- Общий actionErrorText(): «Не удалось удалить чат. Нет связи с сервером…» вместо
  «Не удалось удалить чат: unknown» или английского текста исключения. Технический текст –
  в журнале, на экране – только с инструментами разработчика. Переведены тосты и строки
  статуса чата, сеансов устройств, профилей, редактирования профиля, кошелька, серверов
  доступа, «Моего блокчейна» (≈45 мест). Сетевые ошибки браузера распознаются отдельно.
  «Сервер недоступен. Проверьте, что backend запущен…» → «Нет связи с сервером…».
- Системные окна confirm() в рабочих экранах (закрыть сеансы, завершить сеанс, добавить
  связь, убрать аватар канала, переключить профиль по push, очистить журнал загрузок) –
  общим диалогом приложения с понятным заголовком.
- Документ DM: поведение при ошибке отправки.
2026-10-13 04:40:27 +03:00
..

Личные сообщения 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 SHA-256/Merkle metadata
  • docs/API/18_DM_File_Storage_API.md — HTTP-хранилище зашифрованных файлов DM на access-сервере отправителя

Исторический устаревший документ сохранён отдельно:

  • docs/Personal_Messages/Спецификация_DM_v0.5_устаревшая.md

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

  • код DM и оба документа Протокол_DM_v1.md + Формат_DM_v1.md всегда должны обновляться синхронно;
  • если меняется поведение 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 подпись принадлежит получателю; это локальная мигрированная копия, а не сохранённая подпись первоначального отправителя.