Module request 

Helpers that build requests routed through the root canister.

Non-root canisters submit orchestration requests to root using the canic_response endpoint. This module owns the request envelope and high-level helpers for creating new canisters, triggering upgrades, or moving cycles between principals.

Structs

CreateCanisterRequest

CreateCanisterRequest Payload for Request::CreateCanister

CreateCanisterResponse

CreateCanisterResponse Result of creating and installing a new canister.

CyclesRequest

CyclesRequest Payload for Request::Cycles

CyclesResponse

CyclesResponse Result of transferring cycles to a child canister

UpgradeCanisterRequest

UpgradeCanisterRequest Payload for Request::UpgradeCanister

UpgradeCanisterResponse

UpgradeCanisterResponse Result of an upgrade request (currently empty, reserved for metadata)

Enums

CreateCanisterParent

CreateCanisterParent Parent-location choices for a new canister

Request

Request Root-directed orchestration commands.

RequestOpsError

RequestOpsError Errors produced during request dispatch or response handling

Response

Response Response payloads produced by root for orchestration requests.

Functions

create_canister_request

Ask root to create and install a canister of the given type.

cycles_request

Request a cycle transfer from root to the current canister.

response

Handle a root-bound orchestration request and produce a Response.

upgrade_canister_request

Ask root to upgrade a child canister to its latest registered WASM.