@dynamic-labs/bitcoin 4.53.1 → 4.54.0

package/CHANGELOG.md

@@ -1,4 +1,29 @@
 
+## [4.54.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.53.2...v4.54.0) (2026-01-16)
+
+
+### Features
+
+* add iCloud backup method for wallet backup ([#10221](https://github.com/dynamic-labs/dynamic-auth/issues/10221)) ([36f5b8a](https://github.com/dynamic-labs/dynamic-auth/commit/36f5b8a0df50139fabbc6d6256f396a6d40313f4))
+* add iCloud backup support for wallet key shares ([#10220](https://github.com/dynamic-labs/dynamic-auth/issues/10220)) ([f5f8135](https://github.com/dynamic-labs/dynamic-auth/commit/f5f813593d6ec834fc94f873fd7151b1f3e1a0ca))
+* add legacyWalletId parameter to importPrivateKey ([#10244](https://github.com/dynamic-labs/dynamic-auth/issues/10244)) ([d281dd7](https://github.com/dynamic-labs/dynamic-auth/commit/d281dd7128ac1211e8ca0b72818e109ece7b9837))
+
+### [4.53.2](https://github.com/dynamic-labs/dynamic-auth/compare/v4.53.1...v4.53.2) (2026-01-16)
+
+
+### Features
+
+* add iCloud backup functionality ([#10219](https://github.com/dynamic-labs/dynamic-auth/issues/10219)) ([44e95e5](https://github.com/dynamic-labs/dynamic-auth/commit/44e95e5a5dc99f83918a382ab1c69d452359c346))
+* update PSBT building with Largest-First UTXO selection and fee priorities (high/medium/low) ([#10227](https://github.com/dynamic-labs/dynamic-auth/issues/10227)) ([94c5f5c](https://github.com/dynamic-labs/dynamic-auth/commit/94c5f5cb97432bb97374b754cb95bc23290dd184))
+
+
+### Bug Fixes
+
+* allow late registered solana wallets to appear in the wallet list ([#10224](https://github.com/dynamic-labs/dynamic-auth/issues/10224)) ([2f418d4](https://github.com/dynamic-labs/dynamic-auth/commit/2f418d4f3e0543bdd829a45807329f89da1e41a7))
+* correctly show app name in wallet app for wallet connect evm connections ([#10218](https://github.com/dynamic-labs/dynamic-auth/issues/10218)) ([fec0009](https://github.com/dynamic-labs/dynamic-auth/commit/fec0009177439baa67015050b4ad799119615f4f))
+* destructure wallets from getWalletStandardWallets before calling find ([#10234](https://github.com/dynamic-labs/dynamic-auth/issues/10234)) ([b59617a](https://github.com/dynamic-labs/dynamic-auth/commit/b59617a8579b9c7d8a5f744a2ea9363ccb4aee58))
+* **react-native:** filter connectors by enabled chains and add chain parameter to connectWallet ([#10230](https://github.com/dynamic-labs/dynamic-auth/issues/10230)) ([a2bbd03](https://github.com/dynamic-labs/dynamic-auth/commit/a2bbd03ece52950711d2eda18cb2345df15710dd))
+
 ### [4.53.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.53.0...v4.53.1) (2026-01-14)
 
 ## [4.53.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.52.5...v4.53.0) (2026-01-13)

package/package.cjs

@@ -3,6 +3,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.53.1";
+var version = "4.54.0";
 
 exports.version = version;

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "4.53.1";
+var version = "4.54.0";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/bitcoin",
-  "version": "4.53.1",
+  "version": "4.54.0",
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -18,23 +18,23 @@
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
-    "@dynamic-labs-wallet/browser-wallet-client": "0.0.237",
+    "@dynamic-labs-wallet/browser-wallet-client": "0.0.248",
     "@bitcoinerlab/secp256k1": "1.1.1",
     "@btckit/types": "0.0.19",
-    "@dynamic-labs/sdk-api-core": "0.0.843",
+    "@dynamic-labs/sdk-api-core": "0.0.855",
     "@wallet-standard/app": "1.0.1",
     "@wallet-standard/base": "1.0.1",
     "bitcoinjs-lib": "6.1.5",
     "ecpair": "2.1.0",
     "sats-connect": "4.2.0",
     "jsontokens": "4.0.1",
-    "@dynamic-labs/assert-package-version": "4.53.1",
-    "@dynamic-labs/logger": "4.53.1",
-    "@dynamic-labs/types": "4.53.1",
-    "@dynamic-labs/utils": "4.53.1",
-    "@dynamic-labs/waas": "4.53.1",
-    "@dynamic-labs/wallet-book": "4.53.1",
-    "@dynamic-labs/wallet-connector-core": "4.53.1",
+    "@dynamic-labs/assert-package-version": "4.54.0",
+    "@dynamic-labs/logger": "4.54.0",
+    "@dynamic-labs/types": "4.54.0",
+    "@dynamic-labs/utils": "4.54.0",
+    "@dynamic-labs/waas": "4.54.0",
+    "@dynamic-labs/wallet-book": "4.54.0",
+    "@dynamic-labs/wallet-connector-core": "4.54.0",
     "eventemitter3": "5.0.1"
   },
   "peerDependencies": {}

package/src/connectors/DynamicWaasBitcoinConnector/DynamicWaasBitcoinConnector.cjs

@@ -128,11 +128,15 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
         });
     }
     /**
-     * Signs a Partially Signed Bitcoin Transaction (PSBT)
-     * @param request - The PSBT signing request containing the unsigned PSBT
-     * @returns The signed PSBT response
+     * Signs a Partially Signed Bitcoin Transaction (PSBT) for embedded wallets
+     *
+     * Embedded wallets only support PSBT format and automatically sign all inputs
+     * that belong to the wallet address. Always uses SIGHASH_ALL (0x01).
+     *
+     * @param request - The PSBT signing request. Only unsignedPsbtBase64 is required.
+     * @returns The signed (but not finalized) PSBT response
      * @throws {DynamicError} If active account address is not set
-     * @throws {DynamicError} If signed session ID is not available or signature is provided
+     * @throws {DynamicError} If signed session ID is not available
      */
     signPsbt(request) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
@@ -148,9 +152,6 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
             const mfaToken = yield ((_b = this.getMfaToken) === null || _b === void 0 ? void 0 : _b.call(this, {
                 mfaAction: sdkApiCore.MFAAction.WalletWaasSign,
             }));
-            if (request.signature && request.signature.length > 0) {
-                throw new utils.DynamicError('Signature is not supported for waas at the moment');
-            }
             const signedTransaction = yield walletClient.signTransaction({
                 authToken: (_c = this.getAuthToken) === null || _c === void 0 ? void 0 : _c.call(this),
                 mfaToken,
@@ -192,9 +193,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
             // Step 1: Build the PSBT
             const unsignedPsbt = yield this.buildPsbt(transaction);
             // Step 2: Sign the PSBT
-            // SIGHASH_ALL (0x01) is the most common sighash type for Bitcoin transactions (Eventually can be configurable)
             const signedPsbtResponse = yield this.signPsbt({
-                allowedSighash: [0x01],
                 unsignedPsbtBase64: unsignedPsbt,
             });
             if (!signedPsbtResponse) {
@@ -238,13 +237,14 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
      * @param thresholdSignatureScheme - The threshold signature scheme (default: 'TWO_OF_TWO')
      * @param publicAddressCheck - Optional public address to verify against
      * @param addressType - Required address type for Bitcoin ('native_segwit' or 'taproot')
+     * @param legacyWalletId - Optional ID of the legacy wallet being upgraded
      * @throws {DynamicError} If addressType is missing or invalid for BTC
      */
     importPrivateKey(_a) {
         const _super = Object.create(null, {
             importPrivateKey: { get: () => super.importPrivateKey }
         });
-        return _tslib.__awaiter(this, arguments, void 0, function* ({ privateKey, thresholdSignatureScheme = 'TWO_OF_TWO', publicAddressCheck, addressType, }) {
+        return _tslib.__awaiter(this, arguments, void 0, function* ({ privateKey, thresholdSignatureScheme = 'TWO_OF_TWO', publicAddressCheck, addressType, legacyWalletId, }) {
             if (!addressType) {
                 throw new utils.DynamicError('addressType is required for BTC importPrivateKey');
             }
@@ -254,6 +254,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
             }
             return _super.importPrivateKey.call(this, {
                 addressType,
+                legacyWalletId,
                 privateKey,
                 publicAddressCheck,
                 thresholdSignatureScheme,
@@ -337,7 +338,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
     }
     /**
      * Builds a PSBT for a Bitcoin transaction with real UTXOs
-     * @param transaction - The Bitcoin transaction containing recipient address and amount in satoshis to send
+     * @param transaction - Bitcoin transaction with recipient address, amount in satoshis, and optional fee priority
      * @returns A PSBT in Base64 format
      * @throws {DynamicError} If no active account address, insufficient funds, or other errors
      */
@@ -347,7 +348,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
                 throw new utils.DynamicError('Active account address is required');
             }
             const publicKeyHex = yield this.getPublicKey();
-            const buildOptions = PsbtBuilderService.PsbtBuilderService.createBuildOptions(this.activeAccountAddress, transaction, publicKeyHex);
+            const buildOptions = PsbtBuilderService.PsbtBuilderService.createBuildOptions(this.activeAccountAddress, transaction, publicKeyHex, transaction.feePriority || 'medium');
             return this.psbtBuilderService.buildPsbt(buildOptions);
         });
     }

package/src/connectors/DynamicWaasBitcoinConnector/DynamicWaasBitcoinConnector.d.ts

@@ -2,8 +2,8 @@ import { BitcoinConfig, BitcoinNetwork } from '@dynamic-labs-wallet/browser-wall
 import { JwtVerifiedCredential, MFAAction, SignMessageContext } from '@dynamic-labs/sdk-api-core';
 import { Logger } from '@dynamic-labs/logger';
 import { WalletUiUtils } from '@dynamic-labs/types';
-import { IDynamicWaasConnector, InternalWalletConnector, Chain, BitcoinSignPsbtRequest, BitcoinSignPsbtResponse } from '@dynamic-labs/wallet-connector-core';
-import { BitcoinTransaction } from '../../types';
+import { IDynamicWaasConnector, InternalWalletConnector, Chain, BitcoinSignPsbtResponse } from '@dynamic-labs/wallet-connector-core';
+import { BitcoinTransaction, EmbeddedWalletSignPsbtRequest } from '../../types';
 import { BitcoinWalletConnector } from '../BitcoinWalletConnector';
 import type { ParsedTransaction, DynamicWaasBitcoinConnectorProps } from '../../types';
 declare const DynamicWaasBitcoinConnector_base: (abstract new (...args: any[]) => {
@@ -35,7 +35,10 @@ declare const DynamicWaasBitcoinConnector_base: (abstract new (...args: any[]) =
     setBaseApiUrl(baseApiUrl: string): void;
     setBaseClientKeysharesRelayApiUrl(baseClientKeysharesRelayApiUrl?: string | undefined): void;
     setRelayUrl(relayUrl: string): void;
-    setGetSignedSessionIdFunction(getSignedSessionId: () => Promise<string>): void;
+    setGetSignedSessionIdFunction(getSignedSessionId: () => Promise<string>): void; /**
+     * The primary/active verified credential (first from the filtered array)
+     * This is used for the active account address
+     */
     delegateKeyShares({ accountAddress, password, }: {
         accountAddress: string;
         password?: string | undefined;
@@ -52,11 +55,12 @@ declare const DynamicWaasBitcoinConnector_base: (abstract new (...args: any[]) =
         publicKeyHex: string;
         rawPublicKey: string | Uint8Array | undefined;
     }>;
-    importPrivateKey({ privateKey, thresholdSignatureScheme, publicAddressCheck, addressType, }: {
+    importPrivateKey({ privateKey, thresholdSignatureScheme, publicAddressCheck, addressType, legacyWalletId, }: {
         privateKey: string;
         thresholdSignatureScheme?: string | undefined;
         publicAddressCheck?: string | undefined;
         addressType?: string | undefined;
+        legacyWalletId?: string | undefined;
     }): Promise<void>;
     exportPrivateKey({ accountAddress, displayContainer, password, }?: {
         accountAddress?: string | undefined;
@@ -78,6 +82,15 @@ declare const DynamicWaasBitcoinConnector_base: (abstract new (...args: any[]) =
         accountAddress: string;
         password?: string | undefined;
     }): Promise<void>;
+    backupKeySharesToICloud({ accountAddress, password, }: {
+        accountAddress: string;
+        password?: string | undefined;
+    }): Promise<void>;
+    displayICloudSignIn({ displayContainer, }: {
+        displayContainer: HTMLElement;
+    }): Promise<void>;
+    hideICloudSignIn(): Promise<void>;
+    isICloudAuthenticated(): Promise<boolean>;
     refreshWalletAccountShares({ accountAddress, password, }: {
         accountAddress: string;
         password?: string | undefined;
@@ -169,13 +182,17 @@ export declare class DynamicWaasBitcoinConnector extends DynamicWaasBitcoinConne
      */
     signMessage(message: string): Promise<string>;
     /**
-     * Signs a Partially Signed Bitcoin Transaction (PSBT)
-     * @param request - The PSBT signing request containing the unsigned PSBT
-     * @returns The signed PSBT response
+     * Signs a Partially Signed Bitcoin Transaction (PSBT) for embedded wallets
+     *
+     * Embedded wallets only support PSBT format and automatically sign all inputs
+     * that belong to the wallet address. Always uses SIGHASH_ALL (0x01).
+     *
+     * @param request - The PSBT signing request. Only unsignedPsbtBase64 is required.
+     * @returns The signed (but not finalized) PSBT response
      * @throws {DynamicError} If active account address is not set
-     * @throws {DynamicError} If signed session ID is not available or signature is provided
+     * @throws {DynamicError} If signed session ID is not available
      */
-    signPsbt(request: BitcoinSignPsbtRequest): Promise<BitcoinSignPsbtResponse>;
+    signPsbt(request: EmbeddedWalletSignPsbtRequest): Promise<BitcoinSignPsbtResponse>;
     /**
      * Sends a raw Bitcoin transaction to the mempool
      * @param rawTransaction - The raw transaction in hex format
@@ -214,13 +231,15 @@ export declare class DynamicWaasBitcoinConnector extends DynamicWaasBitcoinConne
      * @param thresholdSignatureScheme - The threshold signature scheme (default: 'TWO_OF_TWO')
      * @param publicAddressCheck - Optional public address to verify against
      * @param addressType - Required address type for Bitcoin ('native_segwit' or 'taproot')
+     * @param legacyWalletId - Optional ID of the legacy wallet being upgraded
      * @throws {DynamicError} If addressType is missing or invalid for BTC
      */
-    importPrivateKey({ privateKey, thresholdSignatureScheme, publicAddressCheck, addressType, }: {
+    importPrivateKey({ privateKey, thresholdSignatureScheme, publicAddressCheck, addressType, legacyWalletId, }: {
         privateKey: string;
         thresholdSignatureScheme?: string;
         publicAddressCheck?: string;
         addressType?: string;
+        legacyWalletId?: string;
     }): Promise<void>;
     /**
      * Gets the wallet client for a specific account address and sets it as active
@@ -258,7 +277,7 @@ export declare class DynamicWaasBitcoinConnector extends DynamicWaasBitcoinConne
     }): Promise<string>;
     /**
      * Builds a PSBT for a Bitcoin transaction with real UTXOs
-     * @param transaction - The Bitcoin transaction containing recipient address and amount in satoshis to send
+     * @param transaction - Bitcoin transaction with recipient address, amount in satoshis, and optional fee priority
      * @returns A PSBT in Base64 format
      * @throws {DynamicError} If no active account address, insufficient funds, or other errors
      */

package/src/connectors/DynamicWaasBitcoinConnector/DynamicWaasBitcoinConnector.js

@@ -124,11 +124,15 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
         });
     }
     /**
-     * Signs a Partially Signed Bitcoin Transaction (PSBT)
-     * @param request - The PSBT signing request containing the unsigned PSBT
-     * @returns The signed PSBT response
+     * Signs a Partially Signed Bitcoin Transaction (PSBT) for embedded wallets
+     *
+     * Embedded wallets only support PSBT format and automatically sign all inputs
+     * that belong to the wallet address. Always uses SIGHASH_ALL (0x01).
+     *
+     * @param request - The PSBT signing request. Only unsignedPsbtBase64 is required.
+     * @returns The signed (but not finalized) PSBT response
      * @throws {DynamicError} If active account address is not set
-     * @throws {DynamicError} If signed session ID is not available or signature is provided
+     * @throws {DynamicError} If signed session ID is not available
      */
     signPsbt(request) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -144,9 +148,6 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
             const mfaToken = yield ((_b = this.getMfaToken) === null || _b === void 0 ? void 0 : _b.call(this, {
                 mfaAction: MFAAction.WalletWaasSign,
             }));
-            if (request.signature && request.signature.length > 0) {
-                throw new DynamicError('Signature is not supported for waas at the moment');
-            }
             const signedTransaction = yield walletClient.signTransaction({
                 authToken: (_c = this.getAuthToken) === null || _c === void 0 ? void 0 : _c.call(this),
                 mfaToken,
@@ -188,9 +189,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
             // Step 1: Build the PSBT
             const unsignedPsbt = yield this.buildPsbt(transaction);
             // Step 2: Sign the PSBT
-            // SIGHASH_ALL (0x01) is the most common sighash type for Bitcoin transactions (Eventually can be configurable)
             const signedPsbtResponse = yield this.signPsbt({
-                allowedSighash: [0x01],
                 unsignedPsbtBase64: unsignedPsbt,
             });
             if (!signedPsbtResponse) {
@@ -234,13 +233,14 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
      * @param thresholdSignatureScheme - The threshold signature scheme (default: 'TWO_OF_TWO')
      * @param publicAddressCheck - Optional public address to verify against
      * @param addressType - Required address type for Bitcoin ('native_segwit' or 'taproot')
+     * @param legacyWalletId - Optional ID of the legacy wallet being upgraded
      * @throws {DynamicError} If addressType is missing or invalid for BTC
      */
     importPrivateKey(_a) {
         const _super = Object.create(null, {
             importPrivateKey: { get: () => super.importPrivateKey }
         });
-        return __awaiter(this, arguments, void 0, function* ({ privateKey, thresholdSignatureScheme = 'TWO_OF_TWO', publicAddressCheck, addressType, }) {
+        return __awaiter(this, arguments, void 0, function* ({ privateKey, thresholdSignatureScheme = 'TWO_OF_TWO', publicAddressCheck, addressType, legacyWalletId, }) {
             if (!addressType) {
                 throw new DynamicError('addressType is required for BTC importPrivateKey');
             }
@@ -250,6 +250,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
             }
             return _super.importPrivateKey.call(this, {
                 addressType,
+                legacyWalletId,
                 privateKey,
                 publicAddressCheck,
                 thresholdSignatureScheme,
@@ -333,7 +334,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
     }
     /**
      * Builds a PSBT for a Bitcoin transaction with real UTXOs
-     * @param transaction - The Bitcoin transaction containing recipient address and amount in satoshis to send
+     * @param transaction - Bitcoin transaction with recipient address, amount in satoshis, and optional fee priority
      * @returns A PSBT in Base64 format
      * @throws {DynamicError} If no active account address, insufficient funds, or other errors
      */
@@ -343,7 +344,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
                 throw new DynamicError('Active account address is required');
             }
             const publicKeyHex = yield this.getPublicKey();
-            const buildOptions = PsbtBuilderService.createBuildOptions(this.activeAccountAddress, transaction, publicKeyHex);
+            const buildOptions = PsbtBuilderService.createBuildOptions(this.activeAccountAddress, transaction, publicKeyHex, transaction.feePriority || 'medium');
             return this.psbtBuilderService.buildPsbt(buildOptions);
         });
     }

package/src/const.cjs

@@ -12,20 +12,28 @@ const MEMPOOL_API_URL_TESTNET = 'https://mempool.space/testnet/api';
 // WaaS Bitcoin constants
 const SATOSHIS_PER_BTC = 100000000;
 const DUST_LIMIT = 546; // Bitcoin's dust limit in satoshis
-const INPUT_BYTE_SIZE_UPPER_BOUND = 90;
-const OUTPUT_BYTE_SIZE_UPPER_BOUND = 45;
+// Accurate vSize constants for Native SegWit (P2WPKH) transactions
+// These are used for precise fee estimation
+const VSIZE_OVERHEAD = 10.5; // Base transaction overhead in vBytes
+const VSIZE_INPUT_P2WPKH = 68; // Each P2WPKH input in vBytes
+const VSIZE_OUTPUT_P2WPKH = 31; // Each P2WPKH output in vBytes
 const MIN_RELAY_FEE = 111;
 const DEFAULT_FEE_ESTIMATE = 1000; // Conservative default fee estimate in satoshis
+// RBF (Replace-By-Fee) sequence number
+// 0xfffffffd = 4294967293 (enables RBF, not final)
+const RBF_SEQUENCE = 0xfffffffd;
 
 exports.BTCKIT_INTERFACE = BTCKIT_INTERFACE;
 exports.DEFAULT_FEE_ESTIMATE = DEFAULT_FEE_ESTIMATE;
 exports.DUST_LIMIT = DUST_LIMIT;
 exports.HTTP_STATUS_NOT_FOUND = HTTP_STATUS_NOT_FOUND;
 exports.HTTP_STATUS_TOO_MANY_REQUESTS = HTTP_STATUS_TOO_MANY_REQUESTS;
-exports.INPUT_BYTE_SIZE_UPPER_BOUND = INPUT_BYTE_SIZE_UPPER_BOUND;
 exports.MEMPOOL_API_URL = MEMPOOL_API_URL;
 exports.MEMPOOL_API_URL_TESTNET = MEMPOOL_API_URL_TESTNET;
 exports.MIN_RELAY_FEE = MIN_RELAY_FEE;
-exports.OUTPUT_BYTE_SIZE_UPPER_BOUND = OUTPUT_BYTE_SIZE_UPPER_BOUND;
+exports.RBF_SEQUENCE = RBF_SEQUENCE;
 exports.SATOSHIS_PER_BTC = SATOSHIS_PER_BTC;
 exports.SATSCONNECT_FEATURE = SATSCONNECT_FEATURE;
+exports.VSIZE_INPUT_P2WPKH = VSIZE_INPUT_P2WPKH;
+exports.VSIZE_OUTPUT_P2WPKH = VSIZE_OUTPUT_P2WPKH;
+exports.VSIZE_OVERHEAD = VSIZE_OVERHEAD;

package/src/const.d.ts

@@ -7,7 +7,9 @@ export declare const MEMPOOL_API_URL = "https://mempool.space/api";
 export declare const MEMPOOL_API_URL_TESTNET = "https://mempool.space/testnet/api";
 export declare const SATOSHIS_PER_BTC = 100000000;
 export declare const DUST_LIMIT = 546;
-export declare const INPUT_BYTE_SIZE_UPPER_BOUND = 90;
-export declare const OUTPUT_BYTE_SIZE_UPPER_BOUND = 45;
+export declare const VSIZE_OVERHEAD = 10.5;
+export declare const VSIZE_INPUT_P2WPKH = 68;
+export declare const VSIZE_OUTPUT_P2WPKH = 31;
 export declare const MIN_RELAY_FEE = 111;
 export declare const DEFAULT_FEE_ESTIMATE = 1000;
+export declare const RBF_SEQUENCE = 4294967293;

package/src/const.js

@@ -8,9 +8,15 @@ const MEMPOOL_API_URL_TESTNET = 'https://mempool.space/testnet/api';
 // WaaS Bitcoin constants
 const SATOSHIS_PER_BTC = 100000000;
 const DUST_LIMIT = 546; // Bitcoin's dust limit in satoshis
-const INPUT_BYTE_SIZE_UPPER_BOUND = 90;
-const OUTPUT_BYTE_SIZE_UPPER_BOUND = 45;
+// Accurate vSize constants for Native SegWit (P2WPKH) transactions
+// These are used for precise fee estimation
+const VSIZE_OVERHEAD = 10.5; // Base transaction overhead in vBytes
+const VSIZE_INPUT_P2WPKH = 68; // Each P2WPKH input in vBytes
+const VSIZE_OUTPUT_P2WPKH = 31; // Each P2WPKH output in vBytes
 const MIN_RELAY_FEE = 111;
 const DEFAULT_FEE_ESTIMATE = 1000; // Conservative default fee estimate in satoshis
+// RBF (Replace-By-Fee) sequence number
+// 0xfffffffd = 4294967293 (enables RBF, not final)
+const RBF_SEQUENCE = 0xfffffffd;
 
-export { BTCKIT_INTERFACE, DEFAULT_FEE_ESTIMATE, DUST_LIMIT, HTTP_STATUS_NOT_FOUND, HTTP_STATUS_TOO_MANY_REQUESTS, INPUT_BYTE_SIZE_UPPER_BOUND, MEMPOOL_API_URL, MEMPOOL_API_URL_TESTNET, MIN_RELAY_FEE, OUTPUT_BYTE_SIZE_UPPER_BOUND, SATOSHIS_PER_BTC, SATSCONNECT_FEATURE };
+export { BTCKIT_INTERFACE, DEFAULT_FEE_ESTIMATE, DUST_LIMIT, HTTP_STATUS_NOT_FOUND, HTTP_STATUS_TOO_MANY_REQUESTS, MEMPOOL_API_URL, MEMPOOL_API_URL_TESTNET, MIN_RELAY_FEE, RBF_SEQUENCE, SATOSHIS_PER_BTC, SATSCONNECT_FEATURE, VSIZE_INPUT_P2WPKH, VSIZE_OUTPUT_P2WPKH, VSIZE_OVERHEAD };

package/src/index.d.ts

@@ -1,6 +1,6 @@
 import { OkxConnector } from './connectors';
 export { BitcoinWalletConnector, type BitcoinWalletConnectorOpts, } from './connectors';
-export type { BitcoinTransaction, BitcoinSignProtocol, BitcoinSignPsbtRequest, BitcoinSignPsbtResponse, BitcoinWalletStandardMethods, SignPsbtOptions, } from './types';
+export type { BitcoinTransaction, BitcoinSignProtocol, BitcoinSignPsbtRequest, BitcoinSignPsbtResponse, BitcoinWalletStandardMethods, SignPsbtOptions, EmbeddedWalletSignPsbtRequest, } from './types';
 export * from './utils';
 export * from './wallet';
 export { UnisatConnector, BitcoinSatsConnectConnector, DynamicWaasBitcoinConnector, } from './connectors';

package/src/services/MempoolApiService.cjs

@@ -70,21 +70,44 @@ class MempoolApiService {
         });
     }
     /**
-     * Estimates transaction fees based on number of inputs and outputs
+     * Estimates transaction fees based on number of inputs and outputs using accurate vSize
      * @param address - The Bitcoin address to determine the network from
      * @param numInputs - Number of transaction inputs
      * @param numOutputs - Number of transaction outputs
+     * @param feePriority - Fee priority level (high/medium/low)
      * @returns Estimated fee in satoshis
      */
-    estimateTransactionFee(address, numInputs, numOutputs) {
-        return _tslib.__awaiter(this, void 0, void 0, function* () {
+    estimateTransactionFee(address_1, numInputs_1, numOutputs_1) {
+        return _tslib.__awaiter(this, arguments, void 0, function* (address, numInputs, numOutputs, feePriority = 'medium') {
             try {
                 const feeData = yield this.getFeeRecommendations(address);
-                const feePerByte = feeData.hourFee || feeData.economyFee || 1;
-                const estimatedFee = feePerByte *
-                    (_const.INPUT_BYTE_SIZE_UPPER_BOUND * numInputs +
-                        _const.OUTPUT_BYTE_SIZE_UPPER_BOUND * numOutputs) +
-                    _const.MIN_RELAY_FEE;
+                // High (Fastest): fastestFee -> Block 1
+                // Medium (Fast): halfHourFee -> Blocks 2-3
+                // Low (Eco): economyFee (preferred) or hourFee -> Blocks 6+
+                let feePerByte;
+                switch (feePriority) {
+                    case 'high':
+                        feePerByte =
+                            feeData.fastestFee || feeData.halfHourFee || feeData.hourFee || 1;
+                        break;
+                    case 'low':
+                        feePerByte = feeData.economyFee || feeData.hourFee || 1;
+                        break;
+                    case 'medium':
+                    default:
+                        feePerByte =
+                            feeData.halfHourFee || feeData.hourFee || feeData.economyFee || 1;
+                        break;
+                }
+                logger.debug(`Fee estimation - Priority: ${feePriority}, fastestFee: ${feeData.fastestFee}, halfHourFee: ${feeData.halfHourFee}, hourFee: ${feeData.hourFee}, economyFee: ${feeData.economyFee}, selected: ${feePerByte} sat/vB`);
+                // Use accurate vSize calculation for Native SegWit (P2WPKH)
+                // Formula: overhead + (inputs × 68) + (outputs × 31)
+                const vSize = _const.VSIZE_OVERHEAD +
+                    numInputs * _const.VSIZE_INPUT_P2WPKH +
+                    numOutputs * _const.VSIZE_OUTPUT_P2WPKH;
+                const estimatedFee = Math.ceil(feePerByte * vSize) + _const.MIN_RELAY_FEE;
+                logger.debug(`Fee calculation - Priority: ${feePriority}, vSize: ${vSize}, feePerByte: ${feePerByte} sat/vB, estimatedFee: ${estimatedFee} satoshis`);
+                logger.debug(`[MempoolApiService] Fee Priority: ${feePriority}, Selected Rate: ${feePerByte} sat/vB, vSize: ${vSize}, Estimated Fee: ${estimatedFee} satoshis`);
                 return estimatedFee;
             }
             catch (error) {

package/src/services/MempoolApiService.d.ts

@@ -24,13 +24,14 @@ export declare class MempoolApiService {
      */
     getFeeRecommendations(address: string): Promise<FeeRecommendations>;
     /**
-     * Estimates transaction fees based on number of inputs and outputs
+     * Estimates transaction fees based on number of inputs and outputs using accurate vSize
      * @param address - The Bitcoin address to determine the network from
      * @param numInputs - Number of transaction inputs
      * @param numOutputs - Number of transaction outputs
+     * @param feePriority - Fee priority level (high/medium/low)
      * @returns Estimated fee in satoshis
      */
-    estimateTransactionFee(address: string, numInputs: number, numOutputs: number): Promise<number>;
+    estimateTransactionFee(address: string, numInputs: number, numOutputs: number, feePriority?: 'high' | 'medium' | 'low'): Promise<number>;
     /**
      * Sends a raw Bitcoin transaction to the mempool
      * @param address - The Bitcoin address to determine the network from

package/src/services/MempoolApiService.js

@@ -9,7 +9,7 @@ import '@dynamic-labs/wallet-book';
 import '@dynamic-labs/sdk-api-core';
 import '@wallet-standard/app';
 import { getMempoolApiUrl } from '../utils/getMempoolApiUrl.js';
-import { INPUT_BYTE_SIZE_UPPER_BOUND, OUTPUT_BYTE_SIZE_UPPER_BOUND, MIN_RELAY_FEE, DEFAULT_FEE_ESTIMATE } from '../const.js';
+import { VSIZE_OVERHEAD, VSIZE_INPUT_P2WPKH, VSIZE_OUTPUT_P2WPKH, MIN_RELAY_FEE, DEFAULT_FEE_ESTIMATE } from '../const.js';
 import 'jsontokens';
 import '../connectors/DynamicWaasBitcoinConnector/DynamicWaasBitcoinConnector.js';
 
@@ -66,21 +66,44 @@ class MempoolApiService {
         });
     }
     /**
-     * Estimates transaction fees based on number of inputs and outputs
+     * Estimates transaction fees based on number of inputs and outputs using accurate vSize
      * @param address - The Bitcoin address to determine the network from
      * @param numInputs - Number of transaction inputs
      * @param numOutputs - Number of transaction outputs
+     * @param feePriority - Fee priority level (high/medium/low)
      * @returns Estimated fee in satoshis
      */
-    estimateTransactionFee(address, numInputs, numOutputs) {
-        return __awaiter(this, void 0, void 0, function* () {
+    estimateTransactionFee(address_1, numInputs_1, numOutputs_1) {
+        return __awaiter(this, arguments, void 0, function* (address, numInputs, numOutputs, feePriority = 'medium') {
             try {
                 const feeData = yield this.getFeeRecommendations(address);
-                const feePerByte = feeData.hourFee || feeData.economyFee || 1;
-                const estimatedFee = feePerByte *
-                    (INPUT_BYTE_SIZE_UPPER_BOUND * numInputs +
-                        OUTPUT_BYTE_SIZE_UPPER_BOUND * numOutputs) +
-                    MIN_RELAY_FEE;
+                // High (Fastest): fastestFee -> Block 1
+                // Medium (Fast): halfHourFee -> Blocks 2-3
+                // Low (Eco): economyFee (preferred) or hourFee -> Blocks 6+
+                let feePerByte;
+                switch (feePriority) {
+                    case 'high':
+                        feePerByte =
+                            feeData.fastestFee || feeData.halfHourFee || feeData.hourFee || 1;
+                        break;
+                    case 'low':
+                        feePerByte = feeData.economyFee || feeData.hourFee || 1;
+                        break;
+                    case 'medium':
+                    default:
+                        feePerByte =
+                            feeData.halfHourFee || feeData.hourFee || feeData.economyFee || 1;
+                        break;
+                }
+                logger.debug(`Fee estimation - Priority: ${feePriority}, fastestFee: ${feeData.fastestFee}, halfHourFee: ${feeData.halfHourFee}, hourFee: ${feeData.hourFee}, economyFee: ${feeData.economyFee}, selected: ${feePerByte} sat/vB`);
+                // Use accurate vSize calculation for Native SegWit (P2WPKH)
+                // Formula: overhead + (inputs × 68) + (outputs × 31)
+                const vSize = VSIZE_OVERHEAD +
+                    numInputs * VSIZE_INPUT_P2WPKH +
+                    numOutputs * VSIZE_OUTPUT_P2WPKH;
+                const estimatedFee = Math.ceil(feePerByte * vSize) + MIN_RELAY_FEE;
+                logger.debug(`Fee calculation - Priority: ${feePriority}, vSize: ${vSize}, feePerByte: ${feePerByte} sat/vB, estimatedFee: ${estimatedFee} satoshis`);
+                logger.debug(`[MempoolApiService] Fee Priority: ${feePriority}, Selected Rate: ${feePerByte} sat/vB, vSize: ${vSize}, Estimated Fee: ${estimatedFee} satoshis`);
                 return estimatedFee;
             }
             catch (error) {