@dfinity/utils v4.0.3

What's changed

Patch release for @dfinity/utils@4.0.3 — backports the toBase64 chunk-loss fix and performance improvement from v96 to the v4.0.x line.

• fix(utils): uint8ArrayToBase64 loses data on large Uint8Array inputs (#1485)
• feat(utils): chunked conversion for better performance (#1487)

Details

See tracking PR #1495 and branch release/v89/patch-1.

npm: npm install @dfinity/utils@4.0.3

v96

Overview

Library	Version	Status
@dfinity/utils	v4.2.1	Maintained ⚙

Fix

• Avoid loss of chunks in util toBase64 of @dfinity/utils when the input is a large Uint8Array.

v95

Overview

Library	Version	Status
@icp-sdk/canisters	v3.5.2	Maintained ⚙
@dfinity/zod-schemas	v3.2.0	Enhanced 🔧️

Features

• Add Option, Nullable and Nullish types to Zod library.
• Add Result schema and type to Zod library which allows for representing type with a success or error state.
• Update latest Candid files.

Chore

• Bump Node version to v25 to use npm@11.10.
• Update actions/checkout@6.0.2.
• Update weekly IC workflow ref.

v94

Overview

Library	Version	Status
@icp-sdk/canisters	v3.5.1	Maintained ⚙
@dfinity/utils	v4.2.0	Enhanced 🔧️
@dfinity/zod-schemas	v3.1.0	Enhanced 🔧️

Features

• Add PrincipalSchema and Uint8ArraySchema to Zod custom schemas.
• Identify schemas with a metadata id corresponding to the enum ZodSchemaId.
• Update latest Candid files.
• Service queryAndUpdate will print the update error to console only when onUpdateError callback is nullish.

v93

Overview

Library	Version	Status
@icp-sdk/canisters	v3.5.0	Enhanced 🔧️

Features

• Update to the latest Candid file for the nns package to introduce support for the new proposal types TakeCanisterSnapshot and LoadCanisterSnapshot.
• Support selfDescribingAction field in Governance proposals.

v92

Overview

Library	Version	Status
@icp-sdk/canisters	v3.4.0	Enhanced 🔧️

Features

• Add support for notifyMintCycles to mint cycles and deposit them to a cycles ledger account via the CMC.
• Update to the latest Candid file for the nns package to introduce support for the new proposal type BlessAlternativeGuestOsVersion.

v91

Overview

Library	Version	Status
@icp-sdk/canisters	v3.3.0	Enhanced 🔧️
@dfinity/ckbtc	v7.1.0	Unchanged️
@dfinity/cketh	v7.1.0	Unchanged️
@dfinity/cmc	v9.1.0	Unchanged️
@dfinity/ic-management	v10.1.0	Unchanged️
@dfinity/ledger-icp	v9.1.0	Unchanged️
@dfinity/ledger-icrc	v7.1.0	Unchanged️
@dfinity/nns	v12.1.0	Unchanged️
@dfinity/nns-proto	v2.0.4	Unchanged️
@dfinity/sns	v7.1.0	Unchanged️
@dfinity/utils	v4.1.0	Unchanged️
@dfinity/zod-schemas	v3.0.2	Unchanged️

Features

• Add new CyclesLedgerCanister to @icp-sdk/canisters with withdraw method to transfer cycles from the ledger to a target canister.
• Update to the latest Candid files.

v90

Overview

Library	Version	Status
@icp-sdk/canisters	v3.2.0	Maintained ⚙
@dfinity/ckbtc	v7.1.0	Maintained ⚙
@dfinity/cketh	v7.1.0	Maintained ⚙
@dfinity/cmc	v9.1.0	Maintained ⚙
@dfinity/ic-management	v10.1.0	Enhanced 🔧️
@dfinity/ledger-icp	v9.1.0	Maintained ⚙
@dfinity/ledger-icrc	v7.1.0	Maintained ⚙
@dfinity/nns	v12.1.0	Maintained ⚙
@dfinity/nns-proto	v2.0.4	Unchanged️
@dfinity/sns	v7.1.0	Maintained ⚙
@dfinity/utils	v4.1.0	Maintained ⚙
@dfinity/zod-schemas	v3.0.2	Unchanged️

Features

• Add new optional parameters uninstallCode and senderCanisterVersion to takeCanisterSnapshot.
• Update to the latest Candid files.

Build

• Upgrade @icp-sdk/core to v5.

Chore

• Bump @icp-sdk/bindgen for generating IDL files.
• Set the workspace to ignore-scripts=true to disallow npm from running scripts.
• Remove explicit dependencies from integration tests and run those only on asset changes.

v89

Overview

Library	Version	Status
@icp-sdk/canisters	v3.1.0	Enhanced 🔧️
@dfinity/ckbtc	v7.0.0	Unchanged️
@dfinity/cketh	v7.0.0	Unchanged️
@dfinity/cmc	v9.0.0	Unchanged️
@dfinity/ic-management	v10.0.0	Unchanged️
@dfinity/ledger-icp	v9.0.0	Unchanged️
@dfinity/ledger-icrc	v7.0.0	Unchanged️
@dfinity/nns	v12.0.0	Unchanged️
@dfinity/nns-proto	v2.0.4	Unchanged️
@dfinity/sns	v7.0.0	Unchanged️
@dfinity/utils	v4.0.2	Unchanged️
@dfinity/zod-schemas	v3.0.2	Unchanged️

Features

• The @dfinity/assets library has been deprecated. Its functionality has been integrated into @icp-sdk/canisters.

v88

Overview

Library	Version	Status
@icp-sdk/canisters	v3.0.0	Breaking Changes ⚠️
@dfinity/ckbtc	v7.0.0	Enhanced 🔧️
@dfinity/cketh	v7.0.0	Enhanced 🔧️
@dfinity/cmc	v9.0.0	Enhanced 🔧️
@dfinity/ic-management	v10.0.0	Enhanced 🔧️
@dfinity/ledger-icp	v9.0.0	Enhanced 🔧️
@dfinity/ledger-icrc	v7.0.0	Breaking Changes ⚠️
@dfinity/nns	v12.0.0	Enhanced 🔧️
@dfinity/nns-proto	v2.0.4	Unchanged️
@dfinity/sns	v7.0.0	Enhanced 🔧️
@dfinity/utils	v4.0.2	Maintained ⚙
@dfinity/zod-schemas	v3.0.2	Maintained ⚙

Breaking Changes

• The types for declarations of the canisters generated to describe the interfaces on the Internet Computer (Candid) are now re-exported through namespaces.

For example, the Tokens type of the IcrcLedgerCanister is available within the related namespace IcrcLedgerDid.

import {
  type IcrcLedgerDid,
  IcrcLedgerCanister,
} from "@icp-sdk/canisters/ledger/icrc";

const { balance } = IcrcLedgerCanister.create({
  agent,
  canisterId,
});

const data: IcrcLedgerDid.Tokens = await balance({ owner });

• The following canisters have been renamed for consistency and readability:

Old	New 🆕
CkBTCMinterCanister	CkBtcMinterCanister
CkETHMinterCanister	CkEthMinterCanister
CkETHOrchestratorCanister	CkEthOrchestratorCanister
CMCCanister	CmcCanister
ICManagementCanister	IcManagementCanister
LedgerCanister	IcpLedgerCanister
IndexCanister	IcpIndexCanister
GenesisTokenCanister	NnsGenesisTokenCanister
GovernanceCanister	NnsGovernanceCanister
GovernanceTestCanister	NnsGovernanceTestCanister

• The deprecated implementation of the ICRC Index canister has been deleted, and its common implementation becomes the new standard.

In other words, IcrcIndexNgCanister becomes IcrcIndexCanister.

Old	New 🆕
IcrcIndexCanister	---
IcrcIndexNgCanister	IcrcIndexCanister

Features

• New class IcrcNftLedgerCanister to interface with ICRC-7 standards.
• Add method collectionMetadata in class IcrcNftLedgerCanister to fetch a collection's metadata.