Skip to content

CreateCanisterOptions

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

Options for creating a canister.

Principal

optional computeAllocation: bigint

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

The compute allocation of the canister.

CanisterSettings.computeAllocation


optional controllers: Principal[]

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

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:838

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:824

Environment variables exposed to the canister.

CanisterSettings.environmentVariables


optional freezingThreshold: bigint

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

The freezing threshold of the canister.

CanisterSettings.freezingThreshold


optional logMemoryLimit: bigint

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

The log memory limit of the canister in bytes.

CanisterSettings.logMemoryLimit


optional logVisibility: LogVisibility

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

Who can read the canister’s logs. Defaults to its controllers.

CanisterSettings.logVisibility


optional memoryAllocation: bigint

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

The memory allocation of the canister.

CanisterSettings.memoryAllocation


optional minimumIncomingCanisterCallCycles: bigint

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

The minimum cycles that calls from other canisters must attach. Calls attaching fewer cycles are rejected and refunded. Ingress messages and calls from the canister itself are not affected.

CanisterSettings.minimumIncomingCanisterCallCycles


optional reservedCyclesLimit: bigint

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

The reserved cycles limit of the canister.

CanisterSettings.reservedCyclesLimit


optional sender: Principal

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

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


optional snapshotVisibility: SnapshotVisibility

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

Who can list and read the canister’s snapshots. Defaults to its controllers.

CanisterSettings.snapshotVisibility


optional statusVisibility: StatusVisibility

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

Who can read the canister’s status. Defaults to its controllers. The canister itself can always read it.

CanisterSettings.statusVisibility


optional targetCanisterId: Principal

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

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:849

The Id of the subnet to create the canister on.


optional wasmMemoryLimit: bigint

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

The WASM memory limit of the canister in bytes.

CanisterSettings.wasmMemoryLimit


optional wasmMemoryThreshold: bigint

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

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