evgeny
73fe99b33f
- src/dm/: dm_core/dm_crypto/dm_mailbox — прямой обмен сообщениями (DM) - lib/soundtouch-master/: vendored SoundTouch (изменение темпа/высоты аудио) - doc/dm_arch.md, doc/chat_call_arch.md: архитектура DM и звонков - tests: test_dm.c, test_dm_e2e.c - chat: рефакторинг chat_* модулей, member_sync, invite_build - chatgui/chatgui-android: синхронизация с новым API чата - lib/u_async, debug_config, utun_instance: сопутствующие изменения
94 lines
4.7 KiB
Markdown
94 lines
4.7 KiB
Markdown
# DM — прямой p2p чат между двумя пользователями группы
|
||
|
||
## 1. Цель
|
||
|
||
Возможность начать личный чат с любым пользователем доступных групп.
|
||
Пока target offline сообщения временно хранятся на storage-узлах.
|
||
|
||
## 2. Ключевые решения
|
||
|
||
- Отдельная DM-подсистема (НЕ канал: без TOPO_GROUP/member_sync/merkle).
|
||
- Идентичность детерминированная: одна ветка на пару, согласование без handshake.
|
||
- E2E-шифрование содержимого сразу.
|
||
- Offline-хранение: dm_mailbox на storage-узлах с флагом dm_storage.
|
||
- Доставка: fallback — сперва проверка наличия узла в BGP-группе; доступен →
|
||
прямой send; нет связи → storage.
|
||
|
||
## 3. Идентичность и ключи (детерминированные)
|
||
|
||
conv_id = SHA256("utun_dm_v1" || min(node_a,node_b) || max(node_a,node_b))[..63]
|
||
shared = X25519(my_x25519_priv, peer_x25519_pub)
|
||
content_key = SHA256(shared || "utun_dm_content")
|
||
|
||
Обе стороны выводят одинаковые значения из своего privkey и pubkey пира
|
||
(известен из общей группы). Смена x25519 у пира = новая ветка.
|
||
|
||
## 4. Модель данных (SQLite, общий chats.db)
|
||
|
||
dm_conversations(conv_id TEXT PK, peer_node_id, peer_x25519 BLOB, peer_ed25519 BLOB,
|
||
peer_name TEXT, last_out_seq INT, last_in_seq INT, created_at INT, last_ts INT)
|
||
dm_messages(conv_id TEXT, dir INT, seq INT, ts INT, author INT, ct TEXT,
|
||
data BLOB, sig BLOB, PRIMARY KEY(conv_id,dir,seq))
|
||
dm_mail(recipient INT, sender INT, conv_id TEXT, seq INT, ts INT, data BLOB, sig BLOB,
|
||
ttl INT, PRIMARY KEY(recipient,sender,seq))
|
||
|
||
Два независимых направленных потока (A→B, B→A) с монотонным seq.
|
||
Без chain-хеша: для 2 пиров достаточно seq + catch-up по диапазону.
|
||
|
||
## 5. Доставка
|
||
|
||
1. Проверка доступности: peer присутствует в BGP-группе (общая группа).
|
||
2. Доступен → прямой send (сервис ETCP_RT_ID_DM = 0x34), ждём DM_ACK{conv_id,seq}.
|
||
Нет ACK за таймаут → fallback в mailbox.
|
||
3. Нет связи → MAIL_PUT на 1..N storage-узлов.
|
||
4. Catch-up при connect: DM_HELLO{conv_id,last_out_seq,last_in_seq} → пир досылает
|
||
(in_seq+1 .. out_seq).
|
||
5. Dedup: вставка только при seq > last_in_seq.
|
||
|
||
## 6. E2E-шифрование
|
||
|
||
data_enc = nonce(13B, счётчик по seq) || AES-CCM_ct || tag
|
||
|
||
secure_channel уже умеет AES-CCM. Storage/relay видят только шифротекст.
|
||
|
||
## 7. Storage-узлы (dm_storage)
|
||
|
||
- Новый флаг dm_storage=yes в adm_tags (блок B владельца), распространяется
|
||
существующим member_sync без нового синка.
|
||
- DM читает adm_tags мемберов общих групп (peers_<ch>) и кэширует storage-узлы.
|
||
- Протокол mailbox (сервис ETCP_RT_ID_DM_MAILBOX = 0x35):
|
||
|
||
MAIL_PUT {recipient,sender,conv_id,seq,ts,data,sig}
|
||
MAIL_PULL {recipient, per-sender cursor}
|
||
MAIL_ACK {up_to_seq}
|
||
|
||
TTL 7 дней + лимит объёма, dedup по (recipient,sender,seq).
|
||
|
||
## 8. Старт и anti-spam
|
||
|
||
- dm_start(peer): создать беседу (вывести conv_id/ключи), обеспечить прямое
|
||
соединение (переиспользовать chat_sync_connect_node/node_conn_direct).
|
||
- Пир автопринимает на первом DM_HELLO/сообщении, только если отправитель в
|
||
общей группе.
|
||
|
||
## 9. Файлы и интеграция
|
||
|
||
| Файл | Назначение |
|
||
|------|-----------|
|
||
| src/dm/dm_core.c/h | беседы, send/recv, таблицы, bind 0x34, conn-события, fallback |
|
||
| src/dm/dm_crypto.c/h | derive + AES-CCM |
|
||
| src/dm/dm_mailbox.c/h | storage-узел, push/pull/ack, bind 0x35 |
|
||
|
||
Плюс:
|
||
|
||
- src/chat/chat_member.c — бит CHAT_MEMBER_FLAG_DM_STORAGE + парсинг dm_storage.
|
||
- utun_instance.c — dm_core_init/destroy.
|
||
- chat_core — API dm_start/send/list + события CHAT_EVT_DM_*.
|
||
- headless CLI — dm list/send/messages.
|
||
- src/Makefile.am — новые источники.
|
||
|
||
## 10. Сервисы ETCP
|
||
|
||
ETCP_RT_ID_DM = 0x34
|
||
ETCP_RT_ID_DM_MAILBOX = 0x35
|