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

use std::collections::{HashSet, VecDeque};

use multiaddr::Multiaddr;

use crate::AutoNAT;

#[derive(Default)]
pub(super) struct MutableSwitch {
    max_observed_addrs_len: usize,
    laddrs: Vec<Multiaddr>,
    observed_addrs: VecDeque<Multiaddr>,
    nat_addrs: HashSet<Multiaddr>,
    nat: AutoNAT,
}

impl MutableSwitch {
    pub(super) fn new(max_observed_addrs_len: usize) -> Self {
        Self {
            max_observed_addrs_len,
            ..Default::default()
        }
    }
    /// Register transport bind addresses.
    pub(super) fn transport_bind_to(&mut self, addr: Multiaddr) {
        self.laddrs.push(addr)
    }

    /// Returns the local bound addrs.
    pub(super) fn local_addrs(&self) -> Vec<Multiaddr> {
        self.laddrs.clone()
    }

    pub(super) fn listen_addrs(&self) -> Vec<Multiaddr> {
        match self.nat {
            AutoNAT::Public => self.laddrs.clone(),
            AutoNAT::NAT => self.nat_addrs.iter().cloned().collect(),
            AutoNAT::Unknown => vec![],
        }
    }

    pub(super) fn set_observed_addrs(&mut self, addrs: Vec<Multiaddr>) {
        for addr in addrs {
            if self.observed_addrs.len() == self.max_observed_addrs_len {
                self.observed_addrs.pop_front();
            }

            self.observed_addrs.push_back(addr);
        }
    }

    pub(super) fn observed_addrs(&self) -> Vec<Multiaddr> {
        self.observed_addrs.iter().cloned().collect()
    }

    pub(super) fn set_net_addrs(&mut self, addrs: Vec<Multiaddr>) {
        self.nat_addrs.extend(addrs.into_iter());
    }

    pub(super) fn remove_net_addrs(&mut self, addrs: &[Multiaddr]) {
        for addr in addrs {
            self.nat_addrs.remove(addr);
        }
    }

    pub(super) fn auto_nat(&self) -> AutoNAT {
        self.nat
    }

    pub(super) fn set_nat(&mut self, state: AutoNAT) {
        self.nat = state;
    }
}