@dynamic-labs/sdk-react-core 4.92.3 → 4.92.4

package/CHANGELOG.md

@@ -1,4 +1,21 @@
 
+### [4.92.4](https://github.com/dynamic-labs/dynamic-auth/compare/v4.92.3...v4.92.4) (2026-07-16)
+
+
+### Features
+
+* **bitcoin:** per-network address switching and dust-limit send validation [v4] ([#11970](https://github.com/dynamic-labs/dynamic-auth/issues/11970)) ([76a4a9a](https://github.com/dynamic-labs/dynamic-auth/commit/76a4a9a5025d78798ebd1beffe6c0af59d2d029a)), closes [#11896](https://github.com/dynamic-labs/dynamic-auth/issues/11896) [#11800](https://github.com/dynamic-labs/dynamic-auth/issues/11800)
+* **midnight:** per-network addresses in deposit and wallet info views [v4] ([#11949](https://github.com/dynamic-labs/dynamic-auth/issues/11949)) ([978446a](https://github.com/dynamic-labs/dynamic-auth/commit/978446aca8546eb038ba9ed3be0503d10594ee15))
+* **midnight:** resolve wallet address per selected network [v4] ([#11948](https://github.com/dynamic-labs/dynamic-auth/issues/11948)) ([d6f858c](https://github.com/dynamic-labs/dynamic-auth/commit/d6f858c5e35defda7ed73cf97b3fdbe5ed9d131d))
+* set useMetamaskSdk to true by default ([#11926](https://github.com/dynamic-labs/dynamic-auth/issues/11926)) ([75b5a4a](https://github.com/dynamic-labs/dynamic-auth/commit/75b5a4a0fe8b1a375afce145c0b8bdc3ce761117))
+
+
+### Bug Fixes
+
+* **midnight:** align per-network code with the final main iteration [v4] ([#11971](https://github.com/dynamic-labs/dynamic-auth/issues/11971)) ([3ef3ba8](https://github.com/dynamic-labs/dynamic-auth/commit/3ef3ba8c090dfd9e4286b4e51bf350ea5e6feac7))
+* settle social sign-in when captcha is backed out or oauth popup never responds (v4) ([#11956](https://github.com/dynamic-labs/dynamic-auth/issues/11956)) ([ad49477](https://github.com/dynamic-labs/dynamic-auth/commit/ad49477f2acf61a154bb79cbe26b24f803cdb0e2))
+* validate that private key is not empty before upgrading to WaaS ([#11952](https://github.com/dynamic-labs/dynamic-auth/issues/11952)) ([21dfb83](https://github.com/dynamic-labs/dynamic-auth/commit/21dfb83cb29e42b335bc94a0cdd2062cf14a262a))
+
 ### [4.92.3](https://github.com/dynamic-labs/dynamic-auth/compare/v4.92.2...v4.92.3) (2026-07-10)
 
 

package/package.cjs

@@ -3,12 +3,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.92.3";
+var version = "4.92.4";
 var dependencies = {
-	"@dynamic-labs/sdk-api-core": "0.0.1067",
+	"@dynamic-labs/sdk-api-core": "0.0.1073",
 	"@dynamic-labs-sdk/client": "1.18.0",
-	"@dynamic-labs-wallet/browser-wallet-client": "1.0.48",
-	"@dynamic-labs-wallet/forward-mpc-client": "0.12.0",
+	"@dynamic-labs-wallet/browser-wallet-client": "1.0.70",
+	"@dynamic-labs-wallet/forward-mpc-client": "1.0.1",
 	"@hcaptcha/react-hcaptcha": "1.4.4",
 	"@marsidev/react-turnstile": "1.5.2",
 	"@thumbmarkjs/thumbmarkjs": "0.16.0",

package/package.js

@@ -1,10 +1,10 @@
 'use client'
-var version = "4.92.3";
+var version = "4.92.4";
 var dependencies = {
-	"@dynamic-labs/sdk-api-core": "0.0.1067",
+	"@dynamic-labs/sdk-api-core": "0.0.1073",
 	"@dynamic-labs-sdk/client": "1.18.0",
-	"@dynamic-labs-wallet/browser-wallet-client": "1.0.48",
-	"@dynamic-labs-wallet/forward-mpc-client": "0.12.0",
+	"@dynamic-labs-wallet/browser-wallet-client": "1.0.70",
+	"@dynamic-labs-wallet/forward-mpc-client": "1.0.1",
 	"@hcaptcha/react-hcaptcha": "1.4.4",
 	"@marsidev/react-turnstile": "1.5.2",
 	"@thumbmarkjs/thumbmarkjs": "0.16.0",

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dynamic-labs/sdk-react-core",
-  "version": "4.92.3",
+  "version": "4.92.4",
   "dependencies": {
-    "@dynamic-labs/sdk-api-core": "0.0.1067",
+    "@dynamic-labs/sdk-api-core": "0.0.1073",
     "@dynamic-labs-sdk/client": "1.18.0",
-    "@dynamic-labs-wallet/browser-wallet-client": "1.0.48",
-    "@dynamic-labs-wallet/forward-mpc-client": "0.12.0",
+    "@dynamic-labs-wallet/browser-wallet-client": "1.0.70",
+    "@dynamic-labs-wallet/forward-mpc-client": "1.0.1",
     "@hcaptcha/react-hcaptcha": "1.4.4",
     "@marsidev/react-turnstile": "1.5.2",
     "@thumbmarkjs/thumbmarkjs": "0.16.0",
@@ -18,17 +18,17 @@
     "react-i18next": "13.5.0",
     "react-international-phone": "4.5.0",
     "yup": "0.32.11",
-    "@dynamic-labs/assert-package-version": "4.92.3",
-    "@dynamic-labs/iconic": "4.92.3",
-    "@dynamic-labs/locale": "4.92.3",
-    "@dynamic-labs/logger": "4.92.3",
-    "@dynamic-labs/multi-wallet": "4.92.3",
-    "@dynamic-labs/rpc-providers": "4.92.3",
-    "@dynamic-labs/store": "4.92.3",
-    "@dynamic-labs/types": "4.92.3",
-    "@dynamic-labs/utils": "4.92.3",
-    "@dynamic-labs/wallet-book": "4.92.3",
-    "@dynamic-labs/wallet-connector-core": "4.92.3",
+    "@dynamic-labs/assert-package-version": "4.92.4",
+    "@dynamic-labs/iconic": "4.92.4",
+    "@dynamic-labs/locale": "4.92.4",
+    "@dynamic-labs/logger": "4.92.4",
+    "@dynamic-labs/multi-wallet": "4.92.4",
+    "@dynamic-labs/rpc-providers": "4.92.4",
+    "@dynamic-labs/store": "4.92.4",
+    "@dynamic-labs/types": "4.92.4",
+    "@dynamic-labs/utils": "4.92.4",
+    "@dynamic-labs/wallet-book": "4.92.4",
+    "@dynamic-labs/wallet-connector-core": "4.92.4",
     "eventemitter3": "5.0.1"
   },
   "devDependencies": {

package/src/lib/components/SendBalanceForm/SendBalanceForm.cjs

@@ -51,7 +51,7 @@ const sendBalanceFormInitialValues = {
     amount: '',
     recipient: '',
 };
-const getDisplayErrorMessage = (errors, t, field, decimals) => {
+const getDisplayErrorMessage = (errors, t, field, decimals, minAmountDisplay) => {
     var _a;
     const mapFieldAndErrorToMessage = {
         amount: {
@@ -60,6 +60,9 @@ const getDisplayErrorMessage = (errors, t, field, decimals) => {
             nonZero: t('dyn_send_transaction.validation.amount.non_zero'),
             overBalance: t('dyn_send_transaction.validation.amount.over_balance'),
             required: t('dyn_send_transaction.validation.amount.required'),
+            underMinimum: t('dyn_send_transaction.validation.amount.under_minimum', {
+                minAmount: minAmountDisplay,
+            }),
         },
         recipient: {
             invalidFormat: t('dyn_send_transaction.validation.recipient.invalid_format'),
@@ -83,7 +86,7 @@ const getDisplayErrorMessage = (errors, t, field, decimals) => {
     return '';
 };
 const SendBalanceForm = ({ initialValues, onSubmit, decimals = 18, validateAddress = () => true, validateAmount = () => true, currentToken, transaction, tokenBalances, setCurrentToken, isLoading, supportsFeeTokenSelection = false, feeTokenOptions, currentFeeToken, setCurrentFeeToken, fallbackTokenIcon, }) => {
-    var _a;
+    var _a, _b;
     const { t } = reactI18next.useTranslation();
     const { showFiat } = useInternalDynamicContext.useInternalDynamicContext();
     const floatingValueRef = React.useRef(null);
@@ -183,6 +186,24 @@ const SendBalanceForm = ({ initialValues, onSubmit, decimals = 18, validateAddre
                         return true;
                     return /^0*(?:\.0+)?$/.test(value) === false;
                 },
+            })
+                // Chains with a minimum sendable value (e.g. Bitcoin's dust limit)
+                //  would otherwise accept the amount here and fail when the
+                //  transaction is built, with no feedback in the UI.
+                .test({
+                message: 'underMinimum',
+                test: (value) => {
+                    if (!value || !(transaction === null || transaction === void 0 ? void 0 : transaction.minAmount))
+                        return true;
+                    if (currentToken && currentToken.isNative !== true)
+                        return true;
+                    try {
+                        return transaction.parse(value) >= transaction.minAmount;
+                    }
+                    catch (_a) {
+                        return true;
+                    }
+                },
             })
                 .test({
                 message: 'overBalance',
@@ -195,7 +216,10 @@ const SendBalanceForm = ({ initialValues, onSubmit, decimals = 18, validateAddre
                 test: (value) => validateAddress(value),
             }),
         });
-    }, [decimals, validateAddress, validateAmount]);
+    }, [decimals, validateAddress, validateAmount, transaction, currentToken]);
+    const minAmountDisplay = (transaction === null || transaction === void 0 ? void 0 : transaction.minAmount)
+        ? `${transaction.format(transaction.minAmount)} ${(_b = currentToken === null || currentToken === void 0 ? void 0 : currentToken.symbol) !== null && _b !== void 0 ? _b : ''}`.trim()
+        : undefined;
     return (jsxRuntime.jsx(formik.Formik, { initialValues: initialValues || sendBalanceFormInitialValues, validationSchema: sendBalanceFormValidationSchema, onSubmit: (values) => onSubmit(values), validateOnChange: false, validateOnBlur: false, children: ({ errors, touched, values, handleChange, setFieldValue, setErrors, handleBlur, setFieldTouched, validateField, }) => {
             var _a;
             return (jsxRuntime.jsxs(formik.Form, { className: 'send-balance-form', children: [jsxRuntime.jsxs("div", { className: 'send-balance-page-layout__balance-container', children: [jsxRuntime.jsx(FormFieldLabel.FormFieldLabel, { copykey: 'dyn_send_transaction.data.select_token', children: t('dyn_send_transaction.data.select_token') }), jsxRuntime.jsx(TokensBalanceDropdown.TokensBalanceDropdown, { tokenBalances: filteredTokenBalances !== null && filteredTokenBalances !== void 0 ? filteredTokenBalances : (pickerToken && [pickerToken]), currentToken: pickerToken, setCurrentToken: setCurrentToken, isLoading: isLoading, setFieldValue: setFieldValue, setErrors: setErrors, fallbackTokenIcon: fallbackTokenIcon, placeholder: t('dyn_send_transaction.data.select_token') })] }), jsxRuntime.jsxs("div", { className: 'send-balance-form__amount-container', children: [jsxRuntime.jsx(formik.Field, { variant: 'regular', className: `send-balance-form__amount-container__field ${showFiat ? 'fiat' : ''}`, name: 'amount', id: 'amount', onChange: (e) => {
@@ -223,7 +247,7 @@ const SendBalanceForm = ({ initialValues, onSubmit, decimals = 18, validateAddre
                                     (_a = transaction === null || transaction === void 0 ? void 0 : transaction.setPendingAmount) === null || _a === void 0 ? void 0 : _a.call(transaction, (_b = e.target.value) !== null && _b !== void 0 ? _b : '');
                                     refreshMergeAction();
                                 }, placeholder: t('dyn_send_transaction.data.amount.placeholder'), as: Input.Input, error: errors['amount'], copykey: 'dyn_send_transaction.data.amount.label', message: touched['amount'] &&
-                                    getDisplayErrorMessage(errors, t, 'amount', decimals), style: {
+                                    getDisplayErrorMessage(errors, t, 'amount', decimals, minAmountDisplay), style: {
                                     paddingLeft: `${leftSymbolPadding}px`,
                                 } }), jsxRuntime.jsx("div", { className: 'send-balance-form__amount-container__floating_value', ref: floatingValueRef, children: jsxRuntime.jsx(Typography.Typography, { variant: 'title', weight: 'regular', color: 'secondary', children: currentToken === null || currentToken === void 0 ? void 0 : currentToken.symbol }) }), jsxRuntime.jsx("div", { className: 'send-balance-form__amount-container__balance', children: showFiat && !Number.isNaN(amount) && (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [jsxRuntime.jsx(Typography.Typography, { variant: 'body_mini', weight: 'bold', color: 'secondary', children: "$" }), jsxRuntime.jsx(Typography.Typography, { variant: 'body_mini', weight: 'regular', color: 'secondary', children: utils.getDisplayFiatPrice(amount, currentToken) })] })) })] }), jsxRuntime.jsx(Typography.Typography, { className: 'send-balance-form__amount_available', variant: 'body_small', weight: 'regular', color: 'secondary', as: 'div', children: jsxRuntime.jsxs("div", { style: { display: 'flex', gap: '0.225rem' }, children: [jsxRuntime.jsx(Typography.Typography, { className: 'send-balance-form__amount_available__line', variant: 'body_small', weight: 'bold', color: 'primary', as: 'div', children: (_a = pickerToken === null || pickerToken === void 0 ? void 0 : pickerToken.balance) !== null && _a !== void 0 ? _a : 0 }), t('dyn_send_transaction.data.symbol_available', {
                                     symbol: pickerToken === null || pickerToken === void 0 ? void 0 : pickerToken.symbol,

package/src/lib/components/SendBalanceForm/SendBalanceForm.js

@@ -47,7 +47,7 @@ const sendBalanceFormInitialValues = {
     amount: '',
     recipient: '',
 };
-const getDisplayErrorMessage = (errors, t, field, decimals) => {
+const getDisplayErrorMessage = (errors, t, field, decimals, minAmountDisplay) => {
     var _a;
     const mapFieldAndErrorToMessage = {
         amount: {
@@ -56,6 +56,9 @@ const getDisplayErrorMessage = (errors, t, field, decimals) => {
             nonZero: t('dyn_send_transaction.validation.amount.non_zero'),
             overBalance: t('dyn_send_transaction.validation.amount.over_balance'),
             required: t('dyn_send_transaction.validation.amount.required'),
+            underMinimum: t('dyn_send_transaction.validation.amount.under_minimum', {
+                minAmount: minAmountDisplay,
+            }),
         },
         recipient: {
             invalidFormat: t('dyn_send_transaction.validation.recipient.invalid_format'),
@@ -79,7 +82,7 @@ const getDisplayErrorMessage = (errors, t, field, decimals) => {
     return '';
 };
 const SendBalanceForm = ({ initialValues, onSubmit, decimals = 18, validateAddress = () => true, validateAmount = () => true, currentToken, transaction, tokenBalances, setCurrentToken, isLoading, supportsFeeTokenSelection = false, feeTokenOptions, currentFeeToken, setCurrentFeeToken, fallbackTokenIcon, }) => {
-    var _a;
+    var _a, _b;
     const { t } = useTranslation();
     const { showFiat } = useInternalDynamicContext();
     const floatingValueRef = useRef(null);
@@ -179,6 +182,24 @@ const SendBalanceForm = ({ initialValues, onSubmit, decimals = 18, validateAddre
                         return true;
                     return /^0*(?:\.0+)?$/.test(value) === false;
                 },
+            })
+                // Chains with a minimum sendable value (e.g. Bitcoin's dust limit)
+                //  would otherwise accept the amount here and fail when the
+                //  transaction is built, with no feedback in the UI.
+                .test({
+                message: 'underMinimum',
+                test: (value) => {
+                    if (!value || !(transaction === null || transaction === void 0 ? void 0 : transaction.minAmount))
+                        return true;
+                    if (currentToken && currentToken.isNative !== true)
+                        return true;
+                    try {
+                        return transaction.parse(value) >= transaction.minAmount;
+                    }
+                    catch (_a) {
+                        return true;
+                    }
+                },
             })
                 .test({
                 message: 'overBalance',
@@ -191,7 +212,10 @@ const SendBalanceForm = ({ initialValues, onSubmit, decimals = 18, validateAddre
                 test: (value) => validateAddress(value),
             }),
         });
-    }, [decimals, validateAddress, validateAmount]);
+    }, [decimals, validateAddress, validateAmount, transaction, currentToken]);
+    const minAmountDisplay = (transaction === null || transaction === void 0 ? void 0 : transaction.minAmount)
+        ? `${transaction.format(transaction.minAmount)} ${(_b = currentToken === null || currentToken === void 0 ? void 0 : currentToken.symbol) !== null && _b !== void 0 ? _b : ''}`.trim()
+        : undefined;
     return (jsx(Formik, { initialValues: initialValues || sendBalanceFormInitialValues, validationSchema: sendBalanceFormValidationSchema, onSubmit: (values) => onSubmit(values), validateOnChange: false, validateOnBlur: false, children: ({ errors, touched, values, handleChange, setFieldValue, setErrors, handleBlur, setFieldTouched, validateField, }) => {
             var _a;
             return (jsxs(Form, { className: 'send-balance-form', children: [jsxs("div", { className: 'send-balance-page-layout__balance-container', children: [jsx(FormFieldLabel, { copykey: 'dyn_send_transaction.data.select_token', children: t('dyn_send_transaction.data.select_token') }), jsx(TokensBalanceDropdown, { tokenBalances: filteredTokenBalances !== null && filteredTokenBalances !== void 0 ? filteredTokenBalances : (pickerToken && [pickerToken]), currentToken: pickerToken, setCurrentToken: setCurrentToken, isLoading: isLoading, setFieldValue: setFieldValue, setErrors: setErrors, fallbackTokenIcon: fallbackTokenIcon, placeholder: t('dyn_send_transaction.data.select_token') })] }), jsxs("div", { className: 'send-balance-form__amount-container', children: [jsx(Field, { variant: 'regular', className: `send-balance-form__amount-container__field ${showFiat ? 'fiat' : ''}`, name: 'amount', id: 'amount', onChange: (e) => {
@@ -219,7 +243,7 @@ const SendBalanceForm = ({ initialValues, onSubmit, decimals = 18, validateAddre
                                     (_a = transaction === null || transaction === void 0 ? void 0 : transaction.setPendingAmount) === null || _a === void 0 ? void 0 : _a.call(transaction, (_b = e.target.value) !== null && _b !== void 0 ? _b : '');
                                     refreshMergeAction();
                                 }, placeholder: t('dyn_send_transaction.data.amount.placeholder'), as: Input, error: errors['amount'], copykey: 'dyn_send_transaction.data.amount.label', message: touched['amount'] &&
-                                    getDisplayErrorMessage(errors, t, 'amount', decimals), style: {
+                                    getDisplayErrorMessage(errors, t, 'amount', decimals, minAmountDisplay), style: {
                                     paddingLeft: `${leftSymbolPadding}px`,
                                 } }), jsx("div", { className: 'send-balance-form__amount-container__floating_value', ref: floatingValueRef, children: jsx(Typography, { variant: 'title', weight: 'regular', color: 'secondary', children: currentToken === null || currentToken === void 0 ? void 0 : currentToken.symbol }) }), jsx("div", { className: 'send-balance-form__amount-container__balance', children: showFiat && !Number.isNaN(amount) && (jsxs(Fragment, { children: [jsx(Typography, { variant: 'body_mini', weight: 'bold', color: 'secondary', children: "$" }), jsx(Typography, { variant: 'body_mini', weight: 'regular', color: 'secondary', children: getDisplayFiatPrice(amount, currentToken) })] })) })] }), jsx(Typography, { className: 'send-balance-form__amount_available', variant: 'body_small', weight: 'regular', color: 'secondary', as: 'div', children: jsxs("div", { style: { display: 'flex', gap: '0.225rem' }, children: [jsx(Typography, { className: 'send-balance-form__amount_available__line', variant: 'body_small', weight: 'bold', color: 'primary', as: 'div', children: (_a = pickerToken === null || pickerToken === void 0 ? void 0 : pickerToken.balance) !== null && _a !== void 0 ? _a : 0 }), t('dyn_send_transaction.data.symbol_available', {
                                     symbol: pickerToken === null || pickerToken === void 0 ? void 0 : pickerToken.symbol,

package/src/lib/context/CaptchaContext/CaptchaContext.cjs

@@ -34,9 +34,17 @@ const CaptchaContextProvider = ({ children, }) => {
     const { setShowAuthFlow } = useInternalDynamicContext.useInternalDynamicContext();
     const [captchaToken, setCaptchaToken, removeCaptchaToken] = useLocalStorage.useLocalStorage(localStorage.CAPTCHA_TOKEN, undefined);
     const [captchaAuthState, setCaptchaAuthState] = React.useState();
-    const engageCaptcha = React.useCallback(({ authMethod, onCaptchaSuccess, }) => {
+    const engageCaptcha = React.useCallback(({ authMethod, onCaptchaSuccess, onCaptchaCancel, }) => {
         setCaptchaAuthState({ authMethod, onCaptchaSuccess });
-        pushView('captcha');
+        pushView('captcha', undefined, {
+            // Navigating back abandons the pending onCaptchaSuccess continuation,
+            // so let the caller settle its flow (eg dismiss a pending view)
+            // instead of leaving it waiting for a captcha token forever
+            onBackClick: () => {
+                setCaptchaAuthState(undefined);
+                onCaptchaCancel === null || onCaptchaCancel === void 0 ? void 0 : onCaptchaCancel();
+            },
+        });
         setShowAuthFlow(true);
     }, [pushView, setCaptchaAuthState, setShowAuthFlow]);
     const getCaptchaToken = React.useCallback(() => {

package/src/lib/context/CaptchaContext/CaptchaContext.d.ts

@@ -4,9 +4,10 @@ type CaptchaContextProps = {
     setCaptchaToken: Dispatch<SetStateAction<string | undefined>>;
     captchaAuthState: CaptchaAuthenticationState | undefined;
     setCaptchaAuthState: Dispatch<SetStateAction<CaptchaAuthenticationState | undefined>>;
-    engageCaptcha: ({ authMethod, onCaptchaSuccess, }: {
+    engageCaptcha: ({ authMethod, onCaptchaSuccess, onCaptchaCancel, }: {
         authMethod: AuthMethod;
         onCaptchaSuccess: (captchaToken: string) => Promise<void>;
+        onCaptchaCancel?: () => void;
     }) => void;
 };
 export type AuthMethod = 'wallet' | 'email' | 'social' | 'phone';

package/src/lib/context/CaptchaContext/CaptchaContext.js

@@ -30,9 +30,17 @@ const CaptchaContextProvider = ({ children, }) => {
     const { setShowAuthFlow } = useInternalDynamicContext();
     const [captchaToken, setCaptchaToken, removeCaptchaToken] = useLocalStorage(CAPTCHA_TOKEN, undefined);
     const [captchaAuthState, setCaptchaAuthState] = useState();
-    const engageCaptcha = useCallback(({ authMethod, onCaptchaSuccess, }) => {
+    const engageCaptcha = useCallback(({ authMethod, onCaptchaSuccess, onCaptchaCancel, }) => {
         setCaptchaAuthState({ authMethod, onCaptchaSuccess });
-        pushView('captcha');
+        pushView('captcha', undefined, {
+            // Navigating back abandons the pending onCaptchaSuccess continuation,
+            // so let the caller settle its flow (eg dismiss a pending view)
+            // instead of leaving it waiting for a captcha token forever
+            onBackClick: () => {
+                setCaptchaAuthState(undefined);
+                onCaptchaCancel === null || onCaptchaCancel === void 0 ? void 0 : onCaptchaCancel();
+            },
+        });
         setShowAuthFlow(true);
     }, [pushView, setCaptchaAuthState, setShowAuthFlow]);
     const getCaptchaToken = useCallback(() => {

package/src/lib/context/DynamicContext/types/DynamicContextProps.d.ts

@@ -119,7 +119,7 @@ export interface DynamicContextProps {
         /**
          * If true, the Metamask SDK will be used to connect to the wallet.
          * If false, the injected eip6963 provider will be used and WalletConnect for mobile.
-         * @default false
+         * @default true
          */
         useMetamaskSdk?: boolean;
     };

package/src/lib/store/state/dynamicContextProps/defaultDynamicSettings.cjs

@@ -23,7 +23,7 @@ const defaultDynamicSettings = {
     shadowDOMEnabled: true,
     showLockedWalletView: false,
     tokensFilter: (tokens) => tokens,
-    useMetamaskSdk: false,
+    useMetamaskSdk: true,
 };
 
 exports.PUBLIC_PROJECT_LIVE_ENVIRONMENT_ID = PUBLIC_PROJECT_LIVE_ENVIRONMENT_ID;

package/src/lib/store/state/dynamicContextProps/defaultDynamicSettings.d.ts

@@ -16,5 +16,5 @@ export declare const defaultDynamicSettings: {
     shadowDOMEnabled: true;
     showLockedWalletView: false;
     tokensFilter: (tokens: import("@dynamic-labs/sdk-api-core").TokenBalance[]) => import("@dynamic-labs/sdk-api-core").TokenBalance[];
-    useMetamaskSdk: false;
+    useMetamaskSdk: true;
 };

package/src/lib/store/state/dynamicContextProps/defaultDynamicSettings.js

@@ -19,7 +19,7 @@ const defaultDynamicSettings = {
     shadowDOMEnabled: true,
     showLockedWalletView: false,
     tokensFilter: (tokens) => tokens,
-    useMetamaskSdk: false,
+    useMetamaskSdk: true,
 };
 
 export { PUBLIC_PROJECT_LIVE_ENVIRONMENT_ID, defaultDynamicSettings };

package/src/lib/utils/functions/getEmbeddedBitcoinActiveAddress/getEmbeddedBitcoinActiveAddress.cjs

@@ -0,0 +1,24 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Embedded Bitcoin wallets expose a per-network payment address (one key,
+ * network-tagged additional addresses). The connector swaps its active
+ * address when the selected network changes, so per-network UI (displayed
+ * address, deposit QR, balance queries) must read the connector's active
+ * address rather than the wallet's static primary (mainnet) address.
+ *
+ * @returns the active address for embedded Bitcoin connectors, undefined otherwise
+ */
+const getEmbeddedBitcoinActiveAddress = (connector) => {
+    if (!connector ||
+        connector.connectedChain !== 'BTC' ||
+        !connector.isEmbeddedWallet) {
+        return undefined;
+    }
+    return connector.activeAccountAddress;
+};
+
+exports.getEmbeddedBitcoinActiveAddress = getEmbeddedBitcoinActiveAddress;

package/src/lib/utils/functions/getEmbeddedBitcoinActiveAddress/getEmbeddedBitcoinActiveAddress.d.ts

@@ -0,0 +1,11 @@
+import { WalletConnector } from '@dynamic-labs/wallet-connector-core';
+/**
+ * Embedded Bitcoin wallets expose a per-network payment address (one key,
+ * network-tagged additional addresses). The connector swaps its active
+ * address when the selected network changes, so per-network UI (displayed
+ * address, deposit QR, balance queries) must read the connector's active
+ * address rather than the wallet's static primary (mainnet) address.
+ *
+ * @returns the active address for embedded Bitcoin connectors, undefined otherwise
+ */
+export declare const getEmbeddedBitcoinActiveAddress: (connector?: WalletConnector) => string | undefined;

package/src/lib/utils/functions/getEmbeddedBitcoinActiveAddress/getEmbeddedBitcoinActiveAddress.js

@@ -0,0 +1,20 @@
+'use client'
+/**
+ * Embedded Bitcoin wallets expose a per-network payment address (one key,
+ * network-tagged additional addresses). The connector swaps its active
+ * address when the selected network changes, so per-network UI (displayed
+ * address, deposit QR, balance queries) must read the connector's active
+ * address rather than the wallet's static primary (mainnet) address.
+ *
+ * @returns the active address for embedded Bitcoin connectors, undefined otherwise
+ */
+const getEmbeddedBitcoinActiveAddress = (connector) => {
+    if (!connector ||
+        connector.connectedChain !== 'BTC' ||
+        !connector.isEmbeddedWallet) {
+        return undefined;
+    }
+    return connector.activeAccountAddress;
+};
+
+export { getEmbeddedBitcoinActiveAddress };

package/src/lib/utils/functions/getEmbeddedBitcoinActiveAddress/index.d.ts

@@ -0,0 +1 @@
+export * from './getEmbeddedBitcoinActiveAddress';

package/src/lib/utils/functions/getTransactionLink/blockExplorerPatterns.cjs

@@ -32,6 +32,18 @@ const BLOCK_EXPLORER_PATTERNS = [
             return url.toString();
         },
     },
+    {
+        // mempool.space scopes networks by path (/testnet, /signet); the network
+        // segment must be preserved or testnet links resolve to mainnet.
+        description: 'mempool.space - keeps the network path segment',
+        domain: 'mempool.space',
+        generateUrl: (baseUrl, hash) => {
+            const url = new URL(baseUrl);
+            const basePath = url.pathname.replace(/\/$/, '');
+            url.pathname = `${basePath}/tx/${hash}`;
+            return url.toString();
+        },
+    },
     {
         // The Midnight explorer indexes by the canonical transaction hash and
         // serves detail pages at `/transactions/{hash}`. Matching the bare

package/src/lib/utils/functions/getTransactionLink/blockExplorerPatterns.js

@@ -28,6 +28,18 @@ const BLOCK_EXPLORER_PATTERNS = [
             return url.toString();
         },
     },
+    {
+        // mempool.space scopes networks by path (/testnet, /signet); the network
+        // segment must be preserved or testnet links resolve to mainnet.
+        description: 'mempool.space - keeps the network path segment',
+        domain: 'mempool.space',
+        generateUrl: (baseUrl, hash) => {
+            const url = new URL(baseUrl);
+            const basePath = url.pathname.replace(/\/$/, '');
+            url.pathname = `${basePath}/tx/${hash}`;
+            return url.toString();
+        },
+    },
     {
         // The Midnight explorer indexes by the canonical transaction hash and
         // serves detail pages at `/transactions/{hash}`. Matching the bare

package/src/lib/utils/functions/getWalletAdditionalAddressByType/getWalletAdditionalAddressByType.cjs

@@ -3,9 +3,22 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-const getWalletAdditionalAddressByType = (type, wallet) => {
-    var _a, _b;
-    return (_b = (_a = wallet === null || wallet === void 0 ? void 0 : wallet.additionalAddresses) === null || _a === void 0 ? void 0 : _a.find((address) => address.type === type)) === null || _b === void 0 ? void 0 : _b.address;
+/**
+ * Returns an additional address of the given type. When a `network` tag is
+ * provided (e.g. Midnight's 'mainnet' | 'preview'), the variant matching that
+ * network is preferred, falling back to the first address of the type for
+ * legacy/untagged wallets. Callers that don't pass `network` keep the previous
+ * "first match" behavior.
+ */
+const getWalletAdditionalAddressByType = (type, wallet, network) => {
+    var _a, _b, _c;
+    const matches = (_b = (_a = wallet === null || wallet === void 0 ? void 0 : wallet.additionalAddresses) === null || _a === void 0 ? void 0 : _a.filter((address) => address.type === type)) !== null && _b !== void 0 ? _b : [];
+    if (network) {
+        const networkMatch = matches.find((address) => address.network === network);
+        if (networkMatch)
+            return networkMatch.address;
+    }
+    return (_c = matches[0]) === null || _c === void 0 ? void 0 : _c.address;
 };
 
 exports.getWalletAdditionalAddressByType = getWalletAdditionalAddressByType;

package/src/lib/utils/functions/getWalletAdditionalAddressByType/getWalletAdditionalAddressByType.d.ts

@@ -1,3 +1,10 @@
 import { WalletAddressType } from '@dynamic-labs/sdk-api-core';
 import { Wallet } from '../../../shared';
-export declare const getWalletAdditionalAddressByType: (type: WalletAddressType, wallet?: Wallet) => string | undefined;
+/**
+ * Returns an additional address of the given type. When a `network` tag is
+ * provided (e.g. Midnight's 'mainnet' | 'preview'), the variant matching that
+ * network is preferred, falling back to the first address of the type for
+ * legacy/untagged wallets. Callers that don't pass `network` keep the previous
+ * "first match" behavior.
+ */
+export declare const getWalletAdditionalAddressByType: (type: WalletAddressType, wallet?: Wallet, network?: string) => string | undefined;

package/src/lib/utils/functions/getWalletAdditionalAddressByType/getWalletAdditionalAddressByType.js

@@ -1,7 +1,20 @@
 'use client'
-const getWalletAdditionalAddressByType = (type, wallet) => {
-    var _a, _b;
-    return (_b = (_a = wallet === null || wallet === void 0 ? void 0 : wallet.additionalAddresses) === null || _a === void 0 ? void 0 : _a.find((address) => address.type === type)) === null || _b === void 0 ? void 0 : _b.address;
+/**
+ * Returns an additional address of the given type. When a `network` tag is
+ * provided (e.g. Midnight's 'mainnet' | 'preview'), the variant matching that
+ * network is preferred, falling back to the first address of the type for
+ * legacy/untagged wallets. Callers that don't pass `network` keep the previous
+ * "first match" behavior.
+ */
+const getWalletAdditionalAddressByType = (type, wallet, network) => {
+    var _a, _b, _c;
+    const matches = (_b = (_a = wallet === null || wallet === void 0 ? void 0 : wallet.additionalAddresses) === null || _a === void 0 ? void 0 : _a.filter((address) => address.type === type)) !== null && _b !== void 0 ? _b : [];
+    if (network) {
+        const networkMatch = matches.find((address) => address.network === network);
+        if (networkMatch)
+            return networkMatch.address;
+    }
+    return (_c = matches[0]) === null || _c === void 0 ? void 0 : _c.address;
 };
 
 export { getWalletAdditionalAddressByType };

package/src/lib/utils/functions/index.d.ts

@@ -54,6 +54,7 @@ export * from './requiresTwoStepAuthentication';
 export * from './shouldManuallyReconnectOnRefresh';
 export * from './stringifyURIQuery';
 export * from './getEnabledEmbeddedWalletsAuthenticators';
+export * from './getEmbeddedBitcoinActiveAddress';
 export * from './getWalletAdditionalAddressByType';
 export * from './isHardwareWalletEnabled';
 export * from './getEnabledEmbeddedWalletProviders';

package/src/lib/utils/hooks/useDynamicWaas/useDynamicWaas.cjs

@@ -472,25 +472,51 @@ const useDynamicWaas = () => {
         return result;
     });
     const upgradeToDynamicWaas = React.useCallback((_j) => _tslib.__awaiter(void 0, [_j], void 0, function* ({ privateKey, wallet, password, }) {
-        isUpgrading.current = true;
         if (!wallet) {
             throw new utils.DynamicError('Wallet to upgrade was not provided', 'wallet_to_upgrade_was_not_provided');
         }
+        // Guard before any destructive work: an empty/whitespace private key
+        // would otherwise soft-delete the legacy wallet and only fail on import.
+        if (!(privateKey === null || privateKey === void 0 ? void 0 : privateKey.trim())) {
+            throw new utils.DynamicError('Private key is required', 'private_key_is_required');
+        }
         const chainName = wallet.chain;
         const walletId = wallet.id;
         const walletConnector = getWaasWalletConnector(chainName);
         if (!walletConnector) {
             throw new utils.DynamicError('Wallet connector not found', 'wallet_connector_not_found');
         }
+        isUpgrading.current = true;
         let softDeleteSucceeded = false;
         // 7702 wallets have a -zerodev suffix because it's a credential created on the fly
         const normalizedWalletId = (walletId === null || walletId === void 0 ? void 0 : walletId.replace('-zerodev', '')) || walletId;
+        walletConnectorCore.logger.info('Upgrade to WaaS - migration started', {
+            chain: chainName,
+            environmentId,
+            key: 'upgradeToWaasStarted',
+            userId: user === null || user === void 0 ? void 0 : user.id,
+            walletId: normalizedWalletId,
+        });
         try {
+            walletConnectorCore.logger.info('Upgrade to WaaS - soft deleting legacy wallet', {
+                chain: chainName,
+                environmentId,
+                key: 'upgradeToWaasSoftDelete',
+                userId: user === null || user === void 0 ? void 0 : user.id,
+                walletId: normalizedWalletId,
+            });
             yield wallets.softDeleteEmbeddedWallet({
                 environmentId,
                 walletId: normalizedWalletId,
             });
             softDeleteSucceeded = true;
+            walletConnectorCore.logger.info('Upgrade to WaaS - importing private key', {
+                chain: chainName,
+                environmentId,
+                key: 'upgradeToWaasImportPrivateKey',
+                userId: user === null || user === void 0 ? void 0 : user.id,
+                walletId: normalizedWalletId,
+            });
             yield walletConnector.importPrivateKey({
                 chainName,
                 legacyWalletId: normalizedWalletId,
@@ -499,10 +525,32 @@ const useDynamicWaas = () => {
                 publicAddressCheck: wallet.address,
             });
             isUpgrading.current = false;
+            walletConnectorCore.logger.info('Upgrade to WaaS - migration completed', {
+                chain: chainName,
+                environmentId,
+                key: 'upgradeToWaasCompleted',
+                userId: user === null || user === void 0 ? void 0 : user.id,
+                walletId: normalizedWalletId,
+            });
         }
         catch (error) {
+            walletConnectorCore.logger.error('Upgrade to WaaS - migration failed', {
+                chain: chainName,
+                environmentId,
+                error,
+                softDeleteSucceeded,
+                userId: user === null || user === void 0 ? void 0 : user.id,
+                walletId: normalizedWalletId,
+            });
             // If soft delete succeeded but import failed, try to restore the wallet
             if (softDeleteSucceeded) {
+                walletConnectorCore.logger.info('Upgrade to WaaS - restoring legacy wallet after failed import', {
+                    chain: chainName,
+                    environmentId,
+                    key: 'upgradeToWaasRestore',
+                    userId: user === null || user === void 0 ? void 0 : user.id,
+                    walletId: normalizedWalletId,
+                });
                 yield wallets.restoreEmbeddedWallet({
                     environmentId,
                     walletId: normalizedWalletId,
@@ -519,7 +567,7 @@ const useDynamicWaas = () => {
             }
             throw new utils.DynamicError('Upgrade failed, please try again.', 'upgrade_failed');
         }
-    }), [environmentId, getWaasWalletConnector, refresh]);
+    }), [environmentId, getWaasWalletConnector, refresh, user === null || user === void 0 ? void 0 : user.id]);
     /**
      * Returns WaaS wallet instances from `userWallets` filtered by `key === 'dynamicwaas'`.
      *