Internet Computer

What are cycles, and do I need them on a cloud engine?

All help topics

Cycles are the Internet Computer's unit for paying for computation, storage and messages; on a cloud engine your canisters don't use them, because you pay for the engine's nodes instead.

On the public Internet Computer
  • Each canister holds a cycles balance, and everything it does (executing, storing data, sending messages, HTTPS outcalls) burns cycles from it.
  • T means a trillion cycles. 1 T is pegged to 1 XDR, the IMF's Special Drawing Right, worth about 1.44 US dollars (the rate moves). Cycles are bought by converting ICP, or with a card.
  • Freezing threshold: a canister keeps a reserve covering some time of idle costs, 30 days by default. Below it, the canister freezes and stops executing messages. If its balance then runs out, it is uninstalled: code and data are deleted, and only its id and settings remain.
  • Developers top canisters up, for example with icp canister top-up backend --amount 2t -e ic.
On a cloud engine
  • The engine's subnet has a free cost schedule: execution, storage, messaging and HTTPS outcalls all cost its canisters zero.
  • Engine canisters hold 0 cycles by design. A status of 0 cycles is normal, they can't be topped up, and there is no freezing threshold for you to manage. Don't carry over top-up logic or low-balance alarms from apps built for ordinary subnets.
  • Never attach cycles to a call from an engine canister: any non-zero amount fails with IC0504 ("is out of cycles").
  • What you pay for is the engine itself: its nodes, day by day, from the engine's balance. Deposits buy cycles for that balance at today's rate, and the console shows amounts in your currency.
  • Proxy canisters are the exception. They live on an ordinary subnet and hold cycles of their own to pay for the chain-key, vetKeys and exchange-rate calls they relay, refilled from the engine's balance.
Which balance is it?
  • "My canister is out of cycles": engine canisters have no balance, so look for a call that attaches cycles.
  • "My engine is running low": add funds to the engine. Close to empty the engine halts, and when the balance runs out the engine is deleted with everything on it.
  • InsufficientCycles from a proxied call: the proxy's balance, which refills from the engine's.
Learn more
Still stuck? Contact support