Struct CallBuilder 

pub struct CallBuilder<R: for<'a> Deserialize<'a> + CandidType, P: Provider> {
    pub provider: P,
    pub canister_id: Principal,
    pub call_mode: CallMode,
    pub method: String,
    pub args: Result<Vec<u8>, Error>,
    pub _result: PhantomData<R>,
}

A builder for creating and executing canister method calls in tests.

Generic over:

• R: The expected result type of the method.
• P: The provider type (e.g., IcpUser or PocketIC).

Fields

provider: P

The test environment provider.

canister_id: Principal

The principal of the canister to call.

call_mode: CallMode

The mode of the call (query or update).

method: String

The name of the method being called.

args: Result<Vec<u8>, Error>

Candid-encoded call arguments, or an encoding error.

_result: PhantomData<R>

Phantom type to carry the result type without storing it.

Implementations

impl<R: for<'a> Deserialize<'a> + CandidType, P: Provider> CallBuilder<R, P>

pub fn with_caller<C: Caller>(self, caller: C) -> CallBuilder<R, C::Provider>

Setup caller of the bulider

pub fn with_update(self) -> Self

Switch caller mode to update

pub async fn maybe_call(self) -> Result<R, CallError>

Execute the call and returns a Result with decoded output or CallError.

Errors

Returns a CallError if encoding, calling, or decoding fails.

pub async fn call(self) -> R

Execute the call assuming there is no error ().