ic-query 0.100.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

//! Private raw query dispatch with an owned error identity.
//!
//! Callers retain codecs, retries, diagnostics and trust policy. Authentication,
//! updates and read-state calls retain their separate existing paths.

mod error;
pub use error::QueryCallError;
#[cfg(any(test, feature = "icrc-host", feature = "subnet-catalog-host"))]
pub use error::QueryFailure;
use ic_platform::Principal;
use ic_platform::agent::Agent;

/// Dispatch one query through the caller's configured Agent, without adding retries.
pub async fn query(
    agent: &Agent,
    canister: &Principal,
    method: &str,
    argument: Vec<u8>,
) -> Result<Vec<u8>, QueryCallError> {
    agent
        .query(
            &crate::agent_principal::effective_canister_id(canister).as_principal(),
            method,
        )
        .with_arg(argument)
        .call()
        .await
        .map_err(QueryCallError::from)
}

#[cfg(test)]
mod tests;