@dynamic-labs/bitcoin 4.56.0 → 4.57.0

package/CHANGELOG.md

@@ -1,4 +1,17 @@
 
+## [4.57.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.56.0...v4.57.0) (2026-01-20)
+
+
+### Features
+
+* auto redirect back from wallet connect ([#10257](https://github.com/dynamic-labs/dynamic-auth/issues/10257)) ([92994da](https://github.com/dynamic-labs/dynamic-auth/commit/92994dadaae851e309b5f889c0e415241cb2d00f))
+
+
+### Bug Fixes
+
+* metamask console noise when signing in with wallet connect ([#10263](https://github.com/dynamic-labs/dynamic-auth/issues/10263)) ([1861e4a](https://github.com/dynamic-labs/dynamic-auth/commit/1861e4a3e78dd7d7a5a250da32f722a7bf972083))
+* only throw webview did not load error after retries ([#10255](https://github.com/dynamic-labs/dynamic-auth/issues/10255)) ([7c11824](https://github.com/dynamic-labs/dynamic-auth/commit/7c11824c32c9058c12aa5d6998b8cc3fe7e75938))
+
 ## [4.56.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.55.0...v4.56.0) (2026-01-19)
 
 

package/package.cjs

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

package/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/bitcoin",
-  "version": "4.56.0",
+  "version": "4.57.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.248",
+    "@dynamic-labs-wallet/browser-wallet-client": "0.0.250",
     "@bitcoinerlab/secp256k1": "1.1.1",
     "@btckit/types": "0.0.19",
-    "@dynamic-labs/sdk-api-core": "0.0.855",
+    "@dynamic-labs/sdk-api-core": "0.0.860",
     "@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.1",
     "jsontokens": "4.0.1",
-    "@dynamic-labs/assert-package-version": "4.56.0",
-    "@dynamic-labs/logger": "4.56.0",
-    "@dynamic-labs/types": "4.56.0",
-    "@dynamic-labs/utils": "4.56.0",
-    "@dynamic-labs/waas": "4.56.0",
-    "@dynamic-labs/wallet-book": "4.56.0",
-    "@dynamic-labs/wallet-connector-core": "4.56.0",
+    "@dynamic-labs/assert-package-version": "4.57.0",
+    "@dynamic-labs/logger": "4.57.0",
+    "@dynamic-labs/types": "4.57.0",
+    "@dynamic-labs/utils": "4.57.0",
+    "@dynamic-labs/waas": "4.57.0",
+    "@dynamic-labs/wallet-book": "4.57.0",
+    "@dynamic-labs/wallet-connector-core": "4.57.0",
     "eventemitter3": "5.0.1"
   },
   "peerDependencies": {}

package/src/connectors/DynamicWaasBitcoinConnector/DynamicWaasBitcoinConnector.cjs

@@ -17,6 +17,7 @@ var PsbtParser = require('../../utils/psbtParser/PsbtParser.cjs');
 require('sats-connect');
 require('jsontokens');
 var btcToSatoshis = require('../../utils/btcToSatoshis/btcToSatoshis.cjs');
+var BitcoinUiTransaction = require('../../utils/BitcoinUiTransaction/BitcoinUiTransaction.cjs');
 
 const logger = new logger$1.Logger('DynamicWaasConnector');
 /**
@@ -41,6 +42,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
         this.walletUiUtils = props.walletUiUtils;
         this.mempoolApiService = new MempoolApiService.MempoolApiService();
         this.psbtBuilderService = new PsbtBuilderService.PsbtBuilderService(this.mempoolApiService);
+        this.bitcoinNetworks = props.bitcoinNetworks || [];
     }
     set verifiedCredential(verifiedCredential) {
         this._verifiedCredential = verifiedCredential;
@@ -106,11 +108,45 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
     }
     /**
      * Gets the current Bitcoin network
-     * @returns The network name ('mainnet' for Bitcoin)
+     * Always returns Dynamic's networkId (1 for mainnet)
+     * @returns The Dynamic networkId (1) for Bitcoin mainnet
      */
     getNetwork() {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
-            return 'mainnet';
+            return 1;
+        });
+    }
+    /**
+     * Maps Dynamic's networkId to BitcoinNetwork enum for internal WaaS API calls
+     * Uses the current network from getNetwork() to determine the BitcoinNetwork value
+     * @returns The corresponding BitcoinNetwork enum value for the current network
+     */
+    getBitcoinNetworkEnum() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const networkId = yield this.getNetwork();
+            const networkIdToBitcoinNetwork = {
+                1: 'mainnet',
+            };
+            return ((_a = networkIdToBitcoinNetwork[networkId]) !== null && _a !== void 0 ? _a : 'mainnet');
+        });
+    }
+    /**
+     * Get the enabled networks for Bitcoin
+     * Returns configured networks from props
+     * @returns Array containing Bitcoin network configurations
+     */
+    getEnabledNetworks() {
+        return this.bitcoinNetworks;
+    }
+    /**
+     * Gets block explorer URLs for the current network
+     * Returns mempool.space for Bitcoin transactions
+     * @returns Array containing mempool.space URL
+     */
+    getBlockExplorerUrlsForCurrentNetwork() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            return ['https://mempool.space/'];
         });
     }
     /**
@@ -228,7 +264,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
             }
             const finalBitcoinConfig = {
                 addressType: bitcoinConfig.addressType,
-                network: yield this.getNetwork(),
+                network: yield this.getBitcoinNetworkEnum(),
             };
             return _super.createWalletAccount.call(this, {
                 bitcoinConfig: finalBitcoinConfig,
@@ -358,6 +394,88 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
             return this.psbtBuilderService.buildPsbt(buildOptions);
         });
     }
+    /**
+     * Creates a UI transaction for the send balance flow
+     * @param from - The address sending the transaction
+     * @returns A BitcoinUiTransaction instance
+     * @throws {DynamicError} If active account address is not set
+     */
+    createUiTransaction(from) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            logger.debug('[DynamicWaasBitcoinConnector] createUiTransaction called', {
+                activeAccountAddress: this.activeAccountAddress,
+                from,
+            });
+            try {
+                logger.debug('[DynamicWaasBitcoinConnector] Validating active wallet', {
+                    from,
+                });
+                yield this.validateActiveWallet(from);
+                logger.debug('[DynamicWaasBitcoinConnector] Active wallet validated successfully');
+            }
+            catch (error) {
+                logger.error('[DynamicWaasBitcoinConnector] Failed to validate active wallet', error);
+                throw error;
+            }
+            if (!this.activeAccountAddress) {
+                logger.error('[DynamicWaasBitcoinConnector] Active account address is required but not set');
+                throw new utils.DynamicError('Active account address is required');
+            }
+            logger.debug('[DynamicWaasBitcoinConnector] Creating BitcoinUiTransaction', {
+                from: this.activeAccountAddress,
+            });
+            const uiTransaction = new BitcoinUiTransaction.BitcoinUiTransaction({
+                from: this.activeAccountAddress,
+                mempoolApiService: this.mempoolApiService,
+                onSubmit: (transaction) => _tslib.__awaiter(this, void 0, void 0, function* () {
+                    var _a;
+                    logger.debug('[DynamicWaasBitcoinConnector] onSubmit called', {
+                        amount: (_a = transaction.amount) === null || _a === void 0 ? void 0 : _a.toString(),
+                        feePriority: transaction.feePriority,
+                        recipientAddress: transaction.recipientAddress,
+                    });
+                    if (!transaction.recipientAddress || !transaction.amount) {
+                        logger.error('[DynamicWaasBitcoinConnector] Missing required transaction fields', {
+                            hasAmount: !!transaction.amount,
+                            hasRecipientAddress: !!transaction.recipientAddress,
+                        });
+                        throw new utils.DynamicError('Recipient address and amount are required');
+                    }
+                    try {
+                        logger.debug('[DynamicWaasBitcoinConnector] Calling sendBitcoin', {
+                            amount: transaction.amount.toString(),
+                            feePriority: transaction.feePriority || 'medium',
+                            recipientAddress: transaction.recipientAddress,
+                        });
+                        const txHash = yield this.sendBitcoin({
+                            amount: transaction.amount,
+                            feePriority: transaction.feePriority || 'medium',
+                            recipientAddress: transaction.recipientAddress,
+                        });
+                        logger.debug('[DynamicWaasBitcoinConnector] sendBitcoin completed', {
+                            txHash,
+                        });
+                        if (!txHash) {
+                            logger.error('[DynamicWaasBitcoinConnector] sendBitcoin returned undefined');
+                            throw new utils.DynamicError('Failed to send Bitcoin transaction');
+                        }
+                        logger.info('[DynamicWaasBitcoinConnector] Transaction submitted successfully', { txHash });
+                        return txHash;
+                    }
+                    catch (error) {
+                        logger.error('[DynamicWaasBitcoinConnector] Error in onSubmit handler', error);
+                        throw error;
+                    }
+                }),
+            });
+            logger.debug('[DynamicWaasBitcoinConnector] BitcoinUiTransaction created successfully', {
+                hasOnSubmit: !!uiTransaction.submit,
+                transactionChain: uiTransaction.chain,
+                transactionFrom: uiTransaction.from,
+            });
+            return uiTransaction;
+        });
+    }
     /**
      * Parse a PSBT or finalized transaction and extract transaction information
      * Auto-detects format (hex/base64) and type (PSBT/finalized transaction)
@@ -458,7 +576,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
                 accountAddress: this.activeAccountAddress,
                 authToken: (_c = this.getAuthToken) === null || _c === void 0 ? void 0 : _c.call(this),
                 bitcoinConfig: {
-                    network: yield this.getNetwork(),
+                    network: yield this.getBitcoinNetworkEnum(),
                 },
                 message,
                 mfaToken,

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

@@ -1,8 +1,8 @@
-import { BitcoinConfig, BitcoinNetwork } from '@dynamic-labs-wallet/browser-wallet-client';
+import { BitcoinConfig } from '@dynamic-labs-wallet/browser-wallet-client';
 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, BitcoinSignPsbtResponse } from '@dynamic-labs/wallet-connector-core';
+import { WalletUiUtils, IUITransaction, GenericNetwork } from '@dynamic-labs/types';
+import { IDynamicWaasConnector, InternalWalletConnector, Chain, BitcoinSignPsbtResponse, ISendBalanceWalletConnector } from '@dynamic-labs/wallet-connector-core';
 import { BitcoinTransaction, EmbeddedWalletSignPsbtRequest } from '../../types';
 import { BitcoinWalletConnector } from '../BitcoinWalletConnector';
 import type { ParsedTransaction, DynamicWaasBitcoinConnectorProps } from '../../types';
@@ -57,11 +57,7 @@ declare const DynamicWaasBitcoinConnector_base: (abstract new (...args: any[]) =
         thresholdSignatureScheme?: string | undefined;
         publicAddressCheck?: string | undefined;
         addressType?: string | undefined;
-        legacyWalletId?: string | undefined; /**
-         * Override setVerifiedCredentials to filter and set Bitcoin WaaS credentials
-         * Filters for credentials with walletName === 'dynamicwaas' and chain === 'bip122'
-         * The base class already has verifiedCredentials property, so we just filter and set it
-         */
+        legacyWalletId?: string | undefined;
     }): Promise<void>;
     exportPrivateKey({ accountAddress, displayContainer, password, }?: {
         accountAddress?: string | undefined;
@@ -131,7 +127,7 @@ declare const DynamicWaasBitcoinConnector_base: (abstract new (...args: any[]) =
  * Bitcoin connector for Dynamic WaaS (Wallet as a Service)
  * Extends BitcoinWalletConnector with WaaS functionality for Bitcoin transactions
  */
-export declare class DynamicWaasBitcoinConnector extends DynamicWaasBitcoinConnector_base implements IDynamicWaasConnector {
+export declare class DynamicWaasBitcoinConnector extends DynamicWaasBitcoinConnector_base implements IDynamicWaasConnector, ISendBalanceWalletConnector {
     name: string;
     logger: Logger;
     overrideKey: string;
@@ -147,6 +143,7 @@ export declare class DynamicWaasBitcoinConnector extends DynamicWaasBitcoinConne
     private _verifiedCredential;
     private mempoolApiService;
     private psbtBuilderService;
+    private bitcoinNetworks;
     /**
      * @param props - Constructor properties including walletUiUtils
      */
@@ -173,9 +170,28 @@ export declare class DynamicWaasBitcoinConnector extends DynamicWaasBitcoinConne
     getConnectedAccounts(): Promise<string[]>;
     /**
      * Gets the current Bitcoin network
-     * @returns The network name ('mainnet' for Bitcoin)
+     * Always returns Dynamic's networkId (1 for mainnet)
+     * @returns The Dynamic networkId (1) for Bitcoin mainnet
      */
-    getNetwork(): Promise<BitcoinNetwork>;
+    getNetwork(): Promise<number>;
+    /**
+     * Maps Dynamic's networkId to BitcoinNetwork enum for internal WaaS API calls
+     * Uses the current network from getNetwork() to determine the BitcoinNetwork value
+     * @returns The corresponding BitcoinNetwork enum value for the current network
+     */
+    private getBitcoinNetworkEnum;
+    /**
+     * Get the enabled networks for Bitcoin
+     * Returns configured networks from props
+     * @returns Array containing Bitcoin network configurations
+     */
+    getEnabledNetworks(): GenericNetwork[];
+    /**
+     * Gets block explorer URLs for the current network
+     * Returns mempool.space for Bitcoin transactions
+     * @returns Array containing mempool.space URL
+     */
+    getBlockExplorerUrlsForCurrentNetwork(): Promise<string[]>;
     /**
      * Signs a message using the wallet UI utils for user interaction
      * @param message - The message to sign
@@ -283,6 +299,13 @@ export declare class DynamicWaasBitcoinConnector extends DynamicWaasBitcoinConne
      * @throws {DynamicError} If no active account address, insufficient funds, or other errors
      */
     buildPsbt(transaction: BitcoinTransaction): Promise<string>;
+    /**
+     * Creates a UI transaction for the send balance flow
+     * @param from - The address sending the transaction
+     * @returns A BitcoinUiTransaction instance
+     * @throws {DynamicError} If active account address is not set
+     */
+    createUiTransaction(from: string): Promise<IUITransaction>;
     /**
      * Parse a PSBT or finalized transaction and extract transaction information
      * Auto-detects format (hex/base64) and type (PSBT/finalized transaction)

package/src/connectors/DynamicWaasBitcoinConnector/DynamicWaasBitcoinConnector.js

@@ -13,6 +13,7 @@ import { PsbtParser } from '../../utils/psbtParser/PsbtParser.js';
 import 'sats-connect';
 import 'jsontokens';
 import { btcToSatoshis } from '../../utils/btcToSatoshis/btcToSatoshis.js';
+import { BitcoinUiTransaction } from '../../utils/BitcoinUiTransaction/BitcoinUiTransaction.js';
 
 const logger = new Logger('DynamicWaasConnector');
 /**
@@ -37,6 +38,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
         this.walletUiUtils = props.walletUiUtils;
         this.mempoolApiService = new MempoolApiService();
         this.psbtBuilderService = new PsbtBuilderService(this.mempoolApiService);
+        this.bitcoinNetworks = props.bitcoinNetworks || [];
     }
     set verifiedCredential(verifiedCredential) {
         this._verifiedCredential = verifiedCredential;
@@ -102,11 +104,45 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
     }
     /**
      * Gets the current Bitcoin network
-     * @returns The network name ('mainnet' for Bitcoin)
+     * Always returns Dynamic's networkId (1 for mainnet)
+     * @returns The Dynamic networkId (1) for Bitcoin mainnet
      */
     getNetwork() {
         return __awaiter(this, void 0, void 0, function* () {
-            return 'mainnet';
+            return 1;
+        });
+    }
+    /**
+     * Maps Dynamic's networkId to BitcoinNetwork enum for internal WaaS API calls
+     * Uses the current network from getNetwork() to determine the BitcoinNetwork value
+     * @returns The corresponding BitcoinNetwork enum value for the current network
+     */
+    getBitcoinNetworkEnum() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const networkId = yield this.getNetwork();
+            const networkIdToBitcoinNetwork = {
+                1: 'mainnet',
+            };
+            return ((_a = networkIdToBitcoinNetwork[networkId]) !== null && _a !== void 0 ? _a : 'mainnet');
+        });
+    }
+    /**
+     * Get the enabled networks for Bitcoin
+     * Returns configured networks from props
+     * @returns Array containing Bitcoin network configurations
+     */
+    getEnabledNetworks() {
+        return this.bitcoinNetworks;
+    }
+    /**
+     * Gets block explorer URLs for the current network
+     * Returns mempool.space for Bitcoin transactions
+     * @returns Array containing mempool.space URL
+     */
+    getBlockExplorerUrlsForCurrentNetwork() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return ['https://mempool.space/'];
         });
     }
     /**
@@ -224,7 +260,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
             }
             const finalBitcoinConfig = {
                 addressType: bitcoinConfig.addressType,
-                network: yield this.getNetwork(),
+                network: yield this.getBitcoinNetworkEnum(),
             };
             return _super.createWalletAccount.call(this, {
                 bitcoinConfig: finalBitcoinConfig,
@@ -354,6 +390,88 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
             return this.psbtBuilderService.buildPsbt(buildOptions);
         });
     }
+    /**
+     * Creates a UI transaction for the send balance flow
+     * @param from - The address sending the transaction
+     * @returns A BitcoinUiTransaction instance
+     * @throws {DynamicError} If active account address is not set
+     */
+    createUiTransaction(from) {
+        return __awaiter(this, void 0, void 0, function* () {
+            logger.debug('[DynamicWaasBitcoinConnector] createUiTransaction called', {
+                activeAccountAddress: this.activeAccountAddress,
+                from,
+            });
+            try {
+                logger.debug('[DynamicWaasBitcoinConnector] Validating active wallet', {
+                    from,
+                });
+                yield this.validateActiveWallet(from);
+                logger.debug('[DynamicWaasBitcoinConnector] Active wallet validated successfully');
+            }
+            catch (error) {
+                logger.error('[DynamicWaasBitcoinConnector] Failed to validate active wallet', error);
+                throw error;
+            }
+            if (!this.activeAccountAddress) {
+                logger.error('[DynamicWaasBitcoinConnector] Active account address is required but not set');
+                throw new DynamicError('Active account address is required');
+            }
+            logger.debug('[DynamicWaasBitcoinConnector] Creating BitcoinUiTransaction', {
+                from: this.activeAccountAddress,
+            });
+            const uiTransaction = new BitcoinUiTransaction({
+                from: this.activeAccountAddress,
+                mempoolApiService: this.mempoolApiService,
+                onSubmit: (transaction) => __awaiter(this, void 0, void 0, function* () {
+                    var _a;
+                    logger.debug('[DynamicWaasBitcoinConnector] onSubmit called', {
+                        amount: (_a = transaction.amount) === null || _a === void 0 ? void 0 : _a.toString(),
+                        feePriority: transaction.feePriority,
+                        recipientAddress: transaction.recipientAddress,
+                    });
+                    if (!transaction.recipientAddress || !transaction.amount) {
+                        logger.error('[DynamicWaasBitcoinConnector] Missing required transaction fields', {
+                            hasAmount: !!transaction.amount,
+                            hasRecipientAddress: !!transaction.recipientAddress,
+                        });
+                        throw new DynamicError('Recipient address and amount are required');
+                    }
+                    try {
+                        logger.debug('[DynamicWaasBitcoinConnector] Calling sendBitcoin', {
+                            amount: transaction.amount.toString(),
+                            feePriority: transaction.feePriority || 'medium',
+                            recipientAddress: transaction.recipientAddress,
+                        });
+                        const txHash = yield this.sendBitcoin({
+                            amount: transaction.amount,
+                            feePriority: transaction.feePriority || 'medium',
+                            recipientAddress: transaction.recipientAddress,
+                        });
+                        logger.debug('[DynamicWaasBitcoinConnector] sendBitcoin completed', {
+                            txHash,
+                        });
+                        if (!txHash) {
+                            logger.error('[DynamicWaasBitcoinConnector] sendBitcoin returned undefined');
+                            throw new DynamicError('Failed to send Bitcoin transaction');
+                        }
+                        logger.info('[DynamicWaasBitcoinConnector] Transaction submitted successfully', { txHash });
+                        return txHash;
+                    }
+                    catch (error) {
+                        logger.error('[DynamicWaasBitcoinConnector] Error in onSubmit handler', error);
+                        throw error;
+                    }
+                }),
+            });
+            logger.debug('[DynamicWaasBitcoinConnector] BitcoinUiTransaction created successfully', {
+                hasOnSubmit: !!uiTransaction.submit,
+                transactionChain: uiTransaction.chain,
+                transactionFrom: uiTransaction.from,
+            });
+            return uiTransaction;
+        });
+    }
     /**
      * Parse a PSBT or finalized transaction and extract transaction information
      * Auto-detects format (hex/base64) and type (PSBT/finalized transaction)
@@ -454,7 +572,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
                 accountAddress: this.activeAccountAddress,
                 authToken: (_c = this.getAuthToken) === null || _c === void 0 ? void 0 : _c.call(this),
                 bitcoinConfig: {
-                    network: yield this.getNetwork(),
+                    network: yield this.getBitcoinNetworkEnum(),
                 },
                 message,
                 mfaToken,

package/src/types.d.ts

@@ -2,7 +2,7 @@ import { BitcoinProvider, InputToSign as SatsConnectInputToSign } from 'sats-con
 import { SignPsbtResponse as BtcKitSignPsbtResponse } from '@btckit/types';
 import { IdentifierString, WalletAccount } from '@wallet-standard/base';
 import type { Network } from 'bitcoinjs-lib';
-import type { WalletUiUtils } from '@dynamic-labs/types';
+import type { GenericNetwork, WalletUiUtils } from '@dynamic-labs/types';
 import type { InternalWalletConnector } from '@dynamic-labs/wallet-connector-core';
 import type { WalletAdditionalAddress } from '@dynamic-labs/sdk-api-core';
 import type { BitcoinWalletConnectorOpts } from './connectors';
@@ -159,6 +159,7 @@ export interface ProviderWithBalance {
 }
 export type DynamicWaasBitcoinConnectorProps = BitcoinWalletConnectorOpts & {
     walletUiUtils: WalletUiUtils<InternalWalletConnector>;
+    bitcoinNetworks?: GenericNetwork[];
 };
 export interface UTXO {
     txid: string;

package/src/utils/BitcoinUiTransaction/BitcoinUiTransaction.cjs

@@ -0,0 +1,158 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../_virtual/_tslib.cjs');
+var utils = require('@dynamic-labs/utils');
+var _const = require('../../const.cjs');
+
+class BitcoinUiTransaction {
+    constructor({ onSubmit, from, mempoolApiService, }) {
+        this.chain = 'BTC';
+        this.data = undefined;
+        this.fee = { gas: undefined };
+        this.feePriority = 'medium';
+        /**
+         * Formats the value into a string for the UI for non-native tokens
+         * @param value - The value to format
+         * @param decimals - The number of decimals for the non-native token
+         * @returns The formatted value
+         */
+        this.formatNonNativeToken = (value, decimals) => (Number(value) / Number(Math.pow(10, decimals))).toString();
+        this.from = from;
+        this.onSubmit = onSubmit;
+        this.mempoolApiService = mempoolApiService;
+    }
+    /**
+     * Updates the fee priority and recalculates the fee
+     * @param priority - The new fee priority (high/medium/low)
+     */
+    updateFeePriority(priority) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (this.feePriority === priority) {
+                return;
+            }
+            this.feePriority = priority;
+            this.fee.gas = undefined;
+            this.lastFeePriority = undefined;
+            if (this.to && this.value) {
+                yield this.fetchFee();
+            }
+        });
+    }
+    /**
+     * Fetches the estimated transaction fee
+     */
+    fetchFee() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            const shouldRecalculate = !this.fee.gas || this.lastFeePriority !== this.feePriority;
+            if (!shouldRecalculate) {
+                return;
+            }
+            if (!this.to || !this.value) {
+                return;
+            }
+            try {
+                const estimatedFee = yield this.mempoolApiService.estimateTransactionFee(this.from, 1, 1, this.feePriority);
+                this.fee.gas = BigInt(estimatedFee);
+                this.lastFeePriority = this.feePriority;
+            }
+            catch (error) {
+                // If fee estimation fails, leave it undefined
+                // The actual fee will be calculated when building the PSBT
+                this.fee.gas = undefined;
+                this.lastFeePriority = undefined;
+            }
+        });
+    }
+    /**
+     * Parses the input string into a bigint value in satoshis
+     * @param input - The input string to parse
+     * @returns The parsed value in satoshis
+     */
+    parse(input) {
+        const floatValue = parseFloat(input);
+        if (isNaN(floatValue)) {
+            return BigInt(0);
+        }
+        const satoshis = Math.round(floatValue * _const.SATOSHIS_PER_BTC);
+        return BigInt(satoshis);
+    }
+    /**
+     * Parses the input string into a bigint value in non-native tokens
+     * @param input - The input string to parse
+     * @param decimals - The number of decimals for the non-native token
+     * @returns The parsed value in non-native tokens
+     */
+    parseNonNativeToken(input, decimals) {
+        return BigInt(Math.floor(Number(input) * Math.pow(10, decimals)));
+    }
+    /**
+     * Formats the value into a string for the UI
+     * @param value - The value to format
+     * @param precision - The precision for the formatted value
+     * @returns The formatted value
+     */
+    format(value, { precision } = {}) {
+        const btcValue = Number(value) / _const.SATOSHIS_PER_BTC;
+        const decimalString = btcValue.toLocaleString('fullwide', {
+            maximumFractionDigits: 20,
+            minimumFractionDigits: 0,
+            useGrouping: false,
+        });
+        return utils.formatNumberText(decimalString, { precision });
+    }
+    /**
+     * Submits the transaction
+     * @returns The transaction hash
+     */
+    submit() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (!this.to) {
+                throw new Error('Recipient address is required');
+            }
+            if (!this.value || this.value <= BigInt(0)) {
+                throw new Error('Amount must be greater than 0');
+            }
+            const txHash = yield this.onSubmit({
+                amount: this.value,
+                feePriority: this.feePriority,
+                recipientAddress: this.to,
+            });
+            if (!txHash) {
+                throw new Error('Transaction failed - no transaction hash returned');
+            }
+            return txHash;
+        });
+    }
+    /**
+     * Fetches the balance of the sender in satoshis
+     * @returns The balance in satoshis
+     */
+    getBalance() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const balance = yield this.mempoolApiService.getUTXOs(this.from);
+                const totalBalance = balance.reduce((sum, utxo) => sum + utxo.value, 0);
+                return BigInt(totalBalance);
+            }
+            catch (error) {
+                return BigInt(0);
+            }
+        });
+    }
+    /**
+     * Validates the address format
+     * @param address - The address to validate
+     * @returns True if the address is valid, false otherwise
+     */
+    validateAddressFormat(address) {
+        if (address === 'dyn_send_transaction.multiple_recipients') {
+            return true;
+        }
+        return /^(bc1|[13]|tb1)[a-zA-HJ-NP-Z0-9]{25,62}$/.test(address);
+    }
+}
+
+exports.BitcoinUiTransaction = BitcoinUiTransaction;

package/src/utils/BitcoinUiTransaction/BitcoinUiTransaction.d.ts

@@ -0,0 +1,82 @@
+import { IUITransaction, IUITransactionFormatOptions } from '@dynamic-labs/types';
+import { MempoolApiService } from '../../services/MempoolApiService';
+import type { FeePriority } from '../../types';
+type BitcoinUiTransactionProps = {
+    from: string;
+    onSubmit: (transaction: {
+        amount: bigint;
+        recipientAddress: string;
+        feePriority?: FeePriority;
+    }) => Promise<string>;
+    mempoolApiService: MempoolApiService;
+};
+export declare class BitcoinUiTransaction implements IUITransaction {
+    to: string | undefined;
+    from: string;
+    value: bigint | undefined;
+    chain: string;
+    receipt: string | undefined;
+    data: undefined;
+    fee: {
+        gas: bigint | undefined;
+    };
+    nativePrice?: number;
+    feePriority: FeePriority;
+    private lastFeePriority?;
+    private onSubmit;
+    private mempoolApiService;
+    constructor({ onSubmit, from, mempoolApiService, }: BitcoinUiTransactionProps);
+    /**
+     * Updates the fee priority and recalculates the fee
+     * @param priority - The new fee priority (high/medium/low)
+     */
+    updateFeePriority(priority: FeePriority): Promise<void>;
+    /**
+     * Fetches the estimated transaction fee
+     */
+    fetchFee(): Promise<void>;
+    /**
+     * Parses the input string into a bigint value in satoshis
+     * @param input - The input string to parse
+     * @returns The parsed value in satoshis
+     */
+    parse(input: string): bigint;
+    /**
+     * Parses the input string into a bigint value in non-native tokens
+     * @param input - The input string to parse
+     * @param decimals - The number of decimals for the non-native token
+     * @returns The parsed value in non-native tokens
+     */
+    parseNonNativeToken(input: string, decimals: number): bigint;
+    /**
+     * Formats the value into a string for the UI for non-native tokens
+     * @param value - The value to format
+     * @param decimals - The number of decimals for the non-native token
+     * @returns The formatted value
+     */
+    formatNonNativeToken: (value: bigint, decimals: number) => string;
+    /**
+     * Formats the value into a string for the UI
+     * @param value - The value to format
+     * @param precision - The precision for the formatted value
+     * @returns The formatted value
+     */
+    format(value: bigint, { precision }?: IUITransactionFormatOptions): string;
+    /**
+     * Submits the transaction
+     * @returns The transaction hash
+     */
+    submit(): Promise<string>;
+    /**
+     * Fetches the balance of the sender in satoshis
+     * @returns The balance in satoshis
+     */
+    getBalance(): Promise<bigint>;
+    /**
+     * Validates the address format
+     * @param address - The address to validate
+     * @returns True if the address is valid, false otherwise
+     */
+    validateAddressFormat(address: string): boolean;
+}
+export {};

package/src/utils/BitcoinUiTransaction/BitcoinUiTransaction.js

@@ -0,0 +1,154 @@
+'use client'
+import { __awaiter } from '../../../_virtual/_tslib.js';
+import { formatNumberText } from '@dynamic-labs/utils';
+import { SATOSHIS_PER_BTC } from '../../const.js';
+
+class BitcoinUiTransaction {
+    constructor({ onSubmit, from, mempoolApiService, }) {
+        this.chain = 'BTC';
+        this.data = undefined;
+        this.fee = { gas: undefined };
+        this.feePriority = 'medium';
+        /**
+         * Formats the value into a string for the UI for non-native tokens
+         * @param value - The value to format
+         * @param decimals - The number of decimals for the non-native token
+         * @returns The formatted value
+         */
+        this.formatNonNativeToken = (value, decimals) => (Number(value) / Number(Math.pow(10, decimals))).toString();
+        this.from = from;
+        this.onSubmit = onSubmit;
+        this.mempoolApiService = mempoolApiService;
+    }
+    /**
+     * Updates the fee priority and recalculates the fee
+     * @param priority - The new fee priority (high/medium/low)
+     */
+    updateFeePriority(priority) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.feePriority === priority) {
+                return;
+            }
+            this.feePriority = priority;
+            this.fee.gas = undefined;
+            this.lastFeePriority = undefined;
+            if (this.to && this.value) {
+                yield this.fetchFee();
+            }
+        });
+    }
+    /**
+     * Fetches the estimated transaction fee
+     */
+    fetchFee() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const shouldRecalculate = !this.fee.gas || this.lastFeePriority !== this.feePriority;
+            if (!shouldRecalculate) {
+                return;
+            }
+            if (!this.to || !this.value) {
+                return;
+            }
+            try {
+                const estimatedFee = yield this.mempoolApiService.estimateTransactionFee(this.from, 1, 1, this.feePriority);
+                this.fee.gas = BigInt(estimatedFee);
+                this.lastFeePriority = this.feePriority;
+            }
+            catch (error) {
+                // If fee estimation fails, leave it undefined
+                // The actual fee will be calculated when building the PSBT
+                this.fee.gas = undefined;
+                this.lastFeePriority = undefined;
+            }
+        });
+    }
+    /**
+     * Parses the input string into a bigint value in satoshis
+     * @param input - The input string to parse
+     * @returns The parsed value in satoshis
+     */
+    parse(input) {
+        const floatValue = parseFloat(input);
+        if (isNaN(floatValue)) {
+            return BigInt(0);
+        }
+        const satoshis = Math.round(floatValue * SATOSHIS_PER_BTC);
+        return BigInt(satoshis);
+    }
+    /**
+     * Parses the input string into a bigint value in non-native tokens
+     * @param input - The input string to parse
+     * @param decimals - The number of decimals for the non-native token
+     * @returns The parsed value in non-native tokens
+     */
+    parseNonNativeToken(input, decimals) {
+        return BigInt(Math.floor(Number(input) * Math.pow(10, decimals)));
+    }
+    /**
+     * Formats the value into a string for the UI
+     * @param value - The value to format
+     * @param precision - The precision for the formatted value
+     * @returns The formatted value
+     */
+    format(value, { precision } = {}) {
+        const btcValue = Number(value) / SATOSHIS_PER_BTC;
+        const decimalString = btcValue.toLocaleString('fullwide', {
+            maximumFractionDigits: 20,
+            minimumFractionDigits: 0,
+            useGrouping: false,
+        });
+        return formatNumberText(decimalString, { precision });
+    }
+    /**
+     * Submits the transaction
+     * @returns The transaction hash
+     */
+    submit() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.to) {
+                throw new Error('Recipient address is required');
+            }
+            if (!this.value || this.value <= BigInt(0)) {
+                throw new Error('Amount must be greater than 0');
+            }
+            const txHash = yield this.onSubmit({
+                amount: this.value,
+                feePriority: this.feePriority,
+                recipientAddress: this.to,
+            });
+            if (!txHash) {
+                throw new Error('Transaction failed - no transaction hash returned');
+            }
+            return txHash;
+        });
+    }
+    /**
+     * Fetches the balance of the sender in satoshis
+     * @returns The balance in satoshis
+     */
+    getBalance() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const balance = yield this.mempoolApiService.getUTXOs(this.from);
+                const totalBalance = balance.reduce((sum, utxo) => sum + utxo.value, 0);
+                return BigInt(totalBalance);
+            }
+            catch (error) {
+                return BigInt(0);
+            }
+        });
+    }
+    /**
+     * Validates the address format
+     * @param address - The address to validate
+     * @returns True if the address is valid, false otherwise
+     */
+    validateAddressFormat(address) {
+        if (address === 'dyn_send_transaction.multiple_recipients') {
+            return true;
+        }
+        return /^(bc1|[13]|tb1)[a-zA-HJ-NP-Z0-9]{25,62}$/.test(address);
+    }
+}
+
+export { BitcoinUiTransaction };

package/src/utils/BitcoinUiTransaction/index.d.ts

@@ -0,0 +1 @@
+export { BitcoinUiTransaction } from './BitcoinUiTransaction';