ic_query/ic/
mod.rs

1//! Certified IC state and official Dashboard report models, adapters, builders, and renderers.
2
3mod api_boundary_node;
4#[cfg(feature = "dashboard-host")]
5mod build;
6#[cfg(feature = "dashboard-host")]
7mod live;
8mod model;
9mod node_status;
10#[cfg(feature = "dashboard-host")]
11mod source;
12mod text;
13
14pub use api_boundary_node::{
15    DEFAULT_IC_STATE_SOURCE_ENDPOINT, IC_API_BOUNDARY_NODE_REPORT_SCHEMA_VERSION,
16    IcApiBoundaryNodeReport, IcApiBoundaryNodeRequest, IcApiBoundaryNodeRow,
17    IcCertifiedStateProvenance, MAX_IC_API_BOUNDARY_NODE_ROWS, ic_api_boundary_node_report_text,
18};
19#[cfg(feature = "ic-state-host")]
20pub use api_boundary_node::{
21    IcApiBoundaryNodeHostError, IcApiBoundaryNodeSource, IcApiBoundaryNodeSourceData,
22    IcApiBoundaryNodeSourceRequest, LiveIcStateSource, build_ic_api_boundary_node_report,
23    build_ic_api_boundary_node_report_with_source,
24};
25#[cfg(feature = "dashboard-host")]
26pub use build::{
27    build_ic_boundary_node_data_centers_report,
28    build_ic_boundary_node_data_centers_report_with_source, build_ic_canister_count_report,
29    build_ic_canister_count_report_with_source, build_ic_canister_page_report,
30    build_ic_canister_page_report_with_source, build_ic_daily_stats_report,
31    build_ic_daily_stats_report_with_source, build_ic_metric_report,
32    build_ic_metric_report_with_source, build_ic_node_provider_reward_history_report,
33    build_ic_node_provider_reward_history_report_with_source,
34    build_ic_node_provider_reward_info_report,
35    build_ic_node_provider_reward_info_report_with_source,
36    build_ic_node_provider_reward_list_report,
37    build_ic_node_provider_reward_list_report_with_source, build_ic_node_status_snapshot,
38    build_ic_node_status_snapshot_with_source, build_ic_replica_version_info_report,
39    build_ic_replica_version_info_report_with_source, build_ic_replica_version_list_report,
40    build_ic_replica_version_list_report_with_source, build_icrc_account_info_report,
41    build_icrc_account_info_report_with_source, build_icrc_account_list_report,
42    build_icrc_account_list_report_with_source, build_icrc_holder_list_report,
43    build_icrc_holder_list_report_with_source, build_icrc_indexed_count_report,
44    build_icrc_indexed_count_report_with_source, build_icrc_token_value_report,
45    build_icrc_token_value_report_with_source, build_icrc_total_supply_report,
46    build_icrc_total_supply_report_with_source,
47};
48#[cfg(feature = "dashboard-host")]
49pub use build::{build_ic_canister_report, build_ic_canister_report_with_source};
50#[cfg(feature = "dashboard-host")]
51pub use live::LiveIcSource;
52pub use model::{
53    IcBoundaryNodeDataCenterRow, IcBoundaryNodeDataCentersReport, IcCanisterCountReport,
54    IcCanisterCountRequest, IcCanisterFilters, IcCanisterPageController, IcCanisterPageReport,
55    IcCanisterPageRequest, IcCanisterPageRow, IcCanisterReport, IcCanisterRequest,
56    IcCanisterUpgrade, IcDailyStatsQuery, IcDailyStatsReport, IcDailyStatsRequest, IcDailyStatsRow,
57    IcDashboardReportProvenance, IcDashboardRequest, IcIcrcAccountInfoReport,
58    IcIcrcAccountInfoRequest, IcIcrcAccountListQuery, IcIcrcAccountListReport,
59    IcIcrcAccountListRequest, IcIcrcAccountRow, IcIcrcAccountSort, IcIcrcAnalyticsRequest,
60    IcIcrcHolderListQuery, IcIcrcHolderListReport, IcIcrcHolderListRequest, IcIcrcHolderRow,
61    IcIcrcHolderSort, IcIcrcIndexedCountKind, IcIcrcIndexedCountReport, IcIcrcIndexedCountRequest,
62    IcIcrcTokenValueQuery, IcIcrcTokenValueReport, IcIcrcTokenValueRequest, IcIcrcTokenValueRow,
63    IcIcrcTotalSupplyObservation, IcIcrcTotalSupplyQuery, IcIcrcTotalSupplyReport,
64    IcIcrcTotalSupplyRequest, IcMetricKind, IcMetricObservation, IcMetricQuery, IcMetricReport,
65    IcMetricRequest, IcMetricSeries, IcNodeProviderRewardHistoryObservation,
66    IcNodeProviderRewardHistoryQuery, IcNodeProviderRewardHistoryReport,
67    IcNodeProviderRewardHistoryRequest, IcNodeProviderRewardInfoReport,
68    IcNodeProviderRewardInfoRequest, IcNodeProviderRewardListQuery, IcNodeProviderRewardListReport,
69    IcNodeProviderRewardListRequest, IcNodeProviderRewardRow,
70    IcNodeProviderRewardXdrConversionRate, IcReplicaVersionInfoReport, IcReplicaVersionInfoRequest,
71    IcReplicaVersionListQuery, IcReplicaVersionListReport, IcReplicaVersionListRequest,
72    IcReplicaVersionListRow, IcReplicaVersionStatus, IcReplicaVersionSubnetRollout,
73};
74#[cfg(feature = "dashboard-host")]
75pub use model::{
76    IcBoundaryNodeDataCentersSourceData, IcCanisterCountSourceData, IcCanisterPageSourceData,
77    IcCanisterSourceData, IcDailyStatsSourceData, IcHostError, IcIcrcAccountInfoSourceData,
78    IcIcrcAccountListSourceData, IcIcrcAccountSourceRow, IcIcrcHolderListSourceData,
79    IcIcrcHolderSourceRow, IcIcrcIndexedCountSourceData, IcIcrcTokenValueSourceData,
80    IcIcrcTokenValueSourceRow, IcIcrcTotalSupplySourceData, IcMetricSourceData,
81    IcNodeProviderRewardHistorySourceData, IcNodeProviderRewardInfoSourceData,
82    IcNodeProviderRewardListSourceData, IcReplicaVersionInfoSourceData,
83    IcReplicaVersionListSourceData, IcSourceRequest,
84};
85#[cfg(feature = "dashboard-host")]
86pub(crate) use node_status::canonicalize_node_status_rows_with_policy;
87#[cfg(feature = "dashboard-host")]
88pub(crate) use node_status::node_status_counts;
89pub use node_status::{
90    DEFAULT_IC_NODE_STATUS_REFRESH_LOCK_STALE_SECONDS, DEFAULT_IC_NODE_STATUS_STALE_AFTER_SECONDS,
91    IC_NODE_STATUS_SCHEMA_VERSION, IcNodeAssignmentStatusCounts, IcNodeCountComparison,
92    IcNodeCountComparisonCounts, IcNodeOperationalStatus, IcNodeProviderStatusReport,
93    IcNodeProviderStatusRow, IcNodeStatusCacheEvidence, IcNodeStatusCounts,
94    IcNodeStatusGroupCounts, IcNodeStatusObservation, IcNodeStatusProjectionError,
95    IcNodeStatusReport, IcNodeStatusRow, IcNodeStatusScope, IcNodeStatusSnapshot, IcNodeStatusView,
96    IcSubnetStatusReport, IcSubnetStatusRow, MAX_IC_NODE_STATUS_ROWS,
97    ic_node_provider_status_report_from_snapshot, ic_node_provider_status_report_text,
98    ic_node_status_report_from_snapshot, ic_node_status_report_text,
99    ic_subnet_status_report_from_snapshot, ic_subnet_status_report_text,
100};
101#[cfg(feature = "dashboard-host")]
102pub use node_status::{
103    IcNodeStatusCacheRequest, IcNodeStatusHostError, IcNodeStatusReadRequest,
104    IcNodeStatusRefreshReport, IcNodeStatusRefreshRequest, IcNodeStatusSourceData,
105    build_ic_node_provider_status_report, build_ic_node_provider_status_report_with_source,
106    build_ic_node_status_report, build_ic_node_status_report_with_source,
107    build_ic_subnet_status_report, build_ic_subnet_status_report_with_source,
108    ic_node_status_cache_path, ic_node_status_refresh_lock_path,
109    ic_node_status_refresh_report_text, load_cached_ic_node_status_snapshot,
110    load_or_refresh_missing_ic_node_status_snapshot,
111    load_or_refresh_missing_ic_node_status_snapshot_with_source,
112    load_or_refresh_stale_ic_node_status_snapshot,
113    load_or_refresh_stale_ic_node_status_snapshot_with_source, refresh_ic_node_status_snapshot,
114    refresh_ic_node_status_snapshot_with_source,
115};
116#[cfg(feature = "dashboard-host")]
117pub use source::{
118    IcCanisterCollectionSource, IcCanisterSource, IcIcrcAnalyticsSource, IcIcrcIndexSource,
119    IcMetricSource, IcNetworkSource, IcNodeProviderRewardSource, IcNodeStatusSource,
120    IcReplicaVersionSource,
121};
122#[cfg(feature = "dashboard-host")]
123pub(crate) use source::{
124    canonical_request_principal, invalid_source, invalid_source_value, report_provenance,
125    validate_canonical_principal, validate_dashboard_network, validate_provenance,
126};
127pub(crate) use text::dashboard_provenance_lines;
128pub use text::{
129    ic_boundary_node_data_centers_report_text, ic_canister_count_report_text,
130    ic_canister_page_report_text, ic_canister_report_text, ic_daily_stats_report_text,
131    ic_metric_report_text, ic_node_provider_reward_history_report_text,
132    ic_node_provider_reward_info_report_text, ic_node_provider_reward_list_report_text,
133    ic_replica_version_info_report_text, ic_replica_version_list_report_text,
134    icrc_account_info_report_text, icrc_account_list_report_text, icrc_holder_list_report_text,
135    icrc_indexed_count_report_text, icrc_token_value_report_text, icrc_total_supply_report_text,
136};
137
138/// Default base endpoint for the official IC Dashboard API.
139pub const DEFAULT_IC_DASHBOARD_SOURCE_ENDPOINT: &str = "https://ic-api.internetcomputer.org/api/v3";
140
141/// Default base endpoint for official IC Dashboard canister collection queries.
142pub const DEFAULT_IC_DASHBOARD_CANISTER_COLLECTION_SOURCE_ENDPOINT: &str =
143    "https://ic-api.internetcomputer.org/api/v4";
144
145/// Default base endpoint for the official IC Dashboard Metrics API.
146pub const DEFAULT_IC_DASHBOARD_METRICS_SOURCE_ENDPOINT: &str =
147    "https://metrics-api.internetcomputer.org/api/v1";
148
149/// Default base endpoint for the official Dashboard ICRC analytics API.
150pub const DEFAULT_ICRC_ANALYTICS_SOURCE_ENDPOINT: &str =
151    "https://icrc-api.internetcomputer.org/api/v2";
152
153/// Default base endpoint for exact official Dashboard ICRC account queries.
154pub const DEFAULT_ICRC_ACCOUNT_INFO_SOURCE_ENDPOINT: &str =
155    "https://icrc-api.internetcomputer.org/api/v1";
156
157/// Default base endpoint for official boundary-node data-center queries.
158pub const DEFAULT_IC_BOUNDARY_NODE_DATA_CENTERS_SOURCE_ENDPOINT: &str =
159    "https://ic-api.internetcomputer.org/api/v4";
160
161/// Maximum response-body size accepted from an official Dashboard HTTP endpoint.
162pub const MAX_IC_DASHBOARD_RESPONSE_BYTES: u64 = 8 * 1024 * 1024;
163
164/// Default row limit for one official Dashboard canister page.
165pub const DEFAULT_IC_CANISTER_PAGE_LIMIT: u16 = 50;
166
167/// Maximum row limit accepted for one official Dashboard canister page.
168pub const MAX_IC_CANISTER_PAGE_LIMIT: u16 = 100;
169
170/// Default relative window for one Dashboard metric query.
171pub const DEFAULT_IC_METRIC_WINDOW_SECS: u64 = 3_600;
172
173/// Default interval between requested Dashboard metric observations.
174pub const DEFAULT_IC_METRIC_STEP_SECS: u32 = 300;
175
176/// Earliest timestamp accepted by the official Dashboard Metrics API.
177pub const MIN_IC_METRIC_TIMESTAMP: u64 = 1_620_432_000;
178
179/// Largest step accepted by the official Dashboard Metrics API.
180pub const MAX_IC_METRIC_STEP_SECS: u32 = 259_200;
181
182/// Maximum requested observations accepted per metric series.
183pub const MAX_IC_METRIC_OBSERVATIONS_PER_SERIES: u64 = 1_000;
184
185/// Default relative window for one ICRC total-supply analytics query.
186pub const DEFAULT_ICRC_TOTAL_SUPPLY_WINDOW_SECS: u64 = 30 * 24 * 60 * 60;
187
188/// Default interval between ICRC total-supply observations.
189pub const DEFAULT_ICRC_TOTAL_SUPPLY_STEP_SECS: u32 = 86_400;
190
191/// Earliest timestamp accepted by the official Dashboard ICRC analytics API.
192pub const MIN_ICRC_ANALYTICS_TIMESTAMP: u64 = 1_620_328_530;
193
194/// Maximum requested observations accepted for one ICRC analytics series.
195pub const MAX_ICRC_ANALYTICS_OBSERVATIONS: u64 = 1_000;
196
197/// Default relative window for one ICRC token-value analytics query.
198pub const DEFAULT_ICRC_TOKEN_VALUE_WINDOW_SECS: u64 = 24 * 60 * 60;
199
200/// Default row limit for one ICRC token-value analytics query.
201pub const DEFAULT_ICRC_TOKEN_VALUE_LIMIT: u16 = 1_000;
202
203/// Largest time window accepted for one ICRC token-value query.
204pub const MAX_ICRC_TOKEN_VALUE_WINDOW_SECS: u64 = 90 * 24 * 60 * 60;
205
206/// Maximum token-value rows requested or accepted by one report.
207pub const MAX_ICRC_TOKEN_VALUE_ROWS: u16 = 1_000;
208
209/// Maximum rows accepted for one official ICRC account or holder index page.
210pub const MAX_ICRC_INDEX_PAGE_ROWS: u16 = 100;
211
212/// Maximum characters accepted for an opaque official ICRC index cursor or account id.
213pub const MAX_ICRC_INDEX_CURSOR_CHARS: usize = 512;
214
215/// Default relative window for one Dashboard daily-statistics query.
216pub const DEFAULT_IC_DAILY_STATS_WINDOW_SECS: u64 = 7 * 24 * 60 * 60;
217
218/// Earliest timestamp accepted by the official Dashboard daily-statistics API.
219pub const MIN_IC_DAILY_STATS_TIMESTAMP: u64 = 1_620_406_800;
220
221/// Largest time window accepted by one daily-statistics request.
222pub const MAX_IC_DAILY_STATS_WINDOW_SECS: u64 = 366 * 24 * 60 * 60;
223
224/// Maximum daily-statistics rows accepted from one source response.
225pub const MAX_IC_DAILY_STATS_ROWS: usize = 366;
226
227/// Maximum boundary-node data-center rows accepted from one source response.
228pub const MAX_IC_BOUNDARY_NODE_DATA_CENTERS: usize = 1_000;
229
230/// Default row limit for one official Dashboard replica-version page.
231pub const DEFAULT_IC_REPLICA_VERSION_PAGE_LIMIT: u16 = 50;
232
233/// Maximum row limit accepted for one official Dashboard replica-version page.
234pub const MAX_IC_REPLICA_VERSION_PAGE_LIMIT: u16 = 100;
235
236/// Default row limit for one official Dashboard node-provider reward page.
237pub const DEFAULT_IC_NODE_PROVIDER_REWARD_PAGE_LIMIT: u16 = 50;
238
239/// Maximum row limit accepted for one official Dashboard node-provider reward page.
240pub const MAX_IC_NODE_PROVIDER_REWARD_PAGE_LIMIT: u16 = 100;
241
242/// Default relative window for one node-provider reward history query.
243pub const DEFAULT_IC_NODE_PROVIDER_REWARD_HISTORY_WINDOW_SECS: u64 = 365 * 24 * 60 * 60;
244
245/// Default interval between node-provider reward history observations.
246pub const DEFAULT_IC_NODE_PROVIDER_REWARD_HISTORY_STEP_SECS: u32 = 86_400;
247
248/// Smallest step accepted by the official node-provider reward history API.
249pub const MIN_IC_NODE_PROVIDER_REWARD_HISTORY_STEP_SECS: u32 = 60;
250
251/// Largest step accepted by the official node-provider reward history API.
252pub const MAX_IC_NODE_PROVIDER_REWARD_HISTORY_STEP_SECS: u32 = 259_200;
253
254/// Maximum requested observations accepted for one node-provider reward history report.
255pub const MAX_IC_NODE_PROVIDER_REWARD_HISTORY_OBSERVATIONS: u64 = 1_000;
256
257#[cfg(feature = "dashboard-host")]
258pub(crate) const IC_DASHBOARD_REPORT_SCHEMA_VERSION: u32 = 1;
259pub(crate) const IC_DASHBOARD_AUTHORITY: &str = "official_ic_dashboard_api";
260#[cfg(feature = "dashboard-host")]
261pub(crate) const IC_DASHBOARD_NETWORK: &str = "ic";
262
263#[cfg(all(test, feature = "dashboard-host"))]
264mod tests;
ic_query/ic/mod.rs

ic_query/ic/
mod.rs
