xstack 0.2.17

libp2p stack rewritten from ground up for rust
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

//! Implementation of [multiaddr](https://github.com/multiformats/multiaddr) in Rust.

use std::net::{IpAddr, SocketAddr};

pub use multiaddr::*;

/// A trait convert object to [`SocketAddr`]
pub trait ToSockAddr {
    type Error;
    fn to_sockaddr(&self) -> std::result::Result<SocketAddr, Self::Error>;
}

impl ToSockAddr for Multiaddr {
    type Error = crate::Error;

    fn to_sockaddr(&self) -> std::result::Result<SocketAddr, Self::Error> {
        let mut iter = self.iter();

        let ip = match iter
            .next()
            .ok_or(Error::UnknownProtocolString(self.to_string()))?
        {
            Protocol::Ip4(ip) => IpAddr::from(ip),
            Protocol::Ip6(ip) => IpAddr::from(ip),
            _ => return Err(Error::UnknownProtocolString(self.to_string()).into()),
        };

        let next = iter
            .next()
            .ok_or(Error::UnknownProtocolString(self.to_string()))?;

        match next {
            Protocol::Tcp(port) | Protocol::Udp(port) => {
                return Ok(SocketAddr::new(ip, port));
            }
            _ => return Err(Error::UnknownProtocolString(self.to_string()).into()),
        }
    }
}

/// Returns true if this [`Multiaddr`] is supported by `tcp/tls` transport.
pub fn is_tcp_transport(addr: &Multiaddr) -> bool {
    for proto in addr.iter() {
        if proto == Protocol::P2pCircuit {
            return false;
        }
    }

    let stack = addr.protocol_stack().collect::<Vec<_>>();

    if stack.len() > 1 {
        if stack[1] == "tcp" {
            return true;
        }
    }

    false
}

/// Returns true if this [`Multiaddr`] is supported by `quic` transport.
pub fn is_quic_transport(addr: &Multiaddr) -> bool {
    for proto in addr.iter() {
        if proto == Protocol::P2pCircuit {
            return false;
        }
    }

    let stack = addr.protocol_stack().collect::<Vec<_>>();

    if stack.len() > 2 {
        if stack[1] == "udp" && stack[2] == "quic-v1" {
            return true;
        }
    }

    false
}

/// Returns true if this [`Multiaddr`] is supported by `dnsaddr` transport.
pub fn is_dnsaddr_transport(addr: &Multiaddr) -> bool {
    for protocol in addr.iter() {
        match protocol {
            Protocol::Dns(_) => return true,
            Protocol::Dns4(_) => return true,
            Protocol::Dns6(_) => return true,
            Protocol::Dnsaddr(_) => return true,
            _ => {}
        }
    }

    false
}