A library for interfacing with the Internet Computer (IC) management canister.
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
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);
ic-management-js
implements following features:
- create
- createCanister
- updateSettings
- installCode
- uploadChunk
- clearChunkStore
- storedChunks
- installChunkedCode
- uninstallCode
- startCanister
- stopCanister
- canisterStatus
- canisterInfo
- deleteCanister
- provisionalCreateCanisterWithCycles
- bitcoinGetUtxos
- bitcoinGetUtxosQuery
Method | Type |
---|---|
create |
(options: ICManagementCanisterOptions) => ICManagementCanister |
Create a new canister
Method | Type |
---|---|
createCanister |
({ settings, senderCanisterVersion, }?: CreateCanisterParams) => Promise<Principal> |
Update canister settings
Method | Type |
---|---|
updateSettings |
({ canisterId, senderCanisterVersion, settings, }: UpdateSettingsParams) => Promise<void> |
Install code to a canister
Method | Type |
---|---|
installCode |
({ mode, canisterId, wasmModule, arg, senderCanisterVersion, }: InstallCodeParams) => Promise<void> |
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.
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.
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.
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.
Uninstall code from a canister
Method | Type |
---|---|
uninstallCode |
({ canisterId, senderCanisterVersion, }: UninstallCodeParams) => Promise<void> |
Start a canister
Method | Type |
---|---|
startCanister |
(canisterId: Principal) => Promise<void> |
Stop a canister
Method | Type |
---|---|
stopCanister |
(canisterId: Principal) => Promise<void> |
Get canister details (memory size, status, etc.)
Method | Type |
---|---|
canisterStatus |
(canisterId: Principal) => Promise<canister_status_result> |
Get canister info (controllers, module hash, changes, etc.)
Method | Type |
---|---|
canisterInfo |
({ canisterId, numRequestChanges, }: CanisterInfoParams) => Promise<canister_info_result> |
Deletes a canister
Method | Type |
---|---|
deleteCanister |
(canisterId: Principal) => Promise<void> |
Creates a canister. Only available on development instances.
Method | Type |
---|---|
provisionalCreateCanisterWithCycles |
({ settings, amount, canisterId, }?: ProvisionalCreateCanisterWithCyclesParams) => Promise<Principal> |
Given a get_utxos_request
, which must specify a Bitcoin address and a Bitcoin network (mainnet
or testnet
), the function returns all unspent transaction outputs (UTXOs) associated with the provided address in the specified Bitcoin network based on the current view of the Bitcoin blockchain available to the Bitcoin component.
Method | Type |
---|---|
bitcoinGetUtxos |
(params: BitcoinGetUtxosParams) => Promise<bitcoin_get_utxos_result> |
Parameters:
-
params.network
: Tesnet or mainnet. -
params.filter
: The optional filter parameter can be used to restrict the set of returned UTXOs, either providing a minimum number of confirmations or a page reference when pagination is used for addresses with many UTXOs. -
params.address
: A Bitcoin address.
This method is identical to bitcoinGetUtxos
, but exposed as a query.
Method | Type |
---|---|
bitcoinGetUtxosQuery |
(params: BitcoinGetUtxosQueryParams) => Promise<bitcoin_get_utxos_query_result> |
Parameters:
-
params.network
: Tesnet or mainnet. -
params.filter
: The optional filter parameter can be used to restrict the set of returned UTXOs, either providing a minimum number of confirmations or a page reference when pagination is used for addresses with many UTXOs. -
params.address
: A Bitcoin address.