Skip to content

infra: move 'Calling canisters that require cycles' from cycles-management to inter-canister-calls #231

@marc0olo

Description

@marc0olo

Problem

The section ## Calling canisters that require cycles in guides/canister-management/cycles-management.mdx is misplaced. It covers a call mechanic (attaching cycles to an inter-canister call), not an operational management concern. The cycles-management guide otherwise covers acquiring cycles, checking balances, topping up, freeze thresholds, and monitoring — all operational topics.

Proposed fix

Move the content into guides/canister-calls/inter-canister-calls.mdx as a new ## Calls with attached cycles section, covering:

  • Attaching cycles when calling out (Motoko (with cycles = amount) syntax, Rust .with_cycles())
  • Accepting cycles when receiving a call
  • Proxy canister pattern for attaching cycles from the CLI

Affected files

  • docs/guides/canister-management/cycles-management.mdx — remove the section
  • docs/guides/canister-calls/inter-canister-calls.mdx — add the section
  • docs/concepts/cycles.md — update link at line ~97 (currently cycles-management.md#calling-canisters-that-require-cycles)
  • docs/guides/chain-fusion/exchange-rates.mdx — update link in "Testing from the CLI" section

Notes

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions