@dynamic-labs/sdk-react-core 4.92.4 → 5.0.0-rc.1

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

@@ -1,19 +1,21 @@
 'use client'
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
 import { useCallback } from 'react';
-import { StorageService, InvalidEmbeddedWalletSessionKeyError, tracing } from '@dynamic-labs/utils';
-import { logger } from '@dynamic-labs/wallet-connector-core';
+import { StorageService, tracing } from '@dynamic-labs/utils';
+import { SECURE_ENCLAVE_WALLET_SESSION_KEYS, SECURE_ENCLAVE_WALLET_SESSION_KEYS_STORAGE_OPTIONS } from '../../constants/localStorage.js';
+import { p256Sign } from '../../functions/keyService/keyService.js';
+import { generateAndSaveSessionKey } from '../../functions/embeddedWalletSessionKeysUtils/embeddedWalletSessionKeysUtils.js';
 import '@dynamic-labs-sdk/client/core';
 import '@dynamic-labs/sdk-api-core';
 import 'eventemitter3';
 import '@dynamic-labs-sdk/client';
 import '../../../config/ApiEndpoint.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 { SECURE_ENCLAVE_WALLET_SESSION_KEYS, SECURE_ENCLAVE_WALLET_SESSION_KEYS_STORAGE_OPTIONS } from '../../constants/localStorage.js';
 import '../../constants/colors.js';
 import '../../constants/values.js';
 import '../../../shared/consts/index.js';
@@ -21,17 +23,13 @@ import '@dynamic-labs/multi-wallet';
 import 'react-international-phone';
 import '../../../store/state/nonce/nonce.js';
 import '@dynamic-labs-wallet/browser-wallet-client';
-import { registerSessionKey } from '../../../data/api/embeddedWallets/embeddedWallets.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 { dynamicEvents } from '../../../events/dynamicEvents.js';
+import '../../../events/dynamicEvents.js';
 import { useOnboardingCompleteUserProfile } from '../../../client/extension/user/useOnboardingCompleteUser/useOnboardingCompleteUser.js';
-import { toEncodedFormat, p256Sign } from '../../functions/keyService/keyService.js';
-import { getTurnkeyWalletId } from '../../functions/getTurnkeyWalletId/getTurnkeyWalletId.js';
-import { generateAndSaveSessionKey, generateSessionKey } from '../../functions/embeddedWalletSessionKeysUtils/embeddedWalletSessionKeysUtils.js';
 
 const useEmbeddedWalletSessionKeys = ({ environmentId, projectSettings, }) => {
     const user = useOnboardingCompleteUserProfile();
@@ -41,111 +39,6 @@ const useEmbeddedWalletSessionKeys = ({ environmentId, projectSettings, }) => {
             ? JSON.parse(Buffer.from(sessionKeysSS, 'base64').toString())
             : undefined;
     }, []);
-    const registerHelper = useCallback((_a) => __awaiter(void 0, [_a], void 0, function* ({ walletId, environmentId, privateKey, privateKeyJwk, publicKey, prevSessionKeySignature, user, }) {
-        let resp;
-        const turnkeyWalletId = getTurnkeyWalletId(walletId, user.verifiedCredentials);
-        try {
-            resp = yield registerSessionKey({
-                environmentId,
-                prevSessionKeySignature,
-                publicKey,
-                walletId: turnkeyWalletId,
-            });
-        }
-        catch (error) {
-            if (error instanceof InvalidEmbeddedWalletSessionKeyError) {
-                // this can happen if the public key passed during initial registration
-                // does not match the root session public key that the backend expects
-                logger.warn('Invalid embedded wallet session key. Re-authentication is required to create new session keys.');
-                dynamicEvents.emit('triggerLogout', 'embedded-wallet-session-key-invalid');
-            }
-            logger.error('Error registering session key', { error });
-            throw error;
-        }
-        const expirationDate = new Date(resp.expiresAt * 1000);
-        tracing.logEvent('session-key', 'Created new session key', tracing.formatObject({
-            expirationDate,
-            publicKey,
-        }));
-        StorageService.setItem(SECURE_ENCLAVE_WALLET_SESSION_KEYS, toEncodedFormat(publicKey, privateKey, privateKeyJwk, true, expirationDate), SECURE_ENCLAVE_WALLET_SESSION_KEYS_STORAGE_OPTIONS);
-        return {
-            expirationDate,
-            privateKey,
-            publicKey,
-        };
-    }), []);
-    // scenario 1: first time session register on first transaction.
-    // scenario 2: refresh/rerender page - session still active and registered (keys were previously generated
-    //             but never registered with the backend)
-    // scenario 3: session expired and needs to be refreshed
-    // Helper to get decoded session keys from storage
-    /**
-     * @param ignoreRestore - if true, will not use the session keys if they are found in storage and didn't expire
-     * @returns - the session key
-     */
-    const registerEmbeddedWalletSessionKey = useCallback((_b) => __awaiter(void 0, [_b], void 0, function* ({ ignoreRestore = false, walletId, }) {
-        if (!user) {
-            throw new Error('User not found');
-        }
-        // check if session keys are already stored in session storage
-        let existingSessionKey = getDecodedSessionKeys();
-        tracing.logEvent('session-key', 'registerEmbeddedWalletSessionKey', tracing.formatObject({
-            hasDecodedSessionKeys: Boolean(existingSessionKey),
-            publicKey: existingSessionKey === null || existingSessionKey === void 0 ? void 0 : existingSessionKey.publicKey,
-        }));
-        if (!existingSessionKey) {
-            // We should never be in a situation where we don't have session keys in storage.
-            // But right now we are in a situation where we don't have session keys in storage,
-            // in many situations.
-            // but this is a fallback to ensure that we always have session keys
-            // To note that this would only work if chaining is disabled in the backend
-            // since the original key was registered for chaining, and now we don't have it
-            // it will fail when interacting with the backend if chaining is enabled.
-            // This logic will be removed and reverted back to logging out once we find
-            // the culprit that cause many of these to happen.
-            logger.error('Session keys not found in storage. Generating new session keys.', { userId: user === null || user === void 0 ? void 0 : user.userId });
-            existingSessionKey = yield generateAndSaveSessionKey();
-        }
-        const isSessionKeyValid = existingSessionKey.registered &&
-            existingSessionKey.expirationDate &&
-            new Date() <= new Date(existingSessionKey.expirationDate) &&
-            !ignoreRestore;
-        tracing.logEvent('session-key', 'isSessionKeyValid', tracing.formatObject({
-            isSessionKeyValid: Boolean(isSessionKeyValid),
-        }));
-        if (isSessionKeyValid) {
-            // scenario 1 - session is valid and registered
-            return existingSessionKey;
-        }
-        tracing.logEvent('session-key', 'decodedSessionKeys', tracing.formatObject({
-            publicKey: existingSessionKey.publicKey,
-            registered: existingSessionKey.registered,
-        }));
-        let publicKey;
-        let privateKey;
-        let privateKeyJwk;
-        let prevSessionKeySignature = undefined;
-        if (!existingSessionKey.registered) {
-            // scenario 2 - session needs to be registered
-            ({ publicKey, privateKey, privateKeyJwk } = existingSessionKey);
-        }
-        else {
-            // scenario 3 - session expired singing with the old key and generating a new one
-            prevSessionKeySignature = yield p256Sign(existingSessionKey.privateKeyJwk, user.sessionId);
-            //  Note that the key is only generated here, it will get saved to storage in the registerHelper
-            ({ publicKey, privateKey, privateKeyJwk } = yield generateSessionKey());
-            tracing.logEvent('session-key', 'Loaded prevSessionKeySignature', tracing.formatObject({ prevSessionKeySignature, publicKey }));
-        }
-        return registerHelper({
-            environmentId,
-            prevSessionKeySignature,
-            privateKey,
-            privateKeyJwk,
-            publicKey,
-            user,
-            walletId,
-        });
-    }), [environmentId, getDecodedSessionKeys, registerHelper, user]);
     const getSessionPublicKey = useCallback(() => {
         const decodedSessionKeys = getDecodedSessionKeys();
         if (!(decodedSessionKeys === null || decodedSessionKeys === void 0 ? void 0 : decodedSessionKeys.publicKey)) {
@@ -173,16 +66,10 @@ const useEmbeddedWalletSessionKeys = ({ environmentId, projectSettings, }) => {
         const signedSessionId = yield p256Sign(decodedSessionKeys.privateKeyJwk, sessionId);
         return signedSessionId;
     }), [getDecodedSessionKeys, user === null || user === void 0 ? void 0 : user.sessionId]);
-    const removeSessionKey = useCallback(() => {
-        tracing.logEvent('session-key', 'removeSessionKey');
-        StorageService.removeItem(SECURE_ENCLAVE_WALLET_SESSION_KEYS, SECURE_ENCLAVE_WALLET_SESSION_KEYS_STORAGE_OPTIONS);
-    }, []);
     return {
         generateSessionKey: generateAndSaveSessionKey,
         getSessionPublicKey,
         getSignedSessionId,
-        registerEmbeddedWalletSessionKey,
-        removeSessionKey,
         shouldRegisterSessionKeysOnSignin,
     };
 };

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

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

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

@@ -0,0 +1,43 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var React = require('react');
+var legacyMigrationProviderRegistry = require('../../legacyMigrationProviderRegistry/legacyMigrationProviderRegistry.cjs');
+var useIsTurnkeyWallet = require('../useIsTurnkeyWallet/useIsTurnkeyWallet.cjs');
+
+const LEGACY_WALLET_DETECTED_MESSAGE = 'A legacy embedded wallet (V1/V2) was detected, but `LegacyWalletMigrationProvider` from `@dynamic-labs/legacy-embedded-wallet-migration` is not mounted. ' +
+    'Legacy wallets are no longer supported natively by `@dynamic-labs/sdk-react-core` — mount the migration provider so the user can complete the migration to a V3 WaaS wallet before performing any further actions.';
+/**
+ * Throws when a legacy Turnkey embedded wallet (V1/V2) is detected but
+ * `LegacyWalletMigrationProvider` is not mounted by the consumer.
+ *
+ * Legacy wallets have no supported runtime path without the migration provider,
+ * so letting the app continue would strand the user with a non-functional wallet.
+ * The error is thrown from inside `useEffect`, so consumers can catch it via a
+ * React `ErrorBoundary` (or surface it through their monitoring stack) and render
+ * an appropriate "please migrate" UI.
+ */
+const useEnforceLegacyMigrationProvider = () => {
+    const { isTurnkeyWallet } = useIsTurnkeyWallet.useIsTurnkeyWallet();
+    React.useEffect(() => {
+        if (!isTurnkeyWallet)
+            return;
+        if (legacyMigrationProviderRegistry.isLegacyMigrationProviderMounted())
+            return;
+        throw new Error(LEGACY_WALLET_DETECTED_MESSAGE);
+    }, [isTurnkeyWallet]);
+};
+/**
+ * Renders nothing, but runs `useEnforceLegacyMigrationProvider` from inside
+ * the DynamicContext tree so the underlying `useInternalDynamicContext` can
+ * resolve. Mounted from `DynamicContext` itself.
+ */
+const EnforceLegacyMigrationProvider = () => {
+    useEnforceLegacyMigrationProvider();
+    return null;
+};
+
+exports.EnforceLegacyMigrationProvider = EnforceLegacyMigrationProvider;
+exports.useEnforceLegacyMigrationProvider = useEnforceLegacyMigrationProvider;

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

@@ -0,0 +1,18 @@
+import { FC } from 'react';
+/**
+ * Throws when a legacy Turnkey embedded wallet (V1/V2) is detected but
+ * `LegacyWalletMigrationProvider` is not mounted by the consumer.
+ *
+ * Legacy wallets have no supported runtime path without the migration provider,
+ * so letting the app continue would strand the user with a non-functional wallet.
+ * The error is thrown from inside `useEffect`, so consumers can catch it via a
+ * React `ErrorBoundary` (or surface it through their monitoring stack) and render
+ * an appropriate "please migrate" UI.
+ */
+export declare const useEnforceLegacyMigrationProvider: () => void;
+/**
+ * Renders nothing, but runs `useEnforceLegacyMigrationProvider` from inside
+ * the DynamicContext tree so the underlying `useInternalDynamicContext` can
+ * resolve. Mounted from `DynamicContext` itself.
+ */
+export declare const EnforceLegacyMigrationProvider: FC;

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

@@ -0,0 +1,38 @@
+'use client'
+import { useEffect } from 'react';
+import { isLegacyMigrationProviderMounted } from '../../legacyMigrationProviderRegistry/legacyMigrationProviderRegistry.js';
+import { useIsTurnkeyWallet } from '../useIsTurnkeyWallet/useIsTurnkeyWallet.js';
+
+const LEGACY_WALLET_DETECTED_MESSAGE = 'A legacy embedded wallet (V1/V2) was detected, but `LegacyWalletMigrationProvider` from `@dynamic-labs/legacy-embedded-wallet-migration` is not mounted. ' +
+    'Legacy wallets are no longer supported natively by `@dynamic-labs/sdk-react-core` — mount the migration provider so the user can complete the migration to a V3 WaaS wallet before performing any further actions.';
+/**
+ * Throws when a legacy Turnkey embedded wallet (V1/V2) is detected but
+ * `LegacyWalletMigrationProvider` is not mounted by the consumer.
+ *
+ * Legacy wallets have no supported runtime path without the migration provider,
+ * so letting the app continue would strand the user with a non-functional wallet.
+ * The error is thrown from inside `useEffect`, so consumers can catch it via a
+ * React `ErrorBoundary` (or surface it through their monitoring stack) and render
+ * an appropriate "please migrate" UI.
+ */
+const useEnforceLegacyMigrationProvider = () => {
+    const { isTurnkeyWallet } = useIsTurnkeyWallet();
+    useEffect(() => {
+        if (!isTurnkeyWallet)
+            return;
+        if (isLegacyMigrationProviderMounted())
+            return;
+        throw new Error(LEGACY_WALLET_DETECTED_MESSAGE);
+    }, [isTurnkeyWallet]);
+};
+/**
+ * Renders nothing, but runs `useEnforceLegacyMigrationProvider` from inside
+ * the DynamicContext tree so the underlying `useInternalDynamicContext` can
+ * resolve. Mounted from `DynamicContext` itself.
+ */
+const EnforceLegacyMigrationProvider = () => {
+    useEnforceLegacyMigrationProvider();
+    return null;
+};
+
+export { EnforceLegacyMigrationProvider, useEnforceLegacyMigrationProvider };

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

@@ -9,9 +9,9 @@ require('../../../context/DynamicContext/useDynamicContext/useDynamicContext.cjs
 var useInternalDynamicContext = require('../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.cjs');
 require('@dynamic-labs/sdk-api-core');
 require('../../constants/values.cjs');
-require('@dynamic-labs/utils');
 require('../../../../../_virtual/_tslib.cjs');
 require('@dynamic-labs/multi-wallet');
+require('@dynamic-labs/utils');
 var logger = require('../../../shared/logger.cjs');
 require('react-international-phone');
 require('../../constants/colors.cjs');

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

@@ -5,9 +5,9 @@ import '../../../context/DynamicContext/useDynamicContext/useDynamicContext.js';
 import { useInternalDynamicContext } from '../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.js';
 import '@dynamic-labs/sdk-api-core';
 import '../../constants/values.js';
-import '@dynamic-labs/utils';
 import '../../../../../_virtual/_tslib.js';
 import '@dynamic-labs/multi-wallet';
+import '@dynamic-labs/utils';
 import { logger } from '../../../shared/logger.js';
 import 'react-international-phone';
 import '../../constants/colors.js';

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

@@ -53,7 +53,6 @@ const useIsTurnkeyWallet = () => {
         isSessionKeyCompatible,
         isTurnkeyWallet,
         isTurnkeyWalletWithoutAuthenticator,
-        turnkeyVerifiedCredential,
     };
 };
 

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

@@ -4,5 +4,4 @@ export declare const useIsTurnkeyWallet: () => {
     isSessionKeyCompatible: boolean;
     isTurnkeyWallet: boolean;
     isTurnkeyWalletWithoutAuthenticator: boolean;
-    turnkeyVerifiedCredential: import("@dynamic-labs/sdk-api-core").JwtVerifiedCredential | undefined;
 };

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

@@ -49,7 +49,6 @@ const useIsTurnkeyWallet = () => {
         isSessionKeyCompatible,
         isTurnkeyWallet,
         isTurnkeyWalletWithoutAuthenticator,
-        turnkeyVerifiedCredential,
     };
 };
 

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

@@ -8,9 +8,9 @@ var useInternalDynamicContext = require('../../../context/DynamicContext/useDyna
 var getUserProfileFields = require('../../functions/getUserProfileFields/getUserProfileFields.cjs');
 require('@dynamic-labs/sdk-api-core');
 require('../../constants/values.cjs');
-require('@dynamic-labs/utils');
 require('../../../../../_virtual/_tslib.cjs');
 require('@dynamic-labs/multi-wallet');
+require('@dynamic-labs/utils');
 require('../../../shared/logger.cjs');
 require('react-international-phone');
 require('../../constants/colors.cjs');

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

@@ -4,9 +4,9 @@ import { useInternalDynamicContext } from '../../../context/DynamicContext/useDy
 import { getUserProfileFields } from '../../functions/getUserProfileFields/getUserProfileFields.js';
 import '@dynamic-labs/sdk-api-core';
 import '../../constants/values.js';
-import '@dynamic-labs/utils';
 import '../../../../../_virtual/_tslib.js';
 import '@dynamic-labs/multi-wallet';
+import '@dynamic-labs/utils';
 import '../../../shared/logger.js';
 import 'react-international-phone';
 import '../../constants/colors.js';

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

@@ -20,7 +20,6 @@ require('@dynamic-labs/wallet-book');
 require('../../constants/colors.cjs');
 require('../../constants/values.cjs');
 require('../../../shared/consts/index.cjs');
-var errors = require('../../constants/errors.cjs');
 require('@dynamic-labs/multi-wallet');
 require('react-international-phone');
 require('../../../store/state/nonce/nonce.cjs');
@@ -36,6 +35,7 @@ var getUserProfile = require('../../../client/extension/user/getUserProfile/getU
 var getProjectSettings = require('../../../client/extension/projectSettings/getProjectSettings/getProjectSettings.cjs');
 var authMode = require('../../../store/state/authMode/authMode.cjs');
 var multichainBalances = require('../../../store/state/multichainBalances.cjs');
+var errors = require('../../constants/errors.cjs');
 var useGetMultichainTokenBalances = require('../useGetMultichainTokenBalances/useGetMultichainTokenBalances.cjs');
 
 // Hook to fetch multichain token balances with caching to reduce re-querying

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

@@ -16,7 +16,6 @@ import '@dynamic-labs/wallet-book';
 import '../../constants/colors.js';
 import '../../constants/values.js';
 import '../../../shared/consts/index.js';
-import { USER_NOT_LOGGED_IN } from '../../constants/errors.js';
 import '@dynamic-labs/multi-wallet';
 import 'react-international-phone';
 import '../../../store/state/nonce/nonce.js';
@@ -32,6 +31,7 @@ import { getUserProfile } from '../../../client/extension/user/getUserProfile/ge
 import { getProjectSettings } from '../../../client/extension/projectSettings/getProjectSettings/getProjectSettings.js';
 import { getAuthMode } from '../../../store/state/authMode/authMode.js';
 import { useMultichainTokenBalancesState, setMultichainTokenBalanceVariable } from '../../../store/state/multichainBalances.js';
+import { USER_NOT_LOGGED_IN } from '../../constants/errors.js';
 import { useGetMultichainTokenBalances } from '../useGetMultichainTokenBalances/useGetMultichainTokenBalances.js';
 
 // Hook to fetch multichain token balances with caching to reduce re-querying

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

@@ -8,9 +8,9 @@ var useInternalDynamicContext = require('../../../context/DynamicContext/useDyna
 var authMode = require('../../../store/state/authMode/authMode.cjs');
 require('@dynamic-labs/sdk-api-core');
 require('../../constants/values.cjs');
-require('@dynamic-labs/utils');
 require('../../../../../_virtual/_tslib.cjs');
 require('@dynamic-labs/multi-wallet');
+require('@dynamic-labs/utils');
 require('../../../shared/logger.cjs');
 require('react-international-phone');
 require('../../constants/colors.cjs');
@@ -37,9 +37,8 @@ require('../../functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.cjs');
 var useConnectAndSign = require('../authenticationHooks/useConnectAndSign/useConnectAndSign.cjs');
 require('../../../context/ErrorContext/ErrorContext.cjs');
 require('react-dom');
-require('../../functions/compareChains/compareChains.cjs');
-require('../../../views/Passkey/utils/findPrimaryEmbeddedChain/findPrimaryEmbeddedChain.cjs');
 require('../../../context/ThemeContext/ThemeContext.cjs');
+require('../../functions/compareChains/compareChains.cjs');
 require('../../../context/VerificationContext/VerificationContext.cjs');
 require('../useUserUpdateRequest/useUpdateUser/userFieldsSchema.cjs');
 require('bs58');
@@ -49,9 +48,6 @@ require('../../../context/CaptchaContext/CaptchaContext.cjs');
 require('../../../context/AccessDeniedContext/AccessDeniedContext.cjs');
 require('../../../context/AccountExistsContext/AccountExistsContext.cjs');
 require('../../../context/LoadingContext/LoadingContext.cjs');
-require('../../../context/WalletContext/WalletContext.cjs');
-require('../../../context/UserWalletsContext/UserWalletsContext.cjs');
-require('../useEmbeddedWallet/useSecureEnclaveEmbeddedWallet/constants.cjs');
 require('yup');
 require('../../../context/MockContext/MockContext.cjs');
 require('../../../views/CollectUserDataView/useFields.cjs');
@@ -60,9 +56,11 @@ require('../../../context/UserFieldEditorContext/UserFieldEditorContext.cjs');
 require('@dynamic-labs/rpc-providers');
 require('../../../store/state/loadingAndLifecycle/loadingAndLifecycle.cjs');
 require('../../../store/state/walletOptions/walletOptions.cjs');
+require('../../../context/UserWalletsContext/UserWalletsContext.cjs');
 require('react-i18next');
 require('../../../components/Accordion/components/AccordionItem/AccordionItem.cjs');
 require('../../../components/Alert/Alert.cjs');
+require('../../../context/WalletContext/WalletContext.cjs');
 require('../../../components/ShadowDOM/ShadowDOM.cjs');
 require('../../../components/IconButton/IconButton.cjs');
 require('../../../components/InlineWidget/InlineWidget.cjs');
@@ -83,6 +81,7 @@ require('../useSubdomainCheck/useSubdomainCheck.cjs');
 require('../../../context/WalletGroupContext/WalletGroupContext.cjs');
 require('../../../widgets/DynamicWidget/context/DynamicWidgetContext.cjs');
 require('../useGetMfaToken/useGetMfaToken.cjs');
+require('../../../views/Passkey/utils/findPrimaryEmbeddedChain/findPrimaryEmbeddedChain.cjs');
 require('../useWalletBackup/useWalletBackup.cjs');
 require('../useWalletBackup/BackupError.cjs');
 require('../useWalletBackup/types.cjs');

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

@@ -4,9 +4,9 @@ import { useInternalDynamicContext } from '../../../context/DynamicContext/useDy
 import { getAuthMode } from '../../../store/state/authMode/authMode.js';
 import '@dynamic-labs/sdk-api-core';
 import '../../constants/values.js';
-import '@dynamic-labs/utils';
 import '../../../../../_virtual/_tslib.js';
 import '@dynamic-labs/multi-wallet';
+import '@dynamic-labs/utils';
 import '../../../shared/logger.js';
 import 'react-international-phone';
 import '../../constants/colors.js';
@@ -33,9 +33,8 @@ import '../../functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.js';
 import { useConnectAndSign } from '../authenticationHooks/useConnectAndSign/useConnectAndSign.js';
 import '../../../context/ErrorContext/ErrorContext.js';
 import 'react-dom';
-import '../../functions/compareChains/compareChains.js';
-import '../../../views/Passkey/utils/findPrimaryEmbeddedChain/findPrimaryEmbeddedChain.js';
 import '../../../context/ThemeContext/ThemeContext.js';
+import '../../functions/compareChains/compareChains.js';
 import '../../../context/VerificationContext/VerificationContext.js';
 import '../useUserUpdateRequest/useUpdateUser/userFieldsSchema.js';
 import 'bs58';
@@ -45,9 +44,6 @@ import '../../../context/CaptchaContext/CaptchaContext.js';
 import '../../../context/AccessDeniedContext/AccessDeniedContext.js';
 import '../../../context/AccountExistsContext/AccountExistsContext.js';
 import '../../../context/LoadingContext/LoadingContext.js';
-import '../../../context/WalletContext/WalletContext.js';
-import '../../../context/UserWalletsContext/UserWalletsContext.js';
-import '../useEmbeddedWallet/useSecureEnclaveEmbeddedWallet/constants.js';
 import 'yup';
 import '../../../context/MockContext/MockContext.js';
 import '../../../views/CollectUserDataView/useFields.js';
@@ -56,9 +52,11 @@ import '../../../context/UserFieldEditorContext/UserFieldEditorContext.js';
 import '@dynamic-labs/rpc-providers';
 import '../../../store/state/loadingAndLifecycle/loadingAndLifecycle.js';
 import '../../../store/state/walletOptions/walletOptions.js';
+import '../../../context/UserWalletsContext/UserWalletsContext.js';
 import 'react-i18next';
 import '../../../components/Accordion/components/AccordionItem/AccordionItem.js';
 import '../../../components/Alert/Alert.js';
+import '../../../context/WalletContext/WalletContext.js';
 import '../../../components/ShadowDOM/ShadowDOM.js';
 import '../../../components/IconButton/IconButton.js';
 import '../../../components/InlineWidget/InlineWidget.js';
@@ -79,6 +77,7 @@ import '../useSubdomainCheck/useSubdomainCheck.js';
 import '../../../context/WalletGroupContext/WalletGroupContext.js';
 import '../../../widgets/DynamicWidget/context/DynamicWidgetContext.js';
 import '../useGetMfaToken/useGetMfaToken.js';
+import '../../../views/Passkey/utils/findPrimaryEmbeddedChain/findPrimaryEmbeddedChain.js';
 import '../useWalletBackup/useWalletBackup.js';
 import '../useWalletBackup/BackupError.js';
 import '../useWalletBackup/types.js';

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

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

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

@@ -0,0 +1,29 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var React = require('react');
+var legacyMigrationProviderRegistry = require('../../legacyMigrationProviderRegistry/legacyMigrationProviderRegistry.cjs');
+
+/**
+ * Tells sdk-react-core that a legacy-wallet migration UI is mounted, so the
+ * `useEnforceLegacyMigrationProvider` check does not throw when a legacy
+ * V1/V2 Turnkey wallet is observed.
+ *
+ * Call this from the component that owns your migration UI when running
+ * headless (i.e. you're not using `LegacyWalletMigrationProvider` from
+ * `@dynamic-labs/legacy-embedded-wallet-migration`, but driving the upgrade
+ * yourself via `useUpgradeToDynamicWaas` and your own UI).
+ *
+ * The flag is cleared on unmount so the enforcement re-engages if your UI is
+ * removed from the tree.
+ */
+const useRegisterLegacyMigrationUI = () => {
+    React.useEffect(() => {
+        legacyMigrationProviderRegistry.setLegacyMigrationProviderMounted(true);
+        return () => legacyMigrationProviderRegistry.setLegacyMigrationProviderMounted(false);
+    }, []);
+};
+
+exports.useRegisterLegacyMigrationUI = useRegisterLegacyMigrationUI;

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

@@ -0,0 +1,14 @@
+/**
+ * Tells sdk-react-core that a legacy-wallet migration UI is mounted, so the
+ * `useEnforceLegacyMigrationProvider` check does not throw when a legacy
+ * V1/V2 Turnkey wallet is observed.
+ *
+ * Call this from the component that owns your migration UI when running
+ * headless (i.e. you're not using `LegacyWalletMigrationProvider` from
+ * `@dynamic-labs/legacy-embedded-wallet-migration`, but driving the upgrade
+ * yourself via `useUpgradeToDynamicWaas` and your own UI).
+ *
+ * The flag is cleared on unmount so the enforcement re-engages if your UI is
+ * removed from the tree.
+ */
+export declare const useRegisterLegacyMigrationUI: () => void;

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

@@ -0,0 +1,25 @@
+'use client'
+import { useEffect } from 'react';
+import { setLegacyMigrationProviderMounted } from '../../legacyMigrationProviderRegistry/legacyMigrationProviderRegistry.js';
+
+/**
+ * Tells sdk-react-core that a legacy-wallet migration UI is mounted, so the
+ * `useEnforceLegacyMigrationProvider` check does not throw when a legacy
+ * V1/V2 Turnkey wallet is observed.
+ *
+ * Call this from the component that owns your migration UI when running
+ * headless (i.e. you're not using `LegacyWalletMigrationProvider` from
+ * `@dynamic-labs/legacy-embedded-wallet-migration`, but driving the upgrade
+ * yourself via `useUpgradeToDynamicWaas` and your own UI).
+ *
+ * The flag is cleared on unmount so the enforcement re-engages if your UI is
+ * removed from the tree.
+ */
+const useRegisterLegacyMigrationUI = () => {
+    useEffect(() => {
+        setLegacyMigrationProviderMounted(true);
+        return () => setLegacyMigrationProviderMounted(false);
+    }, []);
+};
+
+export { useRegisterLegacyMigrationUI };