ic-query 0.25.2

Internet Computer query library for 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

//! Module: sns::report::live::fetch::canisters
//!
//! Responsibility: fetch SNS Root canister inventory and operational health.
//! Does not own: SNS lookup, report assembly, cache IO, or rendering.
//! Boundary: performs one query plus one explicitly read-only ingress call.

use super::block_on_sns;
use crate::sns::report::{
    MainnetSns, MainnetSnsCanisterInventory, SnsHostError, SnsSourceRequest,
    live::{
        convert::mainnet_sns_canister_inventory,
        query::{principal_from_text, query_canister, sns_agent, update_canister},
        types::{
            GetSnsCanistersSummaryRequest, GetSnsCanistersSummaryResponse, ListSnsCanistersRequest,
            ListSnsCanistersResponse,
        },
    },
};

/// Fetch current Root inventory and health without asking Root to update state.
pub(in crate::sns::report::live) fn fetch_mainnet_sns_canisters(
    request: &SnsSourceRequest,
    sns: &MainnetSns,
) -> Result<MainnetSnsCanisterInventory, SnsHostError> {
    block_on_sns(fetch_mainnet_sns_canisters_async(request, sns))
}

async fn fetch_mainnet_sns_canisters_async(
    request: &SnsSourceRequest,
    sns: &MainnetSns,
) -> Result<MainnetSnsCanisterInventory, SnsHostError> {
    let agent = sns_agent(request)?;
    let root_canister = principal_from_text(&sns.root_canister_id, "root_canister_id")?;
    let inventory: ListSnsCanistersResponse = query_canister(
        &agent,
        &root_canister,
        "list_sns_canisters",
        "ListSnsCanistersRequest",
        "ListSnsCanistersResponse",
        &ListSnsCanistersRequest {},
    )
    .await?;
    let health_request = GetSnsCanistersSummaryRequest::read_only();
    let health: GetSnsCanistersSummaryResponse = update_canister(
        &agent,
        &root_canister,
        "get_sns_canisters_summary",
        "GetSnsCanistersSummaryRequest",
        "GetSnsCanistersSummaryResponse",
        &health_request,
    )
    .await?;
    mainnet_sns_canister_inventory(inventory, health)
}