@dfinity/pic 0.16.1 → 0.17.1

package/dist/pocket-ic-types.d.ts

@@ -1,6 +1,6 @@
-import { Principal } from '@dfinity/principal';
+import { Principal } from '@icp-sdk/core/principal';
 import { ActorInterface, Actor } from './pocket-ic-actor';
-import { IDL } from '@dfinity/candid';
+import { IDL } from '@icp-sdk/core/candid';
 import { CanisterInstallModeUpgradeOptions } from './management-canister';
 export { type CanisterInstallModeUpgradeOptions } from './management-canister';
 /**
@@ -348,14 +348,14 @@ export interface SetupCanisterOptions extends CreateCanisterOptions {
     /**
      * The WASM module to install to the canister.
      * If a string is passed, it is treated as a path to a file.
-     * If an `ArrayBufferLike` is passed, it is treated as the WASM module itself.
+     * If an `Uint8Array` is passed, it is treated as the WASM module itself.
      */
-    wasm: ArrayBufferLike | string;
+    wasm: Uint8Array | string;
     /**
      * Candid encoded argument to pass to the canister's init function.
-     * Defaults to an empty ArrayBuffer.
+     * Defaults to an empty Uint8Array.
      */
-    arg?: ArrayBufferLike;
+    arg?: Uint8Array;
     /**
      * The principal to setup the canister as.
      * Defaults to the anonymous principal.
@@ -491,14 +491,14 @@ export interface InstallCodeOptions {
     /**
      * The WASM module to install to the canister.
      * If a string is passed, it is treated as a path to a file.
-     * If an `ArrayBufferLike` is passed, it is treated as the WASM module itself.
+     * If an `Uint8Array` is passed, it is treated as the WASM module itself.
      */
-    wasm: ArrayBufferLike | string;
+    wasm: Uint8Array | string;
     /**
      * Candid encoded argument to pass to the canister's init function.
-     * Defaults to an empty ArrayBuffer.
+     * Defaults to an empty Uint8Array.
      */
-    arg?: ArrayBufferLike;
+    arg?: Uint8Array;
     /**
      * The principal to install the code as.
      * Defaults to the anonymous principal.
@@ -524,13 +524,13 @@ export interface ReinstallCodeOptions {
     /**
      * The WASM module to install to the canister.
      * If a string is passed, it is treated as a path to a file.
-     * If an `ArrayBufferLike` is passed, it is treated as the WASM module itself.
+     * If an `Uint8Array` is passed, it is treated as the WASM module itself.
      */
-    wasm: ArrayBufferLike | string;
+    wasm: Uint8Array | string;
     /**
      * Candid encoded argument to pass to the canister's init function.
      */
-    arg?: ArrayBufferLike;
+    arg?: Uint8Array;
     /**
      * The Principal to send the request as.
      * Defaults to the anonymous principal.
@@ -552,13 +552,13 @@ export interface UpgradeCanisterOptions {
     /**
      * The WASM module to install to the canister.
      * If a string is passed, it is treated as a path to a file.
-     * If an `ArrayBufferLike` is passed, it is treated as the WASM module itself.
+     * If an `Uint8Array` is passed, it is treated as the WASM module itself.
      */
-    wasm: ArrayBufferLike | string;
+    wasm: Uint8Array | string;
     /**
      * Candid encoded argument to pass to the canister's init function.
      */
-    arg?: ArrayBufferLike;
+    arg?: Uint8Array;
     /**
      * The Principal to send the request as.
      * Defaults to the anonymous principal.
@@ -608,9 +608,9 @@ export interface QueryCallOptions {
     method: string;
     /**
      * A Candid encoded argument to pass to the canister's method.
-     * Defaults to an empty ArrayBuffer.
+     * Defaults to an empty Uint8Array.
      */
-    arg?: ArrayBufferLike;
+    arg?: Uint8Array;
     /**
      * The ID of the subnet that the canister resides on.
      */
@@ -638,9 +638,9 @@ export interface UpdateCallOptions {
     method: string;
     /**
      * A Candid encoded argument to pass to the canister's method.
-     * Defaults to an empty ArrayBuffer.
+     * Defaults to an empty Uint8Array.
      */
-    arg?: ArrayBufferLike;
+    arg?: Uint8Array;
     /**
      * The ID of the subnet that the canister resides on.
      */

package/dist/pocket-ic.d.ts

@@ -1,5 +1,5 @@
-import { Principal } from '@dfinity/principal';
-import { IDL } from '@dfinity/candid';
+import { Principal } from '@icp-sdk/core/principal';
+import { IDL } from '@icp-sdk/core/candid';
 import { ActorInterface, Actor } from './pocket-ic-actor';
 import { CanisterFixture, CreateCanisterOptions, CreateInstanceOptions, InstallCodeOptions, ReinstallCodeOptions, SetupCanisterOptions, UpgradeCanisterOptions, SubnetTopology, UpdateCanisterSettingsOptions, StartCanisterOptions, StopCanisterOptions, QueryCallOptions, UpdateCallOptions, PendingHttpsOutcall, MockPendingHttpsOutcallOptions } from './pocket-ic-types';
 import { DeferredActor } from './pocket-ic-deferred-actor';
@@ -141,7 +141,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -165,7 +165,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -192,7 +192,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      * import { resolve } from 'node:path';
      *
@@ -221,7 +221,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      * import { resolve } from 'node:path';
      *
@@ -250,7 +250,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      * import { resolve } from 'node:path';
      *
@@ -276,7 +276,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -311,7 +311,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      * import { _SERVICE, idlFactory } from '../declarations';
      *
@@ -349,8 +349,6 @@ export declare class PocketIc {
      *
      * @see [Principal](https://js.icp.build/core/latest/libs/principal/api/classes/principal/)
      * @see [InterfaceFactory](https://js.icp.build/core/latest/libs/candid/api/namespaces/idl/type-aliases/interfacefactory/)
-     *
-     * @example
      */
     createDeferredActor<T extends ActorInterface<T> = ActorInterface>(interfaceFactory: IDL.InterfaceFactory, canisterId: Principal): DeferredActor<T>;
     /**
@@ -361,7 +359,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      * import { _SERVICE, idlFactory } from '../declarations';
      *
@@ -384,7 +382,7 @@ export declare class PocketIc {
      * await picServer.stop();
      * ```
      */
-    queryCall({ canisterId, method, arg, sender, targetSubnetId, }: QueryCallOptions): Promise<ArrayBufferLike>;
+    queryCall({ canisterId, method, arg, sender, targetSubnetId, }: QueryCallOptions): Promise<Uint8Array>;
     /**
      * Makes an update call to the given canister.
      *
@@ -393,7 +391,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      * import { _SERVICE, idlFactory } from '../declarations';
      *
@@ -416,7 +414,7 @@ export declare class PocketIc {
      * await picServer.stop();
      * ```
      */
-    updateCall({ canisterId, method, arg, sender, targetSubnetId, }: UpdateCallOptions): Promise<ArrayBufferLike>;
+    updateCall({ canisterId, method, arg, sender, targetSubnetId, }: UpdateCallOptions): Promise<Uint8Array>;
     /**
      * Deletes the PocketIC instance.
      *
@@ -464,7 +462,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
      *
@@ -475,6 +473,7 @@ export declare class PocketIc {
      *
      * await pic.tearDown();
      * await picServer.stop();
+     * ```
      */
     getControllers(canisterId: Principal): Promise<Principal[]>;
     /**
@@ -680,7 +679,7 @@ export declare class PocketIc {
      * await picServer.stop();
      * ```
      */
-    getPubKey(subnetId: Principal): Promise<ArrayBufferLike>;
+    getPubKey(subnetId: Principal): Promise<Uint8Array>;
     /**
      * Gets the subnet Id of the provided canister Id.
      *
@@ -714,6 +713,35 @@ export declare class PocketIc {
      * @returns An array of subnet topologies, see {@link SubnetTopology}.
      */
     getTopology(): Promise<SubnetTopology[]>;
+    /**
+     * Get the default effective canister id for this PocketIC instance.
+     * This is useful when calling [`IcManagementCanister.provisionalCreateCanisterWithCycles`](https://js.icp.build/canisters/latest/api/ic-management/classes/icmanagementcanister#provisionalcreatecanisterwithcycles)
+     * on the management canister from `@icp-sdk/canisters/ic-management`.
+     *
+     * @returns The default effective canister id.
+     *
+     * @see [Principal](https://js.icp.build/core/latest/libs/principal/api/classes/principal/)
+     *
+     * @example
+     * ```ts
+     * import { PocketIc, PocketIcServer } from '@dfinity/pic';
+     * import { IcManagementCanister } from '@icp-sdk/canisters/ic-management';
+     *
+     * const picServer = await PocketIcServer.start();
+     * const pic = await PocketIc.create(picServer.getUrl());
+     *
+     * const defaultEffectiveCanisterId = await pic.getDefaultEffectiveCanisterId();
+     *
+     * const managementCanister = IcManagementCanister.create({ agent });
+     * const canisterId = await managementCanister.provisionalCreateCanisterWithCycles({
+     *   canisterId: defaultEffectiveCanisterId,
+     * });
+     *
+     * await pic.tearDown();
+     * await picServer.stop();
+     * ```
+     */
+    getDefaultEffectiveCanisterId(): Promise<Principal>;
     /**
      * Get the Bitcoin subnet topology for this instance's network.
      * The instance network topology is configured via the {@link create} method.
@@ -780,7 +808,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -794,7 +822,7 @@ export declare class PocketIc {
      * await picServer.stop();
      * ```
      */
-    getCyclesBalance(canisterId: Principal): Promise<number>;
+    getCyclesBalance(canisterId: Principal): Promise<bigint>;
     /**
      * Add cycles to the specified canister.
      *
@@ -806,7 +834,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -814,13 +842,13 @@ export declare class PocketIc {
      * const picServer = await PocketIcServer.start();
      * const pic = await PocketIc.create(picServer.getUrl());
      *
-     * const newCyclesBalance = await pic.addCycles(canisterId, 10_000_000);
+     * const newCyclesBalance = await pic.addCycles(canisterId, BigInt(10_000_000));
      *
      * await pic.tearDown();
      * await picServer.stop();
      * ```
      */
-    addCycles(canisterId: Principal, amount: number): Promise<number>;
+    addCycles(canisterId: Principal, amount: bigint): Promise<bigint>;
     /**
      * Set the stable memory of a given canister.
      *
@@ -831,7 +859,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -846,7 +874,7 @@ export declare class PocketIc {
      * await picServer.stop();
      * ```
      */
-    setStableMemory(canisterId: Principal, stableMemory: ArrayBufferLike): Promise<void>;
+    setStableMemory(canisterId: Principal, stableMemory: Uint8Array): Promise<void>;
     /**
      * Get the stable memory of a given canister.
      *
@@ -857,7 +885,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -871,7 +899,7 @@ export declare class PocketIc {
      * await picServer.stop();
      * ```
      */
-    getStableMemory(canisterId: Principal): Promise<ArrayBufferLike>;
+    getStableMemory(canisterId: Principal): Promise<Uint8Array>;
     /**
      * Get all pending HTTPS Outcalls across all subnets on this
      * PocketIC instance.
@@ -880,7 +908,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -928,7 +956,7 @@ export declare class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));

package/dist/pocket-ic.js

@@ -1,13 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PocketIc = void 0;
-const principal_1 = require("@dfinity/principal");
+const principal_1 = require("@icp-sdk/core/principal");
 const util_1 = require("./util");
 const pocket_ic_client_1 = require("./pocket-ic-client");
 const pocket_ic_actor_1 = require("./pocket-ic-actor");
 const pocket_ic_types_1 = require("./pocket-ic-types");
 const management_canister_1 = require("./management-canister");
 const pocket_ic_deferred_actor_1 = require("./pocket-ic-deferred-actor");
+const NANOS_PER_MILLISECOND = BigInt(1_000_000);
 /**
  * This class represents the main PocketIC client.
  * It is responsible for interacting with the PocketIC server via the REST API.
@@ -192,7 +193,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -231,7 +232,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -273,7 +274,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      * import { resolve } from 'node:path';
      *
@@ -325,7 +326,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      * import { resolve } from 'node:path';
      *
@@ -372,7 +373,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      * import { resolve } from 'node:path';
      *
@@ -416,7 +417,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -468,7 +469,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      * import { _SERVICE, idlFactory } from '../declarations';
      *
@@ -509,8 +510,6 @@ class PocketIc {
      *
      * @see [Principal](https://js.icp.build/core/latest/libs/principal/api/classes/principal/)
      * @see [InterfaceFactory](https://js.icp.build/core/latest/libs/candid/api/namespaces/idl/type-aliases/interfacefactory/)
-     *
-     * @example
      */
     createDeferredActor(interfaceFactory, canisterId) {
         const DeferredActor = (0, pocket_ic_deferred_actor_1.createDeferredActorClass)(interfaceFactory, canisterId, this.client);
@@ -524,7 +523,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      * import { _SERVICE, idlFactory } from '../declarations';
      *
@@ -569,7 +568,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      * import { _SERVICE, idlFactory } from '../declarations';
      *
@@ -659,7 +658,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
      *
@@ -670,6 +669,7 @@ class PocketIc {
      *
      * await pic.tearDown();
      * await picServer.stop();
+     * ```
      */
     async getControllers(canisterId) {
         return await this.client.getControllers({ canisterId });
@@ -693,8 +693,8 @@ class PocketIc {
      * ```
      */
     async getTime() {
-        const { millisSinceEpoch } = await this.client.getTime();
-        return millisSinceEpoch;
+        const { nanosSinceEpoch } = await this.client.getTime();
+        return Number(nanosSinceEpoch / NANOS_PER_MILLISECOND);
     }
     /**
      * Reset the time of the IC to the current time.
@@ -849,9 +849,10 @@ class PocketIc {
      * ```
      */
     async advanceTime(duration) {
-        const currentTime = await this.getTime();
-        const newTime = currentTime + duration;
-        await this.setTime(newTime);
+        const { nanosSinceEpoch } = await this.client.getTime();
+        const durationNanos = BigInt(duration) * NANOS_PER_MILLISECOND;
+        const newTimeNanos = nanosSinceEpoch + durationNanos;
+        await this.client.setTime({ nanosSinceEpoch: newTimeNanos });
     }
     /**
      * Advance the time of the IC by the given duration in milliseconds and
@@ -878,9 +879,10 @@ class PocketIc {
      * ```
      */
     async advanceCertifiedTime(duration) {
-        const currentTime = await this.getTime();
-        const newTime = currentTime + duration;
-        await this.setCertifiedTime(newTime);
+        const { nanosSinceEpoch } = await this.client.getTime();
+        const durationNanos = BigInt(duration) * NANOS_PER_MILLISECOND;
+        const newTimeNanos = nanosSinceEpoch + durationNanos;
+        await this.client.setCertifiedTime({ nanosSinceEpoch: newTimeNanos });
     }
     /**
      * Fetch the public key of the specified subnet.
@@ -944,6 +946,37 @@ class PocketIc {
         const topology = await this.client.getTopology();
         return Object.values(topology);
     }
+    /**
+     * Get the default effective canister id for this PocketIC instance.
+     * This is useful when calling [`IcManagementCanister.provisionalCreateCanisterWithCycles`](https://js.icp.build/canisters/latest/api/ic-management/classes/icmanagementcanister#provisionalcreatecanisterwithcycles)
+     * on the management canister from `@icp-sdk/canisters/ic-management`.
+     *
+     * @returns The default effective canister id.
+     *
+     * @see [Principal](https://js.icp.build/core/latest/libs/principal/api/classes/principal/)
+     *
+     * @example
+     * ```ts
+     * import { PocketIc, PocketIcServer } from '@dfinity/pic';
+     * import { IcManagementCanister } from '@icp-sdk/canisters/ic-management';
+     *
+     * const picServer = await PocketIcServer.start();
+     * const pic = await PocketIc.create(picServer.getUrl());
+     *
+     * const defaultEffectiveCanisterId = await pic.getDefaultEffectiveCanisterId();
+     *
+     * const managementCanister = IcManagementCanister.create({ agent });
+     * const canisterId = await managementCanister.provisionalCreateCanisterWithCycles({
+     *   canisterId: defaultEffectiveCanisterId,
+     * });
+     *
+     * await pic.tearDown();
+     * await picServer.stop();
+     * ```
+     */
+    async getDefaultEffectiveCanisterId() {
+        return await this.client.getDefaultEffectiveCanisterId();
+    }
     /**
      * Get the Bitcoin subnet topology for this instance's network.
      * The instance network topology is configured via the {@link create} method.
@@ -1031,7 +1064,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -1060,7 +1093,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -1068,7 +1101,7 @@ class PocketIc {
      * const picServer = await PocketIcServer.start();
      * const pic = await PocketIc.create(picServer.getUrl());
      *
-     * const newCyclesBalance = await pic.addCycles(canisterId, 10_000_000);
+     * const newCyclesBalance = await pic.addCycles(canisterId, BigInt(10_000_000));
      *
      * await pic.tearDown();
      * await picServer.stop();
@@ -1088,7 +1121,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -1119,7 +1152,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -1145,7 +1178,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
@@ -1195,7 +1228,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      * import { PocketIc, PocketIcServer } from '@dfinity/pic';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));