ic-query 0.81.1

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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use ic_host_text::escape::terminal_text;

use crate::{
    human_quantity::cycle_count_text, subnet_catalog::SubnetCatalogInfoReport, text_value::yes_no,
};

/// Render resolved subject, catalog provenance, and execution-rate details as text.
#[must_use]
pub fn subnet_catalog_info_report_text(report: &SubnetCatalogInfoReport) -> String {
    let safe_line = |label: &str, value: &str| format!("{label}: {}", terminal_text(value));
    let mut lines = Vec::new();
    lines.push(safe_line("input_principal", &report.input_principal));
    lines.push(safe_line("resolved_as", &report.resolved_as));
    lines.push(safe_line("resolved_from", &report.resolved_from));
    lines.push(format!("subnet_principal: {}", report.subnet_principal));
    lines.push(format!(
        "registry_subnet_type: {}",
        report.classification.registry_subnet_type
    ));
    lines.push(format!(
        "subnet_kind: {}",
        report.classification.subnet_kind.as_str()
    ));
    lines.push(format!(
        "subnet_kind_source: {}",
        report.classification.subnet_kind_source.as_str()
    ));
    lines.push(format!(
        "subnet_specialization: {}",
        report.classification.subnet_specialization.as_str()
    ));
    lines.push(format!(
        "subnet_specialization_source: {}",
        report.classification.subnet_specialization_source.as_str()
    ));
    lines.push(format!(
        "geographic_scope: {}",
        report.classification.geographic_scope.as_str()
    ));
    lines.push(format!(
        "geographic_scope_source: {}",
        report.classification.geographic_scope_source.as_str()
    ));
    lines.push(safe_line(
        "subnet_label",
        &report.classification.subnet_label,
    ));
    lines.push(format!(
        "subnet_label_source: {}",
        report.classification.subnet_label_source.as_str()
    ));
    lines.push(format!(
        "node_count: {}",
        report
            .node_count
            .map_or_else(|| "unknown".to_string(), |count| count.to_string())
    ));
    lines.push(format!(
        "charges_apply_to_subject: {}",
        yes_no(report.charges_apply_to_subject)
    ));
    lines.push(format!(
        "charge_applicability_reason: {}",
        terminal_text(&report.charge_applicability_reason)
    ));
    append_catalog_evidence(&mut lines, report);
    if let Some(canister) = &report.matched_canister_principal {
        lines.push(format!("matched_canister_principal: {canister}"));
    }
    if let Some(range) = &report.matched_routing_range {
        lines.push(format!(
            "matched_routing_range: {}..{}",
            range.start_canister_id, range.end_canister_id
        ));
    }
    lines.push(format!(
        "cycles_per_billion_instructions: {}",
        report
            .cycles_per_billion_instructions
            .map_or_else(|| "not_applicable".to_string(), cycle_count_text)
    ));
    if let Some(rate_source) = &report.rate_source {
        lines.push(safe_line("rate_source", rate_source));
    }
    if let Some(formula_version) = &report.formula_version {
        lines.push(safe_line("formula_version", formula_version));
    }
    lines.join("\n")
}

fn append_catalog_evidence(lines: &mut Vec<String>, report: &SubnetCatalogInfoReport) {
    lines.push(format!(
        "registry_canister_id: {}",
        report.metadata.registry_canister_id
    ));
    lines.push(format!(
        "registry_version: {}",
        report.metadata.registry_version
    ));
    super::append_catalog_authority(lines, &report.metadata, report.cache_disposition);
    lines.push(format!(
        "catalog_schema_version: {}",
        report.catalog_schema_version
    ));
    lines.push(format!(
        "catalog_path: {}",
        terminal_text(&report.catalog_path)
    ));
    lines.push(format!(
        "fetched_at: {}",
        terminal_text(&report.metadata.fetched_at)
    ));
    lines.push(format!("catalog_stale: {}", yes_no(report.catalog_stale)));
    lines.push(format!(
        "stale_reason: {}",
        terminal_text(&report.stale_reason)
    ));
    super::append_catalog_policy(lines, &report.metadata);
}