ic-agent 0.47.2

Agent library to communicate with the Internet Computer, following the Public Specification.
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

use url::Url;

use crate::agent::ApiBoundaryNode;

/// Represents a node in the dynamic routing.
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub struct Node {
    domain: String,
}

impl Node {
    /// Creates a new `Node` instance from the domain name.
    pub fn new(domain: impl Into<String>) -> Result<Self, url::ParseError> {
        let domain = domain.into();
        check_valid_domain(&domain)?;
        Ok(Self { domain })
    }

    /// Returns the domain name of the node.
    pub fn domain(&self) -> &str {
        &self.domain
    }
}

impl Node {
    /// Converts the node to a routing URL.
    pub fn to_routing_url(&self) -> Url {
        Url::parse(&format!("https://{}", self.domain)).expect("failed to parse URL")
    }
}

impl From<&Node> for Url {
    fn from(node: &Node) -> Self {
        // Parsing can't fail, as the domain was checked at node instantiation.
        Url::parse(&format!("https://{}", node.domain)).expect("failed to parse URL")
    }
}

impl TryFrom<ApiBoundaryNode> for Node {
    type Error = url::ParseError;

    fn try_from(value: ApiBoundaryNode) -> Result<Self, Self::Error> {
        Node::new(value.domain)
    }
}

/// Checks if the given domain is a valid URL.
fn check_valid_domain<S: AsRef<str>>(domain: S) -> Result<(), url::ParseError> {
    // Prepend scheme to make it a valid URL
    let url_string = format!("http://{}", domain.as_ref());
    Url::parse(&url_string)?;
    Ok(())
}