Skip to content

UpdateCanisterSettingsOptions

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

Options for updating the settings of a given canister.

Principal

canisterId: Principal

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

The Principal of the canister to update the settings for.


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

The Principal to send the request 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 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