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

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions