Skip to content

SetupCanisterOptions

Defined in: packages/pic/src/pocket-ic-types.ts:417

Options for setting up a canister.

optional arg: Uint8Array<ArrayBufferLike>

Defined in: packages/pic/src/pocket-ic-types.ts:434

Candid encoded argument to pass to the canister’s init function. Defaults to an empty Uint8Array.


optional computeAllocation: bigint

Defined in: packages/pic/src/pocket-ic-types.ts:510

The compute allocation of the canister.

CreateCanisterOptions.computeAllocation


optional controllers: Principal[]

Defined in: packages/pic/src/pocket-ic-types.ts:505

The controllers of the canister. Defaults to the sender, which defaults to the anonymous principal.

CreateCanisterOptions.controllers


optional cycles: bigint

Defined in: packages/pic/src/pocket-ic-types.ts:570

The amount of cycles to send to the canister. Defaults to 1_000_000_000_000_000_000n.

CreateCanisterOptions.cycles


optional environmentVariables: EnvironmentVariable[]

Defined in: packages/pic/src/pocket-ic-types.ts:556

Environment variables exposed to the canister.

CreateCanisterOptions.environmentVariables


optional freezingThreshold: bigint

Defined in: packages/pic/src/pocket-ic-types.ts:520

The freezing threshold of the canister.

CreateCanisterOptions.freezingThreshold


idlFactory: InterfaceFactory

Defined in: packages/pic/src/pocket-ic-types.ts:421

The interface factory to use for the Actor.


optional logMemoryLimit: bigint

Defined in: packages/pic/src/pocket-ic-types.ts:540

The log memory limit of the canister in bytes.

CreateCanisterOptions.logMemoryLimit


optional logVisibility: LogVisibility

Defined in: packages/pic/src/pocket-ic-types.ts:530

The log visibility of the canister.

CreateCanisterOptions.logVisibility


optional memoryAllocation: bigint

Defined in: packages/pic/src/pocket-ic-types.ts:515

The memory allocation of the canister.

CreateCanisterOptions.memoryAllocation


optional reservedCyclesLimit: bigint

Defined in: packages/pic/src/pocket-ic-types.ts:525

The reserved cycles limit of the canister.

CreateCanisterOptions.reservedCyclesLimit


optional sender: Principal

Defined in: packages/pic/src/pocket-ic-types.ts:440

The principal to setup the canister as. Defaults to the anonymous principal.

CreateCanisterOptions.sender


optional snapshotVisibility: SnapshotVisibility

Defined in: packages/pic/src/pocket-ic-types.ts:535

The snapshot visibility of the canister.

CreateCanisterOptions.snapshotVisibility


optional targetCanisterId: Principal

Defined in: packages/pic/src/pocket-ic-types.ts:587

The Id of the canister to create. Can only be used on Bitcoin, Fiduciary, II, SNS and NNS subnets.

CreateCanisterOptions.targetCanisterId


optional targetSubnetId: Principal

Defined in: packages/pic/src/pocket-ic-types.ts:581

The Id of the subnet to create the canister on.

CreateCanisterOptions.targetSubnetId


wasm: string | Uint8Array<ArrayBufferLike>

Defined in: packages/pic/src/pocket-ic-types.ts:428

The WASM module to install to the canister. If a string is passed, it is treated as a path to a file. If an Uint8Array is passed, it is treated as the WASM module itself.


optional wasmMemoryLimit: bigint

Defined in: packages/pic/src/pocket-ic-types.ts:545

The WASM memory limit of the canister in bytes.

CreateCanisterOptions.wasmMemoryLimit


optional wasmMemoryThreshold: bigint

Defined in: packages/pic/src/pocket-ic-types.ts:551

The WASM memory threshold of the canister in bytes. The canister_on_low_wasm_memory function will be called when the canister’s remaining wasm memory is below this threshold.

CreateCanisterOptions.wasmMemoryThreshold