@dfinity/ckbtc 4.0.0-next-2025-08-14 → 4.0.1-beta-2025-09-25

package/LICENSE

@@ -174,28 +174,3 @@
       of your accepting any such warranty or additional liability.
 
    END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright 2025 DFINITY Stiftung.
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.

package/README.md

@@ -21,7 +21,7 @@ npm i @dfinity/ckbtc
 The bundle needs peer dependencies, be sure that following resources are available in your project as well.
 
 ```bash
-npm i @dfinity/agent @dfinity/candid @dfinity/principal @dfinity/utils
+npm i @icp-sdk/core @dfinity/utils
 ```
 
 ## Usage

package/dist/candid/bitcoin.certified.idl.d.ts

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

package/dist/candid/bitcoin.d.ts

@@ -1,6 +1,6 @@
-import type { ActorMethod } from "@dfinity/agent";
-import type { IDL } from "@dfinity/candid";
-import type { Principal } from "@dfinity/principal";
+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 type address = string;
 export type block_hash = Uint8Array | number[];

package/dist/candid/bitcoin.idl.d.ts

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

package/dist/candid/minter.certified.idl.d.ts

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

package/dist/candid/minter.certified.idl.js

@@ -40,6 +40,16 @@ export const idlFactory = ({ IDL }) => {
     'Upgrade' : IDL.Opt(UpgradeArgs),
     'Init' : InitArgs,
   });
+  const MemoryMetrics = IDL.Record({
+    'wasm_binary_size' : IDL.Nat,
+    'wasm_chunk_store_size' : IDL.Nat,
+    'canister_history_size' : IDL.Nat,
+    'stable_memory_size' : IDL.Nat,
+    'snapshots_size' : IDL.Nat,
+    'wasm_memory_size' : IDL.Nat,
+    'global_memory_size' : IDL.Nat,
+    'custom_sections_size' : IDL.Nat,
+  });
   const CanisterStatusType = IDL.Variant({
     'stopped' : IDL.Null,
     'stopping' : IDL.Null,
@@ -52,6 +62,7 @@ export const idlFactory = ({ IDL }) => {
   });
   const DefiniteCanisterSettings = IDL.Record({
     'freezing_threshold' : IDL.Nat,
+    'wasm_memory_threshold' : IDL.Nat,
     'controllers' : IDL.Vec(IDL.Principal),
     'reserved_cycles_limit' : IDL.Nat,
     'log_visibility' : LogVisibility,
@@ -66,6 +77,7 @@ export const idlFactory = ({ IDL }) => {
     'request_payload_bytes_total' : IDL.Nat,
   });
   const CanisterStatusResponse = IDL.Record({
+    'memory_metrics' : MemoryMetrics,
     'status' : CanisterStatusType,
     'memory_size' : IDL.Nat,
     'cycles' : IDL.Nat,
@@ -91,6 +103,10 @@ export const idlFactory = ({ IDL }) => {
       'kyt_provider' : IDL.Principal,
     }),
   });
+  const WithdrawalFee = IDL.Record({
+    'minter_fee' : IDL.Nat64,
+    'bitcoin_fee' : IDL.Nat64,
+  });
   const SuspendedReason = IDL.Variant({
     'ValueTooSmall' : IDL.Null,
     'Quarantined' : IDL.Null,
@@ -102,6 +118,19 @@ export const idlFactory = ({ IDL }) => {
     'p2wpkh_v0' : IDL.Vec(IDL.Nat8),
     'p2pkh' : IDL.Vec(IDL.Nat8),
   });
+  const InvalidTransactionError = IDL.Variant({
+    'too_many_inputs' : IDL.Record({
+      'max_num_inputs' : IDL.Nat64,
+      'num_inputs' : IDL.Nat64,
+    }),
+  });
+  const WithdrawalReimbursementReason = IDL.Variant({
+    'invalid_transaction' : InvalidTransactionError,
+  });
+  const ReplacedReason = IDL.Variant({
+    'to_cancel' : IDL.Record({ 'reason' : WithdrawalReimbursementReason }),
+    'to_retry' : IDL.Null,
+  });
   const EventType = IDL.Variant({
     'received_utxos' : IDL.Record({
       'to_account' : Account,
@@ -120,6 +149,7 @@ export const idlFactory = ({ IDL }) => {
         IDL.Record({ 'value' : IDL.Nat64, 'vout' : IDL.Nat32 })
       ),
       'txid' : IDL.Vec(IDL.Nat8),
+      'withdrawal_fee' : IDL.Opt(WithdrawalFee),
       'utxos' : IDL.Vec(Utxo),
       'requests' : IDL.Vec(IDL.Nat64),
       'submitted_at' : IDL.Nat64,
@@ -158,14 +188,26 @@ export const idlFactory = ({ IDL }) => {
       'uuid' : IDL.Text,
       'kyt_provider' : IDL.Opt(IDL.Principal),
     }),
+    'schedule_withdrawal_reimbursement' : IDL.Record({
+      'burn_block_index' : IDL.Nat64,
+      'account' : Account,
+      'amount' : IDL.Nat64,
+      'reason' : WithdrawalReimbursementReason,
+    }),
+    'quarantined_withdrawal_reimbursement' : IDL.Record({
+      'burn_block_index' : IDL.Nat64,
+    }),
     'removed_retrieve_btc_request' : IDL.Record({ 'block_index' : IDL.Nat64 }),
     'confirmed_transaction' : IDL.Record({ 'txid' : IDL.Vec(IDL.Nat8) }),
     'replaced_transaction' : IDL.Record({
       'fee' : IDL.Nat64,
       'change_output' : IDL.Record({ 'value' : IDL.Nat64, 'vout' : IDL.Nat32 }),
+      'new_utxos' : IDL.Opt(IDL.Vec(Utxo)),
       'old_txid' : IDL.Vec(IDL.Nat8),
+      'withdrawal_fee' : IDL.Opt(WithdrawalFee),
       'new_txid' : IDL.Vec(IDL.Nat8),
       'submitted_at' : IDL.Nat64,
+      'reason' : IDL.Opt(ReplacedReason),
     }),
     'checked_utxo_v2' : IDL.Record({ 'utxo' : Utxo, 'account' : Account }),
     'ignored_utxo' : IDL.Record({ 'utxo' : Utxo }),
@@ -177,6 +219,10 @@ export const idlFactory = ({ IDL }) => {
       'burn_block_index' : IDL.Nat64,
       'mint_block_index' : IDL.Nat64,
     }),
+    'reimbursed_withdrawal' : IDL.Record({
+      'burn_block_index' : IDL.Nat64,
+      'mint_block_index' : IDL.Nat64,
+    }),
   });
   const Event = IDL.Record({
     'timestamp' : IDL.Opt(IDL.Nat64),

package/dist/candid/minter.d.ts

@@ -1,6 +1,6 @@
-import type { ActorMethod } from "@dfinity/agent";
-import type { IDL } from "@dfinity/candid";
-import type { Principal } from "@dfinity/principal";
+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;
@@ -17,6 +17,7 @@ export type BtcNetwork =
   | { Regtest: null }
   | { Testnet: null };
 export interface CanisterStatusResponse {
+  memory_metrics: MemoryMetrics;
   status: CanisterStatusType;
   memory_size: bigint;
   cycles: bigint;
@@ -32,6 +33,7 @@ export type CanisterStatusType =
   | { running: null };
 export interface DefiniteCanisterSettings {
   freezing_threshold: bigint;
+  wasm_memory_threshold: bigint;
   controllers: Array<Principal>;
   reserved_cycles_limit: bigint;
   log_visibility: LogVisibility;
@@ -64,6 +66,7 @@ export type EventType =
         fee: [] | [bigint];
         change_output: [] | [{ value: bigint; vout: number }];
         txid: Uint8Array | number[];
+        withdrawal_fee: [] | [WithdrawalFee];
         utxos: Array<Utxo>;
         requests: BigUint64Array | bigint[];
         submitted_at: bigint;
@@ -113,15 +116,27 @@ export type EventType =
         kyt_provider: [] | [Principal];
       };
     }
+  | {
+      schedule_withdrawal_reimbursement: {
+        burn_block_index: bigint;
+        account: Account;
+        amount: bigint;
+        reason: WithdrawalReimbursementReason;
+      };
+    }
+  | { quarantined_withdrawal_reimbursement: { burn_block_index: bigint } }
   | { removed_retrieve_btc_request: { block_index: bigint } }
   | { confirmed_transaction: { txid: Uint8Array | number[] } }
   | {
       replaced_transaction: {
         fee: bigint;
         change_output: { value: bigint; vout: number };
+        new_utxos: [] | [Array<Utxo>];
         old_txid: Uint8Array | number[];
+        withdrawal_fee: [] | [WithdrawalFee];
         new_txid: Uint8Array | number[];
         submitted_at: bigint;
+        reason: [] | [ReplacedReason];
       };
     }
   | { checked_utxo_v2: { utxo: Utxo; account: Account } }
@@ -132,6 +147,12 @@ export type EventType =
         burn_block_index: bigint;
         mint_block_index: bigint;
       };
+    }
+  | {
+      reimbursed_withdrawal: {
+        burn_block_index: bigint;
+        mint_block_index: bigint;
+      };
     };
 export interface InitArgs {
   get_utxos_cache_expiration_seconds: [] | [bigint];
@@ -147,10 +168,23 @@ export interface InitArgs {
   min_confirmations: [] | [number];
   kyt_fee: [] | [bigint];
 }
+export type InvalidTransactionError = {
+  too_many_inputs: { max_num_inputs: bigint; num_inputs: bigint };
+};
 export type LogVisibility =
   | { controllers: null }
   | { public: null }
   | { allowed_viewers: Array<Principal> };
+export interface MemoryMetrics {
+  wasm_binary_size: bigint;
+  wasm_chunk_store_size: bigint;
+  canister_history_size: bigint;
+  stable_memory_size: bigint;
+  snapshots_size: bigint;
+  wasm_memory_size: bigint;
+  global_memory_size: bigint;
+  custom_sections_size: bigint;
+}
 export type MinterArg = { Upgrade: [] | [UpgradeArgs] } | { Init: InitArgs };
 export interface MinterInfo {
   retrieve_btc_min_amount: bigint;
@@ -187,6 +221,11 @@ export interface ReimbursementRequest {
   amount: bigint;
   reason: ReimbursementReason;
 }
+export type ReplacedReason =
+  | {
+      to_cancel: { reason: WithdrawalReimbursementReason };
+    }
+  | { to_retry: null };
 export interface RetrieveBtcArgs {
   address: string;
   amount: bigint;
@@ -280,6 +319,13 @@ export type UtxoStatus =
       };
     }
   | { Checked: Utxo };
+export interface WithdrawalFee {
+  minter_fee: bigint;
+  bitcoin_fee: bigint;
+}
+export type WithdrawalReimbursementReason = {
+  invalid_transaction: InvalidTransactionError;
+};
 export interface _SERVICE {
   estimate_withdrawal_fee: ActorMethod<
     [{ amount: [] | [bigint] }],

package/dist/candid/minter.did

@@ -1,4 +1,4 @@
-// Generated from IC repo commit 047925d (2025-08-06 tags: release-2025-08-07_03-33-base) 'rs/bitcoin/ckbtc/minter/ckbtc_minter.did' by import-candid
+// Generated from IC repo commit bf0d4d1 (2025-09-19 tags: release-2025-09-19_10-17-base) 'rs/bitcoin/ckbtc/minter/ckbtc_minter.did' by import-candid
 // Represents an account on the ckBTC ledger.
 type Account = record { owner : principal; subaccount : opt blob };
 
@@ -11,6 +11,7 @@ type CanisterStatusResponse = record {
   module_hash : opt vec nat8;
   query_stats : QueryStats;
   reserved_cycles : nat;
+  memory_metrics : MemoryMetrics;
 };
 
 type QueryStats = record {
@@ -20,6 +21,17 @@ type QueryStats = record {
   request_payload_bytes_total : nat;
 };
 
+type MemoryMetrics = record {
+    wasm_memory_size : nat;
+    stable_memory_size : nat;
+    global_memory_size : nat;
+    wasm_binary_size : nat;
+    custom_sections_size : nat;
+    canister_history_size : nat;
+    wasm_chunk_store_size : nat;
+    snapshots_size : nat;
+};
+
 type CanisterStatusType = variant { stopped; stopping; running };
 
 type DefiniteCanisterSettings = record {
@@ -30,6 +42,7 @@ type DefiniteCanisterSettings = record {
   reserved_cycles_limit : nat;
   log_visibility: LogVisibility;
   wasm_memory_limit : nat;
+  wasm_memory_threshold : nat;
 };
 
 type LogVisibility = variant {
@@ -350,6 +363,24 @@ type ReimbursementReason = variant {
     };
 };
 
+type ReplacedReason = variant {
+  to_retry;
+  to_cancel : record {
+    reason : WithdrawalReimbursementReason;
+  };
+};
+
+type WithdrawalReimbursementReason = variant {
+    invalid_transaction : InvalidTransactionError;
+};
+
+type InvalidTransactionError = variant {
+  too_many_inputs : record {
+        num_inputs : nat64;
+        max_num_inputs : nat64;
+  };
+};
+
 type SuspendedReason = variant {
     // The minter ignored this UTXO because UTXO's value is too small to pay
     // the check fees.
@@ -358,6 +389,11 @@ type SuspendedReason = variant {
     Quarantined;
 };
 
+type WithdrawalFee = record {
+    minter_fee : nat64;
+    bitcoin_fee : nat64;
+};
+
 type Event = record {
     timestamp : opt nat64;
     payload : EventType;
@@ -388,13 +424,17 @@ type EventType = variant {
         change_output : opt record { vout : nat32; value : nat64 };
         submitted_at : nat64;
         fee: opt nat64;
+        withdrawal_fee : opt WithdrawalFee;
     };
     replaced_transaction : record {
         new_txid : blob;
         old_txid : blob;
         change_output : record { vout : nat32; value : nat64 };
         submitted_at : nat64;
-        fee: nat64;
+        fee : nat64;
+        withdrawal_fee : opt WithdrawalFee;
+        reason : opt ReplacedReason;
+        new_utxos : opt vec Utxo;
     };
     confirmed_transaction : record { txid : blob };
     checked_utxo : record {
@@ -428,6 +468,19 @@ type EventType = variant {
         reason : ReimbursementReason;
     };
     reimbursed_failed_deposit : record { burn_block_index : nat64; mint_block_index : nat64 };
+    schedule_withdrawal_reimbursement : record {
+        account : Account;
+        burn_block_index : nat64;
+        amount : nat64;
+        reason : WithdrawalReimbursementReason;
+    };
+    quarantined_withdrawal_reimbursement : record {
+        burn_block_index : nat64;
+    };
+    reimbursed_withdrawal : record {
+        burn_block_index : nat64;
+        mint_block_index : nat64;
+    };
 };
 
 type MinterArg = variant {

package/dist/candid/minter.idl.d.ts

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

package/dist/candid/minter.idl.js

@@ -40,6 +40,16 @@ export const idlFactory = ({ IDL }) => {
     'Upgrade' : IDL.Opt(UpgradeArgs),
     'Init' : InitArgs,
   });
+  const MemoryMetrics = IDL.Record({
+    'wasm_binary_size' : IDL.Nat,
+    'wasm_chunk_store_size' : IDL.Nat,
+    'canister_history_size' : IDL.Nat,
+    'stable_memory_size' : IDL.Nat,
+    'snapshots_size' : IDL.Nat,
+    'wasm_memory_size' : IDL.Nat,
+    'global_memory_size' : IDL.Nat,
+    'custom_sections_size' : IDL.Nat,
+  });
   const CanisterStatusType = IDL.Variant({
     'stopped' : IDL.Null,
     'stopping' : IDL.Null,
@@ -52,6 +62,7 @@ export const idlFactory = ({ IDL }) => {
   });
   const DefiniteCanisterSettings = IDL.Record({
     'freezing_threshold' : IDL.Nat,
+    'wasm_memory_threshold' : IDL.Nat,
     'controllers' : IDL.Vec(IDL.Principal),
     'reserved_cycles_limit' : IDL.Nat,
     'log_visibility' : LogVisibility,
@@ -66,6 +77,7 @@ export const idlFactory = ({ IDL }) => {
     'request_payload_bytes_total' : IDL.Nat,
   });
   const CanisterStatusResponse = IDL.Record({
+    'memory_metrics' : MemoryMetrics,
     'status' : CanisterStatusType,
     'memory_size' : IDL.Nat,
     'cycles' : IDL.Nat,
@@ -91,6 +103,10 @@ export const idlFactory = ({ IDL }) => {
       'kyt_provider' : IDL.Principal,
     }),
   });
+  const WithdrawalFee = IDL.Record({
+    'minter_fee' : IDL.Nat64,
+    'bitcoin_fee' : IDL.Nat64,
+  });
   const SuspendedReason = IDL.Variant({
     'ValueTooSmall' : IDL.Null,
     'Quarantined' : IDL.Null,
@@ -102,6 +118,19 @@ export const idlFactory = ({ IDL }) => {
     'p2wpkh_v0' : IDL.Vec(IDL.Nat8),
     'p2pkh' : IDL.Vec(IDL.Nat8),
   });
+  const InvalidTransactionError = IDL.Variant({
+    'too_many_inputs' : IDL.Record({
+      'max_num_inputs' : IDL.Nat64,
+      'num_inputs' : IDL.Nat64,
+    }),
+  });
+  const WithdrawalReimbursementReason = IDL.Variant({
+    'invalid_transaction' : InvalidTransactionError,
+  });
+  const ReplacedReason = IDL.Variant({
+    'to_cancel' : IDL.Record({ 'reason' : WithdrawalReimbursementReason }),
+    'to_retry' : IDL.Null,
+  });
   const EventType = IDL.Variant({
     'received_utxos' : IDL.Record({
       'to_account' : Account,
@@ -120,6 +149,7 @@ export const idlFactory = ({ IDL }) => {
         IDL.Record({ 'value' : IDL.Nat64, 'vout' : IDL.Nat32 })
       ),
       'txid' : IDL.Vec(IDL.Nat8),
+      'withdrawal_fee' : IDL.Opt(WithdrawalFee),
       'utxos' : IDL.Vec(Utxo),
       'requests' : IDL.Vec(IDL.Nat64),
       'submitted_at' : IDL.Nat64,
@@ -158,14 +188,26 @@ export const idlFactory = ({ IDL }) => {
       'uuid' : IDL.Text,
       'kyt_provider' : IDL.Opt(IDL.Principal),
     }),
+    'schedule_withdrawal_reimbursement' : IDL.Record({
+      'burn_block_index' : IDL.Nat64,
+      'account' : Account,
+      'amount' : IDL.Nat64,
+      'reason' : WithdrawalReimbursementReason,
+    }),
+    'quarantined_withdrawal_reimbursement' : IDL.Record({
+      'burn_block_index' : IDL.Nat64,
+    }),
     'removed_retrieve_btc_request' : IDL.Record({ 'block_index' : IDL.Nat64 }),
     'confirmed_transaction' : IDL.Record({ 'txid' : IDL.Vec(IDL.Nat8) }),
     'replaced_transaction' : IDL.Record({
       'fee' : IDL.Nat64,
       'change_output' : IDL.Record({ 'value' : IDL.Nat64, 'vout' : IDL.Nat32 }),
+      'new_utxos' : IDL.Opt(IDL.Vec(Utxo)),
       'old_txid' : IDL.Vec(IDL.Nat8),
+      'withdrawal_fee' : IDL.Opt(WithdrawalFee),
       'new_txid' : IDL.Vec(IDL.Nat8),
       'submitted_at' : IDL.Nat64,
+      'reason' : IDL.Opt(ReplacedReason),
     }),
     'checked_utxo_v2' : IDL.Record({ 'utxo' : Utxo, 'account' : Account }),
     'ignored_utxo' : IDL.Record({ 'utxo' : Utxo }),
@@ -177,6 +219,10 @@ export const idlFactory = ({ IDL }) => {
       'burn_block_index' : IDL.Nat64,
       'mint_block_index' : IDL.Nat64,
     }),
+    'reimbursed_withdrawal' : IDL.Record({
+      'burn_block_index' : IDL.Nat64,
+      'mint_block_index' : IDL.Nat64,
+    }),
   });
   const Event = IDL.Record({
     'timestamp' : IDL.Opt(IDL.Nat64),