ascii-chat
Binary v0.16.50-198-g78f51665f
Library lib/v0.3.2-2240-g78f51665f
Video chat in your terminal
Loading...
Searching...
No Matches
consensus_integration.c
Go to the documentation of this file.
1
2/* Storage capacities in elements; text buffers include the terminating NUL. */
3#define SESSION_CONSENSUS_INTEGRATION_HOST_ADDRESS_BUFFER_SIZE 64
4#define SESSION_CONSENSUS_INTEGRATION_BACKUP_ADDRESS_BUFFER_SIZE 64
5
7#include <ascii-chat/common.h>
22
23#include "session/consensus.h"
25#include <ascii-chat/common.h>
26#include <ascii-chat/log/log.h>
30#include <string.h>
31
39static asciichat_error_t consensus_send_via_discovery(void *context, const uint8_t next_participant_id[SESSION_ID_SIZE], const uint8_t *packet, size_t packet_size) {
40 // context would be a discovery_session_t in real usage
41 // This is a placeholder showing the pattern
42
43 if (!context || !next_participant_id || !packet) {
44 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid parameters");
45 }
46
47 // In real code:
48 // 1. Serialize the packet with proper headers
49 // 2. Send to ACDS with next_participant_id as recipient
50 // 3. ACDS will relay to that participant
51
52 log_debug("Consensus would send %zu bytes to participant %.*s via ACDS", packet_size, 16, next_participant_id);
53
54 return ASCIICHAT_OK;
55}
56
63static asciichat_error_t consensus_on_election_result(void *context, const uint8_t host_id[SESSION_ID_SIZE], const char host_address[SESSION_CONSENSUS_INTEGRATION_HOST_ADDRESS_BUFFER_SIZE],
64 uint16_t host_port, const uint8_t backup_id[SESSION_ID_SIZE], const char backup_address[SESSION_CONSENSUS_INTEGRATION_BACKUP_ADDRESS_BUFFER_SIZE],
65 uint16_t backup_port) {
66 (void)backup_address; // unused in placeholder
67 (void)backup_port; // unused in placeholder
68
69 // context would be a discovery_session_t in real usage
70 if (!context || !host_id || !backup_id) {
71 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid parameters");
72 }
73
74 // In real code:
75 // 1. Store host_id, backup_id, addresses, ports
76 // 2. If elected as host: Start hosting
77 // 3. If not elected: Connect to host or schedule reconnection
78
79 log_info("Consensus election result: host=%.*s backup=%.*s (addr=%s:%u)", 16, host_id, 16, backup_id, host_address, host_port);
80
81 return ASCIICHAT_OK;
82}
83
90static asciichat_error_t consensus_get_metrics(void *context, const uint8_t my_id[SESSION_ID_SIZE], participant_metrics_t *out_metrics) {
91 // context would be a discovery_session_t in real usage
92 if (!context || !my_id || !out_metrics) {
93 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid parameters");
94 }
95
96 // In real code:
97 // 1. Measure NAT tier via UPnP probe
98 // 2. Estimate upload bandwidth
99 // 3. Measure RTT to current host (or ACDS)
100 // 4. Send STUN probes and count success rate
101 // 5. Get public address from detected NAT result
102
103 return consensus_metrics_measure(my_id, out_metrics);
104}
105
118 if (!context || !out_callbacks) {
119 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid parameters: context=%p, out_callbacks=%p", context, out_callbacks);
120 }
121
122 // Configure callbacks for discovery mode
123 out_callbacks->send_packet = consensus_send_via_discovery;
124 out_callbacks->on_election = consensus_on_election_result;
125 out_callbacks->get_metrics = consensus_get_metrics;
126 out_callbacks->election = NULL; // Use default election algorithm
127 out_callbacks->context = context;
128
129 return ASCIICHAT_OK;
130}
131
148 const uint8_t participant_ids[MAX_SESSION_PARTICIPANTS][SESSION_ID_SIZE], int num_participants, void *discovery_context,
149 session_consensus_t **out_consensus) {
150 (void)session_id; // Informational only, not needed by consensus itself
151
152 if (!my_id || !participant_ids || !discovery_context || !out_consensus) {
153 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid parameters");
154 }
155
156 if (num_participants < 1 || num_participants > MAX_SESSION_PARTICIPANTS) {
157 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid participant count: %d", num_participants);
158 }
159
160 // Determine if we're the ring leader (for now, assume not - ACDS would manage this)
161 // In a real implementation, ACDS would tell us our position in the ring
162 bool is_leader = false; // This would be determined by ACDS
163
164 // Get callbacks configured for our mode
165 session_consensus_callbacks_t callbacks = {0};
166 asciichat_error_t err = consensus_get_discovery_callbacks(discovery_context, &callbacks);
167 if (err != ASCIICHAT_OK) {
168 return err;
169 }
170
171 // Create consensus with the callbacks
172 return session_consensus_create(my_id, is_leader, participant_ids, num_participants, &callbacks, out_consensus);
173}
174
185 if (!consensus) {
186 return current_timeout_ms;
187 }
188
189 // Get time until next round in nanoseconds
190 uint64_t time_to_next_ns = session_consensus_time_until_next_round(consensus);
191
192 // Convert to milliseconds
193 uint64_t time_to_next_ms = time_ns_to_ms(time_to_next_ns);
194
195 // Return minimum of consensus deadline or current timeout
196 if (time_to_next_ms == 0) {
197 return 0; // Consensus needs immediate attention
198 }
199
200 if (time_to_next_ms < current_timeout_ms) {
201 return (uint32_t)time_to_next_ms;
202 }
203
204 return current_timeout_ms;
205}
#define SET_ERRNO(code,...)
asciichat_error_t session_consensus_create(const uint8_t my_id[SESSION_ID_SIZE], bool is_leader, const uint8_t participant_ids[MAX_SESSION_PARTICIPANTS][SESSION_ID_SIZE], int num_participants, const session_consensus_callbacks_t *callbacks, session_consensus_t **out_consensus)
Create a new session consensus instance.
Definition consensus.c:117
uint64_t session_consensus_time_until_next_round(session_consensus_t *consensus)
Get time until next consensus round in nanoseconds.
Definition consensus.c:301
struct session_consensus session_consensus_t
When code needs to work with session consensus, it keeps topology, coordinator, send_packet,...
Mode-agnostic ring consensus abstraction for session discovery.
#define SESSION_CONSENSUS_INTEGRATION_HOST_ADDRESS_BUFFER_SIZE
asciichat_error_t consensus_get_discovery_callbacks(void *context, session_consensus_callbacks_t *out_callbacks)
Get callbacks configured for discovery mode integration.
uint32_t consensus_suggest_timeout_ms(session_consensus_t *consensus, uint32_t current_timeout_ms)
Calculate how long to wait until next consensus processing.
#define SESSION_CONSENSUS_INTEGRATION_BACKUP_ADDRESS_BUFFER_SIZE
asciichat_error_t consensus_create_for_discovery(const uint8_t session_id[SESSION_ID_SIZE], const uint8_t my_id[SESSION_ID_SIZE], const uint8_t participant_ids[MAX_SESSION_PARTICIPANTS][SESSION_ID_SIZE], int num_participants, void *discovery_context, session_consensus_t **out_consensus)
Example: Create session consensus for discovery mode.
🔄 Network byte order conversion helpers
unsigned short uint16_t
unsigned int uint32_t
unsigned long long uint64_t
unsigned char uint8_t
asciichat_error_t
Error and exit codes - unified status values (0-255).
Definition error_codes.h:48
@ ASCIICHAT_OK
Definition error_codes.h:50
@ ERROR_INVALID_PARAM
#define MAX_SESSION_PARTICIPANTS
#define SESSION_ID_SIZE
#define log_info(...)
Log an INFO message.
Definition log/log.h:602
#define log_debug(...)
Log a DEBUG message.
Definition log/log.h:589
⚙️ Common definitions, error codes, macros, and types shared throughout the application
📝 Logging API with multiple log levels and terminal output control
asciichat_error_t consensus_metrics_measure(const uint8_t my_id[SESSION_ID_SIZE], participant_metrics_t *out_metrics)
Measure participant network quality metrics.
Definition metrics.c:33
Ring consensus metrics collection and wire protocol.
uint8_t session_id[SESSION_ID_SIZE]
🔤 String Manipulation and Shell Escaping Utilities
Mode-specific hooks used by the session consensus adapter.
Definition consensus.h:122
void * context
Opaque context passed to all callbacks.
Definition consensus.h:127
session_consensus_election_fn election
Custom election callback (optional, NULL = use default).
Definition consensus.h:126
session_consensus_on_election_fn on_election
Election result callback.
Definition consensus.h:124
session_consensus_get_metrics_fn get_metrics
Measure metrics callback.
Definition consensus.h:125
session_consensus_send_packet_fn send_packet
Send packet callback.
Definition consensus.h:123
⏱️ High-precision timing utilities using sokol_time.h and uthash