@dynamic-labs/bitcoin 4.91.3 → 4.91.4

package/CHANGELOG.md

@@ -1,4 +1,12 @@
 
+### [4.91.4](https://github.com/dynamic-labs/dynamic-auth/compare/v4.91.3...v4.91.4) (2026-07-01)
+
+
+### Bug Fixes
+
+* conditionally use /op/ route for AA transactions based on block explorer support ([#11628](https://github.com/dynamic-labs/dynamic-auth/issues/11628)) ([95822dc](https://github.com/dynamic-labs/dynamic-auth/commit/95822dc0edbcd739afe870f0b3881555fdb17eb6))
+* require error codes in all SDK error classes ([#11761](https://github.com/dynamic-labs/dynamic-auth/issues/11761)) ([5744811](https://github.com/dynamic-labs/dynamic-auth/commit/5744811efdd1e415aaf51eec5b3300b323ec1347))
+
 ### [4.91.3](https://github.com/dynamic-labs/dynamic-auth/compare/v4.91.2...v4.91.3) (2026-06-30)
 
 

package/package.cjs

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

package/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/bitcoin",
-  "version": "4.91.3",
+  "version": "4.91.4",
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -29,13 +29,13 @@
     "ecpair": "2.1.0",
     "sats-connect": "4.2.1",
     "jsontokens": "4.0.1",
-    "@dynamic-labs/assert-package-version": "4.91.3",
-    "@dynamic-labs/logger": "4.91.3",
-    "@dynamic-labs/types": "4.91.3",
-    "@dynamic-labs/utils": "4.91.3",
-    "@dynamic-labs/waas": "4.91.3",
-    "@dynamic-labs/wallet-book": "4.91.3",
-    "@dynamic-labs/wallet-connector-core": "4.91.3",
+    "@dynamic-labs/assert-package-version": "4.91.4",
+    "@dynamic-labs/logger": "4.91.4",
+    "@dynamic-labs/types": "4.91.4",
+    "@dynamic-labs/utils": "4.91.4",
+    "@dynamic-labs/waas": "4.91.4",
+    "@dynamic-labs/wallet-book": "4.91.4",
+    "@dynamic-labs/wallet-connector-core": "4.91.4",
     "eventemitter3": "5.0.1"
   },
   "peerDependencies": {}

package/src/connectors/BitcoinWalletConnector.cjs

@@ -178,11 +178,11 @@ class BitcoinWalletConnector extends walletConnectorCore.WalletConnectorBase {
     sendRawTransaction(rawTransaction) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             if (!rawTransaction) {
-                throw new utils.DynamicError('No transaction specified!');
+                throw new utils.DynamicError('No transaction specified!', 'no_transaction_specified');
             }
             const [connectedAddress] = yield this.getConnectedAccounts();
             if (!connectedAddress) {
-                throw new utils.DynamicError('No connected address found!');
+                throw new utils.DynamicError('No connected address found!', 'no_connected_address_found');
             }
             const API_URL = getMempoolApiUrl.getMempoolApiUrl(connectedAddress);
             const response = yield fetch(`${API_URL}/tx`, {
@@ -194,11 +194,11 @@ class BitcoinWalletConnector extends walletConnectorCore.WalletConnectorBase {
             });
             if (!response.ok) {
                 if (response.status === _const.HTTP_STATUS_TOO_MANY_REQUESTS) {
-                    throw new utils.DynamicError('sendRawTransaction - mempool api rate limit exceeded');
+                    throw new utils.DynamicError('sendRawTransaction - mempool api rate limit exceeded', 'sendrawtransaction_mempool_api_rate_limit_exceeded');
                 }
                 const error = yield response.text();
                 walletConnectorCore.logger.debug(`sendRawTransaction - response not ok: ${JSON.stringify(error)}`);
-                throw new utils.DynamicError('sendRawTransaction - failed to send transaction');
+                throw new utils.DynamicError('sendRawTransaction - failed to send transaction', 'sendrawtransaction_failed_to_send_transaction');
             }
             // this endpoint returns the transaction ID
             return response.text();

package/src/connectors/BitcoinWalletConnector.js

@@ -174,11 +174,11 @@ class BitcoinWalletConnector extends WalletConnectorBase {
     sendRawTransaction(rawTransaction) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!rawTransaction) {
-                throw new DynamicError('No transaction specified!');
+                throw new DynamicError('No transaction specified!', 'no_transaction_specified');
             }
             const [connectedAddress] = yield this.getConnectedAccounts();
             if (!connectedAddress) {
-                throw new DynamicError('No connected address found!');
+                throw new DynamicError('No connected address found!', 'no_connected_address_found');
             }
             const API_URL = getMempoolApiUrl(connectedAddress);
             const response = yield fetch(`${API_URL}/tx`, {
@@ -190,11 +190,11 @@ class BitcoinWalletConnector extends WalletConnectorBase {
             });
             if (!response.ok) {
                 if (response.status === HTTP_STATUS_TOO_MANY_REQUESTS) {
-                    throw new DynamicError('sendRawTransaction - mempool api rate limit exceeded');
+                    throw new DynamicError('sendRawTransaction - mempool api rate limit exceeded', 'sendrawtransaction_mempool_api_rate_limit_exceeded');
                 }
                 const error = yield response.text();
                 logger.debug(`sendRawTransaction - response not ok: ${JSON.stringify(error)}`);
-                throw new DynamicError('sendRawTransaction - failed to send transaction');
+                throw new DynamicError('sendRawTransaction - failed to send transaction', 'sendrawtransaction_failed_to_send_transaction');
             }
             // this endpoint returns the transaction ID
             return response.text();

package/src/connectors/DynamicWaasBitcoinConnector/DynamicWaasBitcoinConnector.cjs

@@ -90,7 +90,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
                     this.setActiveAccount(address);
                     return address;
                 }
-                throw new utils.DynamicError('No active wallet address found');
+                throw new utils.DynamicError('No active wallet address found', 'no_active_wallet_address_found');
             }
             return activeAccount.address;
         });
@@ -180,11 +180,11 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
             var _a, _b, _c, _d;
             const walletClient = yield this.getWaasWalletClient();
             if (!this.activeAccountAddress) {
-                throw new utils.DynamicError('Active account address is required');
+                throw new utils.DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const signedSessionId = yield ((_a = this.getSignedSessionId) === null || _a === void 0 ? void 0 : _a.call(this));
             if (!signedSessionId) {
-                throw new utils.DynamicError('Signed session ID is required');
+                throw new utils.DynamicError('Signed session ID is required', 'signed_session_id_is_required');
             }
             const mfaToken = yield ((_b = this.getMfaToken) === null || _b === void 0 ? void 0 : _b.call(this, {
                 mfaAction: sdkApiCore.MFAAction.WalletWaasSign,
@@ -218,7 +218,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
     sendRawTransaction(rawTransaction) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             if (!this.activeAccountAddress) {
-                throw new utils.DynamicError('Active account address is required');
+                throw new utils.DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             return this.mempoolApiService.sendRawTransaction(this.activeAccountAddress, rawTransaction);
         });
@@ -233,7 +233,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
     sendBitcoin(transaction) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             if (!this.activeAccountAddress) {
-                throw new utils.DynamicError('Active account address is required');
+                throw new utils.DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             // Step 1: Build the PSBT
             const unsignedPsbt = yield this.buildPsbt(transaction);
@@ -242,7 +242,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
                 unsignedPsbtBase64: unsignedPsbt,
             });
             if (!signedPsbtResponse) {
-                throw new utils.DynamicError('Failed to sign PSBT');
+                throw new utils.DynamicError('Failed to sign PSBT', 'sign_psbt_failed');
             }
             // Step 3: Finalize the signed PSBT and extract the raw transaction
             const network = this.activeAccountAddress.startsWith('t')
@@ -297,11 +297,11 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
         });
         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');
+                throw new utils.DynamicError('addressType is required for BTC importPrivateKey', 'addresstype_is_required_for_btc_importprivatekey');
             }
             const validAddressTypes = ['native_segwit', 'taproot'];
             if (!validAddressTypes.includes(addressType)) {
-                throw new utils.DynamicError(`Invalid addressType: ${addressType}. Must be one of: ${validAddressTypes.join(', ')}`);
+                throw new utils.DynamicError(`Invalid addressType: ${addressType}. Must be one of: ${validAddressTypes.join(', ')}`, 'invalid_addresstype_must_be_one_of');
             }
             return _super.importPrivateKey.call(this, {
                 addressType,
@@ -347,7 +347,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
                 signedSessionId: '',
             });
             if (!targetWallet) {
-                throw new utils.DynamicError('Account not found');
+                throw new utils.DynamicError('Account not found', 'account_not_found');
             }
             const isWalletActive = walletConnectorCore.isSameAddress(targetWallet.accountAddress, this.activeAccountAddress || '', this.connectedChain);
             if (!isWalletActive) {
@@ -368,11 +368,11 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
             var _b, _c, _d, _e;
             const walletClient = yield this.getWaasWalletClient();
             if (!this.activeAccountAddress) {
-                throw new utils.DynamicError('Active account address is required');
+                throw new utils.DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const signedSessionId = yield ((_b = this.getSignedSessionId) === null || _b === void 0 ? void 0 : _b.call(this));
             if (!signedSessionId) {
-                throw new utils.DynamicError('Signed session ID is required');
+                throw new utils.DynamicError('Signed session ID is required', 'signed_session_id_is_required');
             }
             const mfaToken = yield ((_c = this.getMfaToken) === null || _c === void 0 ? void 0 : _c.call(this, {
                 mfaAction: sdkApiCore.MFAAction.WalletWaasSign,
@@ -405,7 +405,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
     buildPsbt(transaction) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             if (!this.activeAccountAddress) {
-                throw new utils.DynamicError('Active account address is required');
+                throw new utils.DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const publicKeyHex = yield this.getPublicKey();
             const buildOptions = PsbtBuilderService.PsbtBuilderService.createBuildOptions(this.activeAccountAddress, transaction, publicKeyHex, transaction.feePriority || 'medium');
@@ -437,7 +437,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
             }
             if (!this.activeAccountAddress) {
                 logger.error('[DynamicWaasBitcoinConnector] Active account address is required but not set');
-                throw new utils.DynamicError('Active account address is required');
+                throw new utils.DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             logger.debug('[DynamicWaasBitcoinConnector] Creating BitcoinUiTransaction', {
                 from: this.activeAccountAddress,
@@ -457,7 +457,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
                             hasAmount: Boolean(transaction.amount),
                             hasRecipientAddress: Boolean(transaction.recipientAddress),
                         });
-                        throw new utils.DynamicError('Recipient address and amount are required');
+                        throw new utils.DynamicError('Recipient address and amount are required', 'recipient_address_and_amount_are_required');
                     }
                     try {
                         logger.debug('[DynamicWaasBitcoinConnector] Calling sendBitcoin', {
@@ -475,7 +475,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
                         });
                         if (!txHash) {
                             logger.error('[DynamicWaasBitcoinConnector] sendBitcoin returned undefined');
-                            throw new utils.DynamicError('Failed to send Bitcoin transaction');
+                            throw new utils.DynamicError('Failed to send Bitcoin transaction', 'send_bitcoin_transaction');
                         }
                         logger.info('[DynamicWaasBitcoinConnector] Transaction submitted successfully', { txHash });
                         return txHash;
@@ -530,11 +530,11 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             var _a;
             if (!this.activeAccountAddress) {
-                throw new utils.DynamicError('No active account address');
+                throw new utils.DynamicError('No active account address', 'no_active_account_address');
             }
             const allCredentials = (_a = this.verifiedCredentials) !== null && _a !== void 0 ? _a : [];
             if (allCredentials.length === 0) {
-                throw new utils.DynamicError(`No verified credentials found. The address ${this.activeAccountAddress} may not be properly registered.`);
+                throw new utils.DynamicError(`No verified credentials found. The address ${this.activeAccountAddress} may not be properly registered.`, 'no_verified_credentials_found_the_address');
             }
             for (const credential of allCredentials) {
                 const { walletAdditionalAddresses } = credential !== null && credential !== void 0 ? credential : {};
@@ -550,7 +550,7 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
                 .flatMap((cred) => { var _a; return (_a = cred.walletAdditionalAddresses) !== null && _a !== void 0 ? _a : []; })
                 .map((addr) => addr.address)
                 .join(', ');
-            throw new utils.DynamicError(`No additional address found for ${this.activeAccountAddress}. Available addresses: ${allAvailableAddresses || 'none'}`);
+            throw new utils.DynamicError(`No additional address found for ${this.activeAccountAddress}. Available addresses: ${allAvailableAddresses || 'none'}`, 'no_additional_address_found_for_available');
         });
     }
     /**
@@ -581,11 +581,11 @@ class DynamicWaasBitcoinConnector extends waas.withDynamicWaas(BitcoinWalletConn
             var _a, _b, _c, _d;
             const walletClient = yield this.getWaasWalletClient();
             if (!this.activeAccountAddress) {
-                throw new utils.DynamicError('Active account address is required');
+                throw new utils.DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const signedSessionId = yield ((_a = this.getSignedSessionId) === null || _a === void 0 ? void 0 : _a.call(this));
             if (!signedSessionId) {
-                throw new utils.DynamicError('Signed session ID is required');
+                throw new utils.DynamicError('Signed session ID is required', 'signed_session_id_is_required');
             }
             const mfaToken = yield ((_b = this.getMfaToken) === null || _b === void 0 ? void 0 : _b.call(this, {
                 mfaAction: sdkApiCore.MFAAction.WalletWaasSign,

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

@@ -120,11 +120,7 @@ declare const DynamicWaasBitcoinConnector_base: (abstract new (...args: any[]) =
     hideICloudSignIn(): Promise<void>;
     isICloudAuthenticated(): Promise<boolean>;
     refreshWalletAccountShares({ accountAddress, password, }: {
-        accountAddress: string; /**
-         * Gets block explorer URLs for the current network
-         * Returns mempool.space for Bitcoin transactions
-         * @returns Array containing mempool.space URL
-         */
+        accountAddress: string;
         password?: string | undefined;
     }): Promise<void>;
     reshareWalletAccountShares({ accountAddress, thresholdSignatureScheme, password, }: {

package/src/connectors/DynamicWaasBitcoinConnector/DynamicWaasBitcoinConnector.js

@@ -86,7 +86,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
                     this.setActiveAccount(address);
                     return address;
                 }
-                throw new DynamicError('No active wallet address found');
+                throw new DynamicError('No active wallet address found', 'no_active_wallet_address_found');
             }
             return activeAccount.address;
         });
@@ -176,11 +176,11 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
             var _a, _b, _c, _d;
             const walletClient = yield this.getWaasWalletClient();
             if (!this.activeAccountAddress) {
-                throw new DynamicError('Active account address is required');
+                throw new DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const signedSessionId = yield ((_a = this.getSignedSessionId) === null || _a === void 0 ? void 0 : _a.call(this));
             if (!signedSessionId) {
-                throw new DynamicError('Signed session ID is required');
+                throw new DynamicError('Signed session ID is required', 'signed_session_id_is_required');
             }
             const mfaToken = yield ((_b = this.getMfaToken) === null || _b === void 0 ? void 0 : _b.call(this, {
                 mfaAction: MFAAction.WalletWaasSign,
@@ -214,7 +214,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
     sendRawTransaction(rawTransaction) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.activeAccountAddress) {
-                throw new DynamicError('Active account address is required');
+                throw new DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             return this.mempoolApiService.sendRawTransaction(this.activeAccountAddress, rawTransaction);
         });
@@ -229,7 +229,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
     sendBitcoin(transaction) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.activeAccountAddress) {
-                throw new DynamicError('Active account address is required');
+                throw new DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             // Step 1: Build the PSBT
             const unsignedPsbt = yield this.buildPsbt(transaction);
@@ -238,7 +238,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
                 unsignedPsbtBase64: unsignedPsbt,
             });
             if (!signedPsbtResponse) {
-                throw new DynamicError('Failed to sign PSBT');
+                throw new DynamicError('Failed to sign PSBT', 'sign_psbt_failed');
             }
             // Step 3: Finalize the signed PSBT and extract the raw transaction
             const network = this.activeAccountAddress.startsWith('t')
@@ -293,11 +293,11 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
         });
         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');
+                throw new DynamicError('addressType is required for BTC importPrivateKey', 'addresstype_is_required_for_btc_importprivatekey');
             }
             const validAddressTypes = ['native_segwit', 'taproot'];
             if (!validAddressTypes.includes(addressType)) {
-                throw new DynamicError(`Invalid addressType: ${addressType}. Must be one of: ${validAddressTypes.join(', ')}`);
+                throw new DynamicError(`Invalid addressType: ${addressType}. Must be one of: ${validAddressTypes.join(', ')}`, 'invalid_addresstype_must_be_one_of');
             }
             return _super.importPrivateKey.call(this, {
                 addressType,
@@ -343,7 +343,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
                 signedSessionId: '',
             });
             if (!targetWallet) {
-                throw new DynamicError('Account not found');
+                throw new DynamicError('Account not found', 'account_not_found');
             }
             const isWalletActive = isSameAddress(targetWallet.accountAddress, this.activeAccountAddress || '', this.connectedChain);
             if (!isWalletActive) {
@@ -364,11 +364,11 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
             var _b, _c, _d, _e;
             const walletClient = yield this.getWaasWalletClient();
             if (!this.activeAccountAddress) {
-                throw new DynamicError('Active account address is required');
+                throw new DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const signedSessionId = yield ((_b = this.getSignedSessionId) === null || _b === void 0 ? void 0 : _b.call(this));
             if (!signedSessionId) {
-                throw new DynamicError('Signed session ID is required');
+                throw new DynamicError('Signed session ID is required', 'signed_session_id_is_required');
             }
             const mfaToken = yield ((_c = this.getMfaToken) === null || _c === void 0 ? void 0 : _c.call(this, {
                 mfaAction: MFAAction.WalletWaasSign,
@@ -401,7 +401,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
     buildPsbt(transaction) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.activeAccountAddress) {
-                throw new DynamicError('Active account address is required');
+                throw new DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const publicKeyHex = yield this.getPublicKey();
             const buildOptions = PsbtBuilderService.createBuildOptions(this.activeAccountAddress, transaction, publicKeyHex, transaction.feePriority || 'medium');
@@ -433,7 +433,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
             }
             if (!this.activeAccountAddress) {
                 logger.error('[DynamicWaasBitcoinConnector] Active account address is required but not set');
-                throw new DynamicError('Active account address is required');
+                throw new DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             logger.debug('[DynamicWaasBitcoinConnector] Creating BitcoinUiTransaction', {
                 from: this.activeAccountAddress,
@@ -453,7 +453,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
                             hasAmount: Boolean(transaction.amount),
                             hasRecipientAddress: Boolean(transaction.recipientAddress),
                         });
-                        throw new DynamicError('Recipient address and amount are required');
+                        throw new DynamicError('Recipient address and amount are required', 'recipient_address_and_amount_are_required');
                     }
                     try {
                         logger.debug('[DynamicWaasBitcoinConnector] Calling sendBitcoin', {
@@ -471,7 +471,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
                         });
                         if (!txHash) {
                             logger.error('[DynamicWaasBitcoinConnector] sendBitcoin returned undefined');
-                            throw new DynamicError('Failed to send Bitcoin transaction');
+                            throw new DynamicError('Failed to send Bitcoin transaction', 'send_bitcoin_transaction');
                         }
                         logger.info('[DynamicWaasBitcoinConnector] Transaction submitted successfully', { txHash });
                         return txHash;
@@ -526,11 +526,11 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
             if (!this.activeAccountAddress) {
-                throw new DynamicError('No active account address');
+                throw new DynamicError('No active account address', 'no_active_account_address');
             }
             const allCredentials = (_a = this.verifiedCredentials) !== null && _a !== void 0 ? _a : [];
             if (allCredentials.length === 0) {
-                throw new DynamicError(`No verified credentials found. The address ${this.activeAccountAddress} may not be properly registered.`);
+                throw new DynamicError(`No verified credentials found. The address ${this.activeAccountAddress} may not be properly registered.`, 'no_verified_credentials_found_the_address');
             }
             for (const credential of allCredentials) {
                 const { walletAdditionalAddresses } = credential !== null && credential !== void 0 ? credential : {};
@@ -546,7 +546,7 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
                 .flatMap((cred) => { var _a; return (_a = cred.walletAdditionalAddresses) !== null && _a !== void 0 ? _a : []; })
                 .map((addr) => addr.address)
                 .join(', ');
-            throw new DynamicError(`No additional address found for ${this.activeAccountAddress}. Available addresses: ${allAvailableAddresses || 'none'}`);
+            throw new DynamicError(`No additional address found for ${this.activeAccountAddress}. Available addresses: ${allAvailableAddresses || 'none'}`, 'no_additional_address_found_for_available');
         });
     }
     /**
@@ -577,11 +577,11 @@ class DynamicWaasBitcoinConnector extends withDynamicWaas(BitcoinWalletConnector
             var _a, _b, _c, _d;
             const walletClient = yield this.getWaasWalletClient();
             if (!this.activeAccountAddress) {
-                throw new DynamicError('Active account address is required');
+                throw new DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const signedSessionId = yield ((_a = this.getSignedSessionId) === null || _a === void 0 ? void 0 : _a.call(this));
             if (!signedSessionId) {
-                throw new DynamicError('Signed session ID is required');
+                throw new DynamicError('Signed session ID is required', 'signed_session_id_is_required');
             }
             const mfaToken = yield ((_b = this.getMfaToken) === null || _b === void 0 ? void 0 : _b.call(this, {
                 mfaAction: MFAAction.WalletWaasSign,

package/src/connectors/MagicEdenConnector/MagicEdenConnector.cjs

@@ -174,7 +174,7 @@ class MagicEdenConnector extends BitcoinSatsConnectConnector.BitcoinSatsConnectC
             // to ensure we use it rather than the general Sats Connect API for this method
             const provider = this.getProvider();
             if (!provider)
-                throw new utils.DynamicError('signTransactions failed: Magic Eden provider not found');
+                throw new utils.DynamicError('signTransactions failed: Magic Eden provider not found', 'signtransactions_failed_magic_eden_provider_not');
             return provider.signMultipleTransactions(request);
         });
     }

package/src/connectors/MagicEdenConnector/MagicEdenConnector.js

@@ -170,7 +170,7 @@ class MagicEdenConnector extends BitcoinSatsConnectConnector {
             // to ensure we use it rather than the general Sats Connect API for this method
             const provider = this.getProvider();
             if (!provider)
-                throw new DynamicError('signTransactions failed: Magic Eden provider not found');
+                throw new DynamicError('signTransactions failed: Magic Eden provider not found', 'signtransactions_failed_magic_eden_provider_not');
             return provider.signMultipleTransactions(request);
         });
     }

package/src/services/MempoolApiService.cjs

@@ -42,13 +42,13 @@ class MempoolApiService {
                 const baseUrl = this.getBaseUrl(address);
                 const response = yield fetch(`${baseUrl}/address/${address}/utxo`);
                 if (!response.ok) {
-                    throw new utils.DynamicError(`Failed to fetch UTXOs: ${response.statusText}`);
+                    throw new utils.DynamicError(`Failed to fetch UTXOs: ${response.statusText}`, 'fetch_utxos_failed');
                 }
                 return response.json();
             }
             catch (error) {
                 logger.error('Error fetching UTXOs:', error);
-                throw new utils.DynamicError('Failed to fetch UTXOs');
+                throw new utils.DynamicError('Failed to fetch UTXOs', 'fetch_utxos_failed');
             }
         });
     }
@@ -127,7 +127,7 @@ class MempoolApiService {
     sendRawTransaction(address, rawTransaction) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             if (!rawTransaction) {
-                throw new utils.DynamicError('No transaction specified!');
+                throw new utils.DynamicError('No transaction specified!', 'no_transaction_specified');
             }
             const baseUrl = this.getBaseUrl(address);
             const response = yield fetch(`${baseUrl}/tx`, {
@@ -140,7 +140,7 @@ class MempoolApiService {
             if (!response.ok) {
                 const error = yield response.text();
                 logger.debug(`sendRawTransaction - response not ok: ${JSON.stringify(error)}`);
-                throw new utils.DynamicError('sendRawTransaction - failed to send transaction');
+                throw new utils.DynamicError('sendRawTransaction - failed to send transaction', 'sendrawtransaction_failed_to_send_transaction');
             }
             return response.text();
         });

package/src/services/MempoolApiService.js

@@ -38,13 +38,13 @@ class MempoolApiService {
                 const baseUrl = this.getBaseUrl(address);
                 const response = yield fetch(`${baseUrl}/address/${address}/utxo`);
                 if (!response.ok) {
-                    throw new DynamicError(`Failed to fetch UTXOs: ${response.statusText}`);
+                    throw new DynamicError(`Failed to fetch UTXOs: ${response.statusText}`, 'fetch_utxos_failed');
                 }
                 return response.json();
             }
             catch (error) {
                 logger.error('Error fetching UTXOs:', error);
-                throw new DynamicError('Failed to fetch UTXOs');
+                throw new DynamicError('Failed to fetch UTXOs', 'fetch_utxos_failed');
             }
         });
     }
@@ -123,7 +123,7 @@ class MempoolApiService {
     sendRawTransaction(address, rawTransaction) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!rawTransaction) {
-                throw new DynamicError('No transaction specified!');
+                throw new DynamicError('No transaction specified!', 'no_transaction_specified');
             }
             const baseUrl = this.getBaseUrl(address);
             const response = yield fetch(`${baseUrl}/tx`, {
@@ -136,7 +136,7 @@ class MempoolApiService {
             if (!response.ok) {
                 const error = yield response.text();
                 logger.debug(`sendRawTransaction - response not ok: ${JSON.stringify(error)}`);
-                throw new DynamicError('sendRawTransaction - failed to send transaction');
+                throw new DynamicError('sendRawTransaction - failed to send transaction', 'sendrawtransaction_failed_to_send_transaction');
             }
             return response.text();
         });

package/src/services/PsbtBuilderService.cjs

@@ -36,7 +36,7 @@ class PsbtBuilderService {
         if (accountAddress.toLowerCase().startsWith('bc1p') ||
             accountAddress.toLowerCase().startsWith('tb1p')) {
             logger.warn(`Account address ${accountAddress} appears to be Taproot. Only Native SegWit (P2WPKH) is supported.`);
-            throw new utils.DynamicError('Taproot addresses are not supported. Only Native SegWit (P2WPKH) addresses are allowed.');
+            throw new utils.DynamicError('Taproot addresses are not supported. Only Native SegWit (P2WPKH) addresses are allowed.', 'taproot_addresses_are_not_supported_only');
         }
         return utxos;
     }
@@ -90,11 +90,11 @@ class PsbtBuilderService {
         if (selectedUTXOs.length < allUTXOs.length) {
             const allTotal = this.calculateUTXOTotal(allUTXOs);
             if (allTotal < requiredAmount) {
-                throw new utils.DynamicError(`Insufficient funds. Available: ${allTotal / _const.SATOSHIS_PER_BTC} BTC (${allTotal} satoshis), Required: ${amountInSatoshisNumber / _const.SATOSHIS_PER_BTC} BTC (${amountInSatoshisNumber} satoshis) + fees`);
+                throw new utils.DynamicError(`Insufficient funds. Available: ${allTotal / _const.SATOSHIS_PER_BTC} BTC (${allTotal} satoshis), Required: ${amountInSatoshisNumber / _const.SATOSHIS_PER_BTC} BTC (${amountInSatoshisNumber} satoshis) + fees`, 'insufficient_funds_available_btc_satoshis_required');
             }
             return allUTXOs;
         }
-        throw new utils.DynamicError(`Insufficient funds. Available: ${selectedTotal / _const.SATOSHIS_PER_BTC} BTC (${selectedTotal} satoshis), Required: ${amountInSatoshisNumber / _const.SATOSHIS_PER_BTC} BTC (${amountInSatoshisNumber} satoshis) + fees`);
+        throw new utils.DynamicError(`Insufficient funds. Available: ${selectedTotal / _const.SATOSHIS_PER_BTC} BTC (${selectedTotal} satoshis), Required: ${amountInSatoshisNumber / _const.SATOSHIS_PER_BTC} BTC (${amountInSatoshisNumber} satoshis) + fees`, 'insufficient_funds_available_btc_satoshis_required');
     }
     /**
      * Calculates fee estimate and change amount, handling dust limit
@@ -148,7 +148,7 @@ class PsbtBuilderService {
                 pubkey: publicKeyPair.publicKey,
             }).output;
             if (!outputScript) {
-                throw new utils.DynamicError('Failed to create segwit output script');
+                throw new utils.DynamicError('Failed to create segwit output script', 'create_segwit_output_script');
             }
             // Convert txid from hex string to Buffer and reverse it (Bitcoin uses little-endian)
             // The txid from the API is in big-endian format, but bitcoinjs-lib expects little-endian
@@ -176,7 +176,7 @@ class PsbtBuilderService {
      */
     addOutputsToPsbt(psbt, recipientAddress, accountAddress, amountInSatoshisNumber, changeAmountNumber, hasChangeOutput, network) {
         if (amountInSatoshisNumber < _const.DUST_LIMIT) {
-            throw new utils.DynamicError(`Amount is below dust limit of ${_const.DUST_LIMIT} satoshis (${_const.DUST_LIMIT / _const.SATOSHIS_PER_BTC} BTC)`);
+            throw new utils.DynamicError(`Amount is below dust limit of ${_const.DUST_LIMIT} satoshis (${_const.DUST_LIMIT / _const.SATOSHIS_PER_BTC} BTC)`, 'amount_is_below_dust_limit_of');
         }
         psbt.addOutput({
             script: bitcoinjsLib.address.toOutputScript(recipientAddress, network),
@@ -201,11 +201,11 @@ class PsbtBuilderService {
             const { accountAddress, recipientAddress, amountInSatoshis, publicKeyHex, network, feePriority = 'medium', } = options;
             logger.debug(`buildPsbt called with feePriority: ${feePriority}, amount: ${amountInSatoshis} satoshis`);
             if (amountInSatoshis <= BigInt(0)) {
-                throw new utils.DynamicError('Amount must be greater than 0');
+                throw new utils.DynamicError('Amount must be greater than 0', 'amount_must_be_greater_than_0');
             }
             const allUTXOs = yield this.mempoolApiService.getUTXOs(accountAddress);
             if (allUTXOs.length === 0) {
-                throw new utils.DynamicError('No UTXOs found for this address');
+                throw new utils.DynamicError('No UTXOs found for this address', 'no_utxos_found_for_this_address');
             }
             const utxos = this.filterTaprootUTXOs(accountAddress, allUTXOs);
             const publicKeyBuffer = Buffer.from(publicKeyHex, 'hex');
@@ -229,7 +229,7 @@ class PsbtBuilderService {
             // Final check: ensure we have enough after final fee calculation
             const maxToSpend = selectedTotalValue - feeEstimate;
             if (maxToSpend < amountInSatoshisNumber) {
-                throw new utils.DynamicError(`Insufficient funds. Available: ${maxToSpend / _const.SATOSHIS_PER_BTC} BTC (${maxToSpend} satoshis), Required: ${amountInSatoshisNumber / _const.SATOSHIS_PER_BTC} BTC (${amountInSatoshisNumber} satoshis)`);
+                throw new utils.DynamicError(`Insufficient funds. Available: ${maxToSpend / _const.SATOSHIS_PER_BTC} BTC (${maxToSpend} satoshis), Required: ${amountInSatoshisNumber / _const.SATOSHIS_PER_BTC} BTC (${amountInSatoshisNumber} satoshis)`, 'insufficient_funds_available_btc_satoshis_required');
             }
             // Create PSBT and add inputs/outputs
             const psbt = new bitcoinjsLib.Psbt({ network });

package/src/services/PsbtBuilderService.js

@@ -28,7 +28,7 @@ class PsbtBuilderService {
         if (accountAddress.toLowerCase().startsWith('bc1p') ||
             accountAddress.toLowerCase().startsWith('tb1p')) {
             logger.warn(`Account address ${accountAddress} appears to be Taproot. Only Native SegWit (P2WPKH) is supported.`);
-            throw new DynamicError('Taproot addresses are not supported. Only Native SegWit (P2WPKH) addresses are allowed.');
+            throw new DynamicError('Taproot addresses are not supported. Only Native SegWit (P2WPKH) addresses are allowed.', 'taproot_addresses_are_not_supported_only');
         }
         return utxos;
     }
@@ -82,11 +82,11 @@ class PsbtBuilderService {
         if (selectedUTXOs.length < allUTXOs.length) {
             const allTotal = this.calculateUTXOTotal(allUTXOs);
             if (allTotal < requiredAmount) {
-                throw new DynamicError(`Insufficient funds. Available: ${allTotal / SATOSHIS_PER_BTC} BTC (${allTotal} satoshis), Required: ${amountInSatoshisNumber / SATOSHIS_PER_BTC} BTC (${amountInSatoshisNumber} satoshis) + fees`);
+                throw new DynamicError(`Insufficient funds. Available: ${allTotal / SATOSHIS_PER_BTC} BTC (${allTotal} satoshis), Required: ${amountInSatoshisNumber / SATOSHIS_PER_BTC} BTC (${amountInSatoshisNumber} satoshis) + fees`, 'insufficient_funds_available_btc_satoshis_required');
             }
             return allUTXOs;
         }
-        throw new DynamicError(`Insufficient funds. Available: ${selectedTotal / SATOSHIS_PER_BTC} BTC (${selectedTotal} satoshis), Required: ${amountInSatoshisNumber / SATOSHIS_PER_BTC} BTC (${amountInSatoshisNumber} satoshis) + fees`);
+        throw new DynamicError(`Insufficient funds. Available: ${selectedTotal / SATOSHIS_PER_BTC} BTC (${selectedTotal} satoshis), Required: ${amountInSatoshisNumber / SATOSHIS_PER_BTC} BTC (${amountInSatoshisNumber} satoshis) + fees`, 'insufficient_funds_available_btc_satoshis_required');
     }
     /**
      * Calculates fee estimate and change amount, handling dust limit
@@ -140,7 +140,7 @@ class PsbtBuilderService {
                 pubkey: publicKeyPair.publicKey,
             }).output;
             if (!outputScript) {
-                throw new DynamicError('Failed to create segwit output script');
+                throw new DynamicError('Failed to create segwit output script', 'create_segwit_output_script');
             }
             // Convert txid from hex string to Buffer and reverse it (Bitcoin uses little-endian)
             // The txid from the API is in big-endian format, but bitcoinjs-lib expects little-endian
@@ -168,7 +168,7 @@ class PsbtBuilderService {
      */
     addOutputsToPsbt(psbt, recipientAddress, accountAddress, amountInSatoshisNumber, changeAmountNumber, hasChangeOutput, network) {
         if (amountInSatoshisNumber < DUST_LIMIT) {
-            throw new DynamicError(`Amount is below dust limit of ${DUST_LIMIT} satoshis (${DUST_LIMIT / SATOSHIS_PER_BTC} BTC)`);
+            throw new DynamicError(`Amount is below dust limit of ${DUST_LIMIT} satoshis (${DUST_LIMIT / SATOSHIS_PER_BTC} BTC)`, 'amount_is_below_dust_limit_of');
         }
         psbt.addOutput({
             script: address.toOutputScript(recipientAddress, network),
@@ -193,11 +193,11 @@ class PsbtBuilderService {
             const { accountAddress, recipientAddress, amountInSatoshis, publicKeyHex, network, feePriority = 'medium', } = options;
             logger.debug(`buildPsbt called with feePriority: ${feePriority}, amount: ${amountInSatoshis} satoshis`);
             if (amountInSatoshis <= BigInt(0)) {
-                throw new DynamicError('Amount must be greater than 0');
+                throw new DynamicError('Amount must be greater than 0', 'amount_must_be_greater_than_0');
             }
             const allUTXOs = yield this.mempoolApiService.getUTXOs(accountAddress);
             if (allUTXOs.length === 0) {
-                throw new DynamicError('No UTXOs found for this address');
+                throw new DynamicError('No UTXOs found for this address', 'no_utxos_found_for_this_address');
             }
             const utxos = this.filterTaprootUTXOs(accountAddress, allUTXOs);
             const publicKeyBuffer = Buffer.from(publicKeyHex, 'hex');
@@ -221,7 +221,7 @@ class PsbtBuilderService {
             // Final check: ensure we have enough after final fee calculation
             const maxToSpend = selectedTotalValue - feeEstimate;
             if (maxToSpend < amountInSatoshisNumber) {
-                throw new DynamicError(`Insufficient funds. Available: ${maxToSpend / SATOSHIS_PER_BTC} BTC (${maxToSpend} satoshis), Required: ${amountInSatoshisNumber / SATOSHIS_PER_BTC} BTC (${amountInSatoshisNumber} satoshis)`);
+                throw new DynamicError(`Insufficient funds. Available: ${maxToSpend / SATOSHIS_PER_BTC} BTC (${maxToSpend} satoshis), Required: ${amountInSatoshisNumber / SATOSHIS_PER_BTC} BTC (${amountInSatoshisNumber} satoshis)`, 'insufficient_funds_available_btc_satoshis_required');
             }
             // Create PSBT and add inputs/outputs
             const psbt = new Psbt({ network });

package/src/utils/btcToSatoshis/btcToSatoshis.cjs

@@ -14,7 +14,7 @@ var _const = require('../../const.cjs');
  */
 const btcToSatoshis = (btcAmount) => {
     if (btcAmount < 0) {
-        throw new utils.DynamicError('BTC amount cannot be negative');
+        throw new utils.DynamicError('BTC amount cannot be negative', 'btc_amount_cannot_be_negative');
     }
     // Convert to satoshis and return as BigInt
     const satoshis = Math.floor(btcAmount * _const.SATOSHIS_PER_BTC);

package/src/utils/btcToSatoshis/btcToSatoshis.js

@@ -10,7 +10,7 @@ import { SATOSHIS_PER_BTC } from '../../const.js';
  */
 const btcToSatoshis = (btcAmount) => {
     if (btcAmount < 0) {
-        throw new DynamicError('BTC amount cannot be negative');
+        throw new DynamicError('BTC amount cannot be negative', 'btc_amount_cannot_be_negative');
     }
     // Convert to satoshis and return as BigInt
     const satoshis = Math.floor(btcAmount * SATOSHIS_PER_BTC);

package/src/utils/psbt/validator/validateAddress.cjs

@@ -11,9 +11,9 @@ const validateAddress = (psbt, signingAddress, index, inputAtIndex) => {
     // to be able to compare it to the address provided in the request for the current index
     const extractedAddress = extractAddressFromInput.extractAddressFromInput(psbt, index, inputAtIndex);
     if (!extractedAddress)
-        throw new utils.DynamicError(`validateAddress - input not found for the given address: ${signingAddress}`);
+        throw new utils.DynamicError(`validateAddress - input not found for the given address: ${signingAddress}`, 'validateaddress_input_not_found_for_the');
     if (extractedAddress !== signingAddress)
-        throw new utils.DynamicError('validateAddress - address mismatch with index');
+        throw new utils.DynamicError('validateAddress - address mismatch with index', 'validateaddress_address_mismatch_with_index');
 };
 
 exports.validateAddress = validateAddress;

package/src/utils/psbt/validator/validateAddress.js

@@ -7,9 +7,9 @@ const validateAddress = (psbt, signingAddress, index, inputAtIndex) => {
     // to be able to compare it to the address provided in the request for the current index
     const extractedAddress = extractAddressFromInput(psbt, index, inputAtIndex);
     if (!extractedAddress)
-        throw new DynamicError(`validateAddress - input not found for the given address: ${signingAddress}`);
+        throw new DynamicError(`validateAddress - input not found for the given address: ${signingAddress}`, 'validateaddress_input_not_found_for_the');
     if (extractedAddress !== signingAddress)
-        throw new DynamicError('validateAddress - address mismatch with index');
+        throw new DynamicError('validateAddress - address mismatch with index', 'validateaddress_address_mismatch_with_index');
 };
 
 export { validateAddress };