RAIDA transport

RAIDA transport
Source snapshot: 9b4f8a3 (2026-09-23); retained QMail clone, including M7.
Working = implemented in this snapshot, not a new runtime/test certification.
Partial = an identified implementation/exposure gap; obsolete = retained compatibility only.
Entry points and static functions are selected navigation anchors; full lexical index: function-index.txt.
Used by / Tests list selected source references (including callback registration), not a proven dynamic call graph.
Tests were inspected, not executed; use tools/test.ps1 with isolated scratch data.
Old paths come from docs/path-map.txt; absent mappings denote additions after the move.

Transport and server list

Purpose: Provide TCP/UDP and HTTP transport, server resolution, protocol headers and Type 10 sessions.
Files: src/coin/transport.c src/coin/raida_servers.c src/coin/raida_status.c src/coin/http_client.c src/coin/core_http_provider.c src/coin/protocol.c src/coin/header_v2.c src/coin/t10_session.c
Old paths: vendor/core/src/transport.c -> src/coin/transport.c vendor/core/src/raida_servers.c -> src/coin/raida_servers.c vendor/core/src/raida_status.c -> src/coin/raida_status.c vendor/core/src/http_client.c -> src/coin/http_client.c vendor/core/src/core_http_provider.c -> src/coin/core_http_provider.c vendor/core/src/protocol.c -> src/coin/protocol.c vendor/core/src/header_v2.c -> src/coin/header_v2.c vendor/core/src/t10_session.c -> src/coin/t10_session.c
Public header: include/api/api_rest.h include/core/core_http_provider.h include/core/header_v2.h include/core/http_client.h include/core/protocol.h include/core/raida_servers.h include/core/raida_status.h include/core/t10_session.h include/core/transport.h
Entry points: src/coin/transport.c:110 :: transport_cancel_call() src/coin/raida_servers.c:37 :: raida_index_is_default_qmail() src/coin/raida_status.c:25 :: raida_status_to_string() src/coin/http_client.c:32 :: http_get_with_options() src/coin/core_http_provider.c:6 :: core_http_provider_set() src/coin/protocol.c:22 :: protocol_uses_extended_qmail_framing() src/coin/header_v2.c:39 :: header_v2_is_content_group() src/coin/t10_session.c:147 :: t10_session_set_detect_provider()
Important static functions: src/coin/transport.c:203 :: transport_migrate_legacy_stats_file() src/coin/transport.c:494 :: transport_read_available_from_file() src/coin/raida_servers.c:80 :: is_valid_server_host() src/coin/raida_servers.c:105 :: parse_port_strict() src/coin/http_client.c:360 :: stream_write() src/coin/protocol.c:59 :: protocol_type8_key_valid() src/coin/protocol.c:116 :: protocol_build_packet_hv2() src/coin/t10_session.c:216 :: authority_valid_unlocked()
Owns: Transport execution and RAIDA server address loading; policy owns command timeouts.
Used by: src/app/desktop_api.c src/coin/boot_encryption_check.c src/coin/coin_file.c src/coin/core_bootstrap.c src/coin/drd_sync.c src/coin/executor.c src/coin/logging.c src/coin/raida_consensus_fetch.c
Side effects: Performs network I/O, mutates transport/session state and writes configuration/telemetry/replica data where applicable.
Tests: tests/update/update_download_bundle_test.c tests/update/update_stream_timeout_test.c tests/unit/coin/transport_resolve_test.c tests/unit/mail/qmail_receive_resume_test.c tests/unit/mail/qmail_transfer_reconcile_test.c tests/unit/mail/qmail_transfer_resume_test.c tests/unit/coin/header_v2/header_v2_protocol_test.c tests/unit/coin/sdk/abi_check.c
Platforms: Windows; POSIX branches/dependencies where present. Linux/macOS runtime unverified in M13.
Status: working

Executor and timeout policy

Purpose: Fan out requests, apply command-specific retry/time budgets, record telemetry and fetch consensus data.
Files: src/coin/executor.c src/coin/raida_parallel.c src/coin/raida_policy.c src/coin/raida_telemetry.c src/coin/raida_consensus_fetch.c
Old paths: vendor/core/src/executor.c -> src/coin/executor.c vendor/core/src/raida_parallel.c -> src/coin/raida_parallel.c vendor/core/src/raida_policy.c -> src/coin/raida_policy.c vendor/core/src/raida_telemetry.c -> src/coin/raida_telemetry.c vendor/core/src/raida_consensus_fetch.c -> src/coin/raida_consensus_fetch.c
Public header: include/core/executor.h include/core/raida_consensus_fetch.h include/core/raida_parallel.h include/core/raida_policy.h include/core/raida_telemetry.h
Entry points: src/coin/executor.c:1178 :: executor_run() src/coin/raida_policy.c:147 :: raida_policy_defaults() src/coin/executor.c:83 :: exec_config_init() src/coin/raida_parallel.c:13 :: raida_calculate_timeout() src/coin/raida_telemetry.c:199 :: raida_telemetry_init() src/coin/raida_consensus_fetch.c:96 :: raida_consensus_fetch()
Important static functions: src/coin/executor.c:34 :: thread_shared_release() src/coin/executor.c:615 :: executor_thread_worker() src/coin/raida_policy.c:278 :: parse_u32() src/coin/raida_telemetry.c:97 :: telemetry_write_csv_locked() src/coin/raida_policy.c:13 :: policy_lock_ensure() src/coin/raida_telemetry.c:44 :: telemetry_init_mutex()
Owns: Runtime RAIDA policy and parallel command execution.
Used by: src/app/desktop_api.c src/coin/core_bootstrap.c src/coin/health_manager.c src/coin/raida_servers.c src/coin/rke_client.c src/coin/rke_server_ops.c src/mail/qmail_beacon.c src/mail/qmail_crypto.c
Side effects: Performs network I/O, mutates transport/session state and writes configuration/telemetry/replica data where applicable.
Tests: tests/unit/core_bootstrap_test.c tests/unit/telemetry_report_test.c tests/unit/telemetry_rotation_test.c tests/update/update_download_bundle_test.c tests/unit/coin/qmail_endpoint_test.c tests/unit/mail/qmail_send_deadline_test.c tests/unit/mail/raida_policy_test.c tests/unit/coin/header_v2/header_v2_protocol_test.c
Platforms: Windows; POSIX branches/dependencies where present. Linux/macOS runtime unverified in M13.
Status: working

Transport provider seam

Purpose: Supply transport_adapter_get for desktop SDK and Content Server executable linkage.
Files: src/mail/sdk/qmail_sdk_support.c src/server/cs_transport_provider.c
Old paths: vendor/core/src/qmail_sdk/qmail_sdk_support.c -> src/mail/sdk/qmail_sdk_support.c vendor/content-server/src/cs_transport_provider.c -> src/server/cs_transport_provider.c
Public header: include/api/api_rest.h include/api/transport_adapter.h include/core/core_transport_provider.h include/core/results.h include/qmail/qmail_locker_runtime.h
Entry points: src/mail/sdk/qmail_sdk_support.c:169 :: transport_adapter_get() src/server/cs_transport_provider.c:63 :: transport_adapter_get() src/mail/sdk/qmail_sdk_support.c:41 :: create_directory()
Important static functions: None identified by lexical inspection; C++ methods and script helpers are outside the C static index.
Owns: One native transport provider per executable, selected by CMake.
Used by: src/app/data_compat.c src/app/desktop_api.c src/app/desktop_api_more.c src/app/main.c src/coin/core_bootstrap.c src/coin/drd_sync.c src/coin/qmail_funding_runtime.c src/coin/qmail_locker_pool.c
Side effects: Returns/configures callback interfaces; callbacks delegate network/file work to their implementations.
Tests: tests/integ/type9_gateway_test.c tests/live/large_send_live_probe.c tests/unit/long_path_transfer_test.c tests/unit/sdk_directory_test.c tests/unit/coin/parallel_transport_ownership_test.c tests/unit/coin/qmail_amount_test.c tests/unit/coin/qmail_coin_select_test.c tests/unit/coin/qmail_db_migration_test.c
Platforms: Windows; POSIX branches/dependencies where present. Linux/macOS runtime unverified in M13.
Status: working

RKE and Content Server Type 9 client

Purpose: Collect and derive RKE keys, parse DNS records and open Type 9 sessions to Content Servers.
Files: src/coin/rke_v2_kdf.c src/coin/rke_client.c src/coin/rke_server_ops.c src/coin/rke_session_client.c src/coin/rke_type9.c src/coin/rke_type9_client.c src/coin/rke_dns.c src/coin/rke_sdk/rke_sdk.c
Old paths: vendor/core/src/rke_v2_kdf.c -> src/coin/rke_v2_kdf.c vendor/core/src/rke_client.c -> src/coin/rke_client.c vendor/core/src/rke_server_ops.c -> src/coin/rke_server_ops.c vendor/core/src/rke_session_client.c -> src/coin/rke_session_client.c vendor/core/src/rke_type9.c -> src/coin/rke_type9.c vendor/core/src/rke_type9_client.c -> src/coin/rke_type9_client.c vendor/core/src/rke_dns.c -> src/coin/rke_dns.c vendor/core/src/rke_sdk/rke_sdk.c -> src/coin/rke_sdk/rke_sdk.c
Public header: include/core/rke_client.h include/core/rke_dns.h include/core/rke_sdk.h include/core/rke_server_ops.h include/core/rke_session_client.h include/core/rke_type9.h include/core/rke_v2_kdf.h
Entry points: src/coin/rke_v2_kdf.c:179 :: rke_v2_put_u32_be() src/coin/rke_client.c:106 :: rke_build_keyshare_body() src/coin/rke_server_ops.c:220 :: rke_redeem_tickets() src/coin/rke_session_client.c:43 :: rke_cs_build_open_body() src/coin/rke_type9.c:136 :: rke_t9_build_request() src/coin/rke_type9_client.c:251 :: rke_t9_exchange_exact() src/coin/rke_dns.c:54 :: rke_dns_parse_txt() src/coin/rke_sdk/rke_sdk.c:455 :: rke_sdk_config_init()
Important static functions: src/coin/rke_client.c:37 :: rke_cmd_build_body() src/coin/rke_client.c:73 :: rke_cmd_parse() src/coin/rke_server_ops.c:141 :: redeem_body_builder() src/coin/rke_server_ops.c:160 :: preload_body_builder() src/coin/rke_type9.c:30 :: t9_failure_status() src/coin/rke_type9.c:58 :: t9_write_established_header() src/coin/rke_dns.c:22 :: parse_hex32() src/coin/rke_sdk/rke_sdk.c:336 :: load_candidate_pown()
Owns: RKE derivation/session contracts; shared CS_STATUS wire codes are in include/core/rke_type9.h.
Used by: src/mail/qmail_endpoint.c src/mail/qmail_session_coordinator.c src/server/cs_daemon.c src/server/cs_identity_sdk.c src/server/cs_vault.c src/server/cs_vault_seal.c src/server/hosting_services.c
Side effects: Performs network I/O, mutates transport/session state and writes configuration/telemetry/replica data where applicable.
Tests: tests/integ/type9_gateway_test.c tests/unit/server/test_cs_daemon_e2e.c tests/unit/server/test_cs_listener_socket.c tests/unit/server/test_cs_object_dispatch.c tests/unit/server/test_cs_session_lock.c tests/unit/server/test_cs_session_table.c tests/unit/server/test_cs_type9_e2e.c tests/unit/server/test_cs_vault_session.c
Platforms: Windows; POSIX branches/dependencies where present. Linux/macOS runtime unverified in M13.
Status: working; Type 9 belongs only to Content Servers; this entry does not imply a RAIDAX Type 9 listener.

DRD client and replica

Purpose: Search/post the public directory and synchronize a local SQLite replica.
Files: src/coin/commands/cmd_drd.c src/coin/drd_local_store.c src/coin/drd_sync.c
Old paths: vendor/core/src/commands/cmd_drd.c -> src/coin/commands/cmd_drd.c vendor/core/src/drd_local_store.c -> src/coin/drd_local_store.c vendor/core/src/drd_sync.c -> src/coin/drd_sync.c
Public header: include/core/cmd_drd.h include/core/drd_local_store.h include/core/drd_sync.h
Entry points: src/coin/commands/cmd_drd.c:396 :: core_drd_post_user() src/coin/drd_local_store.c:138 :: drd_local_store_init() src/coin/drd_sync.c:97 :: drd_sync_config_default()
Important static functions: src/coin/commands/cmd_drd.c:107 :: drd_collect() src/coin/commands/cmd_drd.c:156 :: drd_class_rejection_valid() src/coin/drd_local_store.c:461 :: build_where() src/coin/drd_local_store.c:639 :: read_user_row() src/coin/drd_sync.c:107 :: normalize_config() src/coin/drd_sync.c:167 :: status_begin_cycle()
Owns: DRD command codec, local replica schema and differential sync.
Used by: src/app/desktop_api.c src/gui/server_adapter.c src/mail/qmail_amount.c src/server/hosting_services.c src/mail/sdk/qmail_sdk.c src/gui/logic/viewmodel.c
Side effects: Performs network I/O, mutates transport/session state and writes configuration/telemetry/replica data where applicable.
Tests: tests/gui/avatar_render_test.cpp tests/integ/hosting_publication_test.c tests/unit/mail/drd_local_store_test.c
Platforms: Windows; POSIX branches/dependencies where present. Linux/macOS runtime unverified in M13.
Status: working

Bootstrap

Purpose: Initialize retained core services for in-process use and parse core configuration.
Files: src/coin/core_bootstrap.c
Old paths: vendor/core/src/core_bootstrap.c -> src/coin/core_bootstrap.c
Public header: include/core/core_bootstrap.h
Entry points: src/coin/core_bootstrap.c:44 :: core_desktop_config_defaults()
Important static functions: src/coin/core_bootstrap.c:68 :: parse_bool() src/coin/core_bootstrap.c:74 :: parse_long_range()
Owns: Core startup ordering and its configuration dialect.
Used by: src/app/desktop_api.c
Side effects: Performs network I/O, mutates transport/session state and writes configuration/telemetry/replica data where applicable.
Tests: tests/unit/core_bootstrap_test.c
Platforms: Windows; POSIX branches/dependencies where present. Linux/macOS runtime unverified in M13.
Status: working