Struct ic_agent::agent::UpdateBuilder

pub struct UpdateBuilder<'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 */
}

An Update Request Builder.

This makes it easier to do update calls without actually passing all arguments or specifying if you want to wait or not.

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

impl<'agent> UpdateBuilder<'agent>

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.

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

Sets the effective canister ID of the destination.

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

Sets the argument blob to pass to the canister. For most canisters this should be a Candid-serialized tuple.

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_and_wait(&self) -> Result<Vec<u8>, AgentError>

Make an update call. This will call request_status on the RequestId in a loop and return the response as a byte vector.

pub fn call(&self) -> UpdateCall<'_>

Make an update call. This will return a RequestId. The RequestId should then be used for request_status (most likely in a loop).

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

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

Trait Implementations

impl<'agent> Debug for UpdateBuilder<'agent>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.