@dfinity/pic 0.16.0 → 0.17.0

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

@@ -1,7 +1,8 @@
-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';
 /**
  * Options for creating a PocketIc instance.
  */
@@ -347,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.
@@ -490,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.
@@ -523,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.
@@ -551,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.
@@ -607,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.
      */
@@ -637,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-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"pocket-ic-types.js","sourceRoot":"","sources":["../src/pocket-ic-types.ts"],"names":[],"mappings":";;;AAmOA;;GAEG;AACH,IAAY,eAWX;AAXD,WAAY,eAAe;IACzB;;OAEG;IACH,8BAAW,CAAA;IAEX;;;OAGG;IACH,wCAAqB,CAAA;AACvB,CAAC,EAXW,eAAe,+BAAf,eAAe,QAW1B;AAED;;GAEG;AACH,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;AACrB,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB;AAyBD;;GAEG;AACH,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B;;OAEG;IACH,oDAA+B,CAAA;AACjC,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B;AA6ED;;GAEG;AACH,IAAY,UAmCX;AAnCD,WAAY,UAAU;IACpB;;OAEG;IACH,yCAA2B,CAAA;IAE3B;;OAEG;IACH,iCAAmB,CAAA;IAEnB;;OAEG;IACH,qCAAuB,CAAA;IAEvB;;OAEG;IACH,qCAAuB,CAAA;IAEvB;;OAEG;IACH,yBAAW,CAAA;IAEX;;OAEG;IACH,yBAAW,CAAA;IAEX;;OAEG;IACH,+BAAiB,CAAA;AACnB,CAAC,EAnCW,UAAU,0BAAV,UAAU,QAmCrB;AAkaD;;GAEG;AACH,IAAY,kBAeX;AAfD,WAAY,kBAAkB;IAC5B;;OAEG;IACH,iCAAW,CAAA;IAEX;;OAEG;IACH,mCAAa,CAAA;IAEb;;OAEG;IACH,mCAAa,CAAA;AACf,CAAC,EAfW,kBAAkB,kCAAlB,kBAAkB,QAe7B;AAiFD,2BAA2B"}
+{"version":3,"file":"pocket-ic-types.js","sourceRoot":"","sources":["../src/pocket-ic-types.ts"],"names":[],"mappings":";;;AAsOA;;GAEG;AACH,IAAY,eAWX;AAXD,WAAY,eAAe;IACzB;;OAEG;IACH,8BAAW,CAAA;IAEX;;;OAGG;IACH,wCAAqB,CAAA;AACvB,CAAC,EAXW,eAAe,+BAAf,eAAe,QAW1B;AAED;;GAEG;AACH,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;AACrB,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB;AAyBD;;GAEG;AACH,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B;;OAEG;IACH,oDAA+B,CAAA;AACjC,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B;AA6ED;;GAEG;AACH,IAAY,UAmCX;AAnCD,WAAY,UAAU;IACpB;;OAEG;IACH,yCAA2B,CAAA;IAE3B;;OAEG;IACH,iCAAmB,CAAA;IAEnB;;OAEG;IACH,qCAAuB,CAAA;IAEvB;;OAEG;IACH,qCAAuB,CAAA;IAEvB;;OAEG;IACH,yBAAW,CAAA;IAEX;;OAEG;IACH,yBAAW,CAAA;IAEX;;OAEG;IACH,+BAAiB,CAAA;AACnB,CAAC,EAnCW,UAAU,0BAAV,UAAU,QAmCrB;AAkaD;;GAEG;AACH,IAAY,kBAeX;AAfD,WAAY,kBAAkB;IAC5B;;OAEG;IACH,iCAAW,CAAA;IAEX;;OAEG;IACH,mCAAa,CAAA;IAEb;;OAEG;IACH,mCAAa,CAAA;AACf,CAAC,EAfW,kBAAkB,kCAAlB,kBAAkB,QAe7B;AAiFD,2BAA2B"}

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]));
@@ -303,7 +303,7 @@ export declare class PocketIc {
      *
      * @param interfaceFactory The InterfaceFactory to use for the {@link Actor}.
      * @param canisterId The Principal of the canister to create the {@link Actor} for.
-     * @typeparam T The type of the {@link Actor}. Must implement {@link ActorInterface}.
+     * @typeParam T The type of the {@link Actor}. Must implement {@link ActorInterface}.
      * @returns The {@link Actor} instance.
      *
      * @see [Principal](https://js.icp.build/core/latest/libs/principal/api/classes/principal/)
@@ -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';
      *
@@ -344,7 +344,7 @@ export declare class PocketIc {
      *
      * @param interfaceFactory The InterfaceFactory to use for the {@link DeferredActor}.
      * @param canisterId The Principal of the canister to create the {@link DeferredActor} for.
-     * @typeparam T The type of the {@link DeferredActor}. Must implement {@link ActorInterface}.
+     * @typeParam T The type of the {@link DeferredActor}. Must implement {@link ActorInterface}.
      * @returns The {@link DeferredActor} instance.
      *
      * @see [Principal](https://js.icp.build/core/latest/libs/principal/api/classes/principal/)
@@ -361,7 +361,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 +384,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 +393,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 +416,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 +464,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]));
      *
@@ -680,7 +680,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 +714,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 +809,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 +823,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 +835,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]));
@@ -820,7 +849,7 @@ export declare class PocketIc {
      * 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 +860,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 +875,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 +886,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 +900,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 +909,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 +957,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]));
@@ -460,7 +461,7 @@ class PocketIc {
      *
      * @param interfaceFactory The InterfaceFactory to use for the {@link Actor}.
      * @param canisterId The Principal of the canister to create the {@link Actor} for.
-     * @typeparam T The type of the {@link Actor}. Must implement {@link ActorInterface}.
+     * @typeParam T The type of the {@link Actor}. Must implement {@link ActorInterface}.
      * @returns The {@link Actor} instance.
      *
      * @see [Principal](https://js.icp.build/core/latest/libs/principal/api/classes/principal/)
@@ -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';
      *
@@ -504,7 +505,7 @@ class PocketIc {
      *
      * @param interfaceFactory The InterfaceFactory to use for the {@link DeferredActor}.
      * @param canisterId The Principal of the canister to create the {@link DeferredActor} for.
-     * @typeparam T The type of the {@link DeferredActor}. Must implement {@link ActorInterface}.
+     * @typeParam T The type of the {@link DeferredActor}. Must implement {@link ActorInterface}.
      * @returns The {@link DeferredActor} instance.
      *
      * @see [Principal](https://js.icp.build/core/latest/libs/principal/api/classes/principal/)
@@ -524,7 +525,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 +570,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 +660,7 @@ class PocketIc {
      *
      * @example
      * ```ts
-     * import { Principal } from '@dfinity/principal';
+     * import { Principal } from '@icp-sdk/core/principal';
      *
      * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
      *
@@ -693,8 +694,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 +850,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 +880,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 +947,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 +1065,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 +1094,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]));
@@ -1088,7 +1122,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 +1153,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 +1179,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 +1229,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]));