evgeny
734a414186
Все ETCP_ID_*/ETCP_RT_ID_* сведены в etcp_api.h (единственное место
определения) с реестром и предупреждением про коллизии в пределах одного
пространства имён. Убраны локальные define из topo_group.h,
topo_group_invite.h, db_sync.h, chat_sync.h, chat_join.h; хардкод 0x31 в
member_sync.c заменён на ETCP_RT_ID_MEMBER_SYNC.
Коллизия: chatgui-десктоп биндил мёртвый ETCP_RT_ID_CHAT 0x11 поверх
ETCP_RT_ID_CONN_MGR 0x11 — затирался conn_mgr_router_recv_handler, из-за
чего INDIRECT-обмен conn_mgr не работал и голос звонка не устанавливался.
Удалён мёртвый код recvCallback/messageReceived/send в utun_node.{cpp,h}.
121 lines
6.8 KiB
C
121 lines
6.8 KiB
C
/*
|
||
* chat_sync.h — оркестратор синхронизации чата по ETCP
|
||
*
|
||
* При поднятии / разрыве ETCP-соединений:
|
||
* - обновляет online-статус пиров в БД и GUI
|
||
* - запускает member_sync (синхронизацию участников каналов) через merkle_sync
|
||
* - управляет кешем каналов (периодический refresh из БД, 30s)
|
||
*
|
||
* Обслуживает протокол входа в канал (join) между джойнером, connection-узлом и инвайтером:
|
||
* JOIN_INFO_REQ → JOIN_INFO_RESP → JOIN_REQUEST → (форвард инвайтеру) → JOIN_READY.
|
||
* Полное описание flow и дерева приглашений — в chat_join.h.
|
||
*
|
||
* Обрабатывает invite-ссылки (chat_sync_connect_from_invite):
|
||
* - сохраняет pubkey, join_key и адреса invite-узла в БД (nodes, node_addresses)
|
||
* - создаёт TOPO_GROUP, запускает conn_mgr для подключения
|
||
* - после поднятия ETCP-соединения запускает join-протокол
|
||
*
|
||
* Использование:
|
||
* 1. chat_sync_init(inst) — вызывается при старте, биндит ETCP_RT_ID_CHAT_SYNC (0x30)
|
||
* 2. chat_sync_connect_from_invite(ch_id, node_id, pubkey, addrs, count) — вход по invite
|
||
* 3. chat_sync_join_channel(inst, ch_id, target_node_id) — вход через уже подключённый узел
|
||
* 4. chat_sync_destroy(inst) — вызывается при завершении
|
||
*/
|
||
|
||
#ifndef CHAT_SYNC_H
|
||
#define CHAT_SYNC_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
#include <stdint.h>
|
||
#include <stddef.h>
|
||
|
||
struct UTUN_INSTANCE;
|
||
struct UASYNC;
|
||
|
||
/* etcp service IDs (direct P2P): ETCP_RT_ID_CHAT_SYNC / ETCP_RT_ID_MEMBER_SYNC
|
||
* (etcp_bind, см. etcp_api.h) */
|
||
|
||
/* Message types */
|
||
#define CS_MSG_INIT_SYNC 0x01
|
||
#define CS_MSG_INIT_RESP 0x02
|
||
#define CS_MSG_SEND_DATA 0x03
|
||
#define CS_MSG_PUSH 0x04
|
||
#define CS_MSG_ACK_PUSH 0x05
|
||
#define CS_MSG_SYNC_DONE 0x06
|
||
#define CS_MSG_ERROR 0x07
|
||
#define CS_MSG_CHANNEL_INVITE 0x0F /* push-invite: inviter → joiner */
|
||
#define CS_MSG_JOIN_INFO_REQ 0x10 /* joiner → connection: {join_key:8} */
|
||
#define CS_MSG_JOIN_INFO_RESP 0x11 /* connection → joiner: channel info + connection's member record */
|
||
#define CS_MSG_JOIN_REQUEST 0x12 /* joiner → connection: {join_key:8, member...} */
|
||
#define CS_MSG_JOIN_READY 0x13 /* connection → joiner: {group_id:8} */
|
||
|
||
/* Protocol constants */
|
||
#define CS_SEND_DATA_MAX 32
|
||
#define CS_MAX_SPARSE 16
|
||
#define CS_PEER_TIMEOUT_MS 5000
|
||
|
||
/* Sync states per channel */
|
||
#define CS_SYNC_NONE 0
|
||
#define CS_SYNC_IN_PROGRESS 1
|
||
#define CS_SYNC_DONE 2
|
||
|
||
/* ── Public API ── */
|
||
|
||
int chat_sync_init(struct UTUN_INSTANCE* inst);
|
||
void chat_sync_destroy(struct UTUN_INSTANCE* inst);
|
||
|
||
/* Прямое ETCP-подключение к узлу (pubkey+адреса из БД) */
|
||
void chat_sync_connect_node(struct UTUN_INSTANCE* inst, uint64_t node_id);
|
||
|
||
/* Подключиться к пиру по данным invite-ссылки (вызывается из uasync-потока).
|
||
join_key — 64-битный ключ входа из ссылки (регистрируется инвайтером на connection-узле).
|
||
password может быть NULL — тогда отправляется без пароля (совместимость с v1) */
|
||
void chat_sync_connect_from_invite(struct UTUN_INSTANCE* inst, uint64_t channel_id, uint64_t node_id,
|
||
const uint8_t* pubkey_bin,
|
||
const uint8_t* addrs_data, int addr_count,
|
||
int addrs_data_len,
|
||
const char* password, uint64_t join_key);
|
||
|
||
/* Пригласить target_node_id в канал ch_id с адресами из invite-ссылки (inviter → joiner).
|
||
Принимает pubkey и адреса целевого узла. Если соединения ещё нет — строит TOPO_NODE
|
||
с адресами, запускает conn_mgr для подключения, и по conn_up отправляет CS_MSG_CHANNEL_INVITE.
|
||
Если соединение уже есть — отправляет CHANNEL_INVITE сразу.
|
||
Копирует pubkey_bin и addrs_data (вызывающий может освободить после возврата).
|
||
Вызов из любого потока — внутри постит в uasync. */
|
||
void chat_sync_invite_to_channel_with_addrs(
|
||
struct UTUN_INSTANCE* inst, const char* ch_id, uint64_t target_node_id,
|
||
const uint8_t* pubkey_bin, const uint8_t* addrs_data, int addr_count,
|
||
int addrs_data_len);
|
||
|
||
/* Пригласить target_node_id в канал ch_id (inviter → joiner).
|
||
Отправляет CS_MSG_CHANNEL_INVITE с полной информацией о канале и своих адресах */
|
||
void chat_sync_invite_to_channel(struct UTUN_INSTANCE* inst, const char* ch_id, uint64_t target_node_id);
|
||
|
||
/* Принять входящее приглашение — продолжаем join-протокол (CHANNEL_JOIN → WELCOME) */
|
||
void chat_sync_accept_invite(struct UTUN_INSTANCE* inst, uint64_t channel_id, uint64_t inviter_node_id);
|
||
|
||
/* Отклонить входящее приглашение */
|
||
void chat_sync_deny_invite(struct UTUN_INSTANCE* inst, uint64_t channel_id, uint64_t inviter_node_id);
|
||
|
||
/* Присоединиться к каналу через уже подключённый узел (uasync-поток).
|
||
Соединение с target_node_id должно быть установлено (links_up && initialized).
|
||
Протокол: CHANNEL_INFO_REQ → CHANNEL_INFO_RESP → CHANNEL_JOIN → WELCOME.
|
||
Канал (DB + TOPO_GROUP) создаётся локально при получении CHANNEL_INFO_RESP. */
|
||
void chat_sync_join_channel(struct UTUN_INSTANCE* inst, const char* ch_id, uint64_t target_node_id);
|
||
|
||
/* Перезапустить групповые подключения для каналов без активных соединений.
|
||
Вызывается из auto_socket при появлении/изменении сетевой связности. */
|
||
void chat_sync_retry_channels_on_socket_change(struct UTUN_INSTANCE* inst);
|
||
|
||
/* Немедленно убрать канал из кеша g_cs->channels (локальное удаление канала),
|
||
* чтобы cs_on_conn_status не запускал member_sync для удалённого ns до следующего refresh. */
|
||
void chat_sync_on_channel_deleted(struct UTUN_INSTANCE* inst, const char* ch_id);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif /* CHAT_SYNC_H */
|