ic_query/
lib.rs

1//! Reusable report models and helpers for Internet Computer metadata queries.
2//!
3//! The default feature set is empty. A dependency using
4//! `default-features = false` gets the pure report DTOs, JSON contracts, and local
5//! parsing/resolution helpers that are intended to stay free of native
6//! live-call dependencies. Human-facing rendering lives in `ic-query-text`.
7//!
8//! This is a host dependency boundary, not a `no_std` promise. No-default
9//! builds are expected to compile for `wasm32-unknown-unknown` without
10//! `ic-agent`, Reqwest, Tokio, or `futures-util`, but they may still use ordinary
11//! `std` types such as `String` and `Vec`.
12//!
13//! Enable `dashboard-host` for official Dashboard live/cache APIs,
14//! `ic-state-host` for certified IC state-tree reports,
15//! `cloud-engine-host` for native CloudEngine control-plane reports (combine it
16//! with `subnet-catalog-host` for the Registry-backed CloudEngine list),
17//! `icrc-host` for native ICRC ledger/index APIs, `sns-host` for native SNS
18//! live/cache APIs, `cmc-host` for certified Cycles Minting Canister reports,
19//! `subnet-catalog-host` for the focused live/cache Subnet catalog API,
20//! `nns-topology-host` for that API plus exact-version joined NNS Subnet
21//! topology, `nns-host` for the complete NNS host surface, `canister` for the
22//! replicated NNS Governance adapter on `wasm32`, or `host` for every native
23//! live-call adapter. CLI parsing and process IO belong to
24//! the separate `ic-query-cli` crate.
25
26#[cfg(any(
27    feature = "cloud-engine-host",
28    feature = "cmc-host",
29    feature = "ic-state-host",
30    feature = "icrc-host",
31    feature = "sns-host",
32    feature = "subnet-catalog-host"
33))]
34mod agent;
35#[cfg(any(
36    feature = "cloud-engine-host",
37    feature = "cmc-host",
38    feature = "icrc-host",
39    feature = "sns-host",
40    feature = "subnet-catalog-host"
41))]
42mod agent_transport;
43pub mod cache;
44#[cfg(any(
45    feature = "dashboard-host",
46    feature = "icrc-host",
47    feature = "sns-host",
48    feature = "subnet-catalog-host"
49))]
50mod cache_file;
51#[cfg(any(
52    feature = "cloud-engine-host",
53    feature = "cmc-host",
54    feature = "icrc-host",
55    feature = "nns-host",
56    feature = "sns-host"
57))]
58mod candid_call;
59#[cfg(any(
60    test,
61    all(feature = "canister", target_arch = "wasm32"),
62    feature = "cloud-engine-host",
63    feature = "cmc-host",
64    feature = "icrc-host",
65    feature = "sns-host",
66    feature = "subnet-catalog-host"
67))]
68mod candid_decode;
69#[cfg(feature = "certificate-host")]
70pub mod certificate;
71#[cfg(any(
72    feature = "nns-host",
73    feature = "cmc-host",
74    feature = "ic-state-host",
75    feature = "icrc-host"
76))]
77mod certification;
78pub mod cloud_engine;
79#[cfg(any(
80    feature = "cloud-engine-host",
81    feature = "dashboard-host",
82    feature = "icrc-host",
83    feature = "sns-host"
84))]
85mod decimal;
86#[cfg(any(
87    feature = "dashboard-host",
88    feature = "icrc-host",
89    feature = "sns-host",
90    feature = "subnet-catalog-host"
91))]
92mod freshness;
93mod hex;
94mod http_endpoint;
95pub mod ic;
96#[cfg(feature = "subnet-catalog-host")]
97mod ic_registry;
98pub mod icrc;
99mod identifier_match;
100#[cfg(any(
101    feature = "cloud-engine-host",
102    feature = "cmc-host",
103    feature = "dashboard-host",
104    feature = "sns-host",
105    feature = "subnet-catalog-host"
106))]
107mod network;
108pub mod nns;
109mod principal_text;
110#[cfg(any(
111    feature = "dashboard-host",
112    feature = "icrc-host",
113    feature = "nns-host",
114    feature = "sns-host",
115    feature = "subnet-catalog-host"
116))]
117mod progress;
118pub mod report;
119mod report_sort;
120#[cfg(any(
121    feature = "dashboard-host",
122    feature = "icrc-host",
123    feature = "nns-host",
124    feature = "sns-host"
125))]
126pub(crate) mod snapshot_cache;
127pub mod sns;
128pub mod subnet_catalog;
129pub mod system;
130
131#[cfg(any(
132    feature = "dashboard-host",
133    feature = "icrc-host",
134    feature = "sns-host",
135    feature = "subnet-catalog-host"
136))]
137pub use cache_file::{CacheFileError, HostCacheError};
138mod text_search;
139
140#[cfg(all(
141    test,
142    any(
143        feature = "dashboard-host",
144        feature = "icrc-host",
145        feature = "sns-host",
146        feature = "subnet-catalog-host"
147    )
148))]
149mod tests;
150
151#[cfg(any(
152    feature = "dashboard-host",
153    feature = "icrc-host",
154    feature = "nns-host",
155    feature = "sns-host",
156    feature = "subnet-catalog-host"
157))]
158pub use progress::{
159    PagedQueryProgress, QueryProgress, QueryProgressCollection, QueryProgressEvent,
160    QueryProgressState,
161};
ic_query/lib.rs

ic_query/
lib.rs
