@dfinity/ledger-icrc 6.0.1-next-2025-11-26 → 6.0.1

package/dist/ledger.canister.d.ts

@@ -1,11 +1,10 @@
-import { type Nullable, type QueryParams } from "@dfinity/utils";
+import { Canister, type Nullable, type QueryParams } from "@dfinity/utils";
 import type { Principal } from "@icp-sdk/core/principal";
 import type { Account, Allowance, BlockIndex, GetBlocksResult, icrc21_consent_info, _SERVICE as IcrcLedgerService, StandardRecord, Tokens } from "./candid/icrc_ledger";
-import { IcrcCanister } from "./canister";
 import type { IcrcLedgerCanisterOptions } from "./types/canister.options";
-import type { AllowanceParams, ApproveParams, GetBlocksParams, Icrc21ConsentMessageParams, TransferFromParams, TransferParams } from "./types/ledger.params";
+import type { AllowanceParams, ApproveParams, BalanceParams, GetBlocksParams, Icrc21ConsentMessageParams, TransferFromParams, TransferParams } from "./types/ledger.params";
 import type { IcrcTokenMetadataResponse } from "./types/ledger.responses";
-export declare class IcrcLedgerCanister extends IcrcCanister<IcrcLedgerService> {
+export declare class IcrcLedgerCanister extends Canister<IcrcLedgerService> {
     static create(options: IcrcLedgerCanisterOptions<IcrcLedgerService>): IcrcLedgerCanister;
     /**
      * The token metadata (name, symbol, etc.).
@@ -17,6 +16,13 @@ export declare class IcrcLedgerCanister extends IcrcCanister<IcrcLedgerService>
      * @returns {Tokens} The ledger transaction fees in Tokens
      */
     transactionFee: (params: QueryParams) => Promise<Tokens>;
+    /**
+     * Returns the balance for a given account provided as owner and with optional subaccount.
+     *
+     * @param {BalanceParams} params The parameters to get the balance of an account.
+     * @returns {Promise<Tokens>} The balance of the given account.
+     */
+    balance: (params: BalanceParams) => Promise<Tokens>;
     /**
      * Transfers tokens from the sender to the given account.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dfinity/ledger-icrc",
-  "version": "6.0.1-next-2025-11-26",
+  "version": "6.0.1",
   "description": "A library for interfacing with ICRC ledgers on the Internet Computer.",
   "license": "Apache-2.0",
   "type": "module",
@@ -50,7 +50,7 @@
   ],
   "homepage": "https://github.com/dfinity/icp-js-canisters#readme",
   "peerDependencies": {
-    "@dfinity/utils": "next",
-    "@icp-sdk/core": "*"
+    "@dfinity/utils": "^4",
+    "@icp-sdk/core": "^4"
   }
-}
+}

package/dist/candid/icrc_icrc-1.certified.idl.d.ts

@@ -1,2 +0,0 @@
-import type { IDL } from "@icp-sdk/core/candid";
-export const idlFactory: IDL.InterfaceFactory;

package/dist/candid/icrc_icrc-1.certified.idl.js

@@ -1,68 +0,0 @@
-/* eslint-disable */
-
-// @ts-nocheck
-
-// This file was automatically generated by @icp-sdk/bindgen@0.2.0.
-// You should NOT make any changes in this file as it will be overwritten.
-// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
-
-export const idlFactory = ({ IDL }) => {
-  const Subaccount = IDL.Vec(IDL.Nat8);
-  const Account = IDL.Record({
-    owner: IDL.Principal,
-    subaccount: IDL.Opt(Subaccount),
-  });
-  const Value = IDL.Variant({
-    Int: IDL.Int,
-    Nat: IDL.Nat,
-    Blob: IDL.Vec(IDL.Nat8),
-    Text: IDL.Text,
-  });
-  const Timestamp = IDL.Nat64;
-  const TransferArgs = IDL.Record({
-    to: Account,
-    fee: IDL.Opt(IDL.Nat),
-    memo: IDL.Opt(IDL.Vec(IDL.Nat8)),
-    from_subaccount: IDL.Opt(Subaccount),
-    created_at_time: IDL.Opt(Timestamp),
-    amount: IDL.Nat,
-  });
-  const TransferError = IDL.Variant({
-    GenericError: IDL.Record({
-      message: IDL.Text,
-      error_code: IDL.Nat,
-    }),
-    TemporarilyUnavailable: IDL.Null,
-    BadBurn: IDL.Record({ min_burn_amount: IDL.Nat }),
-    Duplicate: IDL.Record({ duplicate_of: IDL.Nat }),
-    BadFee: IDL.Record({ expected_fee: IDL.Nat }),
-    CreatedInFuture: IDL.Record({ ledger_time: Timestamp }),
-    TooOld: IDL.Null,
-    InsufficientFunds: IDL.Record({ balance: IDL.Nat }),
-  });
-
-  return IDL.Service({
-    icrc1_balance_of: IDL.Func([Account], [IDL.Nat], []),
-    icrc1_decimals: IDL.Func([], [IDL.Nat8], []),
-    icrc1_fee: IDL.Func([], [IDL.Nat], []),
-    icrc1_metadata: IDL.Func([], [IDL.Vec(IDL.Tuple(IDL.Text, Value))], []),
-    icrc1_minting_account: IDL.Func([], [IDL.Opt(Account)], []),
-    icrc1_name: IDL.Func([], [IDL.Text], []),
-    icrc1_supported_standards: IDL.Func(
-      [],
-      [IDL.Vec(IDL.Record({ url: IDL.Text, name: IDL.Text }))],
-      [],
-    ),
-    icrc1_symbol: IDL.Func([], [IDL.Text], []),
-    icrc1_total_supply: IDL.Func([], [IDL.Nat], []),
-    icrc1_transfer: IDL.Func(
-      [TransferArgs],
-      [IDL.Variant({ Ok: IDL.Nat, Err: TransferError })],
-      [],
-    ),
-  });
-};
-
-export const init = ({ IDL }) => {
-  return [];
-};

package/dist/candid/icrc_icrc-1.d.ts

@@ -1,69 +0,0 @@
-/* eslint-disable */
-
-// @ts-nocheck
-
-// This file was automatically generated by @icp-sdk/bindgen@0.2.0.
-// You should NOT make any changes in this file as it will be overwritten.
-// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
-
-import type { ActorMethod } from "@icp-sdk/core/agent";
-import type { IDL } from "@icp-sdk/core/candid";
-import type { Principal } from "@icp-sdk/core/principal";
-
-export interface Account {
-  owner: Principal;
-  subaccount: [] | [Subaccount];
-}
-/**
- * Number of nanoseconds between two [Timestamp]s.
- */
-export type Duration = bigint;
-export type Subaccount = Uint8Array;
-/**
- * Number of nanoseconds since the UNIX epoch in UTC timezone.
- */
-export type Timestamp = bigint;
-export interface TransferArgs {
-  to: Account;
-  fee: [] | [bigint];
-  memo: [] | [Uint8Array];
-  from_subaccount: [] | [Subaccount];
-  created_at_time: [] | [Timestamp];
-  amount: bigint;
-}
-export type TransferError =
-  | {
-      GenericError: { message: string; error_code: bigint };
-    }
-  | { TemporarilyUnavailable: null }
-  | { BadBurn: { min_burn_amount: bigint } }
-  | { Duplicate: { duplicate_of: bigint } }
-  | { BadFee: { expected_fee: bigint } }
-  | { CreatedInFuture: { ledger_time: Timestamp } }
-  | { TooOld: null }
-  | { InsufficientFunds: { balance: bigint } };
-export type Value =
-  | { Int: bigint }
-  | { Nat: bigint }
-  | { Blob: Uint8Array }
-  | { Text: string };
-export interface _SERVICE {
-  icrc1_balance_of: ActorMethod<[Account], bigint>;
-  icrc1_decimals: ActorMethod<[], number>;
-  icrc1_fee: ActorMethod<[], bigint>;
-  icrc1_metadata: ActorMethod<[], Array<[string, Value]>>;
-  icrc1_minting_account: ActorMethod<[], [] | [Account]>;
-  icrc1_name: ActorMethod<[], string>;
-  icrc1_supported_standards: ActorMethod<
-    [],
-    Array<{ url: string; name: string }>
-  >;
-  icrc1_symbol: ActorMethod<[], string>;
-  icrc1_total_supply: ActorMethod<[], bigint>;
-  icrc1_transfer: ActorMethod<
-    [TransferArgs],
-    { Ok: bigint } | { Err: TransferError }
-  >;
-}
-export declare const idlFactory: IDL.InterfaceFactory;
-export declare const init: (args: { IDL: typeof IDL }) => IDL.Type[];

package/dist/candid/icrc_icrc-1.did

@@ -1,54 +0,0 @@
-// Generated from dfinity/ICRC-1 commit f8c39bec71b1ac7f6cdb1a6c9844726efc58be38 for file 'standards/ICRC-1/ICRC-1.did'
-
-// Number of nanoseconds since the UNIX epoch in UTC timezone.
-type Timestamp = nat64;
-
-// Number of nanoseconds between two [Timestamp]s.
-type Duration = nat64;
-
-type Subaccount = blob;
-
-type Account = record {
-    owner : principal;
-    subaccount : opt Subaccount;
-};
-
-type TransferArgs = record {
-    from_subaccount : opt Subaccount;
-    to : Account;
-    amount : nat;
-    fee : opt nat;
-    memo : opt blob;
-    created_at_time : opt Timestamp;
-};
-
-type TransferError = variant {
-    BadFee : record { expected_fee : nat };
-    BadBurn : record { min_burn_amount : nat };
-    InsufficientFunds : record { balance : nat };
-    TooOld;
-    CreatedInFuture: record { ledger_time : Timestamp };
-    Duplicate : record { duplicate_of : nat };
-    TemporarilyUnavailable;
-    GenericError : record { error_code : nat; message : text };
-};
-
-type Value = variant {
-    Nat : nat;
-    Int : int;
-    Text : text;
-    Blob : blob;
-};
-
-service : {
-    icrc1_metadata : () -> (vec record { text; Value; }) query;
-    icrc1_name : () -> (text) query;
-    icrc1_symbol : () -> (text) query;
-    icrc1_decimals : () -> (nat8) query;
-    icrc1_fee : () -> (nat) query;
-    icrc1_total_supply : () -> (nat) query;
-    icrc1_minting_account : () -> (opt Account) query;
-    icrc1_balance_of : (Account) -> (nat) query;
-    icrc1_transfer : (TransferArgs) -> (variant { Ok : nat; Err : TransferError });
-    icrc1_supported_standards : () -> (vec record { name : text; url : text }) query;
-}

package/dist/candid/icrc_icrc-1.idl.d.ts

@@ -1,2 +0,0 @@
-import type { IDL } from "@icp-sdk/core/candid";
-export const idlFactory: IDL.InterfaceFactory;

package/dist/candid/icrc_icrc-1.idl.js

@@ -1,72 +0,0 @@
-/* eslint-disable */
-
-// @ts-nocheck
-
-// This file was automatically generated by @icp-sdk/bindgen@0.2.0.
-// You should NOT make any changes in this file as it will be overwritten.
-// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
-
-export const idlFactory = ({ IDL }) => {
-  const Subaccount = IDL.Vec(IDL.Nat8);
-  const Account = IDL.Record({
-    owner: IDL.Principal,
-    subaccount: IDL.Opt(Subaccount),
-  });
-  const Value = IDL.Variant({
-    Int: IDL.Int,
-    Nat: IDL.Nat,
-    Blob: IDL.Vec(IDL.Nat8),
-    Text: IDL.Text,
-  });
-  const Timestamp = IDL.Nat64;
-  const TransferArgs = IDL.Record({
-    to: Account,
-    fee: IDL.Opt(IDL.Nat),
-    memo: IDL.Opt(IDL.Vec(IDL.Nat8)),
-    from_subaccount: IDL.Opt(Subaccount),
-    created_at_time: IDL.Opt(Timestamp),
-    amount: IDL.Nat,
-  });
-  const TransferError = IDL.Variant({
-    GenericError: IDL.Record({
-      message: IDL.Text,
-      error_code: IDL.Nat,
-    }),
-    TemporarilyUnavailable: IDL.Null,
-    BadBurn: IDL.Record({ min_burn_amount: IDL.Nat }),
-    Duplicate: IDL.Record({ duplicate_of: IDL.Nat }),
-    BadFee: IDL.Record({ expected_fee: IDL.Nat }),
-    CreatedInFuture: IDL.Record({ ledger_time: Timestamp }),
-    TooOld: IDL.Null,
-    InsufficientFunds: IDL.Record({ balance: IDL.Nat }),
-  });
-
-  return IDL.Service({
-    icrc1_balance_of: IDL.Func([Account], [IDL.Nat], ["query"]),
-    icrc1_decimals: IDL.Func([], [IDL.Nat8], ["query"]),
-    icrc1_fee: IDL.Func([], [IDL.Nat], ["query"]),
-    icrc1_metadata: IDL.Func(
-      [],
-      [IDL.Vec(IDL.Tuple(IDL.Text, Value))],
-      ["query"],
-    ),
-    icrc1_minting_account: IDL.Func([], [IDL.Opt(Account)], ["query"]),
-    icrc1_name: IDL.Func([], [IDL.Text], ["query"]),
-    icrc1_supported_standards: IDL.Func(
-      [],
-      [IDL.Vec(IDL.Record({ url: IDL.Text, name: IDL.Text }))],
-      ["query"],
-    ),
-    icrc1_symbol: IDL.Func([], [IDL.Text], ["query"]),
-    icrc1_total_supply: IDL.Func([], [IDL.Nat], ["query"]),
-    icrc1_transfer: IDL.Func(
-      [TransferArgs],
-      [IDL.Variant({ Ok: IDL.Nat, Err: TransferError })],
-      [],
-    ),
-  });
-};
-
-export const init = ({ IDL }) => {
-  return [];
-};

package/dist/candid/icrc_icrc-10.certified.idl.d.ts

@@ -1,2 +0,0 @@
-import type { IDL } from "@icp-sdk/core/candid";
-export const idlFactory: IDL.InterfaceFactory;

package/dist/candid/icrc_icrc-10.certified.idl.js

@@ -1,20 +0,0 @@
-/* eslint-disable */
-
-// @ts-nocheck
-
-// This file was automatically generated by @icp-sdk/bindgen@0.2.0.
-// You should NOT make any changes in this file as it will be overwritten.
-// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
-
-export const idlFactory = ({ IDL }) => {
-  const SupportedStandard = IDL.Record({ url: IDL.Text, name: IDL.Text });
-  const SupportedStandardsResponse = IDL.Vec(SupportedStandard);
-
-  return IDL.Service({
-    icrc10_supported_standards: IDL.Func([], [SupportedStandardsResponse], []),
-  });
-};
-
-export const init = ({ IDL }) => {
-  return [];
-};

package/dist/candid/icrc_icrc-10.d.ts

@@ -1,21 +0,0 @@
-/* eslint-disable */
-
-// @ts-nocheck
-
-// This file was automatically generated by @icp-sdk/bindgen@0.2.0.
-// You should NOT make any changes in this file as it will be overwritten.
-// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
-
-import type { ActorMethod } from "@icp-sdk/core/agent";
-import type { IDL } from "@icp-sdk/core/candid";
-
-export interface SupportedStandard {
-  url: string;
-  name: string;
-}
-export type SupportedStandardsResponse = Array<SupportedStandard>;
-export interface _SERVICE {
-  icrc10_supported_standards: ActorMethod<[], SupportedStandardsResponse>;
-}
-export declare const idlFactory: IDL.InterfaceFactory;
-export declare const init: (args: { IDL: typeof IDL }) => IDL.Type[];

package/dist/candid/icrc_icrc-10.did

@@ -1,8 +0,0 @@
-// Generated from dfinity/ICRC commit 1df0c6af6ecca4f4eb1956c67b29c0d13279f1cd for file 'ICRCs/ICRC-10/ICRC-10.did'
-
-type SupportedStandard = record { name : text; url : text; };
-type SupportedStandardsResponse = vec SupportedStandard;
-
-service : {
-  icrc10_supported_standards : () -> (SupportedStandardsResponse) query;
-}

package/dist/candid/icrc_icrc-10.idl.d.ts

@@ -1,2 +0,0 @@
-import type { IDL } from "@icp-sdk/core/candid";
-export const idlFactory: IDL.InterfaceFactory;

package/dist/candid/icrc_icrc-10.idl.js

@@ -1,24 +0,0 @@
-/* eslint-disable */
-
-// @ts-nocheck
-
-// This file was automatically generated by @icp-sdk/bindgen@0.2.0.
-// You should NOT make any changes in this file as it will be overwritten.
-// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
-
-export const idlFactory = ({ IDL }) => {
-  const SupportedStandard = IDL.Record({ url: IDL.Text, name: IDL.Text });
-  const SupportedStandardsResponse = IDL.Vec(SupportedStandard);
-
-  return IDL.Service({
-    icrc10_supported_standards: IDL.Func(
-      [],
-      [SupportedStandardsResponse],
-      ["query"],
-    ),
-  });
-};
-
-export const init = ({ IDL }) => {
-  return [];
-};

package/dist/nft-ledger.canister.d.ts

@@ -1,16 +0,0 @@
-import { Canister, type QueryParams } from "@dfinity/utils";
-import type { _SERVICE as IcrcNftLedgerService } from "./candid/icrc_nft-ledger";
-import type { IcrcLedgerCanisterOptions } from "./types/canister.options";
-import type { IcrcTokenMetadataResponse } from "./types/ledger.responses";
-export declare class IcrcNftLedgerCanister extends Canister<IcrcNftLedgerService> {
-    static create(options: IcrcLedgerCanisterOptions<IcrcNftLedgerService>): IcrcNftLedgerCanister;
-    /**
-     * The collection metadata.
-     *
-     * @link https://github.com/dfinity/ICRC/blob/main/ICRCs/ICRC-7/ICRC-7.md#icrc7_collection_metadata
-     *
-     * @param {QueryParams} params The parameters to get the metadata of the collection.
-     * @returns {Promise<IcrcTokenMetadataResponse>} The metadata as a list of metadata type and its value.
-     */
-    collectionMetadata: (params: QueryParams) => Promise<IcrcTokenMetadataResponse>;
-}

package/dist/types/canister.types.d.ts

@@ -1,2 +0,0 @@
-import type { _SERVICE as Icrc1Service } from "../candid/icrc_icrc-1";
-export type IcrcCanisterService = Pick<Icrc1Service, "icrc1_balance_of">;