veilnet 0.4.4

Networking abstractions built on Veilid API primitives
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//! Address types for DHT-based communication.

use std::{fmt::Display, str::FromStr};

use anyhow::Error;
use veilid_core::RecordKey;

/// An address for DHT-based communication in the Veilid network.
///
/// A DHT address consists of a typed record key that identifies a DHT record
/// and a subkey that specifies a particular entry within that record.
/// This is commonly used for addressing services or endpoints.
///
/// # Examples
///
/// ```no_run
/// use veilnet::DHTAddr;
///
/// // Parse from string representation
/// let addr: DHTAddr = "VLD0:abcd1234...efgh5678:8080".parse()?;
/// println!("Connecting to {}", addr);
/// # Ok::<(), Box<dyn std::error::Error>>(())
/// ```
#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub struct DHTAddr {
    /// The DHT record key identifying the target record.
    pub key: RecordKey,
    /// The subkey within the DHT record, used as a port number.
    pub subkey: u16,
}

impl DHTAddr {
    pub fn new(key: RecordKey, subkey: u16) -> DHTAddr {
        Self { key, subkey }
    }
}

impl Display for DHTAddr {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}:{}", self.key, self.subkey)
    }
}

impl FromStr for DHTAddr {
    type Err = Error;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s.rsplit_once(":") {
            Some((key_str, subkey_str)) => Ok(DHTAddr {
                key: key_str.parse()?,
                subkey: subkey_str.parse()?,
            }),
            None => Err(anyhow::anyhow!("invalid address: {s}")),
        }
    }
}