Struct ic_utils::canister::SyncCallBuilder

pub struct SyncCallBuilder<'agent, 'canister> { /* private fields */ }

A builder for a synchronous call (ie. query) to the Internet Computer.

See SyncCaller for a description of this structure once built.

Implementations

impl<'agent: 'canister, 'canister> SyncCallBuilder<'agent, 'canister>

pub fn with_arg<Argument>(self, arg: Argument) -> Self

where Argument: CandidType + Sync + Send,

Set the argument with candid argument. Can be called at most once.

pub fn with_args(self, tuple: impl ArgumentEncoder) -> Self

Set the argument with multiple arguments as tuple. Can be called at most once.

pub fn with_value_arg(self, arg: IDLValue) -> Self

Set the argument with IDLValue argument. Can be called at most once.

TODO: make this method unnecessary (#132)

pub fn with_arg_raw(self, arg: Vec<u8>) -> Self

Set the argument with raw argument bytes. Can be called at most once.

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

Sets the effective canister ID of the destination.

pub fn build<Output>(self) -> SyncCaller<'agent, Output>

where Output: for<'de> ArgumentDecoder<'de> + Send + Sync,

Builds a SyncCaller from this builder’s state.

Trait Implementations

impl<'agent, 'canister> Debug for SyncCallBuilder<'agent, 'canister>

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

Formats the value using the given formatter.