Struct RpcApi 

pub struct RpcApi;

RpcApi

Public, user-callable wrappers for Canic’s internal RPC workflows.

These functions:

• form part of the public API surface
• are safe to call from downstream canister lib.rs code
• return Error suitable for IC boundaries

Internally, they delegate to workflow-level RPC implementations, preserving the layering:

user canister -> api -> workflow -> ops -> infra

Workflow preserves typed internal failures; conversion to Error happens exclusively at this API boundary.

Implementations

impl RpcApi

pub async fn response_capability_v1_root( envelope: RootCapabilityEnvelopeV1, authority: RootCapabilityAuthority, lifecycle: &dyn RootCapabilityLifecycleExecutor, ) -> Result<RootCapabilityResponseV1, Error>

Dispatch the full root capability envelope verifier/orchestrator path.

pub async fn response_capability_v1_nonroot( envelope: NonrootCyclesCapabilityEnvelopeV1, ) -> Result<NonrootCyclesCapabilityResponseV1, Error>

Dispatch the non-root structural cycles capability path.

pub async fn create_canister_request<A>( operation_id: [u8; 32], canister_role: &CanisterRole, parent: CreateCanisterParent, extra: Option<A>, ) -> Result<CreateCanisterResponse, Error>

where A: CandidType + Send + Sync,

Request one role-admitted direct child through the local Fleet Subnet Root.

The application must durably allocate a nonzero operation_id before calling and reuse that exact identity after an interrupted or uncertain result. Reusing the identity with a different request is rejected.

pub async fn request_cycles(cycles: u128) -> Result<CyclesResponse, Error>