@dynamic-labs/sdk-react-core 5.0.0-rc.0 → 5.0.0-rc.2

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

@@ -6,18 +6,20 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var _tslib = require('../../../../../_virtual/_tslib.cjs');
 var React = require('react');
 var utils = require('@dynamic-labs/utils');
-var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
+var localStorage = require('../../constants/localStorage.cjs');
+var keyService = require('../../functions/keyService/keyService.cjs');
+var embeddedWalletSessionKeysUtils = require('../../functions/embeddedWalletSessionKeysUtils/embeddedWalletSessionKeysUtils.cjs');
 require('@dynamic-labs-sdk/client/core');
 require('@dynamic-labs/sdk-api-core');
 require('eventemitter3');
 require('@dynamic-labs-sdk/client');
 require('../../../config/ApiEndpoint.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');
-var localStorage = require('../../constants/localStorage.cjs');
 require('../../constants/colors.cjs');
 require('../../constants/values.cjs');
 require('../../../shared/consts/index.cjs');
@@ -25,17 +27,13 @@ require('@dynamic-labs/multi-wallet');
 require('react-international-phone');
 require('../../../store/state/nonce/nonce.cjs');
 require('@dynamic-labs-wallet/browser-wallet-client');
-var embeddedWallets = require('../../../data/api/embeddedWallets/embeddedWallets.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');
-var dynamicEvents = require('../../../events/dynamicEvents.cjs');
+require('../../../events/dynamicEvents.cjs');
 var useOnboardingCompleteUser = require('../../../client/extension/user/useOnboardingCompleteUser/useOnboardingCompleteUser.cjs');
-var keyService = require('../../functions/keyService/keyService.cjs');
-var getTurnkeyWalletId = require('../../functions/getTurnkeyWalletId/getTurnkeyWalletId.cjs');
-var embeddedWalletSessionKeysUtils = require('../../functions/embeddedWalletSessionKeysUtils/embeddedWalletSessionKeysUtils.cjs');
 
 const useEmbeddedWalletSessionKeys = ({ environmentId, projectSettings, }) => {
     const user = useOnboardingCompleteUser.useOnboardingCompleteUserProfile();
@@ -45,111 +43,6 @@ const useEmbeddedWalletSessionKeys = ({ environmentId, projectSettings, }) => {
             ? JSON.parse(Buffer.from(sessionKeysSS, 'base64').toString())
             : undefined;
     }, []);
-    const registerHelper = React.useCallback((_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ walletId, environmentId, privateKey, privateKeyJwk, publicKey, prevSessionKeySignature, user, }) {
-        let resp;
-        const turnkeyWalletId = getTurnkeyWalletId.getTurnkeyWalletId(walletId, user.verifiedCredentials);
-        try {
-            resp = yield embeddedWallets.registerSessionKey({
-                environmentId,
-                prevSessionKeySignature,
-                publicKey,
-                walletId: turnkeyWalletId,
-            });
-        }
-        catch (error) {
-            if (error instanceof utils.InvalidEmbeddedWalletSessionKeyError) {
-                // this can happen if the public key passed during initial registration
-                // does not match the root session public key that the backend expects
-                walletConnectorCore.logger.warn('Invalid embedded wallet session key. Re-authentication is required to create new session keys.');
-                dynamicEvents.dynamicEvents.emit('triggerLogout', 'embedded-wallet-session-key-invalid');
-            }
-            walletConnectorCore.logger.error('Error registering session key', { error });
-            throw error;
-        }
-        const expirationDate = new Date(resp.expiresAt * 1000);
-        utils.tracing.logEvent('session-key', 'Created new session key', utils.tracing.formatObject({
-            expirationDate,
-            publicKey,
-        }));
-        utils.StorageService.setItem(localStorage.SECURE_ENCLAVE_WALLET_SESSION_KEYS, keyService.toEncodedFormat(publicKey, privateKey, privateKeyJwk, true, expirationDate), localStorage.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 = React.useCallback((_b) => _tslib.__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();
-        utils.tracing.logEvent('session-key', 'registerEmbeddedWalletSessionKey', utils.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.
-            walletConnectorCore.logger.error('Session keys not found in storage. Generating new session keys.', { userId: user === null || user === void 0 ? void 0 : user.userId });
-            existingSessionKey = yield embeddedWalletSessionKeysUtils.generateAndSaveSessionKey();
-        }
-        const isSessionKeyValid = existingSessionKey.registered &&
-            existingSessionKey.expirationDate &&
-            new Date() <= new Date(existingSessionKey.expirationDate) &&
-            !ignoreRestore;
-        utils.tracing.logEvent('session-key', 'isSessionKeyValid', utils.tracing.formatObject({
-            isSessionKeyValid: Boolean(isSessionKeyValid),
-        }));
-        if (isSessionKeyValid) {
-            // scenario 1 - session is valid and registered
-            return existingSessionKey;
-        }
-        utils.tracing.logEvent('session-key', 'decodedSessionKeys', utils.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 keyService.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 embeddedWalletSessionKeysUtils.generateSessionKey());
-            utils.tracing.logEvent('session-key', 'Loaded prevSessionKeySignature', utils.tracing.formatObject({ prevSessionKeySignature, publicKey }));
-        }
-        return registerHelper({
-            environmentId,
-            prevSessionKeySignature,
-            privateKey,
-            privateKeyJwk,
-            publicKey,
-            user,
-            walletId,
-        });
-    }), [environmentId, getDecodedSessionKeys, registerHelper, user]);
     const getSessionPublicKey = React.useCallback(() => {
         const decodedSessionKeys = getDecodedSessionKeys();
         if (!(decodedSessionKeys === null || decodedSessionKeys === void 0 ? void 0 : decodedSessionKeys.publicKey)) {
@@ -177,16 +70,10 @@ const useEmbeddedWalletSessionKeys = ({ environmentId, projectSettings, }) => {
         const signedSessionId = yield keyService.p256Sign(decodedSessionKeys.privateKeyJwk, sessionId);
         return signedSessionId;
     }), [getDecodedSessionKeys, user === null || user === void 0 ? void 0 : user.sessionId]);
-    const removeSessionKey = React.useCallback(() => {
-        utils.tracing.logEvent('session-key', 'removeSessionKey');
-        utils.StorageService.removeItem(localStorage.SECURE_ENCLAVE_WALLET_SESSION_KEYS, localStorage.SECURE_ENCLAVE_WALLET_SESSION_KEYS_STORAGE_OPTIONS);
-    }, []);
     return {
         generateSessionKey: embeddedWalletSessionKeysUtils.generateAndSaveSessionKey,
         getSessionPublicKey,
         getSignedSessionId,
-        registerEmbeddedWalletSessionKey,
-        removeSessionKey,
         shouldRegisterSessionKeysOnSignin,
     };
 };

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

@@ -7,14 +7,5 @@ export declare const useEmbeddedWalletSessionKeys: ({ environmentId, projectSett
     generateSessionKey: () => Promise<SessionKey>;
     getSessionPublicKey: () => string;
     getSignedSessionId: () => Promise<string>;
-    registerEmbeddedWalletSessionKey: ({ ignoreRestore, walletId, }: {
-        ignoreRestore?: boolean;
-        walletId: string;
-    }) => Promise<SessionKey | {
-        expirationDate: Date;
-        privateKey: string;
-        publicKey: string;
-    }>;
-    removeSessionKey: () => void;
     shouldRegisterSessionKeysOnSignin: () => true;
 };

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,14 +81,16 @@ 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');
 require('../useWalletBackup/cloudProviders.cjs');
+require('@hcaptcha/react-hcaptcha');
+require('@marsidev/react-turnstile');
 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/helpers/convertExchangeKeyAndProviderEnum.cjs');
 require('../../../views/ExchangeWhitelistWarning/ExchangeWhitelistWarning.cjs');
 require('../../../context/ErrorContext/hooks/useErrorText/useErrorText.cjs');