Struct ic_agent::agent::QueryBuilder

pub struct QueryBuilder<'agent> { /* fields omitted */ }

A Query Request Builder.

This makes it easier to do query calls without actually passing all arguments.

Implementations

impl<'agent> QueryBuilder<'agent>

pub fn new(
    agent: &'agent Agent,
    canister_id: Principal,
    method_name: String
) -> Self

pub fn with_effective_canister_id(
    &mut self,
    canister_id: Principal
) -> &mut Self

pub fn with_arg<A: AsRef<[u8]>>(&mut self, arg: A) -> &mut Self

pub fn expire_at(&mut self, time: SystemTime) -> &mut Self

Takes a SystemTime converts it to a Duration by calling duration_since(UNIX_EPOCH) to learn about where in time this SystemTime lies. The Duration is converted to nanoseconds and stored in ingress_expiry_datetime

pub fn expire_after(&mut self, duration: Duration) -> &mut Self

Takes a Duration (i.e. 30 sec/5 min 30 sec/1 h 30 min, etc.) and adds it to the Duration of the current SystemTime since the UNIX_EPOCH Subtracts a permitted drift from the sum to account for using system time and not block time. Converts the difference to nanoseconds and stores in ingress_expiry_datetime

pub async fn call(&self) -> Result<Vec<u8>, AgentError>

Make a query call. This will return a byte vector.

pub fn sign(&self) -> Result<SignedQuery, AgentError>

Sign a query call. This will return a signed::SignedQuery which contains all fields of the query and the signed query in CBOR encoding