Struct IcpUser 

pub struct IcpUser {
    pub principal: Principal,
    /* private fields */
}

A simulated Internet Computer user for use in tests.

Provides a simplified API for calling methods and deploying canisters. Wraps a Principal identity and a reference to the PocketIc test environment.

Fields

principal: Principal

The user’s principal identity used for calls and deployments.

Implementations

impl IcpUser

pub fn call<ResultType>( &self, canister_id: Principal, call_mode: CallMode, method: &str, args: Result<Vec<u8>, Error>, ) -> CallBuilder<ResultType, Self>

where ResultType: for<'a> Deserialize<'a> + CandidType,

Prepare a canister method call builder for the user.

Parameters

• canister_id: The principal ID of the target canister.
• call_mode: Whether the call is a query or an update.
• method: The name of the method to invoke.
• args: Encoded Candid arguments or an error.

Returns

A CallBuilder for the specified method, result type, and context.

pub fn deploy<Canister>( &self, args: Result<Vec<u8>, Error>, new: fn(&Self, Principal) -> Canister, ) -> DeployBuilder<Canister, Self>

Prepare a new canister deployment as this user.

Parameters

• args: Encoded Candid arguments for the canister constructor, or an error.
• new: A function to instantiate the canister wrapper after deployment.

Returns

A DeployBuilder for the specified canister.

Trait Implementations

impl Caller for IcpUser

fn call<ResultType>( &self, canister_id: Principal, call_mode: CallMode, method: &str, args: Result<Vec<u8>, Error>, ) -> CallBuilder<ResultType, Self::Provider>

where ResultType: for<'a> Deserialize<'a> + CandidType,

Dispatch a call via this user, required by the Caller trait.

type Provider = IcpUser

impl Clone for IcpUser

fn clone(&self) -> IcpUser

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Deployer for IcpUser

fn deploy<Canister>( &self, args: Result<Vec<u8>, Error>, new: fn(&Self::Caller, Principal) -> Canister, ) -> DeployBuilder<Canister, Self::Caller>

Dispatch a deployment via this user, required by the Deployer trait.

type Caller = IcpUser