Struct ic_kit::Canister

pub struct Canister { /* private fields */ }

Can be used to represent a canister and different method on the canister.

Implementations

impl Canister

pub fn new(id: Principal) -> Self

Create a new canister with the given principal id, this handler rejects any call to a different canister id.

pub fn context(&self) -> Ref<'_, MockContext>

Return a reference to the context associated with this canister.

pub fn with_balance(self, cycles: u64) -> Self

Update the balance of this canister.

pub fn method<S: Into<String> + Copy>(
    self,
    name: S,
    handler: Box<dyn CallHandler>
) -> Self

Add the given method to the canister.

Panics

If a method with the same name is already defined on the canister.

pub fn or(self, handler: Box<dyn CallHandler>) -> Self

Add a default handler to the canister.

Panics

If a default handler is already set.

Trait Implementations

impl CallHandler for Canister

fn accept(&self, canister_id: &Principal, method: &str) -> bool

Whatever the handler can handle the given call or not, if this method returns false, we skip this handler and try to find the next handler that can handle the call.

fn perform(
    &self,
    caller: &Principal,
    cycles: u64,
    canister_id: &Principal,
    method: &str,
    args_raw: &Vec<u8>,
    ctx: Option<&mut MockContext>
) -> (CallResult<Vec<u8>>, u64)

Perform the call using this handler. Only called if accept() first returned true.