@dfinity/pic 0.18.0 → 0.19.0

package/dist/pocket-ic-client.js

@@ -10,11 +10,14 @@ const AWAIT_INGRESS_STATUS_ROUNDS = 100;
 class PocketIcClient {
     serverClient;
     instancePath;
+    instanceId;
     ingressMaxRetries;
     isInstanceDeleted = false;
-    constructor(serverClient, instancePath, ingressMaxRetries) {
+    httpGatewayInstanceId = null;
+    constructor(serverClient, instancePath, instanceId, ingressMaxRetries) {
         this.serverClient = serverClient;
         this.instancePath = instancePath;
+        this.instanceId = instanceId;
         this.ingressMaxRetries = ingressMaxRetries;
     }
     static async create(url, req) {
@@ -30,7 +33,7 @@ class PocketIcClient {
         }
         const instanceId = res.Created.instance_id;
         const ingressMaxRetries = req?.ingressMaxRetries ?? AWAIT_INGRESS_STATUS_ROUNDS;
-        return new PocketIcClient(serverClient, `/instances/${instanceId}`, ingressMaxRetries);
+        return new PocketIcClient(serverClient, `/instances/${instanceId}`, instanceId, ingressMaxRetries);
     }
     async deleteInstance() {
         this.assertInstanceNotDeleted();
@@ -159,6 +162,37 @@ class PocketIcClient {
         }
         throw new Error(`PocketIC did not complete the update call within ${this.ingressMaxRetries} rounds`);
     }
+    async autoProgress() {
+        await this.post('/auto_progress', {
+            artificial_delay_ms: 0,
+        });
+    }
+    async autoProgressEnabled() {
+        return await this.get('/auto_progress');
+    }
+    async stopProgress() {
+        await this.post('/stop_progress', {});
+    }
+    async startHttpGateway() {
+        const res = await this.serverClient.jsonPost({
+            path: '/http_gateway',
+            body: { forward_to: { PocketIcInstance: this.instanceId } },
+        });
+        if ('Error' in res) {
+            throw new Error(res.Error.message);
+        }
+        this.httpGatewayInstanceId = res.Created.instance_id;
+        return res.Created.port;
+    }
+    async stopHttpGateway() {
+        if ((0, util_1.isNil)(this.httpGatewayInstanceId)) {
+            return;
+        }
+        await this.serverClient.jsonPost({
+            path: `/http_gateway/${this.httpGatewayInstanceId}/stop`,
+        });
+        this.httpGatewayInstanceId = null;
+    }
     async post(endpoint, body, responseJsonParser) {
         return await this.serverClient.jsonPost({
             path: `${this.instancePath}${endpoint}`,

package/dist/pocket-ic-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"pocket-ic-client.js","sourceRoot":"","sources":["../src/pocket-ic-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pocket-ic-client.js","sourceRoot":"","sources":["../src/pocket-ic-client.ts"],"names":[],"mappings":"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"}

package/dist/pocket-ic-server.js

@@ -72,7 +72,13 @@ class PocketIcServer {
             throw new error_1.BinStartError(error);
         });
         return await (0, util_1.poll)(async () => {
-            const portString = await (0, util_1.readFileAsString)(portFilePath);
+            const portString = await (0, util_1.readFileAsString)(portFilePath).catch((err) => {
+                if (err instanceof Error &&
+                    err.code === 'ENOENT') {
+                    throw new error_1.BinTimeoutError();
+                }
+                throw err;
+            });
             const port = parseInt(portString);
             if (isNaN(port)) {
                 throw new error_1.BinTimeoutError();

package/dist/pocket-ic-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"pocket-ic-server.js","sourceRoot":"","sources":["../src/pocket-ic-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pocket-ic-server.js","sourceRoot":"","sources":["../src/pocket-ic-server.ts"],"names":[],"mappings":"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"}

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

@@ -590,6 +590,93 @@ export interface UpdateCanisterSettingsOptions extends Partial<CanisterSettings>
      */
     sender?: Principal;
 }
+/**
+ * Options for querying the status of a given canister.
+ *
+ * @category Types
+ * @see [Principal](https://js.icp.build/core/latest/libs/principal/api/classes/principal/)
+ */
+export interface CanisterStatusOptions {
+    /**
+     * The Principal of the canister to query the status of.
+     */
+    canisterId: Principal;
+    /**
+     * The Principal to send the request as.
+     * Defaults to the anonymous principal.
+     */
+    sender?: Principal;
+}
+/**
+ * The status of a canister.
+ *
+ * @category Types
+ */
+export type CanisterStatus = {
+    running: null;
+} | {
+    stopping: null;
+} | {
+    stopped: null;
+};
+/**
+ * Query statistics for a canister.
+ *
+ * @category Types
+ */
+export interface CanisterQueryStats {
+    numCallsTotal: bigint;
+    numInstructionsTotal: bigint;
+    requestPayloadBytesTotal: bigint;
+    responsePayloadBytesTotal: bigint;
+}
+/**
+ * The result of querying the status of a canister.
+ * Matches the IC management canister `canister_status` response.
+ *
+ * @category Types
+ * @see [Principal](https://js.icp.build/core/latest/libs/principal/api/classes/principal/)
+ */
+export interface CanisterStatusResult {
+    /**
+     * The current status of the canister.
+     */
+    status: CanisterStatus;
+    /**
+     * The definite settings of the canister.
+     */
+    settings: {
+        controllers: Principal[];
+        computeAllocation: bigint;
+        memoryAllocation: bigint;
+        freezingThreshold: bigint;
+        reservedCyclesLimit: bigint;
+    };
+    /**
+     * The SHA-256 hash of the installed WASM module, if any.
+     */
+    moduleHash: Uint8Array | null;
+    /**
+     * The total memory size of the canister in bytes.
+     */
+    memorySize: bigint;
+    /**
+     * The current cycle balance of the canister.
+     */
+    cycles: bigint;
+    /**
+     * The reserved cycles of the canister.
+     */
+    reservedCycles: bigint;
+    /**
+     * The amount of cycles burned per day when idle.
+     */
+    idleCyclesBurnedPerDay: bigint;
+    /**
+     * Query call statistics for the canister.
+     */
+    queryStats: CanisterQueryStats;
+}
 /**
  * Options for making a query call to a given canister.
  *

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":";;;AA0OA;;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":";;;AA0OA;;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;AAigBD;;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,7 +1,7 @@
 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 { CanisterFixture, CreateCanisterOptions, CreateInstanceOptions, InstallCodeOptions, ReinstallCodeOptions, SetupCanisterOptions, UpgradeCanisterOptions, SubnetTopology, UpdateCanisterSettingsOptions, StartCanisterOptions, StopCanisterOptions, QueryCallOptions, UpdateCallOptions, PendingHttpsOutcall, MockPendingHttpsOutcallOptions, CanisterStatusOptions, CanisterStatusResult } from './pocket-ic-types';
 import { DeferredActor } from './pocket-ic-deferred-actor';
 /**
  * This class represents the main PocketIC client.
@@ -53,6 +53,7 @@ import { DeferredActor } from './pocket-ic-deferred-actor';
  */
 export declare class PocketIc {
     private readonly client;
+    private httpGatewayPort;
     private constructor();
     /**
      * Creates a PocketIC instance.
@@ -294,6 +295,31 @@ export declare class PocketIc {
      * ```
      */
     updateCanisterSettings({ canisterId, computeAllocation, controllers, freezingThreshold, memoryAllocation, reservedCyclesLimit, sender, }: UpdateCanisterSettingsOptions): Promise<void>;
+    /**
+     * Returns the status of the given canister.
+     *
+     * @param options Options for querying the canister status, see {@link CanisterStatusOptions}.
+     * @returns The canister status, see {@link CanisterStatusResult}.
+     *
+     * @see [Principal](https://js.icp.build/core/latest/libs/principal/api/classes/principal/)
+     *
+     * @example
+     * ```ts
+     * import { Principal } from '@icp-sdk/core/principal';
+     * import { PocketIc, PocketIcServer } from '@dfinity/pic';
+     *
+     * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
+     *
+     * const picServer = await PocketIcServer.start();
+     * const pic = await PocketIc.create(picServer.getUrl());
+     *
+     * const status = await pic.canisterStatus({ canisterId });
+     *
+     * await pic.tearDown();
+     * await picServer.stop();
+     * ```
+     */
+    canisterStatus({ canisterId, sender, }: CanisterStatusOptions): Promise<CanisterStatusResult>;
     /**
      * Creates an {@link Actor} for the given canister.
      * An {@link Actor} is a typesafe class that implements the Candid interface of a canister.
@@ -997,4 +1023,79 @@ export declare class PocketIc {
      * ```
      */
     mockPendingHttpsOutcall({ requestId, response, subnetId, additionalResponses, }: MockPendingHttpsOutcallOptions): Promise<void>;
+    /**
+     * Make the PocketIC instance live by enabling auto progress and starting the HTTP Gateway.
+     * If the server is already live, this method will return the HTTP Gateway URL.
+     * The PocketIC instance must be created with at least an NNS subnet in
+     * order for `fetchRootKey` to work correctly.
+     *
+     * @example
+     * ```ts
+     * import { Principal } from '@icp-sdk/core/principal';
+     * import { PocketIc, PocketIcServer } from '@dfinity/pic';
+     * import { resolve } from 'node:path';
+     *
+     * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
+     * const wasm = resolve('..', '..', 'canister.wasm');
+     *
+     * const picServer = await PocketIcServer.start();
+     * const pic = await PocketIc.create(picServer.getUrl(), {
+     *   nns: { state: { type: SubnetStateType.New } },
+     *   application: [{ state: { type: SubnetStateType.New } }],
+     * });
+     *
+     * const canister = await pic.installCode({ canisterId, wasm });
+     * await pic.installCode({ canisterId, wasm });
+     *
+     * const httpGatewayUrl = await pic.makeLive();
+     * const agent = await HttpAgent.create({
+     *   host: httpGatewayUrl,
+     *   shouldFetchRootKey: true,
+     * });
+     * const actor = Actor.createActor(idlFactory, { agent, canisterId });
+     *
+     * await pic.stopLive();
+     * await pic.tearDown();
+     * await picServer.stop();
+     * ```
+     *
+     * @returns The HTTP Gateway port.
+     */
+    makeLive(): Promise<number>;
+    /**
+     * Disables auto progress and stops the HTTP Gateway for the PocketIC instance.
+     *
+     *
+     * @example
+     * ```ts
+     * import { Principal } from '@icp-sdk/core/principal';
+     * import { PocketIc, PocketIcServer } from '@dfinity/pic';
+     * import { resolve } from 'node:path';
+     *
+     * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
+     * const wasm = resolve('..', '..', 'canister.wasm');
+     *
+     * const picServer = await PocketIcServer.start();
+     * const pic = await PocketIc.create(picServer.getUrl(), {
+     *   nns: { state: { type: SubnetStateType.New } },
+     *   application: [{ state: { type: SubnetStateType.New } }],
+     * });
+     *
+     * const canister = await pic.installCode({ canisterId, wasm });
+     * await pic.installCode({ canisterId, wasm });
+     *
+     * const httpGatewayUrl = await pic.makeLive();
+     * const agent = await HttpAgent.create({
+     *   host: httpGatewayUrl,
+     *   shouldFetchRootKey: true,
+     * });
+     * const actor = Actor.createActor(idlFactory, { agent, canisterId });
+     *
+     * await pic.stopLive();
+     * await pic.tearDown();
+     * await picServer.stop();
+     * ```
+     */
+    stopLive(): Promise<void>;
+    private installCodeChunked;
 }

package/dist/pocket-ic.js

@@ -9,6 +9,12 @@ 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);
+// The IC ingress message limit is 2 MB, but that covers the entire message
+// envelope (signature, delegations, Candid overhead, etc.).
+// We use 1.85 MB to match dfx's conservative threshold.
+const MAX_INSTALL_CODE_PAYLOAD_SIZE = 1_850_000;
+const WASM_CHUNK_SIZE = 1_000_000;
+const CHUNK_UPLOAD_BATCH_SIZE = 12;
 /**
  * This class represents the main PocketIC client.
  * It is responsible for interacting with the PocketIC server via the REST API.
@@ -59,6 +65,7 @@ const NANOS_PER_MILLISECOND = BigInt(1_000_000);
  */
 class PocketIc {
     client;
+    httpGatewayPort = null;
     constructor(client) {
         this.client = client;
     }
@@ -294,6 +301,16 @@ class PocketIc {
         if (typeof wasm === 'string') {
             wasm = await (0, util_1.readFileAsBytes)(wasm);
         }
+        if (wasm.byteLength + arg.byteLength > MAX_INSTALL_CODE_PAYLOAD_SIZE) {
+            return this.installCodeChunked({
+                wasm,
+                arg,
+                canisterId,
+                mode: { install: null },
+                sender,
+                targetSubnetId,
+            });
+        }
         const payload = (0, management_canister_1.encodeInstallCodeRequest)({
             arg: new Uint8Array(arg),
             canister_id: canisterId,
@@ -346,6 +363,15 @@ class PocketIc {
         if (typeof wasm === 'string') {
             wasm = await (0, util_1.readFileAsBytes)(wasm);
         }
+        if (wasm.byteLength + arg.byteLength > MAX_INSTALL_CODE_PAYLOAD_SIZE) {
+            return this.installCodeChunked({
+                wasm,
+                arg,
+                canisterId,
+                mode: { reinstall: null },
+                sender,
+            });
+        }
         const payload = (0, management_canister_1.encodeInstallCodeRequest)({
             arg: new Uint8Array(arg),
             canister_id: canisterId,
@@ -393,6 +419,15 @@ class PocketIc {
         if (typeof wasm === 'string') {
             wasm = await (0, util_1.readFileAsBytes)(wasm);
         }
+        if (wasm.byteLength + arg.byteLength > MAX_INSTALL_CODE_PAYLOAD_SIZE) {
+            return this.installCodeChunked({
+                wasm,
+                arg,
+                canisterId,
+                mode: { upgrade: (0, util_1.optional)(upgradeModeOptions) },
+                sender,
+            });
+        }
         const payload = (0, management_canister_1.encodeInstallCodeRequest)({
             arg: new Uint8Array(arg),
             canister_id: canisterId,
@@ -452,6 +487,63 @@ class PocketIc {
             payload,
         });
     }
+    /**
+     * Returns the status of the given canister.
+     *
+     * @param options Options for querying the canister status, see {@link CanisterStatusOptions}.
+     * @returns The canister status, see {@link CanisterStatusResult}.
+     *
+     * @see [Principal](https://js.icp.build/core/latest/libs/principal/api/classes/principal/)
+     *
+     * @example
+     * ```ts
+     * import { Principal } from '@icp-sdk/core/principal';
+     * import { PocketIc, PocketIcServer } from '@dfinity/pic';
+     *
+     * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
+     *
+     * const picServer = await PocketIcServer.start();
+     * const pic = await PocketIc.create(picServer.getUrl());
+     *
+     * const status = await pic.canisterStatus({ canisterId });
+     *
+     * await pic.tearDown();
+     * await picServer.stop();
+     * ```
+     */
+    async canisterStatus({ canisterId, sender = principal_1.Principal.anonymous(), }) {
+        const payload = (0, management_canister_1.encodeCanisterStatusRequest)({
+            canister_id: canisterId,
+        });
+        const res = await this.client.updateCall({
+            canisterId: management_canister_1.MANAGEMENT_CANISTER_ID,
+            sender,
+            method: 'canister_status',
+            payload,
+        });
+        const response = (0, management_canister_1.decodeCanisterStatusResponse)(res.body);
+        return {
+            status: response.status,
+            settings: {
+                controllers: response.settings.controllers,
+                computeAllocation: response.settings.compute_allocation,
+                memoryAllocation: response.settings.memory_allocation,
+                freezingThreshold: response.settings.freezing_threshold,
+                reservedCyclesLimit: response.settings.reserved_cycles_limit,
+            },
+            moduleHash: response.module_hash[0] ?? null,
+            memorySize: response.memory_size,
+            cycles: response.cycles,
+            reservedCycles: response.reserved_cycles,
+            idleCyclesBurnedPerDay: response.idle_cycles_burned_per_day,
+            queryStats: {
+                numCallsTotal: response.query_stats.num_calls_total,
+                numInstructionsTotal: response.query_stats.num_instructions_total,
+                requestPayloadBytesTotal: response.query_stats.request_payload_bytes_total,
+                responsePayloadBytesTotal: response.query_stats.response_payload_bytes_total,
+            },
+        };
+    }
     /**
      * Creates an {@link Actor} for the given canister.
      * An {@link Actor} is a typesafe class that implements the Candid interface of a canister.
@@ -1276,6 +1368,149 @@ class PocketIc {
             additionalResponses,
         });
     }
+    /**
+     * Make the PocketIC instance live by enabling auto progress and starting the HTTP Gateway.
+     * If the server is already live, this method will return the HTTP Gateway URL.
+     * The PocketIC instance must be created with at least an NNS subnet in
+     * order for `fetchRootKey` to work correctly.
+     *
+     * @example
+     * ```ts
+     * import { Principal } from '@icp-sdk/core/principal';
+     * import { PocketIc, PocketIcServer } from '@dfinity/pic';
+     * import { resolve } from 'node:path';
+     *
+     * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
+     * const wasm = resolve('..', '..', 'canister.wasm');
+     *
+     * const picServer = await PocketIcServer.start();
+     * const pic = await PocketIc.create(picServer.getUrl(), {
+     *   nns: { state: { type: SubnetStateType.New } },
+     *   application: [{ state: { type: SubnetStateType.New } }],
+     * });
+     *
+     * const canister = await pic.installCode({ canisterId, wasm });
+     * await pic.installCode({ canisterId, wasm });
+     *
+     * const httpGatewayUrl = await pic.makeLive();
+     * const agent = await HttpAgent.create({
+     *   host: httpGatewayUrl,
+     *   shouldFetchRootKey: true,
+     * });
+     * const actor = Actor.createActor(idlFactory, { agent, canisterId });
+     *
+     * await pic.stopLive();
+     * await pic.tearDown();
+     * await picServer.stop();
+     * ```
+     *
+     * @returns The HTTP Gateway port.
+     */
+    async makeLive() {
+        const isLive = await this.client.autoProgressEnabled();
+        if (isLive) {
+            if ((0, util_1.isNil)(this.httpGatewayPort)) {
+                throw new Error('Inconsistent state, PocketIC server is live but no HTTP Gateway URL is known');
+            }
+            return this.httpGatewayPort;
+        }
+        await this.client.autoProgress();
+        this.httpGatewayPort = await this.client.startHttpGateway();
+        return this.httpGatewayPort;
+    }
+    /**
+     * Disables auto progress and stops the HTTP Gateway for the PocketIC instance.
+     *
+     *
+     * @example
+     * ```ts
+     * import { Principal } from '@icp-sdk/core/principal';
+     * import { PocketIc, PocketIcServer } from '@dfinity/pic';
+     * import { resolve } from 'node:path';
+     *
+     * const canisterId = Principal.fromUint8Array(new Uint8Array([0]));
+     * const wasm = resolve('..', '..', 'canister.wasm');
+     *
+     * const picServer = await PocketIcServer.start();
+     * const pic = await PocketIc.create(picServer.getUrl(), {
+     *   nns: { state: { type: SubnetStateType.New } },
+     *   application: [{ state: { type: SubnetStateType.New } }],
+     * });
+     *
+     * const canister = await pic.installCode({ canisterId, wasm });
+     * await pic.installCode({ canisterId, wasm });
+     *
+     * const httpGatewayUrl = await pic.makeLive();
+     * const agent = await HttpAgent.create({
+     *   host: httpGatewayUrl,
+     *   shouldFetchRootKey: true,
+     * });
+     * const actor = Actor.createActor(idlFactory, { agent, canisterId });
+     *
+     * await pic.stopLive();
+     * await pic.tearDown();
+     * await picServer.stop();
+     * ```
+     */
+    async stopLive() {
+        this.httpGatewayPort = null;
+        await this.client.stopHttpGateway();
+        await this.client.stopProgress();
+    }
+    async installCodeChunked({ wasm, arg, canisterId, mode, sender, targetSubnetId, }) {
+        const effectivePrincipal = targetSubnetId
+            ? { subnetId: targetSubnetId }
+            : { canisterId };
+        const clearChunkStoreRequestPayload = (0, management_canister_1.encodeClearChunkStoreRequest)({
+            canister_id: canisterId,
+        });
+        // 1. Clear existing chunk store
+        await this.client.updateCall({
+            canisterId: management_canister_1.MANAGEMENT_CANISTER_ID,
+            sender,
+            method: 'clear_chunk_store',
+            payload: clearChunkStoreRequestPayload,
+            effectivePrincipal,
+        });
+        // 2. Split WASM into chunks and upload in parallel batches
+        const chunks = (0, util_1.splitIntoChunks)(wasm, WASM_CHUNK_SIZE);
+        const chunkHashes = [];
+        for (let i = 0; i < chunks.length; i += CHUNK_UPLOAD_BATCH_SIZE) {
+            const batch = chunks.slice(i, i + CHUNK_UPLOAD_BATCH_SIZE);
+            const chunkHashResponses = await Promise.all(batch.map(async (chunk) => {
+                const uploadChunkRequestPayload = (0, management_canister_1.encodeUploadChunkRequest)({
+                    canister_id: canisterId,
+                    chunk,
+                });
+                const response = await this.client.updateCall({
+                    canisterId: management_canister_1.MANAGEMENT_CANISTER_ID,
+                    sender,
+                    method: 'upload_chunk',
+                    payload: uploadChunkRequestPayload,
+                    effectivePrincipal,
+                });
+                return (0, management_canister_1.decodeUploadChunkResponse)(response.body);
+            }));
+            chunkHashes.push(...chunkHashResponses);
+        }
+        // 3. Install the chunked code
+        const installChunkedCodePayload = (0, management_canister_1.encodeInstallChunkedCodeRequest)({
+            mode,
+            target_canister: canisterId,
+            store_canister: [],
+            chunk_hashes_list: chunkHashes,
+            wasm_module_hash: (0, util_1.sha256)(wasm),
+            arg,
+            sender_canister_version: [],
+        });
+        await this.client.updateCall({
+            canisterId: management_canister_1.MANAGEMENT_CANISTER_ID,
+            sender,
+            method: 'install_chunked_code',
+            payload: installChunkedCodePayload,
+            effectivePrincipal,
+        });
+    }
 }
 exports.PocketIc = PocketIc;
 //# sourceMappingURL=pocket-ic.js.map