90 lines
3.7 KiB
C
90 lines
3.7 KiB
C
/*
|
|
* chat_sync.h — оркестратор синхронизации чата по ETCP
|
|
*
|
|
* При поднятии / разрыве ETCP-соединений:
|
|
* - обновляет online-статус пиров в БД и GUI
|
|
* - запускает member_sync (синхронизацию участников каналов) через merkle_sync
|
|
* - управляет кешем каналов (периодический refresh из БД, 30s)
|
|
*
|
|
* Обслуживает протокол входа в канал между joiner и inviter:
|
|
* CHANNEL_INFO_REQ → CHANNEL_INFO_RESP → CHANNEL_JOIN → WELCOME
|
|
* Все сообщения с Ed25519-верификацией.
|
|
*
|
|
* Обрабатывает invite-ссылки (chat_sync_connect_from_invite):
|
|
* - сохраняет pubkey и адреса 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 ID (direct P2P) */
|
|
#define ETCP_RT_ID_CHAT_SYNC 0x30
|
|
#define ETCP_RT_ID_MEMBER_SYNC 0x31
|
|
|
|
/* 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_INFO_REQ 0x09
|
|
#define CS_MSG_CHANNEL_INFO_RESP 0x0A
|
|
#define CS_MSG_CHANNEL_JOIN 0x0B
|
|
#define CS_MSG_WELCOME 0x0C
|
|
#define CS_MSG_PEER_UPSERT 0x0D
|
|
#define CS_MSG_PEER_REMOVE 0x0E
|
|
|
|
/* 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-потока) */
|
|
void chat_sync_connect_from_invite(uint64_t channel_id, uint64_t node_id,
|
|
const uint8_t* pubkey_bin,
|
|
const uint8_t* addrs_data, int addr_count);
|
|
|
|
/* Присоединиться к каналу через уже подключённый узел (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);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* CHAT_SYNC_H */
|