Struct ic_utils::interfaces::wallet::CallForwarder
source · pub struct CallForwarder<'agent, 'canister, Out>{ /* private fields */ }
Expand description
An interface for forwarding a canister method call through the wallet canister via wallet_canister_call
.
Implementations§
source§impl<'agent: 'canister, 'canister, Out> CallForwarder<'agent, 'canister, Out>
impl<'agent: 'canister, 'canister, Out> CallForwarder<'agent, 'canister, Out>
sourcepub fn with_arg<Argument>(self, arg: Argument) -> Self
pub fn with_arg<Argument>(self, arg: Argument) -> Self
Set the argument with candid argument. Can be called at most once.
sourcepub fn with_args(self, tuple: impl ArgumentEncoder) -> Self
pub fn with_args(self, tuple: impl ArgumentEncoder) -> Self
Set the argument with multiple arguments as tuple. Can be called at most once.
sourcepub fn with_arg_raw(self, arg: Vec<u8>) -> Self
pub fn with_arg_raw(self, arg: Vec<u8>) -> Self
Set the argument with raw argument bytes. Can be called at most once.
sourcepub fn build<'out>(self) -> Result<impl 'out + AsyncCall<Out>, AgentError>where
Out: 'out,
'agent: 'out,
pub fn build<'out>(self) -> Result<impl 'out + AsyncCall<Out>, AgentError>where
Out: 'out,
'agent: 'out,
Creates an AsyncCall
implementation that, when called, will forward the specified canister call.
sourcepub async fn call(self) -> Result<RequestId, AgentError>
pub async fn call(self) -> Result<RequestId, AgentError>
Calls the forwarded canister call on the wallet canister. Equivalent to .build().call()
.
sourcepub async fn call_and_wait(self) -> Result<Out, AgentError>
pub async fn call_and_wait(self) -> Result<Out, AgentError>
Calls the forwarded canister call on the wallet canister, and waits for the result. Equivalent to .build().call_and_wait()
.
Trait Implementations§
source§impl<'agent: 'canister, 'canister, Out> AsyncCall<Out> for CallForwarder<'agent, 'canister, Out>
impl<'agent: 'canister, 'canister, Out> AsyncCall<Out> for CallForwarder<'agent, 'canister, Out>
source§fn call<'async_trait>(
self
) -> Pin<Box<dyn Future<Output = Result<RequestId, AgentError>> + Send + 'async_trait>>where
Self: 'async_trait,
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. Read more
source§fn call_and_wait<'async_trait>(
self
) -> Pin<Box<dyn Future<Output = Result<Out, AgentError>> + Send + 'async_trait>>where
Self: 'async_trait,
fn call_and_wait<'async_trait>(
self
) -> Pin<Box<dyn Future<Output = Result<Out, AgentError>> + Send + 'async_trait>>where
Self: 'async_trait,
Execute the call, and wait for an answer using an exponential-backoff strategy. The return
type is encoded in the trait.
source§fn and_then<Out2, R, AndThen>(
self,
and_then: AndThen
) -> AndThenAsyncCaller<Out, Out2, Self, R, AndThen>where
Self: Sized + Send,
Out2: for<'de> ArgumentDecoder<'de> + Send,
R: Future<Output = Result<Out2, AgentError>> + Send,
AndThen: Send + Fn(Out) -> R,
fn and_then<Out2, R, AndThen>(
self,
and_then: AndThen
) -> AndThenAsyncCaller<Out, Out2, Self, R, AndThen>where
Self: Sized + Send,
Out2: for<'de> ArgumentDecoder<'de> + Send,
R: Future<Output = Result<Out2, AgentError>> + Send,
AndThen: Send + Fn(Out) -> R,
Apply a transformation function after the call has been successful. The transformation
is applied with the result. Read more
source§fn map<Out2, Map>(self, map: Map) -> MappedAsyncCaller<Out, Out2, Self, Map>
fn map<Out2, Map>(self, map: Map) -> MappedAsyncCaller<Out, Out2, Self, Map>
Apply a transformation function after the call has been successful. Equivalent to
.and_then(|x| async { map(x) })
.Auto Trait Implementations§
impl<'agent, 'canister, Out> Freeze for CallForwarder<'agent, 'canister, Out>
impl<'agent, 'canister, Out> !RefUnwindSafe for CallForwarder<'agent, 'canister, Out>
impl<'agent, 'canister, Out> Send for CallForwarder<'agent, 'canister, Out>
impl<'agent, 'canister, Out> Sync for CallForwarder<'agent, 'canister, Out>
impl<'agent, 'canister, Out> Unpin for CallForwarder<'agent, 'canister, Out>where
Out: Unpin,
impl<'agent, 'canister, Out> !UnwindSafe for CallForwarder<'agent, 'canister, Out>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more