ic-query 0.90.0

Internet Computer query library for CloudEngine, NNS, SNS, ICRC, system canisters, and public network metadata
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

use crate::nns::NnsInventoryRefreshReport;
use crate::{
    nns::node::{NnsNodeListReport, NnsNodeRow},
    subnet_catalog::SubnetKind,
};

pub(in crate::nns::topology::report::tests) fn node_refresh_report_fixture()
-> NnsInventoryRefreshReport {
    NnsInventoryRefreshReport {
        schema_version: 1,
        collection: "nodes".to_string(),
        provenance: super::inventory_provenance(43, "2026-06-04T00:01:00Z"),
        cache_path: "/cache/nns/ic/node/nodes.json".to_string(),
        refresh_lock_path: "/cache/nns/ic/node/refresh.lock".to_string(),
        output_path: None,
        governance_canister_id: None,
        dry_run: false,
        wrote_cache: true,
        replaced_existing_cache: false,
        row_count: 3,
    }
}

pub(in crate::nns::topology::report::tests) fn dry_run_node_refresh_report_fixture()
-> NnsInventoryRefreshReport {
    NnsInventoryRefreshReport {
        dry_run: true,
        wrote_cache: false,
        ..node_refresh_report_fixture()
    }
}

pub(in crate::nns::topology::report::tests) fn node_report_fixture() -> NnsNodeListReport {
    NnsNodeListReport {
        schema_version: 1,
        provenance: super::inventory_provenance(43, "2026-06-04T00:01:00Z"),
        nodes: vec![
            node_row(
                "node-a",
                "operator-a",
                "provider-a",
                "dc1",
                SubnetKind::Application,
            ),
            node_row(
                "node-b",
                "operator-a",
                "provider-a",
                "dc1",
                SubnetKind::Application,
            ),
            node_row(
                "node-c",
                "operator-z",
                "provider-z",
                "dc-z",
                SubnetKind::System,
            ),
        ],
    }
}

fn node_row(
    node_principal: &str,
    node_operator_principal: &str,
    node_provider_principal: &str,
    data_center_id: &str,
    subnet_kind: SubnetKind,
) -> NnsNodeRow {
    NnsNodeRow {
        node_principal: node_principal.to_string(),
        node_operator_principal: node_operator_principal.to_string(),
        node_provider_principal: node_provider_principal.to_string(),
        subnet_principal: "subnet-a".to_string(),
        subnet_kind,
        data_center_id: data_center_id.to_string(),
    }
}