nat.h

Go to the documentation of this file.

 
#pragma once
 
#include <ascii-chat/asciichat_errno.h>
#include <ascii-chat/network/acip/acds.h>
#include <ascii-chat/platform/socket.h>
#include <stdbool.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct {
  // NAT detection results
  bool has_public_ip;        
  bool upnp_available;       
  uint16_t upnp_mapped_port; 
  acip_nat_type_t nat_type;  
  bool lan_reachable;        
  uint64_t stun_latency_ns;  
  char public_address[64];   
  uint16_t public_port;      
 
  // Bandwidth measurements
  uint32_t upload_kbps;    
  uint32_t download_kbps;  
  uint64_t rtt_to_acds_ns; 
  uint64_t jitter_ns;      
  uint8_t packet_loss_pct; 
 
  // ICE candidate summary
  bool has_host_candidates;  
  bool has_srflx_candidates; 
  bool has_relay_candidates; 
 
  // Detection status
  bool detection_complete; 
  asciichat_error_t error; 
} nat_quality_t;
 
void nat_quality_init(nat_quality_t *quality);
 
asciichat_error_t nat_detect_quality(nat_quality_t *quality, const char *stun_server, uint16_t local_port);
 
asciichat_error_t nat_measure_bandwidth(nat_quality_t *quality, socket_t acds_socket);
 
int nat_compare_quality(const nat_quality_t *ours, const nat_quality_t *theirs, bool we_are_initiator);
 
void nat_quality_to_acip(const nat_quality_t *quality, const uint8_t session_id[16], const uint8_t participant_id[16],
                         acip_nat_quality_t *out);
 
void nat_quality_from_acip(const acip_nat_quality_t *acip, nat_quality_t *out);
 
const char *nat_type_to_string(acip_nat_type_t type);
 
int nat_compute_tier(const nat_quality_t *quality);
 
#ifdef __cplusplus
}
#endif