@dfinity/ic-management v5.2.3
ic-management-js
A library for interfacing with the Internet Computer (IC) management canister.
Table of contents
Installation
You can use ic-management-js
by installing it in your project.
npm i @dfinity/ic-management
The bundle needs peer dependencies, be sure that following resources are available in your project as well.
npm i @dfinity/agent @dfinity/candid @dfinity/principal @dfinity/utils
Usage
The features are available through the class ICMgmtCanister
. It has to be instantiated with a canister ID.
e.g. fetching a token metadata.
import { ICManagementCanister } from "@dfinity/ic-management";
import { createAgent } from "@dfinity/utils";
const agent = await createAgent({
identity,
host: HOST,
});
const { canisterStatus } = ICManagementCanister.create({
agent,
});
const { status, memory_size, ...rest } = await canisterStatus(YOUR_CANISTER_ID);
Features
ic-management-js
implements following features:
:factory: ICManagementCanister
Methods
- create
- createCanister
- updateSettings
- installCode
- uploadChunk
- clearChunkStore
- storedChunks
- installChunkedCode
- uninstallCode
- startCanister
- stopCanister
- canisterStatus
- deleteCanister
- provisionalCreateCanisterWithCycles
:gear: create
Method | Type |
---|---|
create | (options: ICManagementCanisterOptions) => ICManagementCanister |
:gear: createCanister
Create a new canister
Method | Type |
---|---|
createCanister | ({ settings, senderCanisterVersion, }?: CreateCanisterParams) => Promise<Principal> |
:gear: updateSettings
Update canister settings
Method | Type |
---|---|
updateSettings | ({ canisterId, senderCanisterVersion, settings, }: UpdateSettingsParams) => Promise<void> |
:gear: installCode
Install code to a canister
Method | Type |
---|---|
installCode | ({ mode, canisterId, wasmModule, arg, senderCanisterVersion, }: InstallCodeParams) => Promise<void> |
:gear: uploadChunk
Upload chunks of Wasm modules that are too large to fit in a single message for installation purposes.
Method | Type |
---|---|
uploadChunk | ({ canisterId, ...rest }: UploadChunkParams) => Promise<chunk_hash> |
Parameters:
params.canisterId
: The canister in which the chunks will be stored.params.chunk
: A chunk of Wasm module.
:gear: clearChunkStore
Clear the entire chunk storage of a canister.
Method | Type |
---|---|
clearChunkStore | ({ canisterId, }: ClearChunkStoreParams) => Promise<void> |
Parameters:
params.canisterId
: The canister in which the chunks are stored.
:gear: storedChunks
List the hashes of chunks in the chunk storage of a canister.
Method | Type |
---|---|
storedChunks | ({ canisterId, }: StoredChunksParams) => Promise<chunk_hash[]> |
Parameters:
params.canisterId
: The canister in which the chunks are stored.
:gear: installChunkedCode
Installs code that had previously been uploaded in chunks.
Method | Type |
---|---|
installChunkedCode | ({ mode, arg, senderCanisterVersion, chunkHashesList, targetCanisterId, storeCanisterId, wasmModuleHash, }: InstallChunkedCodeParams) => Promise<void> |
Parameters:
params.mode
: Installation, re-installation or upgrade.params.arg
: The arguments of the canister.params.senderCanisterVersion
: The optional sender_canister_version parameter can contain the caller's canister version.params.chunkHashesList
: The list of chunks of the Wasm module to install.params.targetCanisterId
: Specifies the canister where the code should be installed.params.storeCanisterId
: Specifies the canister in whose chunk storage the chunks are stored (this parameter defaults to target_canister if not specified).params.wasmModuleHash
: The Wasm module hash as hex string. Used to check that the SHA-256 hash of wasm_module is equal to the wasm_module_hash parameter and can calls install_code with parameters.
:gear: uninstallCode
Uninstall code from a canister
Method | Type |
---|---|
uninstallCode | ({ canisterId, senderCanisterVersion, }: UninstallCodeParams) => Promise<void> |
:gear: startCanister
Start a canister
Method | Type |
---|---|
startCanister | (canisterId: Principal) => Promise<void> |
:gear: stopCanister
Stop a canister
Method | Type |
---|---|
stopCanister | (canisterId: Principal) => Promise<void> |
:gear: canisterStatus
Get canister details (memory size, status, etc.)
Method | Type |
---|---|
canisterStatus | (canisterId: Principal) => Promise<canister_status_result> |
:gear: deleteCanister
Deletes a canister
Method | Type |
---|---|
deleteCanister | (canisterId: Principal) => Promise<void> |
:gear: provisionalCreateCanisterWithCycles
Creates a canister. Only available on development instances.
Method | Type |
---|---|
provisionalCreateCanisterWithCycles | ({ settings, amount, canisterId, }?: ProvisionalCreateCanisterWithCyclesParams) => Promise<Principal> |
Resources
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
10 months ago
10 months ago
9 months ago
9 months ago
9 months ago
9 months ago
10 months ago
10 months ago
9 months ago
1 year ago
12 months ago
10 months ago
10 months ago
10 months ago
12 months ago
10 months ago
11 months ago
11 months ago
11 months ago
12 months ago
10 months ago
1 year ago
1 year ago
11 months ago
11 months ago
11 months ago
11 months ago
1 year ago
11 months ago
11 months ago
12 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
11 months ago
1 year ago
1 year ago
1 year ago
1 year ago
12 months ago
1 year ago
1 year ago
1 year ago
10 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
11 months ago
11 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago