Files
utun2/src/routing_layer/topo_node_sqlite_doc.md
T
evgeny 451021b292 stcp: ed25519 pubkey exchange in handshake, fix instance destroy segfault, fix chat_tcp_test
- u_async.c: process immediate_queue BEFORE epoll_wait in uasync_poll
- stcp_link.c: defensive NULL etcp_conn/etcp_link in stcp_link_close
- utun_instance.c: move stcp_server_list_destroy_all to Phase J (before ETCP),
  add deferred drain in both Phase J and L
- stcp.h/c: STCP_HS_ENC_CLIENT 6→38, STCP_HS_ENC_SERVER 7→39,
  exchange ed25519_pubkey in both handshake directions
- etcp_connections.c: copy peer_ed25519 from STCP to ETCP_CONN in
  etcp_link_enter_ready_tcp; guard link->etcp in tcp_link_close_cb
- chat_sync.c: fix lk->conn NULL dereference for TCP links
- test_stcp.c: update stcp_server_create/stcp_client_connect callsites
- tools/chat_tcp_test: change transport udp→tcp
2026-08-07 00:48:27 +03:00

4.2 KiB

topo_node_sqlite — SQLite-персистентность топологии

1. Назначение

Обеспечивает сохранение и восстановление топологии P2P-сети (ноды, адреса, каналы, участники каналов) в SQLite-базе. База используется как основной источник данных для chatgui и восстановления состояния между запусками utun.

В отличие от LMDB-слоя (topo_node_lmdb), который хранит данные в бинарном формате BGP-сообщений, SQLite-слой работает с нормализованными таблицами и используется для клиентских целей — чтение данных chatgui, получение списка участников канала, проверка online-статуса.

2. Как пользоваться

  1. Получить готовый sqlite3* db (открывается извне, обычно в chat_sync.c)
  2. Вызвать topo_node_sqlite_init(db) для создания таблиц
  3. Сохранять/обновлять ноды через topo_node_sqlite_node_put()
  4. Сохранять каналы через topo_node_sqlite_channel_put() (автоматически создаёт таблицу peers_<channel_id>)
  5. Добавлять участников в канал через topo_node_sqlite_member_put()
  6. Читать участников канала через topo_node_sqlite_channel_peers_all() — возвращает бинарный буфер со всеми участниками (node_id, ключи, подписи, адреса)

Нюансы:

  • Имена таблиц peers_<channel_id> санитизируются: все символы кроме [a-zA-Z0-9_] заменяются на _
  • topo_node_sqlite_channel_peers_all() формирует компактный бинарный буфер с числом записей в начале (uint16_t)
  • Ключи в BLOB-полях всегда 32 байта (x25519/ed25519), подписи — 64 байта
  • Функции online и get_ed25519_pubkey — простые SELECT-запросы без JOIN

3. API

Функция Описание
topo_node_sqlite_init(db) Создаёт таблицы nodes, node_addresses, channels (если не существуют)
topo_node_sqlite_node_put(db, nq) Сохраняет ноду и её адреса (IPv4/IPv6) в транзакции; старые адреса удаляются
topo_node_sqlite_channel_put(...) Сохраняет канал в channels + создаёт таблицу peers_<ch_id>
topo_node_sqlite_member_put(...) Добавляет/обновляет участника в peers_<ch_id> (INSERT OR REPLACE)
topo_node_sqlite_member_get_join(db, ch_id, node_id, ...) Читает join_sig и join_ts участника канала
topo_node_sqlite_member_del(db, ch_id, node_id) Удаляет участника из peers_<ch_id>
topo_node_sqlite_node_update_verified(...) Обновляет ключи и имя ноды по условию update_ts < новое_значение (защита от stale-данных)
topo_node_sqlite_channel_get(...) Читает метаданные канала (имя, владелец, ключи, подпись)
topo_node_sqlite_channel_peers_all(...) Сериализует всех участников канала в бинарный буфер (count + [node_id|x25519|ed25519|flags|sigs|name|addrs])
topo_node_sqlite_node_set_online(db, id, online) Устанавливает флаг online для ноды
topo_node_sqlite_node_get_online(db, id) Возвращает 1 если нода online
topo_node_sqlite_get_ed25519_pubkey(db, id, out) Извлекает ed25519-публичный ключ ноды (32 байта)

Структуры: внешние — sqlite3*, struct TOPO_NODEQ, struct TOPO_NODE; собственных структур нет.