ic_query/icrc/
mod.rs

1//! Module: icrc
2//!
3//! Responsibility: expose generic ICRC ledger request and report APIs.
4//! Does not own: SNS lookup, NNS registry cache behavior, or release flow.
5//! Boundary: exposes live read-only token metadata, account balance, allowance,
6//! index discovery, account and ledger transaction history, block type, and archive reports.
7
8#[cfg(feature = "host")]
9mod account_transaction_cache;
10#[cfg(feature = "host")]
11pub(crate) mod ledger;
12#[cfg(feature = "host")]
13mod live;
14mod model;
15mod text;
16
17pub const DEFAULT_ICRC_SOURCE_ENDPOINT: &str = "https://icp-api.io";
18
19#[cfg(feature = "host")]
20pub use account_transaction_cache::{
21    DEFAULT_ICRC_ACCOUNT_TRANSACTION_REFRESH_LOCK_STALE_SECONDS,
22    build_icrc_account_transaction_cache_status_report, build_icrc_account_transaction_list_report,
23    icrc_account_transaction_cache_path, icrc_account_transaction_refresh_attempt_path,
24    icrc_account_transaction_refresh_lock_path, load_cached_icrc_account_transactions,
25    load_or_refresh_missing_icrc_account_transactions,
26    load_or_refresh_missing_icrc_account_transactions_with_source,
27    load_or_refresh_stale_icrc_account_transactions,
28    load_or_refresh_stale_icrc_account_transactions_with_source,
29    refresh_icrc_account_transaction_cache, refresh_icrc_account_transaction_cache_with_progress,
30    refresh_icrc_account_transaction_cache_with_source,
31};
32#[cfg(feature = "host")]
33pub use live::{
34    ICRC_ACCOUNT_TRANSACTION_MAX_PAGE_SIZE, IcrcAccountTransactionCollectionSource,
35    IcrcAccountTransactionPageSource, IcrcAllowanceSource, IcrcArchivesSource, IcrcBalanceSource,
36    IcrcBlockTypesSource, IcrcCapabilitiesSource, IcrcIndexSource, IcrcTipCertificateSource,
37    IcrcTokenSource, IcrcTransactionsSource, LiveIcrcSource,
38    build_icrc_account_transaction_page_report,
39    build_icrc_account_transaction_page_report_with_source, build_icrc_allowance_report,
40    build_icrc_allowance_report_with_source, build_icrc_archives_report,
41    build_icrc_archives_report_with_source, build_icrc_balance_report,
42    build_icrc_balance_report_with_source, build_icrc_block_types_report,
43    build_icrc_block_types_report_with_source, build_icrc_capabilities_report,
44    build_icrc_capabilities_report_with_source, build_icrc_index_report,
45    build_icrc_index_report_with_source, build_icrc_tip_certificate_report,
46    build_icrc_tip_certificate_report_with_source, build_icrc_token_report,
47    build_icrc_token_report_with_source, build_icrc_transactions_report,
48    build_icrc_transactions_report_with_source,
49};
50pub use model::normalize_subaccount_hex;
51#[cfg(feature = "host")]
52pub use model::{
53    CachedIcrcAccountTransactionSnapshot, IcrcAccountTransactionCollectionData,
54    IcrcAccountTransactionPageData, IcrcAllowanceData, IcrcArchivesData, IcrcBalanceData,
55    IcrcBlockTypesData, IcrcCapabilitiesData, IcrcIndexData, IcrcTipCertificateData, IcrcTokenData,
56    IcrcTransactionsData,
57};
58pub use model::{
59    IcrcAccountRow, IcrcAccountTransactionCacheRequest, IcrcAccountTransactionCacheStatusReport,
60    IcrcAccountTransactionCacheSummary, IcrcAccountTransactionError,
61    IcrcAccountTransactionListReport, IcrcAccountTransactionListRequest,
62    IcrcAccountTransactionPageReport, IcrcAccountTransactionPageRequest,
63    IcrcAccountTransactionRefreshAttemptStatus, IcrcAccountTransactionRefreshReport,
64    IcrcAccountTransactionRefreshRequest, IcrcAccountTransactionRow,
65    IcrcAccountTransactionSnapshot, IcrcAccountTransactionSort, IcrcAllowanceReport,
66    IcrcAllowanceRequest, IcrcArchiveFollowErrorRow, IcrcArchiveRow, IcrcArchivedBlocksRow,
67    IcrcArchivedRangeRow, IcrcArchivesReport, IcrcArchivesRequest, IcrcBalanceReport,
68    IcrcBalanceRequest, IcrcBlockTypeRow, IcrcBlockTypesReport, IcrcCapabilitiesReport,
69    IcrcCapabilityRow, IcrcError, IcrcFollowedArchiveBlockRow, IcrcIndexReport, IcrcLedgerRequest,
70    IcrcTipCertificateReport, IcrcTokenMetadataRow, IcrcTokenReport, IcrcTokenStandardRow,
71    IcrcTransactionBlockRow, IcrcTransactionsReport, IcrcTransactionsRequest,
72};
73pub use text::{
74    icrc_account_transaction_cache_status_report_text, icrc_account_transaction_list_report_text,
75    icrc_account_transaction_page_report_text, icrc_account_transaction_refresh_report_text,
76    icrc_allowance_report_text, icrc_archives_report_text, icrc_balance_report_text,
77    icrc_block_types_report_text, icrc_capabilities_report_text, icrc_index_report_text,
78    icrc_tip_certificate_report_text, icrc_token_report_text, icrc_transactions_report_text,
79};
80
81#[cfg(all(test, feature = "host"))]
82mod tests;
ic_query/icrc/mod.rs

ic_query/icrc/
mod.rs
