Struct AgentRuntime 

pub struct AgentRuntime<'a> { /* private fields */ }

Runtime for interacting with a canister through an ic_agent::Agent. This can be useful when, e.g., contacting a canister via ingress messages instead of via another canister.

Examples

Call the make_http_post_request endpoint on the example http_canister.

use ic_agent::agent::Agent;
use ic_agent_canister_runtime::AgentRuntime;
use ic_canister_runtime::Runtime;

let agent = Agent::builder().build().expect("Failed to initialize agent");
let runtime = AgentRuntime::new(&agent);
let http_request_result: String = runtime
    .update_call(canister_id, "make_http_post_request", (), 0)
    .await
    .expect("Call to `http_canister` failed");

assert!(http_request_result.contains("Hello, World!"));
assert!(http_request_result.contains("\"X-Id\": \"42\""));

Implementations

impl<'a> AgentRuntime<'a>

pub fn new(agent: &'a Agent) -> Self

Create a new AgentRuntime with the given Agent.

Trait Implementations

impl<'a> Clone for AgentRuntime<'a>

fn clone(&self) -> AgentRuntime<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for AgentRuntime<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Runtime for AgentRuntime<'_>

fn update_call<'life0, 'life1, 'async_trait, In, Out>( &'life0 self, id: Principal, method: &'life1 str, args: In, _cycles: u128, ) -> Pin<Box<dyn Future<Output = Result<Out, IcError>> + Send + 'async_trait>>

where In: ArgumentEncoder + Send + 'async_trait, Out: CandidType + DeserializeOwned + 'async_trait, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Defines how asynchronous inter-canister update calls are made.

fn query_call<'life0, 'life1, 'async_trait, In, Out>( &'life0 self, id: Principal, method: &'life1 str, args: In, ) -> Pin<Box<dyn Future<Output = Result<Out, IcError>> + Send + 'async_trait>>

where In: ArgumentEncoder + Send + 'async_trait, Out: CandidType + DeserializeOwned + 'async_trait, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Defines how asynchronous inter-canister query calls are made.