Release Notes
- feat: Added 'friendly name' domains for canisters - instead of
<frontend principal>.localhost you can access frontend.local.localhost.
- feat: Added
bind key to network gateway config to pick your network interface (previous documentation mentioned a host key, but it did not do anything)
- feat: check for Candid incompatibility when upgrading a canister
- feat: Add
bitcoind-addr and dogecoind-addr options for managed networks to connect to Bitcoin and Dogecoin nodes
- feat: Init/call arg files now support raw binary without conversion to hex
- feat!: Remove argument type inference in init/call args in commands and manifest. Args are always assumed Candid, new parameters allow specifying other formats like hex, and alternate parameters are used to specify loading from a file.
- feat: Network gateway now supports a
domains key
- feat:
icp identity export now takes an --encrypt flag to avoid rendering the key in plaintext
- feat: Optionally split connected networks'
url into api-url and http-gateway-url
- feat: Allow specifying a version of the network launcher to use
- feat: Support subaccounts and ICRC-1 IDs in
icp token, icp cycles, and icp identity account-id
- feat!: Recipes are now specified
@registry/recipe@version, the version component is required. The latest version is no longer assumed and the version tags will be removed soon.
- feat: Recipes and prebuilt canisters are now cached locally
- feat:
icp settings autocontainerize true, always use a docker container for all networks
- feat:
icp canister migrate-id - initiate canister ID migration across subnets
- feat: Install proxy canister when starting managed networks with all identities as controllers (or anonymous + default if more than 10 identities)
icp network status displays the proxy canister principal
- feat:
icp network status display more information about networks
- feat:
icp canister logs to display the current canister logs
- use
--follow to continuously poll for new logs. --interval <n> to poll every n seconds
- feat: Support
k, m, b, t suffixes in .yaml files when specifying cycles amounts
- feat: Support
kb, kib, mb, mib, gb, gib suffixes in .yaml files and CLI arguments when specifying memory amounts
- feat: Add an optional root-key argument to canister commands
- feat:
icp canister call now supports --output <mode> with the following modes:
auto (default): Try decoding the response as Candid, then UTF-8, then fall back to hex.candid: Parse as Candid and pretty-print; error if parsing fails.text: Parse as UTF-8 text; error if invalid.hex: Print raw response as hex.
- chore!: new passwords for identity encryption need to be at least 8 characters long
- feat: Anonymous usage telemetry — collects command name, arguments, duration, and outcome
- Enabled by default; opt out with
icp settings telemetry false, DO_NOT_TRACK=1, or ICP_TELEMETRY_DISABLED=1
- Automatically disabled in CI environments (
CI env var set)
icp settings telemetry to view or change the current setting
Install icp-cli 0.2.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/dfinity/icp-cli/releases/download/v0.2.0/icp-cli-installer.sh | sh
Install prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/dfinity/icp-cli/releases/download/v0.2.0/icp-cli-installer.ps1 | iex"
Download icp-cli 0.2.0
