ic-query 0.40.0

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

//! Reusable NNS Governance economics, metrics, reward, and collection contracts.

mod build;
#[cfg(feature = "nns-host")]
pub(super) mod collection;
mod error;
mod model;
mod request;
mod source;
mod text;
mod validation;
#[cfg(any(feature = "nns-host", feature = "canister"))]
mod wire;

#[cfg(feature = "nns-host")]
pub use build::{
    build_nns_governance_economics_report, build_nns_governance_maturity_modulation_report,
    build_nns_governance_metrics_report, build_nns_governance_reward_event_report,
};
pub use build::{
    build_nns_governance_economics_report_with_source,
    build_nns_governance_maturity_modulation_report_with_source,
    build_nns_governance_metrics_report_with_source,
    build_nns_governance_reward_event_report_with_source,
};
#[cfg(feature = "nns-host")]
pub(super) use collection::{
    NnsGovernanceAttemptReadError, NnsGovernanceCacheMetadata, mainnet_governance_cache_metadata,
    read_governance_refresh_attempt_status, validate_governance_cache_metadata,
    write_complete_governance_refresh_attempt, write_failed_governance_refresh_attempt,
    write_running_governance_refresh_attempt, write_starting_governance_refresh_attempt,
};
pub use error::NnsGovernanceError;
#[cfg(feature = "nns-host")]
pub use error::NnsGovernanceHostError;
pub use model::{
    NnsGovernanceDecimal, NnsGovernanceEconomics, NnsGovernanceEconomicsReport,
    NnsGovernanceExecutionAssurance, NnsGovernanceMaturityModulation,
    NnsGovernanceMaturityModulationReport, NnsGovernanceMetricBucket, NnsGovernanceMetrics,
    NnsGovernanceMetricsReport, NnsGovernanceNeuronSubsetMetrics, NnsGovernancePercentage,
    NnsGovernanceProposalId, NnsGovernanceReportContext, NnsGovernanceRewardEvent,
    NnsGovernanceRewardEventReport, NnsGovernanceSourceProvenance, NnsNeuronsFundEconomics,
    NnsNeuronsFundMatchedFundingCurveCoefficients, NnsVotingPowerEconomics,
};
pub use request::{NnsGovernanceRequest, NnsGovernanceSourceSelection};
#[cfg(all(feature = "canister", target_arch = "wasm32"))]
pub use source::CanisterNnsSource;
#[cfg(all(feature = "canister", target_arch = "wasm32"))]
pub(crate) use source::canister::{call_with_arg, canister_provenance};
#[cfg(feature = "nns-host")]
pub(crate) use source::host::host_request;
pub use source::{NnsGovernanceSource, NnsGovernanceSourceData, NnsGovernanceSourceFuture};
pub(crate) use text::{
    context_lines as governance_context_lines, source_lines as governance_source_lines,
};
pub use text::{
    nns_governance_economics_report_text, nns_governance_maturity_modulation_report_text,
    nns_governance_metrics_report_text, nns_governance_reward_event_report_text,
};
#[cfg(feature = "nns-host")]
pub(crate) use validation::enforce_mainnet_network as enforce_governance_mainnet_network;
pub(crate) use validation::{
    validate_governance_report_source, validate_governance_request, validate_source_provenance,
};
/// Default replica endpoint used for direct NNS Governance reports.
pub const DEFAULT_NNS_GOVERNANCE_SOURCE_ENDPOINT: &str = "https://icp-api.io";

/// Maximum raw response bytes accepted from one direct Governance call.
pub const MAX_NNS_GOVERNANCE_RESPONSE_BYTES: usize = 8 * 1024 * 1024;

const NNS_GOVERNANCE_REPORT_SCHEMA_VERSION: u32 = 1;

#[cfg(all(test, feature = "nns-host"))]
mod tests;