@dynamic-labs/bitcoin 5.2.0 → 5.3.1

package/CHANGELOG.md

@@ -1,4 +1,25 @@
 
+### [5.3.1](https://github.com/dynamic-labs/dynamic-auth/compare/v5.3.0...v5.3.1) (2026-08-14)
+
+## [5.3.0](https://github.com/dynamic-labs/dynamic-auth/compare/v5.2.0...v5.3.0) (2026-08-12)
+
+
+### Features
+
+* **screening:** add transaction-screening service, types, and connector wiring (DYNT-1663) ([#12160](https://github.com/dynamic-labs/dynamic-auth/issues/12160)) ([d8df6a1](https://github.com/dynamic-labs/dynamic-auth/commit/d8df6a1fccbb6370c140454d9297eabd97699e35)), closes [#12172](https://github.com/dynamic-labs/dynamic-auth/issues/12172) [#12167](https://github.com/dynamic-labs/dynamic-auth/issues/12167) [#12168](https://github.com/dynamic-labs/dynamic-auth/issues/12168) [#12169](https://github.com/dynamic-labs/dynamic-auth/issues/12169)
+* **screening:** screen Bitcoin connected-wallet transactions (DYNT-1663) ([#12169](https://github.com/dynamic-labs/dynamic-auth/issues/12169)) ([f34d1c3](https://github.com/dynamic-labs/dynamic-auth/commit/f34d1c31fe10d0cb02b4f7462dd4900d0256604a))
+* **screening:** screen EVM connected-wallet sends (DYNT-1663) ([#12167](https://github.com/dynamic-labs/dynamic-auth/issues/12167)) ([1b72b24](https://github.com/dynamic-labs/dynamic-auth/commit/1b72b24393a49153d74ce715a44d262e8e48ddc7))
+* **screening:** screen Solana connected-wallet transactions (DYNT-1663) ([#12168](https://github.com/dynamic-labs/dynamic-auth/issues/12168)) ([000eb18](https://github.com/dynamic-labs/dynamic-auth/commit/000eb180aca8349804953ff7738c0ba984a2fa21))
+
+
+### Bug Fixes
+
+* add PhoneNumberAlreadyLinkedError and map duplicate-phone backend code ([#12145](https://github.com/dynamic-labs/dynamic-auth/issues/12145)) ([9d13b5f](https://github.com/dynamic-labs/dynamic-auth/commit/9d13b5f8b22716b4c9ce206ee870aab5bd745b8b))
+* **react-native-extension:** throw clear error when react-native-keychain native module is missing ([#12197](https://github.com/dynamic-labs/dynamic-auth/issues/12197)) ([b9983e1](https://github.com/dynamic-labs/dynamic-auth/commit/b9983e1f1aefa9a9bbdc1435f706a05e64f34f1c))
+* security updates ([#12187](https://github.com/dynamic-labs/dynamic-auth/issues/12187)) ([d3a31e2](https://github.com/dynamic-labs/dynamic-auth/commit/d3a31e23533b6b7739851a3b747d62ba13d318b2))
+* security updates ([#12208](https://github.com/dynamic-labs/dynamic-auth/issues/12208)) ([9e9472a](https://github.com/dynamic-labs/dynamic-auth/commit/9e9472acfbe01f7ac9e160829cc10e53c65f91e7))
+* **sdk-react-core:** avoid spurious WaaS client rebuild on transient user sessionId churn ([#12182](https://github.com/dynamic-labs/dynamic-auth/issues/12182)) ([480b2ec](https://github.com/dynamic-labs/dynamic-auth/commit/480b2ecc87486a852e75e8814a76fb59ffe40c5d))
+
 ## [5.2.0](https://github.com/dynamic-labs/dynamic-auth/compare/v5.1.0...v5.2.0) (2026-08-06)
 
 

package/package.cjs

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

package/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/bitcoin",
-  "version": "5.2.0",
+  "version": "5.3.1",
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -22,20 +22,20 @@
     "@dynamic-labs-wallet/forward-mpc-client": "1.0.1",
     "@bitcoinerlab/secp256k1": "1.1.1",
     "@btckit/types": "0.0.19",
-    "@dynamic-labs/sdk-api-core": "0.0.1093",
+    "@dynamic-labs/sdk-api-core": "0.0.1118",
     "@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": "5.2.0",
-    "@dynamic-labs/logger": "5.2.0",
-    "@dynamic-labs/types": "5.2.0",
-    "@dynamic-labs/utils": "5.2.0",
-    "@dynamic-labs/waas": "5.2.0",
-    "@dynamic-labs/wallet-book": "5.2.0",
-    "@dynamic-labs/wallet-connector-core": "5.2.0",
+    "@dynamic-labs/assert-package-version": "5.3.1",
+    "@dynamic-labs/logger": "5.3.1",
+    "@dynamic-labs/types": "5.3.1",
+    "@dynamic-labs/utils": "5.3.1",
+    "@dynamic-labs/waas": "5.3.1",
+    "@dynamic-labs/wallet-book": "5.3.1",
+    "@dynamic-labs/wallet-connector-core": "5.3.1",
     "eventemitter3": "5.0.1"
   },
   "peerDependencies": {}

package/src/index.cjs

@@ -30,6 +30,7 @@ var createSignPsbtOptions = require('./utils/psbt/createSignPsbtOptions.cjs');
 var satoshisToBtc = require('./utils/satoshisToBtc/satoshisToBtc.cjs');
 var btcToSatoshis = require('./utils/btcToSatoshis/btcToSatoshis.cjs');
 var getBitcoinNetwork = require('./utils/getBitcoinNetwork/getBitcoinNetwork.cjs');
+var getBitcoinChainId = require('./utils/getBitcoinChainId/getBitcoinChainId.cjs');
 var PsbtParser = require('./utils/psbtParser/PsbtParser.cjs');
 var BitcoinWallet = require('./wallet/BitcoinWallet.cjs');
 var isBitcoinWallet = require('./wallet/isBitcoinWallet/isBitcoinWallet.cjs');
@@ -65,6 +66,9 @@ exports.createPsbtOptions = createSignPsbtOptions.createPsbtOptions;
 exports.satoshisToBtc = satoshisToBtc.satoshisToBtc;
 exports.btcToSatoshis = btcToSatoshis.btcToSatoshis;
 exports.getBitcoinNetwork = getBitcoinNetwork.getBitcoinNetwork;
+exports.BITCOIN_MAINNET_CHAIN_ID = getBitcoinChainId.BITCOIN_MAINNET_CHAIN_ID;
+exports.BITCOIN_TESTNET_CHAIN_ID = getBitcoinChainId.BITCOIN_TESTNET_CHAIN_ID;
+exports.getBitcoinChainId = getBitcoinChainId.getBitcoinChainId;
 exports.PsbtParser = PsbtParser.PsbtParser;
 exports.BitcoinWallet = BitcoinWallet.BitcoinWallet;
 exports.isBitcoinWallet = isBitcoinWallet.isBitcoinWallet;

package/src/index.js

@@ -30,6 +30,7 @@ export { createPsbtOptions } from './utils/psbt/createSignPsbtOptions.js';
 export { satoshisToBtc } from './utils/satoshisToBtc/satoshisToBtc.js';
 export { btcToSatoshis } from './utils/btcToSatoshis/btcToSatoshis.js';
 export { getBitcoinNetwork } from './utils/getBitcoinNetwork/getBitcoinNetwork.js';
+export { BITCOIN_MAINNET_CHAIN_ID, BITCOIN_TESTNET_CHAIN_ID, getBitcoinChainId } from './utils/getBitcoinChainId/getBitcoinChainId.js';
 export { PsbtParser } from './utils/psbtParser/PsbtParser.js';
 export { BitcoinWallet } from './wallet/BitcoinWallet.js';
 export { isBitcoinWallet } from './wallet/isBitcoinWallet/isBitcoinWallet.js';

package/src/services/MempoolApiService.cjs

@@ -14,6 +14,7 @@ require('@dynamic-labs/sdk-api-core');
 require('@wallet-standard/app');
 var getMempoolApiUrl = require('../utils/getMempoolApiUrl.cjs');
 var _const = require('../const.cjs');
+require('@dynamic-labs/types');
 require('jsontokens');
 require('../connectors/DynamicWaasBitcoinConnector/DynamicWaasBitcoinConnector.cjs');
 

package/src/services/MempoolApiService.js

@@ -10,6 +10,7 @@ import '@dynamic-labs/sdk-api-core';
 import '@wallet-standard/app';
 import { getMempoolApiUrl } from '../utils/getMempoolApiUrl.js';
 import { VSIZE_OVERHEAD, VSIZE_INPUT_P2WPKH, VSIZE_OUTPUT_P2WPKH, MIN_RELAY_FEE, DEFAULT_FEE_ESTIMATE } from '../const.js';
+import '@dynamic-labs/types';
 import 'jsontokens';
 import '../connectors/DynamicWaasBitcoinConnector/DynamicWaasBitcoinConnector.js';
 

package/src/utils/fetchSatsConnectConnectors/fetchSatsConnectConnectors.cjs

@@ -11,6 +11,7 @@ require('@dynamic-labs/wallet-book');
 require('@dynamic-labs/utils');
 require('@dynamic-labs/sdk-api-core');
 var _const = require('../../const.cjs');
+require('@dynamic-labs/types');
 require('bitcoinjs-lib');
 var BitcoinSatsConnectConnector = require('../../connectors/BitcoinSatsConnectConnector/BitcoinSatsConnectConnector.cjs');
 require('jsontokens');

package/src/utils/fetchSatsConnectConnectors/fetchSatsConnectConnectors.js

@@ -7,6 +7,7 @@ import '@dynamic-labs/wallet-book';
 import '@dynamic-labs/utils';
 import '@dynamic-labs/sdk-api-core';
 import { SATSCONNECT_FEATURE } from '../../const.js';
+import '@dynamic-labs/types';
 import 'bitcoinjs-lib';
 import { BitcoinSatsConnectConnector } from '../../connectors/BitcoinSatsConnectConnector/BitcoinSatsConnectConnector.js';
 import 'jsontokens';

package/src/utils/getBitcoinChainId/getBitcoinChainId.cjs

@@ -0,0 +1,23 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var bitcoinjsLib = require('bitcoinjs-lib');
+var getBitcoinNetwork = require('../getBitcoinNetwork/getBitcoinNetwork.cjs');
+
+// Bitcoin network identifiers from the signing contract (1=mainnet, 2=testnet)
+const BITCOIN_MAINNET_CHAIN_ID = '1';
+const BITCOIN_TESTNET_CHAIN_ID = '2';
+/**
+ * Maps a Bitcoin address to the network identifier used by the transaction
+ * screening contract. Regtest counts as testnet here: there is no separate
+ * identifier for it in the signing contract, and it isn't mainnet.
+ */
+const getBitcoinChainId = (accountAddress) => getBitcoinNetwork.getBitcoinNetwork(accountAddress) === bitcoinjsLib.networks.bitcoin
+    ? BITCOIN_MAINNET_CHAIN_ID
+    : BITCOIN_TESTNET_CHAIN_ID;
+
+exports.BITCOIN_MAINNET_CHAIN_ID = BITCOIN_MAINNET_CHAIN_ID;
+exports.BITCOIN_TESTNET_CHAIN_ID = BITCOIN_TESTNET_CHAIN_ID;
+exports.getBitcoinChainId = getBitcoinChainId;

package/src/utils/getBitcoinChainId/getBitcoinChainId.d.ts

@@ -0,0 +1,8 @@
+export declare const BITCOIN_MAINNET_CHAIN_ID = "1";
+export declare const BITCOIN_TESTNET_CHAIN_ID = "2";
+/**
+ * Maps a Bitcoin address to the network identifier used by the transaction
+ * screening contract. Regtest counts as testnet here: there is no separate
+ * identifier for it in the signing contract, and it isn't mainnet.
+ */
+export declare const getBitcoinChainId: (accountAddress: string) => string;

package/src/utils/getBitcoinChainId/getBitcoinChainId.js

@@ -0,0 +1,17 @@
+'use client'
+import { networks } from 'bitcoinjs-lib';
+import { getBitcoinNetwork } from '../getBitcoinNetwork/getBitcoinNetwork.js';
+
+// Bitcoin network identifiers from the signing contract (1=mainnet, 2=testnet)
+const BITCOIN_MAINNET_CHAIN_ID = '1';
+const BITCOIN_TESTNET_CHAIN_ID = '2';
+/**
+ * Maps a Bitcoin address to the network identifier used by the transaction
+ * screening contract. Regtest counts as testnet here: there is no separate
+ * identifier for it in the signing contract, and it isn't mainnet.
+ */
+const getBitcoinChainId = (accountAddress) => getBitcoinNetwork(accountAddress) === networks.bitcoin
+    ? BITCOIN_MAINNET_CHAIN_ID
+    : BITCOIN_TESTNET_CHAIN_ID;
+
+export { BITCOIN_MAINNET_CHAIN_ID, BITCOIN_TESTNET_CHAIN_ID, getBitcoinChainId };

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

@@ -0,0 +1 @@
+export { BITCOIN_MAINNET_CHAIN_ID, BITCOIN_TESTNET_CHAIN_ID, getBitcoinChainId, } from './getBitcoinChainId';

package/src/utils/getBitcoinNetwork/getBitcoinNetwork.cjs

@@ -5,11 +5,46 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var bitcoinjsLib = require('bitcoinjs-lib');
 
+// Resolved per call rather than as a module-scope map: building the map at
+// import time reads `networks` the moment any module in the import graph is
+// loaded, which crashes every spec that partially mocks bitcoinjs-lib.
+const networkForBech32Prefix = (prefix) => {
+    if (prefix === bitcoinjsLib.networks.bitcoin.bech32)
+        return bitcoinjsLib.networks.bitcoin;
+    if (prefix === bitcoinjsLib.networks.regtest.bech32)
+        return bitcoinjsLib.networks.regtest;
+    if (prefix === bitcoinjsLib.networks.testnet.bech32)
+        return bitcoinjsLib.networks.testnet;
+    return undefined;
+};
 /**
- * Gets the Bitcoin network based on address prefix
+ * Gets the Bitcoin network by decoding the address (bech32 human-readable
+ * part, or base58 version byte) rather than checking a single leading
+ * character, which misreads legacy testnet (m/n/2...) and regtest (bcrt1...)
+ * addresses as mainnet. Base58 can't distinguish testnet from regtest (they
+ * share version bytes), so a base58 testnet-versioned address resolves to
+ * networks.testnet. Anything undecodable defaults to mainnet.
  * @param accountAddress - The Bitcoin address
- * @returns The Bitcoin network (mainnet or testnet)
+ * @returns The Bitcoin network (mainnet, testnet, or regtest)
  */
-const getBitcoinNetwork = (accountAddress) => accountAddress.startsWith('t') ? bitcoinjsLib.networks.testnet : bitcoinjsLib.networks.bitcoin;
+const getBitcoinNetwork = (accountAddress) => {
+    var _a;
+    try {
+        return ((_a = networkForBech32Prefix(bitcoinjsLib.address.fromBech32(accountAddress).prefix)) !== null && _a !== void 0 ? _a : bitcoinjsLib.networks.bitcoin);
+    }
+    catch (_b) {
+        // Not bech32; fall through to base58.
+    }
+    try {
+        const { version } = bitcoinjsLib.address.fromBase58Check(accountAddress);
+        return version === bitcoinjsLib.networks.testnet.pubKeyHash ||
+            version === bitcoinjsLib.networks.testnet.scriptHash
+            ? bitcoinjsLib.networks.testnet
+            : bitcoinjsLib.networks.bitcoin;
+    }
+    catch (_c) {
+        return bitcoinjsLib.networks.bitcoin;
+    }
+};
 
 exports.getBitcoinNetwork = getBitcoinNetwork;

package/src/utils/getBitcoinNetwork/getBitcoinNetwork.d.ts

@@ -1,7 +1,12 @@
 import { type Network } from 'bitcoinjs-lib';
 /**
- * Gets the Bitcoin network based on address prefix
+ * Gets the Bitcoin network by decoding the address (bech32 human-readable
+ * part, or base58 version byte) rather than checking a single leading
+ * character, which misreads legacy testnet (m/n/2...) and regtest (bcrt1...)
+ * addresses as mainnet. Base58 can't distinguish testnet from regtest (they
+ * share version bytes), so a base58 testnet-versioned address resolves to
+ * networks.testnet. Anything undecodable defaults to mainnet.
  * @param accountAddress - The Bitcoin address
- * @returns The Bitcoin network (mainnet or testnet)
+ * @returns The Bitcoin network (mainnet, testnet, or regtest)
  */
 export declare const getBitcoinNetwork: (accountAddress: string) => Network;

package/src/utils/getBitcoinNetwork/getBitcoinNetwork.js

@@ -1,11 +1,46 @@
 'use client'
-import { networks } from 'bitcoinjs-lib';
+import { address, networks } from 'bitcoinjs-lib';
 
+// Resolved per call rather than as a module-scope map: building the map at
+// import time reads `networks` the moment any module in the import graph is
+// loaded, which crashes every spec that partially mocks bitcoinjs-lib.
+const networkForBech32Prefix = (prefix) => {
+    if (prefix === networks.bitcoin.bech32)
+        return networks.bitcoin;
+    if (prefix === networks.regtest.bech32)
+        return networks.regtest;
+    if (prefix === networks.testnet.bech32)
+        return networks.testnet;
+    return undefined;
+};
 /**
- * Gets the Bitcoin network based on address prefix
+ * Gets the Bitcoin network by decoding the address (bech32 human-readable
+ * part, or base58 version byte) rather than checking a single leading
+ * character, which misreads legacy testnet (m/n/2...) and regtest (bcrt1...)
+ * addresses as mainnet. Base58 can't distinguish testnet from regtest (they
+ * share version bytes), so a base58 testnet-versioned address resolves to
+ * networks.testnet. Anything undecodable defaults to mainnet.
  * @param accountAddress - The Bitcoin address
- * @returns The Bitcoin network (mainnet or testnet)
+ * @returns The Bitcoin network (mainnet, testnet, or regtest)
  */
-const getBitcoinNetwork = (accountAddress) => accountAddress.startsWith('t') ? networks.testnet : networks.bitcoin;
+const getBitcoinNetwork = (accountAddress) => {
+    var _a;
+    try {
+        return ((_a = networkForBech32Prefix(address.fromBech32(accountAddress).prefix)) !== null && _a !== void 0 ? _a : networks.bitcoin);
+    }
+    catch (_b) {
+        // Not bech32; fall through to base58.
+    }
+    try {
+        const { version } = address.fromBase58Check(accountAddress);
+        return version === networks.testnet.pubKeyHash ||
+            version === networks.testnet.scriptHash
+            ? networks.testnet
+            : networks.bitcoin;
+    }
+    catch (_c) {
+        return networks.bitcoin;
+    }
+};
 
 export { getBitcoinNetwork };

package/src/utils/index.d.ts

@@ -6,4 +6,5 @@ export { createPsbtOptions } from './psbt/createSignPsbtOptions';
 export { satoshisToBtc } from './satoshisToBtc';
 export { btcToSatoshis } from './btcToSatoshis';
 export { getBitcoinNetwork } from './getBitcoinNetwork';
+export { BITCOIN_MAINNET_CHAIN_ID, BITCOIN_TESTNET_CHAIN_ID, getBitcoinChainId, } from './getBitcoinChainId';
 export { PsbtParser } from './psbtParser';

package/src/wallet/BitcoinWallet.cjs

@@ -5,7 +5,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var _tslib = require('../../_virtual/_tslib.cjs');
 var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
+var types = require('@dynamic-labs/types');
 var getAddressByType = require('../utils/getAddressByType/getAddressByType.cjs');
+var getBitcoinChainId = require('../utils/getBitcoinChainId/getBitcoinChainId.cjs');
 
 class BitcoinWallet extends walletConnectorCore.Wallet {
     /**
@@ -39,6 +41,11 @@ class BitcoinWallet extends walletConnectorCore.Wallet {
     sendBitcoin(transaction) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             yield this.sync();
+            if (this._connector.transactionScreening) {
+                yield this.screenBeforeSigning({
+                    recipientAddress: transaction.recipientAddress,
+                });
+            }
             return this._connector.sendBitcoin(transaction);
         });
     }
@@ -51,6 +58,11 @@ class BitcoinWallet extends walletConnectorCore.Wallet {
     sendBitcoinWithConfirmation(transaction) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             yield this.sync();
+            if (this._connector.transactionScreening) {
+                yield this.screenBeforeSigning({
+                    recipientAddress: transaction.recipientAddress,
+                });
+            }
             if (this._connector.sendBitcoinWithConfirmation) {
                 return this._connector.sendBitcoinWithConfirmation(transaction);
             }
@@ -86,6 +98,9 @@ class BitcoinWallet extends walletConnectorCore.Wallet {
     signPsbt(request) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             yield this.sync();
+            if (this._connector.transactionScreening) {
+                yield this.screenBeforeSigning({ psbt: request.unsignedPsbtBase64 });
+            }
             return this._connector.signPsbt(request);
         });
     }
@@ -97,6 +112,9 @@ class BitcoinWallet extends walletConnectorCore.Wallet {
     signPsbts(requests) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             yield this.sync();
+            if (this._connector.transactionScreening) {
+                yield Promise.all(requests.map((request) => this.screenBeforeSigning({ psbt: request.unsignedPsbtBase64 })));
+            }
             return this._connector.signPsbts(requests);
         });
     }
@@ -111,6 +129,22 @@ class BitcoinWallet extends walletConnectorCore.Wallet {
             return this._connector.buildPsbt(transaction);
         });
     }
+    /**
+     * Screens the transaction's destinations before the wallet is prompted to
+     * sign. Rejects only on an explicit block (best-effort, fail-open).
+     */
+    screenBeforeSigning(btcTransaction) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const chainId = getBitcoinChainId.getBitcoinChainId(this.address);
+            yield ((_a = this._connector.transactionScreening) === null || _a === void 0 ? void 0 : _a.screenTransaction({
+                chain: types.TransactionScreeningChain.BTC,
+                chainId,
+                context: { btcTransaction: Object.assign({ chainId }, btcTransaction) },
+                senderAddress: this.address,
+            }));
+        });
+    }
 }
 
 exports.BitcoinWallet = BitcoinWallet;

package/src/wallet/BitcoinWallet.d.ts

@@ -1,5 +1,5 @@
 import { Wallet } from '@dynamic-labs/wallet-connector-core';
-import type { WalletAddressType } from '@dynamic-labs/types';
+import { type WalletAddressType } from '@dynamic-labs/types';
 import { BitcoinWalletConnector } from '../connectors';
 import { BitcoinSignProtocol, BitcoinSignPsbtRequest, BitcoinSignPsbtResponse, BitcoinTransaction, EmbeddedWalletSignPsbtRequest } from '../types';
 export declare class BitcoinWallet extends Wallet<BitcoinWalletConnector> {
@@ -61,4 +61,9 @@ export declare class BitcoinWallet extends Wallet<BitcoinWalletConnector> {
      * @returns A promise that resolves to a PSBT in Base64 format, or undefined if not supported
      */
     buildPsbt(transaction: BitcoinTransaction): Promise<string | undefined>;
+    /**
+     * Screens the transaction's destinations before the wallet is prompted to
+     * sign. Rejects only on an explicit block (best-effort, fail-open).
+     */
+    private screenBeforeSigning;
 }

package/src/wallet/BitcoinWallet.js

@@ -1,7 +1,9 @@
 'use client'
 import { __awaiter } from '../../_virtual/_tslib.js';
 import { Wallet } from '@dynamic-labs/wallet-connector-core';
+import { TransactionScreeningChain } from '@dynamic-labs/types';
 import { getAddressByType } from '../utils/getAddressByType/getAddressByType.js';
+import { getBitcoinChainId } from '../utils/getBitcoinChainId/getBitcoinChainId.js';
 
 class BitcoinWallet extends Wallet {
     /**
@@ -35,6 +37,11 @@ class BitcoinWallet extends Wallet {
     sendBitcoin(transaction) {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.sync();
+            if (this._connector.transactionScreening) {
+                yield this.screenBeforeSigning({
+                    recipientAddress: transaction.recipientAddress,
+                });
+            }
             return this._connector.sendBitcoin(transaction);
         });
     }
@@ -47,6 +54,11 @@ class BitcoinWallet extends Wallet {
     sendBitcoinWithConfirmation(transaction) {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.sync();
+            if (this._connector.transactionScreening) {
+                yield this.screenBeforeSigning({
+                    recipientAddress: transaction.recipientAddress,
+                });
+            }
             if (this._connector.sendBitcoinWithConfirmation) {
                 return this._connector.sendBitcoinWithConfirmation(transaction);
             }
@@ -82,6 +94,9 @@ class BitcoinWallet extends Wallet {
     signPsbt(request) {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.sync();
+            if (this._connector.transactionScreening) {
+                yield this.screenBeforeSigning({ psbt: request.unsignedPsbtBase64 });
+            }
             return this._connector.signPsbt(request);
         });
     }
@@ -93,6 +108,9 @@ class BitcoinWallet extends Wallet {
     signPsbts(requests) {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.sync();
+            if (this._connector.transactionScreening) {
+                yield Promise.all(requests.map((request) => this.screenBeforeSigning({ psbt: request.unsignedPsbtBase64 })));
+            }
             return this._connector.signPsbts(requests);
         });
     }
@@ -107,6 +125,22 @@ class BitcoinWallet extends Wallet {
             return this._connector.buildPsbt(transaction);
         });
     }
+    /**
+     * Screens the transaction's destinations before the wallet is prompted to
+     * sign. Rejects only on an explicit block (best-effort, fail-open).
+     */
+    screenBeforeSigning(btcTransaction) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const chainId = getBitcoinChainId(this.address);
+            yield ((_a = this._connector.transactionScreening) === null || _a === void 0 ? void 0 : _a.screenTransaction({
+                chain: TransactionScreeningChain.BTC,
+                chainId,
+                context: { btcTransaction: Object.assign({ chainId }, btcTransaction) },
+                senderAddress: this.address,
+            }));
+        });
+    }
 }
 
 export { BitcoinWallet };