v0.1.0

Release Notes

• feat: icp canister snapshot - create, delete, restore, list, download, and upload canister snapshots
• feat: icp canister call now supports --proxy flag to route calls through a proxy canister
  • Use --proxy <CANISTER_ID> to forward the call through a proxy canister's proxy method
  • Use --cycles <AMOUNT> to specify cycles to forward with the proxied call (defaults to 0)

Install icp-cli 0.1.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/dfinity/icp-cli/releases/download/v0.1.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.1.0/icp-cli-installer.ps1 | iex"

Download icp-cli 0.1.0

File	Platform	Checksum
icp-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icp-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icp-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
icp-cli-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
icp-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.0-beta.6

Release Notes

• feat: icp identity export to print the PEM file for the identity

Install icp-cli 0.1.0-beta.6

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/dfinity/icp-cli/releases/download/v0.1.0-beta.6/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.1.0-beta.6/icp-cli-installer.ps1 | iex"

Download icp-cli 0.1.0-beta.6

File	Platform	Checksum
icp-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icp-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icp-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
icp-cli-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
icp-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.0-beta.5

Release Notes

• fix: Fix error when loading network descriptors from v0.1.0-beta.3
• feat: icp identity delete and icp identity rename

Install icp-cli 0.1.0-beta.5

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/dfinity/icp-cli/releases/download/v0.1.0-beta.5/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.1.0-beta.5/icp-cli-installer.ps1 | iex"

Download icp-cli 0.1.0-beta.5

File	Platform	Checksum
icp-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icp-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icp-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
icp-cli-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
icp-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.0-beta.4

Release Notes

• fix: More reliably detect occupied ports' project locations across containers and backgrounded networks
• feat: Bind Docker networks to 127.0.0.1
• feat: Add IC options to network manifest (ii, nns, subnets, artificial-delay-ms)
• feat: Release for Windows
• feat: Add safety controls for --set-controller and --remove-controller
  • Warn and prompt for confirmation when removing yourself from controllers
  • Add -f/--force flag to skip confirmation prompts
• feat: Show name in canister status command
• feat: icp canister metadata <canister> <metadata section> now fetches metadata sections from specified canisters
• fix: Validate explicit canister paths and throw an error if canister.yaml is not found
• feat!: Rename the implicit "mainnet" network to "ic"
  • The corresponding environment "ic" is defined implicitly which can be overwritten by user configuration.
  • The --mainnet and --ic flags are removed. Use -n/--network ic, -e/--environment ic instead.
• feat: Allow overriding the implicit local network and environment.
• chore: get rid of TCYCLES mentions and replace them with cycles
• feat: Add icp cycles transfer as replacement for icp token cycles transfer
• chore!: remove support for cycles in icp token. Use icp cycles instead
• chore!: Change display format of token and cycles amounts
• feat: Token and cycles amounts now support new formats. Valid examples: 1_000, 1k, 1.5m, 1_234.5b, 4T
• feat: Allow installing WASMs that are larger than 2MB
• feat: Add icp identity account-id command to display the ICP ledger account identifier
  • Supports --of-principal flag to convert a specific principal instead of the current identity
• feat: icp token transfer now accepts AccountIdentifier hex strings for ICP ledger transfers
  • Legacy ICP ledger transfers using AccountIdentifier are automatically used when a 64-character hex string is provided
  • AccountIdentifier format is only supported for the ICP ledger; other tokens require Principal format
• feat: icp canister call can now take arguments in hex
• feat: allow specifying paths to files that contain canister arguments:
  • in icp canister call <canister> <function> <argument> the argument can now point to a file that contains hex or Candid
  • in icp canister install <canister> <argument> the argument can now point to a file that contains hex or Candid
  • in icp.yaml, a canister's install_args field can now point to a file that contains hex or Candid

Install icp-cli 0.1.0-beta.4

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/dfinity/icp-cli/releases/download/v0.1.0-beta.4/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.1.0-beta.4/icp-cli-installer.ps1 | iex"

Download icp-cli 0.1.0-beta.4

File	Platform	Checksum
icp-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icp-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icp-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
icp-cli-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
icp-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.0-beta.3

Release Notes

• feat: Remove requirement that the user install icp-cli-network-launcher, auto-install it on first use
• feat: Support keyring storage and password-protected encryption for identity keys (and make keyring the default)
• fix: Use EOP when upgrading motoko canisters
• feat: Network startup verbose output now requires --debug flag
• feat: Add icp network status command to display network information
  • Displays port, root key, and candid UI principal (if available)
  • Supports --json flag for JSON output
• feat: icp deploy now displays URLs to interact with the deployed canister(s)
• feat: Allow overriding the local network in the config file
  • This makes it more convenient to configure the default environment
• feat: Validate call argument against candid interface
  • The interface is fetched from canister metadata onchain
• feat: Accept an environment as argument for network commands
• feat: call argument building interactively using candid assist
• feat: specifying canister init_args in icp.yaml
• fix: overriding canister settings from the canisters section of icp.yaml with settings from the environments section now works as intended

Install icp-cli 0.1.0-beta.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/dfinity/icp-cli/releases/download/v0.1.0-beta.3/icp-cli-installer.sh | sh

Download icp-cli 0.1.0-beta.3

File	Platform	Checksum
icp-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
icp-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
icp-cli-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
icp-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.0-beta.2

What's Changed

• fix: When deleting a canister, also delete the id from id store by @viviveevee in #229
• chore: make the list commands consistent by @raymondk in #230
• chore!: rename icp network run to icp network start by @raymondk in #231
• docs: Add more info to the docs by @raymondk in #232
• feat: Docker container integration by @adamspofford-dfinity in #233
• chore: Update CHANGELOG with new features and fixes by @raymondk in #234
• feat: Pull docker image if not found by @adamspofford-dfinity in #235
• chore: Enable linux-arm64 builds by @adamspofford-dfinity in #236
• docs: fix typo in example manifest by @raymondk in #238
• feat: install candid UI when start network by @lwshang in #237
• fix: autodetect alternate sockets with docker context by @adamspofford-dfinity in #240
• chore: Add v0.1.0-beta.2 to CHANGELOG by @lwshang in #242

Full Changelog: v0.1.0-beta.1...v0.1.0-beta.2

Release v0.1.0-beta.1

• feat!: Switch to using icp-cli-network-launcher instead of pocket-ic directly. Download it here.
• feat!: Introduce new command to create projects from templates (#219)

Release v0.1.0-beta.0

This is a the first beta release of icp-cli.

Supports:

• Creating an identity.
• Launching a local network with pocket-ic.
• Executing operations against a network.
• Building and deploying canisters to a network.

Please report issues in Github, on Discord or on the Forum