chore: migrate build tooling from dfx to icp-cli

.github/actions/setup-canister-toolchain/action.yml

@@ -0,0 +1,41 @@
+name: Setup Canister Toolchain
+description: Install ICP CLI, Motoko toolchain, Rust wasm32 target, and configure caching
+
+inputs:
+  package-manager:
+    description: 'Package manager to use (pnpm or bun)'
+    required: true
+
+runs:
+  using: composite
+  steps:
+    - name: Install ICP CLI tools
+      shell: bash
+      run: ${{ inputs.package-manager }} add -g @icp-sdk/icp-cli @icp-sdk/ic-wasm
+
+    - name: Cache Mops
+      uses: actions/cache@v4
+      with:
+        path: |
+          ~/.cache/mops
+          ~/Library/Caches/mops
+          .mops
+        key: mops-${{ runner.os }}-${{ runner.arch }}-${{ hashFiles('mops.toml') }}
+
+    - name: Setup Motoko toolchain
+      shell: bash
+      run: |
+        ${{ inputs.package-manager }} add -g ic-mops
+        mops install
+
+    - name: Cache Cargo
+      uses: actions/cache@v4
+      with:
+        path: |
+          ~/.cargo/registry
+          target
+        key: cargo-${{ runner.os }}-${{ runner.arch }}-${{ hashFiles('**/Cargo.lock') }}
+
+    - name: Add wasm32 Rust target
+      shell: bash
+      run: rustup target add wasm32-unknown-unknown

.github/workflows/e2e-test-nodejs.yml

@@ -31,10 +31,10 @@ jobs:
       - name: Setup PNPM
         uses: dfinity/ci-tools/actions/setup-pnpm@main
 
-      - name: Setup DFX
-        uses: dfinity/setup-dfx@main
+      - name: Setup Canister Toolchain
+        uses: ./.github/actions/setup-canister-toolchain
         with:
-          dfx-version: 'auto'
+          package-manager: pnpm
 
       - name: Build
         run: pnpm run build
@@ -64,10 +64,10 @@ jobs:
         shell: bash
         run: bun i --frozen-lockfile
 
-      - name: Setup DFX
-        uses: dfinity/setup-dfx@main
+      - name: Setup Canister Toolchain
+        uses: ./.github/actions/setup-canister-toolchain
         with:
-          dfx-version: 'auto'
+          package-manager: bun
 
       - name: Build
         run: bun run build

.gitignore

@@ -1,4 +1,6 @@
 /.dfx/
+/.icp/cache/
+/.mops/
 /node_modules/
 /target/
 

examples/README.md

@@ -1,6 +1,6 @@
 # Examples
 
-All examples are written in [TypeScript](https://www.typescriptlang.org/) with [Jest](https://jestjs.io/) as the test runner,
+All examples are written in [TypeScript](https://www.typescriptlang.org/) with [Jest](https://jestjs.io/) or [Vitest](https://vitest.dev/) as the test runner,
 but `@dfinity/pic` can be used with JavaScript and any other testing runner, such as [NodeJS](https://nodejs.org/dist/latest-v20.x/docs/api/test.html), [bun](https://bun.sh/docs/cli/test) or [Mocha](https://mochajs.org/).
 
 ## Setup
@@ -13,6 +13,27 @@ but `@dfinity/pic` can be used with JavaScript and any other testing runner, suc
   bun i
   ```
 
+- Build all examples:
+
+  ```bash
+  bun build:examples
+  ```
+
+- Test all examples:
+
+  ```bash
+  bun test:examples
+  ```
+
+- Build or test a single example:
+
+  ```bash
+  bun build:examples -- counter
+  bun test:examples -- counter
+  ```
+
+## Examples
+
 - [Counter](./counter/README.md)
   This example demonstrates how to work with a simple canister as well as init arguments, canister upgrades and WASM reinstallation.
 - [Clock](./clock/README.md)
@@ -21,6 +42,8 @@ but `@dfinity/pic` can be used with JavaScript and any other testing runner, suc
   This example demonstrates how to work with more complex canisters, identities, canister upgrades, and stable memory management. It also shows how to use "live" mode with agent-js (in contrast to the pic-js actor).
 - [Multicanister](./multicanister/README.md)
   This example demonstrates how to work with multiple canisters and multiple subnets.
+- [ICP Features](./icp_features/README.md)
+  This example demonstrates how to enable ICP features when creating a PocketIC instance.
 - [NNS Proxy](./nns_proxy/README.md)
   This example demonstrates how to work with an NNS state directory.
 - [Google Search](./google_search/README.md)

examples/clock/README.md

@@ -2,14 +2,14 @@
 
 This example demonstrates how to work with the replica's system time, canister timers as well as checking for canister existence and cycle management.
 
-Build the counter canister:
+Build the canister:
 
 ```shell
-bun build:clock
+bun build:examples -- clock
 ```
 
-Run the counter tests:
+Run the tests:
 
 ```shell
-bun test:clock
+bun test:examples -- clock
 ```

examples/clock/canister.yaml

@@ -0,0 +1,7 @@
+name: clock
+recipe:
+  type: '@dfinity/motoko@v4.1.0'
+  configuration:
+    main: src/main.mo
+    candid: clock.did
+    compress: true

examples/clock/clock.did

@@ -0,0 +1,3 @@
+service : {
+  get : () -> (int) query;
+}

examples/clock/src/main.mo

@@ -1,5 +1,5 @@
-import Time "mo:base/Time";
-import { setTimer; recurringTimer } = "mo:base/Timer";
+import Time "mo:core/Time";
+import { setTimer; recurringTimer } = "mo:core/Timer";
 
 persistent actor Clock {
   private type Time = Time.Time;

examples/clock/tests/src/clock.spec.ts

@@ -11,11 +11,10 @@ const WASM_PATH = resolve(
   '..',
   '..',
   '..',
-  '.dfx',
-  'local',
-  'canisters',
+  '.icp',
+  'cache',
+  'artifacts',
   'clock',
-  'clock.wasm.gz',
 );
 
 describe('Clock', () => {

examples/counter/README.md

@@ -2,14 +2,14 @@
 
 This example demonstrates how to work with a simple canister as well as init arguments, canister upgrades and WASM reinstallation.
 
-Build the counter canister:
+Build the canister:
 
 ```shell
-bun build:counter
+bun build:examples -- counter
 ```
 
-Run the counter tests:
+Run the tests:
 
 ```shell
-bun test:counter
+bun test:examples -- counter
 ```

examples/counter/canister.yaml

@@ -0,0 +1,7 @@
+name: counter
+recipe:
+  type: '@dfinity/motoko@v4.1.0'
+  configuration:
+    main: src/main.mo
+    candid: counter.did
+    compress: true

examples/counter/counter.did

@@ -0,0 +1,6 @@
+service : (nat) -> {
+  get : () -> (nat) query;
+  set : (nat) -> ();
+  inc : () -> ();
+  dec : () -> ();
+}

examples/counter/src/main.mo

@@ -1,4 +1,4 @@
-import Nat "mo:base/Nat";
+import Nat "mo:core/Nat";
 
 persistent actor class Counter(initial_count : Nat) {
   private var counter = initial_count;

examples/counter/tests/src/counter.spec.ts

@@ -12,11 +12,10 @@ const WASM_PATH = resolve(
   '..',
   '..',
   '..',
-  '.dfx',
-  'local',
-  'canisters',
+  '.icp',
+  'cache',
+  'artifacts',
   'counter',
-  'counter.wasm.gz',
 );
 
 describe('Counter', () => {

examples/google_search/README.md

@@ -1,15 +1,15 @@
-# Multi canister
+# Google Search
 
-This example demonstrates how to test HTTPS Outcalls in canisters.
+This example demonstrates how to mock HTTPS Outcalls in canisters.
 
-Build the canisters:
+Build the canister:
 
 ```shell
-bun build:google_search
+bun build:examples -- google_search
 ```
 
 Run the tests:
 
 ```shell
-bun test:google_search
+bun test:examples -- google_search
 ```