Struct ic_agent::agent::QueryBuilder
source · pub struct QueryBuilder<'agent> {
pub effective_canister_id: Principal,
pub canister_id: Principal,
pub method_name: String,
pub arg: Vec<u8>,
pub ingress_expiry_datetime: Option<u64>,
/* private fields */
}
Expand description
A Query Request Builder.
This makes it easier to do query calls without actually passing all arguments.
Fields§
§effective_canister_id: Principal
The effective canister ID of the destination.
canister_id: Principal
The principal ID of the canister being called.
method_name: String
The name of the canister method being called.
arg: Vec<u8>
The argument blob to be passed to the method.
ingress_expiry_datetime: Option<u64>
The Unix timestamp that the request will expire at.
Implementations§
source§impl<'agent> QueryBuilder<'agent>
impl<'agent> QueryBuilder<'agent>
sourcepub fn new(
agent: &'agent Agent,
canister_id: Principal,
method_name: String
) -> Self
pub fn new( agent: &'agent Agent, canister_id: Principal, method_name: String ) -> Self
Creates a new query builder with an agent for a particular canister method.
sourcepub fn with_effective_canister_id(self, canister_id: Principal) -> Self
pub fn with_effective_canister_id(self, canister_id: Principal) -> Self
Sets the effective canister ID of the destination.
sourcepub fn with_arg<A: Into<Vec<u8>>>(self, arg: A) -> Self
pub fn with_arg<A: Into<Vec<u8>>>(self, arg: A) -> Self
Sets the argument blob to pass to the canister. For most canisters this should be a Candid-serialized tuple.
sourcepub fn expire_at(self, time: impl Into<OffsetDateTime>) -> Self
pub fn expire_at(self, time: impl Into<OffsetDateTime>) -> Self
Sets ingress_expiry_datetime to the provided timestamp, at nanosecond precision.
sourcepub fn expire_after(self, duration: Duration) -> Self
pub fn expire_after(self, duration: Duration) -> Self
Sets ingress_expiry_datetime to now + duration - drift
, where drift
is a
permitted drift from the duration to account for using system time and not block time.
sourcepub async fn call(self) -> Result<Vec<u8>, AgentError>
pub async fn call(self) -> Result<Vec<u8>, AgentError>
Make a query call. This will return a byte vector.
sourcepub fn sign(self) -> Result<SignedQuery, AgentError>
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
Trait Implementations§
source§impl<'agent> Clone for QueryBuilder<'agent>
impl<'agent> Clone for QueryBuilder<'agent>
source§fn clone(&self) -> QueryBuilder<'agent>
fn clone(&self) -> QueryBuilder<'agent>
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read more