Skip to content

CreateCanisterOptions

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

Options for creating a canister.

Principal

optional computeAllocation: bigint

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

The compute allocation of the canister.

CanisterSettings.computeAllocation


optional controllers: Principal[]

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

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

CanisterSettings.controllers


optional cycles: bigint

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

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


optional environmentVariables: EnvironmentVariable[]

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

Environment variables exposed to the canister.

CanisterSettings.environmentVariables


optional freezingThreshold: bigint

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

The freezing threshold of the canister.

CanisterSettings.freezingThreshold


optional logVisibility: LogVisibility

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

The log visibility of the canister.

CanisterSettings.logVisibility


optional memoryAllocation: bigint

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

The memory allocation of the canister.

CanisterSettings.memoryAllocation


optional reservedCyclesLimit: bigint

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

The reserved cycles limit of the canister.

CanisterSettings.reservedCyclesLimit


optional sender: Principal

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

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


optional targetCanisterId: Principal

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

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


optional targetSubnetId: Principal

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

The Id of the subnet to create the canister on.


optional wasmMemoryLimit: bigint

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

The WASM memory limit of the canister in bytes.

CanisterSettings.wasmMemoryLimit


optional wasmMemoryThreshold: bigint

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

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.

CanisterSettings.wasmMemoryThreshold