@dynamic-labs/sdk-react-core 4.59.2 → 4.60.1

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

@@ -100,3 +100,7 @@ export { CloudBackupProvider, isWalletBackedUp, useBackupWallets, useWalletBacku
 export type { WalletBackupStatus, WalletOperationState, WalletToBackup, WalletWithBackupStatus, } from './useWalletBackup';
 export { useRefreshAuth } from './useRefreshAuth';
 export { useSetupPassword, PASSWORD_SETUP_CANCELLED_ERROR, } from './useSetupPassword';
+export { useWalletUnlock } from './useWalletUnlock';
+export type { UseWalletUnlockReturn, WalletUnlockState, } from './useWalletUnlock';
+export { usePromptWalletUnlock } from './usePromptWalletUnlock';
+export { useGetWalletPassword } from './useGetWalletPassword';

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

@@ -86,6 +86,13 @@ require('qrcode');
 require('formik');
 require('../useSubdomainCheck/useSubdomainCheck.cjs');
 require('../../../context/WalletGroupContext/WalletGroupContext.cjs');
+var apiUrl = require('../../constants/waas/apiUrl.cjs');
+var useClientSessionKeys = require('../useClientSessionKeys/useClientSessionKeys.cjs');
+var useGetMfaToken = require('../useGetMfaToken/useGetMfaToken.cjs');
+var useGetWalletPassword = require('../useGetWalletPassword/useGetWalletPassword.cjs');
+var useRefreshAuth = require('../useRefreshAuth/useRefreshAuth.cjs');
+var constants = require('./constants.cjs');
+var normalizeWalletRequirements = require('./normalizeWalletRequirements.cjs');
 require('../useWalletBackup/useWalletBackup.cjs');
 require('../useWalletBackup/types.cjs');
 require('../useWalletBackup/cloudProviders.cjs');
@@ -101,12 +108,6 @@ require('../../../context/FooterAnimationContext/index.cjs');
 require('../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.cjs');
 require('../../../context/PasskeyContext/PasskeyContext.cjs');
 require('../../../context/OnrampContext/OnrampContext.cjs');
-var useRefreshAuth = require('../useRefreshAuth/useRefreshAuth.cjs');
-var apiUrl = require('../../constants/waas/apiUrl.cjs');
-var useClientSessionKeys = require('../useClientSessionKeys/useClientSessionKeys.cjs');
-var useGetMfaToken = require('../useGetMfaToken/useGetMfaToken.cjs');
-var constants = require('./constants.cjs');
-var normalizeWalletRequirements = require('./normalizeWalletRequirements.cjs');
 require('../../../store/state/sendBalances.cjs');
 require('../../../store/state/connectorsInitializing/connectorsInitializing.cjs');
 require('../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.cjs');
@@ -122,7 +123,7 @@ require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
 var useInternalDynamicContext = require('../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.cjs');
 
 const dynamicWaasKey = 'dynamicwaas';
-const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode = 'header', getSignedSessionId, getMfaToken, svmGasSponsorshipEnabled = false, }) => {
+const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode = 'header', getSignedSessionId, getMfaToken, getWalletPassword, svmGasSponsorshipEnabled = false, }) => {
     var _a;
     walletConnector.setEnvironmentId(environmentId);
     walletConnector.setBaseApiUrl((_a = (apiBaseUrl || apiUrl.DEFAULT_WAAS_API_URL)) === null || _a === void 0 ? void 0 : _a.replace('/api/v0', ''));
@@ -138,6 +139,10 @@ const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl,
     walletConnector.setRelayUrl(relayUrl);
     walletConnector.setGetMfaTokenFunction(getMfaToken);
     walletConnector.setBaseClientKeysharesRelayApiUrl(baseClientKeysharesRelayApiUrl);
+    // Set password provider for locked wallets
+    if (getWalletPassword) {
+        walletConnector.setGetWalletPasswordFunction(getWalletPassword);
+    }
     // Sync SVM gas sponsorship setting for SOL connectors
     const isSolConnector = walletConnector.connectedChain === 'SOL';
     const supportsSponsorshipSetting = 'setSvmGasSponsorshipEnabled' in walletConnector;
@@ -170,6 +175,7 @@ const useDynamicWaas = () => {
     const authToken = getMinAuthToken.getMinAuthToken();
     const { getSignedSessionId } = useClientSessionKeys.useClientSessionKeys();
     const getMfaToken = useGetMfaToken.useGetMfaToken();
+    const getWalletPassword = useGetWalletPassword.useGetWalletPassword();
     const isCookieAuthEnabled = projectSettings && isCookieEnabled.isCookieEnabled();
     const isUpgrading = React.useRef(false);
     const [recoveredWallets, setRecoveredWallets] = React.useState(() => new Set());
@@ -192,6 +198,7 @@ const useDynamicWaas = () => {
             environmentId,
             getMfaToken,
             getSignedSessionId,
+            getWalletPassword,
             relayUrl: relayUrl !== null && relayUrl !== void 0 ? relayUrl : '',
             svmGasSponsorshipEnabled,
             walletConnector,
@@ -204,6 +211,7 @@ const useDynamicWaas = () => {
         environmentId,
         apiBaseUrl,
         getMfaToken,
+        getWalletPassword,
         getSignedSessionId,
         relayUrl,
         baseClientKeysharesRelayApiUrl,
@@ -233,14 +241,23 @@ const useDynamicWaas = () => {
             return;
         try {
             const initializationStart = new Date().getTime();
-            yield Promise.all((enabledChainNames || []).map((chain) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+            const userWaasWallets = user.verifiedCredentials.filter((vc) => vc.walletName === dynamicWaasKey && vc.address && vc.chain);
+            const chainsWithWallets = [
+                ...new Set(userWaasWallets.map((vc) => { var _a; return values.VerifiedCredentialNameToChainEnum[(_a = vc.chain) !== null && _a !== void 0 ? _a : '']; })),
+            ].filter(Boolean);
+            // Combine enabled chains with chains that have wallets
+            // This ensures we initialize clients for enabled chains AND recover wallets from any other chains
+            const allChainsToProcess = [
+                ...new Set([...(enabledChainNames || []), ...chainsWithWallets]),
+            ];
+            yield Promise.all(allChainsToProcess.map((chain) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
                 const walletConnector = getWaasWalletConnector(chain);
                 if (!walletConnector)
                     return;
                 // Filter for waas wallets on this chain
                 const waasWallets = user.verifiedCredentials.filter((credential) => {
                     var _a;
-                    return credential.walletName === 'dynamicwaas' &&
+                    return credential.walletName === dynamicWaasKey &&
                         credential.address &&
                         values.VerifiedCredentialNameToChainEnum[(_a = credential.chain) !== null && _a !== void 0 ? _a : ''] ===
                             walletConnector.connectedChain;
@@ -276,6 +293,7 @@ const useDynamicWaas = () => {
                                 const signedSessionId = yield getSignedSessionId();
                                 yield client.getWallet({
                                     accountAddress: wallet.address,
+                                    authToken: getMinAuthToken.getMinAuthToken(),
                                     signedSessionId,
                                     walletOperation: 'RECOVER',
                                 });

package/src/lib/utils/hooks/useDynamicWaas/useDynamicWaas.d.ts

@@ -1,5 +1,5 @@
 import { ChainEnum, MFAAction } from '@dynamic-labs/sdk-api-core';
-import { IDynamicWaasConnector, Wallet, WalletConnectorCore } from '@dynamic-labs/wallet-connector-core';
+import { GetWalletPasswordFn, IDynamicWaasConnector, Wallet, WalletConnectorCore } from '@dynamic-labs/wallet-connector-core';
 /**
  * Type for wallet creation requirements
  * For BTC: includes bitcoinConfig with addressType
@@ -12,7 +12,7 @@ export type WalletCreationRequirement = {
         network?: string;
     };
 };
-export declare const configWaasWalletConnector: ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode, getSignedSessionId, getMfaToken, svmGasSponsorshipEnabled, }: {
+export declare const configWaasWalletConnector: ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode, getSignedSessionId, getMfaToken, getWalletPassword, svmGasSponsorshipEnabled, }: {
     walletConnector: IDynamicWaasConnector;
     environmentId: string;
     apiBaseUrl: string;
@@ -23,6 +23,7 @@ export declare const configWaasWalletConnector: ({ walletConnector, environmentI
     getMfaToken: (props?: {
         mfaAction?: MFAAction;
     }) => Promise<string | undefined>;
+    getWalletPassword?: GetWalletPasswordFn;
     svmGasSponsorshipEnabled?: boolean;
 }) => IDynamicWaasConnector;
 export declare const useDynamicWaas: () => {

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

@@ -82,6 +82,13 @@ import 'qrcode';
 import 'formik';
 import '../useSubdomainCheck/useSubdomainCheck.js';
 import '../../../context/WalletGroupContext/WalletGroupContext.js';
+import { DEFAULT_WAAS_API_URL } from '../../constants/waas/apiUrl.js';
+import { useClientSessionKeys } from '../useClientSessionKeys/useClientSessionKeys.js';
+import { useGetMfaToken } from '../useGetMfaToken/useGetMfaToken.js';
+import { useGetWalletPassword } from '../useGetWalletPassword/useGetWalletPassword.js';
+import { useRefreshAuth } from '../useRefreshAuth/useRefreshAuth.js';
+import { DYNAMIC_WAAS_CONNECTOR_NOT_FOUND_ERROR, NO_ENABLED_CHAINS_ERROR, INVALID_CHAINS_ERROR, WALLET_CREATION_FAILED_ERROR } from './constants.js';
+import { normalizeWalletRequirements } from './normalizeWalletRequirements.js';
 import '../useWalletBackup/useWalletBackup.js';
 import '../useWalletBackup/types.js';
 import '../useWalletBackup/cloudProviders.js';
@@ -97,12 +104,6 @@ import '../../../context/FooterAnimationContext/index.js';
 import '../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.js';
 import '../../../context/PasskeyContext/PasskeyContext.js';
 import '../../../context/OnrampContext/OnrampContext.js';
-import { useRefreshAuth } from '../useRefreshAuth/useRefreshAuth.js';
-import { DEFAULT_WAAS_API_URL } from '../../constants/waas/apiUrl.js';
-import { useClientSessionKeys } from '../useClientSessionKeys/useClientSessionKeys.js';
-import { useGetMfaToken } from '../useGetMfaToken/useGetMfaToken.js';
-import { DYNAMIC_WAAS_CONNECTOR_NOT_FOUND_ERROR, NO_ENABLED_CHAINS_ERROR, INVALID_CHAINS_ERROR, WALLET_CREATION_FAILED_ERROR } from './constants.js';
-import { normalizeWalletRequirements } from './normalizeWalletRequirements.js';
 import '../../../store/state/sendBalances.js';
 import '../../../store/state/connectorsInitializing/connectorsInitializing.js';
 import '../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.js';
@@ -118,7 +119,7 @@ import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
 import { useInternalDynamicContext } from '../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.js';
 
 const dynamicWaasKey = 'dynamicwaas';
-const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode = 'header', getSignedSessionId, getMfaToken, svmGasSponsorshipEnabled = false, }) => {
+const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode = 'header', getSignedSessionId, getMfaToken, getWalletPassword, svmGasSponsorshipEnabled = false, }) => {
     var _a;
     walletConnector.setEnvironmentId(environmentId);
     walletConnector.setBaseApiUrl((_a = (apiBaseUrl || DEFAULT_WAAS_API_URL)) === null || _a === void 0 ? void 0 : _a.replace('/api/v0', ''));
@@ -134,6 +135,10 @@ const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl,
     walletConnector.setRelayUrl(relayUrl);
     walletConnector.setGetMfaTokenFunction(getMfaToken);
     walletConnector.setBaseClientKeysharesRelayApiUrl(baseClientKeysharesRelayApiUrl);
+    // Set password provider for locked wallets
+    if (getWalletPassword) {
+        walletConnector.setGetWalletPasswordFunction(getWalletPassword);
+    }
     // Sync SVM gas sponsorship setting for SOL connectors
     const isSolConnector = walletConnector.connectedChain === 'SOL';
     const supportsSponsorshipSetting = 'setSvmGasSponsorshipEnabled' in walletConnector;
@@ -166,6 +171,7 @@ const useDynamicWaas = () => {
     const authToken = getMinAuthToken();
     const { getSignedSessionId } = useClientSessionKeys();
     const getMfaToken = useGetMfaToken();
+    const getWalletPassword = useGetWalletPassword();
     const isCookieAuthEnabled = projectSettings && isCookieEnabled();
     const isUpgrading = useRef(false);
     const [recoveredWallets, setRecoveredWallets] = useState(() => new Set());
@@ -188,6 +194,7 @@ const useDynamicWaas = () => {
             environmentId,
             getMfaToken,
             getSignedSessionId,
+            getWalletPassword,
             relayUrl: relayUrl !== null && relayUrl !== void 0 ? relayUrl : '',
             svmGasSponsorshipEnabled,
             walletConnector,
@@ -200,6 +207,7 @@ const useDynamicWaas = () => {
         environmentId,
         apiBaseUrl,
         getMfaToken,
+        getWalletPassword,
         getSignedSessionId,
         relayUrl,
         baseClientKeysharesRelayApiUrl,
@@ -229,14 +237,23 @@ const useDynamicWaas = () => {
             return;
         try {
             const initializationStart = new Date().getTime();
-            yield Promise.all((enabledChainNames || []).map((chain) => __awaiter(void 0, void 0, void 0, function* () {
+            const userWaasWallets = user.verifiedCredentials.filter((vc) => vc.walletName === dynamicWaasKey && vc.address && vc.chain);
+            const chainsWithWallets = [
+                ...new Set(userWaasWallets.map((vc) => { var _a; return VerifiedCredentialNameToChainEnum[(_a = vc.chain) !== null && _a !== void 0 ? _a : '']; })),
+            ].filter(Boolean);
+            // Combine enabled chains with chains that have wallets
+            // This ensures we initialize clients for enabled chains AND recover wallets from any other chains
+            const allChainsToProcess = [
+                ...new Set([...(enabledChainNames || []), ...chainsWithWallets]),
+            ];
+            yield Promise.all(allChainsToProcess.map((chain) => __awaiter(void 0, void 0, void 0, function* () {
                 const walletConnector = getWaasWalletConnector(chain);
                 if (!walletConnector)
                     return;
                 // Filter for waas wallets on this chain
                 const waasWallets = user.verifiedCredentials.filter((credential) => {
                     var _a;
-                    return credential.walletName === 'dynamicwaas' &&
+                    return credential.walletName === dynamicWaasKey &&
                         credential.address &&
                         VerifiedCredentialNameToChainEnum[(_a = credential.chain) !== null && _a !== void 0 ? _a : ''] ===
                             walletConnector.connectedChain;
@@ -272,6 +289,7 @@ const useDynamicWaas = () => {
                                 const signedSessionId = yield getSignedSessionId();
                                 yield client.getWallet({
                                     accountAddress: wallet.address,
+                                    authToken: getMinAuthToken(),
                                     signedSessionId,
                                     walletOperation: 'RECOVER',
                                 });

package/src/lib/utils/hooks/useGetWalletPassword/index.d.ts

@@ -0,0 +1,2 @@
+export { useGetWalletPassword } from './useGetWalletPassword';
+export type { GetWalletPasswordProps } from './useGetWalletPassword';

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

@@ -0,0 +1,130 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../../_virtual/_tslib.cjs');
+var React = require('react');
+require('../../../context/DynamicContext/DynamicContext.cjs');
+require('../../../store/state/loadingAndLifecycle/loadingAndLifecycle.cjs');
+require('@dynamic-labs/iconic');
+require('@dynamic-labs/wallet-connector-core');
+require('react/jsx-runtime');
+require('../../../context/ViewContext/ViewContext.cjs');
+require('../../../shared/logger.cjs');
+require('@dynamic-labs/wallet-book');
+require('@dynamic-labs/utils');
+require('../../constants/colors.cjs');
+require('../../constants/values.cjs');
+require('@dynamic-labs/sdk-api-core');
+require('../../../shared/consts/index.cjs');
+require('../../../events/dynamicEvents.cjs');
+require('../../../context/CaptchaContext/CaptchaContext.cjs');
+require('../../../context/ErrorContext/ErrorContext.cjs');
+require('@dynamic-labs/multi-wallet');
+require('react-international-phone');
+require('../../../store/state/nonce/nonce.cjs');
+require('@dynamic-labs-sdk/client/core');
+require('../../../client/client.cjs');
+require('@dynamic-labs-sdk/client');
+require('../../../config/ApiEndpoint.cjs');
+require('@dynamic-labs/locale');
+require('../../../store/state/dynamicContextProps/dynamicContextProps.cjs');
+require('../../../store/state/primaryWalletId/primaryWalletId.cjs');
+require('../../../store/state/connectedWalletsInfo/connectedWalletsInfo.cjs');
+require('../../functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.cjs');
+require('../../../context/AccessDeniedContext/AccessDeniedContext.cjs');
+require('../../../context/AccountExistsContext/AccountExistsContext.cjs');
+require('../../../context/UserWalletsContext/UserWalletsContext.cjs');
+require('../../../store/state/authMode/authMode.cjs');
+require('../../../context/VerificationContext/VerificationContext.cjs');
+require('react-dom');
+require('../../functions/compareChains/compareChains.cjs');
+require('../../../views/Passkey/utils/findPrimaryEmbeddedChain/findPrimaryEmbeddedChain.cjs');
+require('../../../context/ThemeContext/ThemeContext.cjs');
+require('../useUserUpdateRequest/useUpdateUser/userFieldsSchema.cjs');
+require('bs58');
+require('@dynamic-labs/types');
+require('../../../context/SocialRedirectContext/SocialRedirectContext.cjs');
+require('../../../context/LoadingContext/LoadingContext.cjs');
+require('../../../context/WalletContext/WalletContext.cjs');
+require('../useEmbeddedWallet/useSecureEnclaveEmbeddedWallet/constants.cjs');
+require('yup');
+require('../../../context/MockContext/MockContext.cjs');
+require('../../../views/CollectUserDataView/useFields.cjs');
+require('../../../context/FieldsStateContext/FieldsStateContext.cjs');
+require('../../../context/UserFieldEditorContext/UserFieldEditorContext.cjs');
+require('@dynamic-labs/rpc-providers');
+require('../../../store/state/walletOptions/walletOptions.cjs');
+require('react-i18next');
+require('../../../components/Accordion/components/AccordionItem/AccordionItem.cjs');
+require('../../../components/Alert/Alert.cjs');
+require('../../../components/ShadowDOM/ShadowDOM.cjs');
+require('../../../components/IconButton/IconButton.cjs');
+require('../../../components/InlineWidget/InlineWidget.cjs');
+require('../../../components/Input/Input.cjs');
+require('../../../components/IsBrowser/IsBrowser.cjs');
+require('../../../components/MenuList/Dropdown/Dropdown.cjs');
+require('../../../components/OverlayCard/OverlayCard.cjs');
+require('../../../components/Transition/ZoomTransition/ZoomTransition.cjs');
+require('../../../components/Transition/SlideInUpTransition/SlideInUpTransition.cjs');
+require('../../../components/Transition/OpacityTransition/OpacityTransition.cjs');
+require('../../../components/PasskeyCreatedSuccessBanner/PasskeyCreatedSuccessBanner.cjs');
+require('../../../components/Popper/Popper/Popper.cjs');
+require('../../../components/Popper/PopperContext/PopperContext.cjs');
+require('react-focus-lock');
+require('qrcode');
+require('formik');
+require('../useSubdomainCheck/useSubdomainCheck.cjs');
+require('../../../context/WalletGroupContext/WalletGroupContext.cjs');
+var usePromptWalletUnlock = require('../usePromptWalletUnlock/usePromptWalletUnlock.cjs');
+require('../useWalletBackup/useWalletBackup.cjs');
+require('../useWalletBackup/types.cjs');
+require('../useWalletBackup/cloudProviders.cjs');
+require('../../../context/IpConfigurationContext/IpConfigurationContext.cjs');
+require('../../../context/ConnectWithOtpContext/ConnectWithOtpContext.cjs');
+require('../../../widgets/DynamicBridgeWidget/views/WalletsView/components/SecondaryWallets/SecondaryWallets.cjs');
+require('@hcaptcha/react-hcaptcha');
+require('../../../widgets/DynamicWidget/context/DynamicWidgetContext.cjs');
+require('../../../widgets/DynamicWidget/helpers/convertExchangeKeyAndProviderEnum.cjs');
+require('../../../views/ExchangeWhitelistWarning/ExchangeWhitelistWarning.cjs');
+require('../../../context/ErrorContext/hooks/useErrorText/useErrorText.cjs');
+require('../../../context/FooterAnimationContext/index.cjs');
+require('../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.cjs');
+require('../../../context/PasskeyContext/PasskeyContext.cjs');
+require('../../../context/OnrampContext/OnrampContext.cjs');
+require('../../../store/state/sendBalances.cjs');
+require('../../../store/state/connectorsInitializing/connectorsInitializing.cjs');
+require('../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.cjs');
+require('../../../widgets/DynamicWidget/components/DynamicWidgetHeader/DynamicWidgetHeader.cjs');
+require('../../../views/TransactionConfirmationView/TransactionConfirmationView.cjs');
+require('../../../widgets/DynamicWidget/components/PasskeyCard/PasskeyCard.cjs');
+require('../../../widgets/DynamicWidget/views/CryptoComOnramp/CryptoComOnramp.cjs');
+require('../../../../index.cjs');
+require('../../../widgets/DynamicWidget/views/ReceiveWalletFunds/ReceiveWalletFunds.cjs');
+require('../../../store/state/tokenBalances.cjs');
+require('../../../store/state/multichainBalances.cjs');
+require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
+var useInternalDynamicContext = require('../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.cjs');
+
+const useGetWalletPassword = () => {
+    const { handlers } = useInternalDynamicContext.useInternalDynamicContext();
+    const promptWalletUnlock = usePromptWalletUnlock.usePromptWalletUnlock();
+    // Use ref pattern to avoid callback recreation when handlers change
+    const getWalletPasswordHandlerRef = React.useRef(handlers === null || handlers === void 0 ? void 0 : handlers.getWalletPassword);
+    getWalletPasswordHandlerRef.current = handlers === null || handlers === void 0 ? void 0 : handlers.getWalletPassword;
+    const getWalletPassword = React.useCallback((_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ accountAddress, chainName, }) {
+        // If custom handler provided, use it
+        if (getWalletPasswordHandlerRef.current) {
+            return getWalletPasswordHandlerRef.current({
+                accountAddress,
+                chainName,
+            });
+        }
+        // Otherwise use default UI prompt
+        return promptWalletUnlock({ accountAddress, chainName });
+    }), [promptWalletUnlock]);
+    return getWalletPassword;
+};
+
+exports.useGetWalletPassword = useGetWalletPassword;

package/src/lib/utils/hooks/useGetWalletPassword/useGetWalletPassword.d.ts

@@ -0,0 +1,6 @@
+import { GetWalletPasswordFn } from '../../../shared/types/dynamicHandlers';
+export type GetWalletPasswordProps = {
+    accountAddress: string;
+    chainName: string;
+};
+export declare const useGetWalletPassword: () => GetWalletPasswordFn;

package/src/lib/utils/hooks/useGetWalletPassword/useGetWalletPassword.js

@@ -0,0 +1,126 @@
+'use client'
+import { __awaiter } from '../../../../../_virtual/_tslib.js';
+import { useRef, useCallback } from 'react';
+import '../../../context/DynamicContext/DynamicContext.js';
+import '../../../store/state/loadingAndLifecycle/loadingAndLifecycle.js';
+import '@dynamic-labs/iconic';
+import '@dynamic-labs/wallet-connector-core';
+import 'react/jsx-runtime';
+import '../../../context/ViewContext/ViewContext.js';
+import '../../../shared/logger.js';
+import '@dynamic-labs/wallet-book';
+import '@dynamic-labs/utils';
+import '../../constants/colors.js';
+import '../../constants/values.js';
+import '@dynamic-labs/sdk-api-core';
+import '../../../shared/consts/index.js';
+import '../../../events/dynamicEvents.js';
+import '../../../context/CaptchaContext/CaptchaContext.js';
+import '../../../context/ErrorContext/ErrorContext.js';
+import '@dynamic-labs/multi-wallet';
+import 'react-international-phone';
+import '../../../store/state/nonce/nonce.js';
+import '@dynamic-labs-sdk/client/core';
+import '../../../client/client.js';
+import '@dynamic-labs-sdk/client';
+import '../../../config/ApiEndpoint.js';
+import '@dynamic-labs/locale';
+import '../../../store/state/dynamicContextProps/dynamicContextProps.js';
+import '../../../store/state/primaryWalletId/primaryWalletId.js';
+import '../../../store/state/connectedWalletsInfo/connectedWalletsInfo.js';
+import '../../functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.js';
+import '../../../context/AccessDeniedContext/AccessDeniedContext.js';
+import '../../../context/AccountExistsContext/AccountExistsContext.js';
+import '../../../context/UserWalletsContext/UserWalletsContext.js';
+import '../../../store/state/authMode/authMode.js';
+import '../../../context/VerificationContext/VerificationContext.js';
+import 'react-dom';
+import '../../functions/compareChains/compareChains.js';
+import '../../../views/Passkey/utils/findPrimaryEmbeddedChain/findPrimaryEmbeddedChain.js';
+import '../../../context/ThemeContext/ThemeContext.js';
+import '../useUserUpdateRequest/useUpdateUser/userFieldsSchema.js';
+import 'bs58';
+import '@dynamic-labs/types';
+import '../../../context/SocialRedirectContext/SocialRedirectContext.js';
+import '../../../context/LoadingContext/LoadingContext.js';
+import '../../../context/WalletContext/WalletContext.js';
+import '../useEmbeddedWallet/useSecureEnclaveEmbeddedWallet/constants.js';
+import 'yup';
+import '../../../context/MockContext/MockContext.js';
+import '../../../views/CollectUserDataView/useFields.js';
+import '../../../context/FieldsStateContext/FieldsStateContext.js';
+import '../../../context/UserFieldEditorContext/UserFieldEditorContext.js';
+import '@dynamic-labs/rpc-providers';
+import '../../../store/state/walletOptions/walletOptions.js';
+import 'react-i18next';
+import '../../../components/Accordion/components/AccordionItem/AccordionItem.js';
+import '../../../components/Alert/Alert.js';
+import '../../../components/ShadowDOM/ShadowDOM.js';
+import '../../../components/IconButton/IconButton.js';
+import '../../../components/InlineWidget/InlineWidget.js';
+import '../../../components/Input/Input.js';
+import '../../../components/IsBrowser/IsBrowser.js';
+import '../../../components/MenuList/Dropdown/Dropdown.js';
+import '../../../components/OverlayCard/OverlayCard.js';
+import '../../../components/Transition/ZoomTransition/ZoomTransition.js';
+import '../../../components/Transition/SlideInUpTransition/SlideInUpTransition.js';
+import '../../../components/Transition/OpacityTransition/OpacityTransition.js';
+import '../../../components/PasskeyCreatedSuccessBanner/PasskeyCreatedSuccessBanner.js';
+import '../../../components/Popper/Popper/Popper.js';
+import '../../../components/Popper/PopperContext/PopperContext.js';
+import 'react-focus-lock';
+import 'qrcode';
+import 'formik';
+import '../useSubdomainCheck/useSubdomainCheck.js';
+import '../../../context/WalletGroupContext/WalletGroupContext.js';
+import { usePromptWalletUnlock } from '../usePromptWalletUnlock/usePromptWalletUnlock.js';
+import '../useWalletBackup/useWalletBackup.js';
+import '../useWalletBackup/types.js';
+import '../useWalletBackup/cloudProviders.js';
+import '../../../context/IpConfigurationContext/IpConfigurationContext.js';
+import '../../../context/ConnectWithOtpContext/ConnectWithOtpContext.js';
+import '../../../widgets/DynamicBridgeWidget/views/WalletsView/components/SecondaryWallets/SecondaryWallets.js';
+import '@hcaptcha/react-hcaptcha';
+import '../../../widgets/DynamicWidget/context/DynamicWidgetContext.js';
+import '../../../widgets/DynamicWidget/helpers/convertExchangeKeyAndProviderEnum.js';
+import '../../../views/ExchangeWhitelistWarning/ExchangeWhitelistWarning.js';
+import '../../../context/ErrorContext/hooks/useErrorText/useErrorText.js';
+import '../../../context/FooterAnimationContext/index.js';
+import '../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.js';
+import '../../../context/PasskeyContext/PasskeyContext.js';
+import '../../../context/OnrampContext/OnrampContext.js';
+import '../../../store/state/sendBalances.js';
+import '../../../store/state/connectorsInitializing/connectorsInitializing.js';
+import '../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.js';
+import '../../../widgets/DynamicWidget/components/DynamicWidgetHeader/DynamicWidgetHeader.js';
+import '../../../views/TransactionConfirmationView/TransactionConfirmationView.js';
+import '../../../widgets/DynamicWidget/components/PasskeyCard/PasskeyCard.js';
+import '../../../widgets/DynamicWidget/views/CryptoComOnramp/CryptoComOnramp.js';
+import '../../../../index.js';
+import '../../../widgets/DynamicWidget/views/ReceiveWalletFunds/ReceiveWalletFunds.js';
+import '../../../store/state/tokenBalances.js';
+import '../../../store/state/multichainBalances.js';
+import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
+import { useInternalDynamicContext } from '../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.js';
+
+const useGetWalletPassword = () => {
+    const { handlers } = useInternalDynamicContext();
+    const promptWalletUnlock = usePromptWalletUnlock();
+    // Use ref pattern to avoid callback recreation when handlers change
+    const getWalletPasswordHandlerRef = useRef(handlers === null || handlers === void 0 ? void 0 : handlers.getWalletPassword);
+    getWalletPasswordHandlerRef.current = handlers === null || handlers === void 0 ? void 0 : handlers.getWalletPassword;
+    const getWalletPassword = useCallback((_a) => __awaiter(void 0, [_a], void 0, function* ({ accountAddress, chainName, }) {
+        // If custom handler provided, use it
+        if (getWalletPasswordHandlerRef.current) {
+            return getWalletPasswordHandlerRef.current({
+                accountAddress,
+                chainName,
+            });
+        }
+        // Otherwise use default UI prompt
+        return promptWalletUnlock({ accountAddress, chainName });
+    }), [promptWalletUnlock]);
+    return getWalletPassword;
+};
+
+export { useGetWalletPassword };

package/src/lib/utils/hooks/usePromptWalletUnlock/index.d.ts

@@ -0,0 +1,2 @@
+export { usePromptWalletUnlock } from './usePromptWalletUnlock';
+export type { PromptWalletUnlockProps } from './usePromptWalletUnlock';