Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/developer-tools/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,13 @@ Key features:
- **Environments**: named deployment targets that combine a network, canister set, and settings (e.g., local, staging, production)
- **Project scaffolding**: `icp new` bootstraps new projects from official templates

For installation, see the [Quickstart](../getting-started/quickstart.md) or the [full CLI documentation](https://cli.internetcomputer.org/1.1/).
For installation, see the [Quickstart](../getting-started/quickstart.md) or the [full CLI documentation](https://cli.internetcomputer.org/1.3/).

Advanced: [creating recipes](https://cli.internetcomputer.org/1.1/guides/creating-recipes) and [creating templates](https://cli.internetcomputer.org/1.1/guides/creating-templates) are documented on the CLI docs site.
Advanced: [creating recipes](https://cli.internetcomputer.org/1.3/guides/creating-recipes) and [creating templates](https://cli.internetcomputer.org/1.3/guides/creating-templates) are documented on the CLI docs site.

icp-cli collects anonymous usage telemetry. Opt out with `icp settings telemetry false` or `DO_NOT_TRACK=1`.

Coming from dfx? See the [migration guide](https://cli.internetcomputer.org/1.1/migration/from-dfx).
Coming from dfx? See the [migration guide](https://cli.internetcomputer.org/1.3/migration/from-dfx).

### ic-wasm

Expand Down
6 changes: 3 additions & 3 deletions docs/getting-started/project-structure.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ Beyond canisters, `icp.yaml` can also define **networks** (where to deploy) and
| `local` | `local` (managed, localhost:8000) | Local development |
| `ic` | `ic` (connected, https://icp-api.io) | Mainnet production |

You only need to add custom networks or environments when you have staging environments, testnets, or other deployment targets. See the [icp-cli configuration reference](https://cli.internetcomputer.org/1.1/reference/configuration#networks) for the full schema.
You only need to add custom networks or environments when you have staging environments, testnets, or other deployment targets. See the [icp-cli configuration reference](https://cli.internetcomputer.org/1.3/reference/configuration#networks) for the full schema.

## Canister configuration (canister.yaml)

Expand Down Expand Up @@ -155,7 +155,7 @@ icp project show

This outputs the effective configuration, including all expanded recipe steps and implicit defaults.

Recipes are Handlebars templates hosted at [dfinity/icp-cli-recipes](https://github.com/dfinity/icp-cli-recipes). You can also create local or remote recipes for custom build patterns. See the [icp-cli recipes documentation](https://cli.internetcomputer.org/1.1/guides/creating-recipes) for details.
Recipes are Handlebars templates hosted at [dfinity/icp-cli-recipes](https://github.com/dfinity/icp-cli-recipes). You can also create local or remote recipes for custom build patterns. See the [icp-cli recipes documentation](https://cli.internetcomputer.org/1.3/guides/creating-recipes) for details.

## The .icp/ directory

Expand Down Expand Up @@ -254,6 +254,6 @@ For a deep dive on binding generation, see [Binding generation](../guides/canist
- [Binding generation](../guides/canister-calls/candid.md#binding-generation): deep dive on generating type-safe client code
- [Asset canister](../guides/frontends/asset-canister.md): how the frontend recipe and asset upload work
- [Canister lifecycle](../guides/canister-management/lifecycle.md): build, deploy, upgrade, and manage canisters
- [icp-cli reference](https://cli.internetcomputer.org/1.1/reference/cli): full CLI and configuration documentation
- [icp-cli reference](https://cli.internetcomputer.org/1.3/reference/cli): full CLI and configuration documentation

{/* Upstream: informed by dfinity/icp-cli docs/concepts/project-model.md, docs/concepts/recipes.md, docs/concepts/binding-generation.md, docs/concepts/canister-discovery.md */}
4 changes: 2 additions & 2 deletions docs/getting-started/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ icp --version
ic-wasm --version
```

> **Alternative methods:** [Homebrew, shell scripts, and other options](https://cli.internetcomputer.org/1.1/guides/installation) are also available.
> **Alternative methods:** [Homebrew, shell scripts, and other options](https://cli.internetcomputer.org/1.3/guides/installation) are also available.

## Create a project

Expand Down Expand Up @@ -127,6 +127,6 @@ Each canister name maps to a directory containing its own `canister.yaml` with b
- [Choose your path](choose-your-path.md): pick a development path based on what you want to build
- [Concepts: Canisters](../concepts/canisters.md): learn what canisters are and how they work
- [AI coding agents](../guides/ai-coding-agents.md): use ICP skills to build on the Internet Computer with AI
- [icp-cli documentation](https://cli.internetcomputer.org/1.1/): full CLI reference and guides
- [icp-cli documentation](https://cli.internetcomputer.org/1.3/): full CLI reference and guides

<!-- Upstream: informed by dfinity/icp-cli docs/quickstart.md, docs/tutorial.md -->
Original file line number Diff line number Diff line change
Expand Up @@ -16,13 +16,13 @@ Parallel calls are most beneficial when the caller and callee are on **different
<Tabs syncKey="lang">
<TabItem label="Motoko">

- [icp-cli](https://cli.internetcomputer.org/1.1/guides/installation) installed
- [icp-cli](https://cli.internetcomputer.org/1.3/guides/installation) installed
- `mops` package manager with `core = "2.0.0"` in `mops.toml`

</TabItem>
<TabItem label="Rust">

- [icp-cli](https://cli.internetcomputer.org/1.1/guides/installation) installed
- [icp-cli](https://cli.internetcomputer.org/1.3/guides/installation) installed
- `ic-cdk = "0.19"` and `futures = "0.3"` in `Cargo.toml`

</TabItem>
Expand Down
4 changes: 2 additions & 2 deletions docs/guides/canister-management/cycles-management.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -307,7 +307,7 @@ icp deploy -e staging
icp deploy -e production
```

Each environment maintains separate canister IDs. Mainnet IDs are stored in `.icp/data/mappings/<environment>.ids.json` and should be committed to version control. See [Managing environments](https://cli.internetcomputer.org/1.1/guides/managing-environments) for full configuration options.
Each environment maintains separate canister IDs. Mainnet IDs are stored in `.icp/data/mappings/<environment>.ids.json` and should be committed to version control. See [Managing environments](https://cli.internetcomputer.org/1.3/guides/managing-environments) for full configuration options.

## Production deployment checklist

Expand Down Expand Up @@ -375,6 +375,6 @@ icp canister top-up backend --amount 1T -n ic
- [Cycles ledger reference](../../references/system-canisters.md#cycles-ledger): Canister IDs and interface specification
- [Calls with attached cycles](../canister-calls/inter-canister-calls.md#calls-with-attached-cycles): attach cycles to an inter-canister call and accept them in the callee
- [Reproducible builds](reproducible-builds.md): Verify your WASM is trustworthy before deploying
- [icp-cli docs](https://cli.internetcomputer.org/1.1/reference/cli#icp-cycles): Full command reference for `icp cycles` and `icp canister top-up`
- [icp-cli docs](https://cli.internetcomputer.org/1.3/reference/cli#icp-cycles): Full command reference for `icp cycles` and `icp canister top-up`

{/* Upstream: informed by dfinity/portal (docs/building-apps/canister-management/topping-up.mdx, docs/building-apps/getting-started/tokens-and-cycles.mdx; dfinity/icp-cli) docs/guides/deploying-to-mainnet.md, docs/guides/tokens-and-cycles.md, docs/guides/managing-environments.md; dfinity/icskills: skills/cycles-management/SKILL.md */}
2 changes: 1 addition & 1 deletion docs/guides/canister-management/lifecycle.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -264,7 +264,7 @@ This is useful during development when you want a clean slate. The canister ID i

Deleting permanently removes a canister from the network. The canister ID cannot be reused.

> **Note:** Canisters are like real estate on the IC. Creating them costs cycles. Instead of deleting a canister, consider reusing it in a different project. Check the [cli reference](https://cli.internetcomputer.org/1.1/concepts/project-model/#canister-ids) for more information.
> **Note:** Canisters are like real estate on the IC. Creating them costs cycles. Instead of deleting a canister, consider reusing it in a different project. Check the [cli reference](https://cli.internetcomputer.org/1.3/concepts/project-model/#canister-ids) for more information.

1. Stop the canister first:

Expand Down
4 changes: 2 additions & 2 deletions docs/guides/canister-management/logs.md
Original file line number Diff line number Diff line change
Expand Up @@ -403,7 +403,7 @@ async fn main() -> Result<()> {

- [Canister lifecycle](lifecycle.md): configure log visibility and memory limits when creating or deploying a canister
- [Testing strategies](../testing/strategies.md): use canister logs as part of your debugging workflow
- [CLI reference: `icp canister logs`](https://cli.internetcomputer.org/1.1/reference/cli#icp-canister-logs): full command flags and options
- [CLI reference: `icp canister settings update`](https://cli.internetcomputer.org/1.1/reference/cli#icp-canister-settings-update): full command flags and options
- [CLI reference: `icp canister logs`](https://cli.internetcomputer.org/1.3/reference/cli#icp-canister-logs): full command flags and options
- [CLI reference: `icp canister settings update`](https://cli.internetcomputer.org/1.3/reference/cli#icp-canister-settings-update): full command flags and options

<!-- Upstream: informed by dfinity/portal — docs/building-apps/canister-management/logs.mdx, docs/building-apps/canister-management/backtraces.mdx, docs/building-apps/advanced/canister-access-logs.mdx; dfinity/examples — rust/canister_logs, motoko/canister_logs, rust/query_stats, motoko/query_stats; dfinity/cdk-rs — ic-cdk/src/api.rs, ic-cdk/src/management_canister.rs, ic-management-canister-types/src/lib.rs; dfinity/icp-cli — docs/reference/cli.md, docs/reference/canister-settings.md -->
2 changes: 1 addition & 1 deletion docs/guides/canister-management/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -332,7 +332,7 @@ icp canister settings update backend -e ic --freezing-threshold 90d

Additional flags: `--reserved-cycles-limit`, `--wasm-memory-threshold`, `--log-memory-limit`, `--add-environment-variable`. Run `icp canister settings update --help` for the full list.

For the full list of CLI flags, see the [icp-cli reference](https://cli.internetcomputer.org/1.1/reference/cli#icp-canister-settings-update).
For the full list of CLI flags, see the [icp-cli reference](https://cli.internetcomputer.org/1.3/reference/cli#icp-canister-settings-update).

## Updating settings programmatically

Expand Down
2 changes: 1 addition & 1 deletion docs/guides/canister-management/snapshots.md
Original file line number Diff line number Diff line change
Expand Up @@ -181,6 +181,6 @@ icp canister status my-canister -e ic
- [Canister lifecycle](lifecycle.md): Understand how snapshots fit into the upgrade workflow
- [Canister migration](canister-migration.md): Complete guide for moving a canister to a different subnet using the snapshot transfer workflow
- [Canister upgrades security](../security/canister-upgrades.md): Security considerations when using snapshot-based rollbacks
- [icp-cli canister snapshot reference](https://cli.internetcomputer.org/1.1/guides/canister-snapshots): Full command reference for all snapshot subcommands
- [icp-cli canister snapshot reference](https://cli.internetcomputer.org/1.3/guides/canister-snapshots): Full command reference for all snapshot subcommands

<!-- Upstream: informed by dfinity/icp-cli docs/guides/canister-snapshots.md; dfinity/portal docs/building-apps/canister-management/snapshots.mdx -->
2 changes: 1 addition & 1 deletion docs/guides/digital-assets/ledgers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -252,7 +252,7 @@ ICRC-2 adds an approve/transferFrom pattern. The asset owner first approves a sp

**When to use:** Exchange logic, payment processing, subscription services, or any case where a canister needs to pull assets from a user's account.

> To grant or inspect an allowance manually without writing code, use the [`icp token approve`](https://cli.internetcomputer.org/1.1/reference/cli#icp-token-approve) and [`icp token allowance`](https://cli.internetcomputer.org/1.1/reference/cli#icp-token-allowance) CLI commands.
> To grant or inspect an allowance manually without writing code, use the [`icp token approve`](https://cli.internetcomputer.org/1.3/reference/cli#icp-token-approve) and [`icp token allowance`](https://cli.internetcomputer.org/1.3/reference/cli#icp-token-allowance) CLI commands.

<Tabs syncKey="lang">
<TabItem label="Motoko">
Expand Down
2 changes: 1 addition & 1 deletion docs/guides/frontends/frameworks.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ This guide shows you how to configure your framework's build pipeline, wire up t

## Prerequisites

- [icp-cli](https://cli.internetcomputer.org/1.1/guides/installation) installed: `npm install -g @icp-sdk/icp-cli @icp-sdk/ic-wasm`
- [icp-cli](https://cli.internetcomputer.org/1.3/guides/installation) installed: `npm install -g @icp-sdk/icp-cli @icp-sdk/ic-wasm`
- A backend canister deployed (or a static-only site with no backend)
- Familiarity with [asset canisters](asset-canister.md)

Expand Down
2 changes: 1 addition & 1 deletion docs/guides/testing/pocket-ic.md
Original file line number Diff line number Diff line change
Expand Up @@ -377,7 +377,7 @@ PocketIC runs on macOS and Linux. Windows is not currently supported for standal

## Connecting to a running network for testing

For end-to-end tests that need a full network with all system canisters, use a containerized network instead of PocketIC. See the [icp-cli containerized networks documentation](https://cli.internetcomputer.org/1.1/guides/containerized-networks) for how to configure Docker-based test networks in `icp.yaml`.
For end-to-end tests that need a full network with all system canisters, use a containerized network instead of PocketIC. See the [icp-cli containerized networks documentation](https://cli.internetcomputer.org/1.3/guides/containerized-networks) for how to configure Docker-based test networks in `icp.yaml`.

The containerized network is appropriate when:

Expand Down
2 changes: 1 addition & 1 deletion docs/guides/testing/strategies.md
Original file line number Diff line number Diff line change
Expand Up @@ -330,7 +330,7 @@ icp network status docker-test --json

For the full containerized network configuration reference: including environment variables, volume mounts, and
custom images: see the
[icp-cli containerized networks guide](https://cli.internetcomputer.org/1.1/guides/containerized-networks).
[icp-cli containerized networks guide](https://cli.internetcomputer.org/1.3/guides/containerized-networks).

## Choosing the right approach

Expand Down
2 changes: 1 addition & 1 deletion docs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Teach your AI coding agent the patterns, APIs, and deployment workflows it needs
## External resources

<CardGrid>
<LinkCard title="ICP CLI" description="Command-line tool for ICP development" href="https://cli.internetcomputer.org/1.1/" />
<LinkCard title="ICP CLI" description="Command-line tool for ICP development" href="https://cli.internetcomputer.org/1.3/" />
<LinkCard title="JS SDK" description="JavaScript/TypeScript libraries for ICP" href="https://js.icp.build" />
<LinkCard title="ICP Skills" description="Skills for agents that write code on ICP" href="https://skills.internetcomputer.org" />
<LinkCard title="Examples" description="Working Motoko and Rust canister examples" href="https://github.com/dfinity/examples" />
Expand Down
Loading