Struct ic_utils::interfaces::management_canister::InstallCodeBuilder

pub struct InstallCodeBuilder<'agent, 'canister: 'agent, T> { /* fields omitted */ }

Implementations

impl<'agent, 'canister: 'agent, T> InstallCodeBuilder<'agent, 'canister, T>

pub fn builder(
    canister: &'canister Canister<'agent, T>,
    canister_id: &Principal,
    wasm: &'canister [u8]
) -> Self

Create an InstallCode builder, which is also an AsyncCall implementation.

pub fn with_arg<Argument: CandidType + Sync + Send>(
    self,
    arg: Argument
) -> InstallCodeBuilder<'agent, 'canister, T>

Add an argument to the installation, which will be passed to the init method of the canister.

pub fn with_raw_arg(
    self,
    arg: Vec<u8>
) -> InstallCodeBuilder<'agent, 'canister, T>

Override the argument passed in to the canister with raw bytes.

pub fn with_mode(self, mode: InstallMode) -> Self

Pass in the InstallMode.

pub fn with_optional_compute_allocation<C, E>(
    self,
    compute_allocation: Option<C>
) -> Self where
    E: Display,
    C: TryInto<ComputeAllocation, Error = E>, 

Pass in a compute allocation optional value for the canister. If this is None, it will revert the compute allocation to default.

pub fn with_compute_allocation<C, E>(self, compute_allocation: C) -> Self where
    E: Display,
    C: TryInto<ComputeAllocation, Error = E>, 

Pass in a compute allocation value for the canister.

pub fn with_optional_memory_allocation<E, C>(
    self,
    memory_allocation: Option<C>
) -> Self where
    E: Display,
    C: TryInto<MemoryAllocation, Error = E>, 

Pass in a memory allocation optional value for the canister. If this is None, it will revert the memory allocation to default.

pub fn with_memory_allocation<C, E>(self, memory_allocation: C) -> Self where
    E: Display,
    C: TryInto<MemoryAllocation, Error = E>, 

Pass in a memory allocation value for the canister.

pub fn build(self) -> Result<impl 'agent + AsyncCall<()>, AgentError>

Create an AsyncCall implementation that, when called, will install the canister.

pub async fn call(self) -> Result<RequestId, AgentError>

Make a call. This is equivalent to the AsyncCall::call.

pub async fn call_and_wait<W>(self, waiter: W) -> Result<(), AgentError> where
    W: Waiter, 

Make a call. This is equivalent to the AsyncCall::call_and_wait.

Trait Implementations

impl<'agent, 'canister: 'agent, T: Sync> AsyncCall<()> for InstallCodeBuilder<'agent, 'canister, T>

fn call<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Result<RequestId, AgentError>> + Send + 'async_trait>> where
    Self: 'async_trait, 

Execute the call, but returns the RequestId. Waiting on the request Id must be managed by the caller using the Agent directly.

fn call_and_wait<'async_trait, W>(
    self,
    waiter: W
) -> Pin<Box<dyn Future<Output = Result<(), AgentError>> + Send + 'async_trait>> where
    W: Waiter,
    W: 'async_trait,
    Self: 'async_trait, 

Execute the call, and wait for an answer using a Waiter strategy. The return type is encoded in the trait.

fn and_then<Out2, R, AndThen>(
    self,
    and_then: AndThen
) -> AndThenAsyncCaller<Out, Out2, Self, R, AndThen> where
    Self: Sized + Sync + Send,
    Out2: for<'de> ArgumentDecoder<'de> + Send + Sync,
    R: Future<Output = Result<Out2, AgentError>> + Send + Sync,
    AndThen: Sync + Send + Fn(Out) -> R, 

Apply a transformation function after the call has been successful. The transformation is applied with the result.

fn map<Out2, Map>(self, map: Map) -> MappedAsyncCaller<Out, Out2, Self, Map> where
    Self: Sized + Sync + Send,
    Out2: for<'de> ArgumentDecoder<'de> + Send + Sync,
    Map: Sync + Send + Fn(Out) -> Out2,