acds_protocol.h

Go to the documentation of this file.

#pragma once
 
/* Storage capacities in elements; text buffers include the terminating NUL. */
#define NETWORK_ACIP_ACDS_PROTOCOL_ERROR_BUFFER_SIZE 256
#define NETWORK_ACIP_ACDS_PROTOCOL_NAME_BUFFER_SIZE 49
 
#include <ascii-chat/network/acip/acds_client.h>

typedef asciichat_error_t (*acds_protocol_send_fn)(void *, packet_type_t, const void *, size_t);
typedef enum {
  ACDS_IDLE,
  ACDS_CREATING,
  ACDS_LOOKING_UP,
  ACDS_JOINING,
  ACDS_CREATED,
  ACDS_FOUND,
  ACDS_JOINED,
  ACDS_ENDED,
  ACDS_FAILED
} acds_protocol_state_t;
 
typedef struct acds_protocol {
  acds_protocol_send_fn send;
  void *user_data;
  acds_protocol_state_t state;
  bool terminal;
  bool auto_join;
  bool require_webrtc;
  char error[NETWORK_ACIP_ACDS_PROTOCOL_ERROR_BUFFER_SIZE];
  acds_session_join_params_t join;
  char name[NETWORK_ACIP_ACDS_PROTOCOL_NAME_BUFFER_SIZE];
  acip_session_created_t created;
  acip_session_info_t info;
  acip_session_joined_t joined;
  uint16_t quic_port;
  char webtransport_url[512];
} acds_protocol_t;
 
void acds_protocol_init(acds_protocol_t *protocol, acds_protocol_send_fn send, void *user_data);
void acds_protocol_destroy(acds_protocol_t *protocol);
asciichat_error_t acds_protocol_create(acds_protocol_t *protocol, const acds_session_create_params_t *params,
                                       uint8_t total_keys, uint8_t key_index);
asciichat_error_t acds_protocol_lookup(acds_protocol_t *protocol, const char *name);
asciichat_error_t acds_protocol_join(acds_protocol_t *protocol, const acds_session_join_params_t *params);
asciichat_error_t acds_protocol_enter(acds_protocol_t *protocol, bool create, const char *name, const char *password);
asciichat_error_t acds_protocol_receive(acds_protocol_t *protocol, packet_type_t type, const void *payload,
                                        size_t length);
asciichat_error_t acds_protocol_leave(acds_protocol_t *protocol);

asciichat_error_t acds_handshake_begin(acip_transport_t *transport, uint8_t mode);
asciichat_error_t acds_handshake_receive(crypto_handshake_context_t *context, acip_transport_t *transport,
                                         packet_type_t type, const void *payload, size_t length);

asciichat_error_t acds_receive_packet(acip_transport_t *transport, packet_type_t *type, void **payload, size_t *length,
                                      void **allocation);