ant_quic/api/
mod.rs

1//! High-Level NAT Traversal API
2//!
3//! This module provides a clean, intuitive API for developers to use the
4//! ant-quic library for NAT traversal and P2P networking.
5
6use std::collections::HashMap;
7use std::time::Duration;
8use thiserror::Error;
9
10use crate::nat_traversal::{NatTraversalEndpoint, NatTraversalError, PeerId};
11
12// Re-export configuration module
13pub mod config;
14pub use config::ConfigError;
15pub use config::P2PConfig;
16pub use config::P2PConfigBuilder;
17
18/// High-level P2P node implementation
19pub struct P2PNode {
20    // Internal NAT traversal endpoint
21    endpoint: NatTraversalEndpoint,
22    // Node configuration
23    config: P2PConfig,
24    // Active connections
25    connections: HashMap<PeerId, P2PConnection>,
26    // Event queue
27    events: Vec<P2PEvent>,
28}
29
30/// High-level P2P connection
31pub struct P2PConnection {
32    // Peer ID
33    peer_id: PeerId,
34    // Connection state
35    state: ConnectionState,
36    // Statistics
37    stats: ConnectionStats,
38}
39
40/// Connection state
41enum ConnectionState {
42    Connecting,
43    Connected,
44    Disconnecting,
45    Disconnected,
46}
47
48/// Connection statistics
49pub struct ConnectionStats {
50    // Round-trip time
51    rtt: Duration,
52    // Bytes sent
53    bytes_sent: u64,
54    // Bytes received
55    bytes_received: u64,
56    // Packets sent
57    packets_sent: u64,
58    // Packets received
59    packets_received: u64,
60}
61
62/// High-level P2P events
63pub enum P2PEvent {
64    /// Connected to a peer
65    Connected { peer_id: PeerId },
66    /// Disconnected from a peer
67    Disconnected {
68        peer_id: PeerId,
69        reason: Option<String>,
70    },
71    /// Received data from a peer
72    Data { peer_id: PeerId, data: Vec<u8> },
73    /// Error occurred
74    Error {
75        peer_id: Option<PeerId>,
76        error: P2PError,
77    },
78}
79
80/// Errors that can occur in the P2P API
81#[derive(Debug, Error)]
82pub enum P2PError {
83    #[error("Connection error: {0}")]
84    Connection(String),
85
86    #[error("Authentication error: {0}")]
87    Authentication(String),
88
89    #[error("NAT traversal error: {0}")]
90    NatTraversal(#[from] NatTraversalError),
91
92    #[error("Configuration error: {0}")]
93    Configuration(String),
94
95    #[error("Timeout: {0}")]
96    Timeout(String),
97}
98
99// Implementation of the P2P API
100// (Placeholder - actual implementation would go here)
ant_quic/api/mod.rs

ant_quic/api/
mod.rs
