nym-node-requests 1.21.5-rc.2

Nym Node API endpoint definitions and functions
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

// Copyright 2023 - Nym Technologies SA <contact@nymtech.net>
// SPDX-License-Identifier: Apache-2.0

use thiserror::Error;

#[derive(Debug, Error)]
pub enum Error {
    #[error("failed to serialize json data: {source}")]
    JsonSerializationFailure {
        #[from]
        source: serde_json::Error,
    },

    #[error(transparent)]
    WireguardError {
        #[from]
        source: nym_wireguard_types::Error,
    },

    #[cfg(feature = "client")]
    #[error("node {node_id} has provided malformed host information ({host}: {source})")]
    MalformedHost {
        host: String,

        node_id: u32,

        #[source]
        source: Box<crate::api::client::NymNodeApiClientError>,
    },

    #[cfg(feature = "client")]
    #[error("failed to query node {node_id} at host {host}: {source}")]
    QueryFailure {
        host: String,

        node_id: u32,

        #[source]
        source: Box<crate::api::client::NymNodeApiClientError>,
    },

    #[cfg(feature = "client")]
    #[error(
        "node {node_id} with host '{host}' doesn't seem to expose its declared http port nor any of the standard API ports, i.e.: 80, 443 or {}",
        nym_network_defaults::DEFAULT_NYM_NODE_HTTP_PORT
    )]
    NoHttpPortsAvailable { host: String, node_id: u32 },

    #[cfg(feature = "client")]
    #[error("could not verify signed host information for node {node_id}")]
    MissignedHostInformation { node_id: u32 },

    #[cfg(feature = "client")]
    #[error("identity of node {node_id} does not match. expected {expected} but got {got}")]
    MismatchedIdentity {
        node_id: u32,
        expected: String,
        got: String,
    },
}