discovery.h

Go to the documentation of this file.

 
#pragma once
 
/* Storage capacities in elements; text buffers include the terminating NUL. */
#define NETWORK_MDNS_DISCOVERY_ERROR_MESSAGE_BUFFER_SIZE 256
 
#include <ascii-chat/crypto/sizes.h>
#include <ascii-chat/common/limits.h>
 
#include <stdint.h>
#include <stdbool.h>
#include <time.h>
#include "../../common.h"
#include "../../discovery/strings.h" // For is_session_string()
#include "../../tui/mdns.h"          // For ui_mdns_server_t
 
#ifdef __cplusplus
extern "C" {
#endif
 
// ============================================================================
// Discovery Result
// ============================================================================

typedef struct {
  bool success;                                 
  uint8_t host_pubkey[ED25519_PUBLIC_KEY_SIZE]; 
  char server_address[HOSTNAME_BUFFER_SIZE];    
  uint16_t server_port;                         
  enum {
    DISCOVERY_SOURCE_MDNS = 0, 
    DISCOVERY_SOURCE_ACDS = 1, 
  } source;                    
 
  // For mDNS results
  char mdns_service_name[HOSTNAME_BUFFER_SIZE]; 
  char mdns_hostname[HOSTNAME_BUFFER_SIZE];     
 
  // For ACDS results (if applicable)
  uint8_t session_id[SESSION_ID_SIZE];     
  uint8_t participant_id[SESSION_ID_SIZE]; 
 
  // Error details
  asciichat_error_t error;                                              
  char error_message[NETWORK_MDNS_DISCOVERY_ERROR_MESSAGE_BUFFER_SIZE]; 
} discovery_result_t;

typedef struct {
  // Verification options
  const uint8_t *expected_pubkey; 
  bool insecure_mode;             
 
  // Connection details
  char acds_server[HOSTNAME_BUFFER_SIZE]; 
  uint16_t acds_port;                     
 
  // Timeouts
  uint32_t mdns_timeout_ms; 
  uint32_t acds_timeout_ms; 
 
  // Client identity (for SESSION_JOIN)
  const uint8_t *client_pubkey; 
  const uint8_t *client_seckey; 
  const char *password;         
} discovery_config_t;

void discovery_config_init_defaults(discovery_config_t *config);
 
// ============================================================================
// Parallel Discovery
// ============================================================================

asciichat_error_t discover_session_parallel(const char *session_string, const discovery_config_t *config,
                                            discovery_result_t *result);
 
// ============================================================================
// mDNS Query API (Core Module)
// ============================================================================

ui_mdns_server_t *discovery_mdns_query(int timeout_ms, int max_servers, bool quiet, int *out_count);

void discovery_mdns_destroy(ui_mdns_server_t *servers);
 
// ============================================================================
// Utility Functions
// ============================================================================

void pubkey_to_hex(const uint8_t pubkey[ED25519_PUBLIC_KEY_SIZE], char hex_out[HEX_STRING_SIZE_32]);

asciichat_error_t hex_to_pubkey(const char *hex_str, uint8_t pubkey_out[ED25519_PUBLIC_KEY_SIZE]);
 
#ifdef __cplusplus
}
#endif