discovery.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#include <stdbool.h>
#include <time.h>
#include "../../common.h"
#include "../../discovery/strings.h" // For is_session_string()
#include "../../ui/mdns.h"  // For ui_mdns_server_t
 
#ifdef __cplusplus
extern "C" {
#endif
 
// ============================================================================
// Discovery Result
// ============================================================================
 
typedef struct {
  bool success;             
  uint8_t host_pubkey[32];  
  char server_address[256]; 
  uint16_t server_port;     
  enum {
    DISCOVERY_SOURCE_MDNS = 0, 
    DISCOVERY_SOURCE_ACDS = 1, 
  } source;                    
 
  // For mDNS results
  char mdns_service_name[256]; 
  char mdns_hostname[256];     
 
  // For ACDS results (if applicable)
  uint8_t session_id[16];     
  uint8_t participant_id[16]; 
 
  // Error details
  asciichat_error_t error; 
  char error_message[256]; 
} discovery_result_t;
 
typedef struct {
  // Verification options
  const uint8_t *expected_pubkey; 
  bool insecure_mode;             
 
  // Connection details
  char acds_server[256]; 
  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[32], char hex_out[65]);
 
asciichat_error_t hex_to_pubkey(const char *hex_str, uint8_t pubkey_out[32]);
 
#ifdef __cplusplus
}
#endif