@dynamic-labs/sdk-react-core 1.1.0-alpha.7 → 1.1.0-alpha.9

package/src/lib/context/DynamicContext/DynamicContext.js

@@ -1,6 +1,6 @@
 import { __awaiter } from '../../../../_virtual/_tslib.js';
 import { jsx, jsxs } from 'react/jsx-runtime';
-import { createContext, useState, useEffect, useCallback, useRef, useMemo } from 'react';
+import { createContext, useState, useRef, useEffect, useCallback, useMemo } from 'react';
 import { I18nextProvider } from 'react-i18next';
 import { ICONIC_SPRITE_URL } from '@dynamic-labs/iconic';
 import { MissingEnvironmentIdError } from '@dynamic-labs/utils';
@@ -30,7 +30,6 @@ import { AccountExistsContextProvider } from '../AccountExistsContext/AccountExi
 import { revokeSession, sendDynamicProps } from '../../data/api.js';
 import { EmailVerificationContextProvider } from '../EmailVerificationContext/EmailVerificationContext.js';
 import 'react-dom';
-import { isSameWalletName } from '../../utils/functions/isSameWalletName/isSameWalletName.js';
 import { useFetchNonce } from '../../utils/hooks/useFetchNonce/useFetchNonce.js';
 import { useFetchProjectSettings } from '../../utils/hooks/useFetchProjectSettings/useFetchProjectSettings.js';
 import { ThemeContextProvider } from '../ThemeContext/ThemeContext.js';
@@ -68,10 +67,10 @@ import { useMultiWalletWidgetState } from '../../utils/hooks/multiWallet/useMult
 import { useMultiWallet } from '../../utils/hooks/multiWallet/useMultiWallet/useMultiWallet.js';
 import { useClearWalletConnectSessions } from '../../utils/hooks/useClearWalletConnectSessions/useClearWalletConnectSessions.js';
 import { useConnectWallet } from '../../utils/hooks/useConnectWallet/useConnectWallet.js';
-import { useProcessNetworkConfigurations } from '../../utils/hooks/useProcessNetworkConfigurations/useProcessNetworkConfigurations.js';
 import { useFetchWalletsForChainsMap } from '../../utils/hooks/useFetchWalletsForChainsMap/useFetchWalletsForChainsMap.js';
 import { useHandleUnlinkWallet } from '../../utils/hooks/useHandleUnlinkWallet/useHandleUnlinkWallet.js';
 import { usePrimaryWalletId } from '../../utils/hooks/usePrimaryWalletId/usePrimaryWalletId.js';
+import { useProcessNetworkConfigurations } from '../../utils/hooks/useProcessNetworkConfigurations/useProcessNetworkConfigurations.js';
 import { useRpcProviders } from '../../utils/hooks/useRpcProviders/useRpcProviders.js';
 import { useWalletEventListeners } from '../../utils/hooks/useWalletEventListeners/useWalletEventListeners.js';
 import { DynamicBridgeWidgetContextProvider } from '../../widgets/DynamicBridgeWidget/context/DynamicBridgeWidgetContext/DynamicBridgeWidgetContext.js';
@@ -90,23 +89,24 @@ import '../../widgets/DynamicWidget/views/ManagePasskeysWidgetView/PasskeyCard/P
 import '../../views/WalletList/WalletList.js';
 import '../../views/viewToComponentMap.js';
 import { FundingWidget } from '../../widgets/FundingWidget/FundingWidget.js';
+import { ConnectWithEmailOtpProvider } from '../ConnectWithEmailOtpContext/ConnectWithEmailOtpProvider.js';
+import '../ConnectWithEmailOtpContext/connectWithEmailOtpContext.js';
 import { FundingContextProvider } from '../FundingContext/FundingContext.js';
 import { SendBalanceContextProvider } from '../SendBalanceContext/SendBalanceContext.js';
 import { UseNetworkValidation } from '../UseNetworkValidation/UseNetworkValidation.js';
 import { UserWalletsProvider } from '../UserWalletsContext/UserWalletsContext.js';
 import { WalletContextProvider } from '../WalletContext/WalletContext.js';
-import { ConnectWithEmailOtpProvider } from '../ConnectWithEmailOtpContext/ConnectWithEmailOtpProvider.js';
-import '../ConnectWithEmailOtpContext/connectWithEmailOtpContext.js';
 import { handleDisconnectWallet } from './handleDisconnectWallet/handleDisconnectWallet.js';
 import { initExpirationTime, getInitialView } from './helpers.js';
 import { useDisplayOrderState } from './hooks/useDisplayOrderState/useDisplayOrderState.js';
 import { useEmailLoginState } from './hooks/useEmailLoginState/useEmailLoginState.js';
 import { useNameService } from './hooks/useNameService/useNameService.js';
 import { useSelectedWalletConnector } from './hooks/useSelectedWalletConnector/useSelectedWalletConnector.js';
-import { useSetShowAuthFlowWithInit } from './hooks/useSetShowAuthFlowWithInit/useSetShowAuthFlowWithInit.js';
+import { useShowAuthFlow } from './hooks/useShowAuthFlow/useShowAuthFlow.js';
 import { useShowPasskeyCreateSuccess } from './hooks/useShowPasskeyCreateSuccess/useShowPasskeyCreateSuccess.js';
 import { useTieCallbacksToEvents } from './hooks/useTieCallbacksToEvents/useTieCallbacksToEvents.js';
 import { useVerificationInProgress } from './hooks/useVerificationInProgress/useVerificationInProgress.js';
+import { useSetShowLinkNewWalletModal } from './hooks/useSetShowLinkNewWalletModal/useSetShowLinkNewWalletModal.js';
 import { useCustomerCallbacks } from './useCustomerCallbacks/useCustomerCallbacks.js';
 import { useCustomerAuthFlowCallbacks } from './useCustomerCallbacks/useCustomerAuthFlowCallbacks.js';
 import { validateAuthUser } from './validators.js';
@@ -116,7 +116,7 @@ const EMPTY_INITIAL_USER = undefined;
 const DynamicContext = createContext(undefined);
 /** The context provider itself we only use internally */
 const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _a, _b, _c, _d, _e, _f;
     const { accessDeniedMessagePrimary, accessDeniedMessageSecondary, accessDeniedButton, apiBaseUrl, enableForcedNetworkValidation: enableForcedNetworkValidationProp = false, deepLinkPreference = 'native', bridgeChains, cssOverrides, defaultNumberOfWalletsToShow = DEFAULT_NUMBER_OF_WALLETS_TO_SHOW, flowNetwork, initialAuthenticationMode = 'connect-and-sign', debugError = false, displaySiweStatement = true, newToWeb3WalletChainMap, enableVisitTrackingOnConnectOnly = true, environmentId, localStorageSuffix, eventsCallbacks, evmNetworks, walletsFilter, logLevel = 'WARN', notInTheListImageUrl, onboardingImageUrl, policiesConsentInnerComponent, customPrivacyPolicy, privacyPolicyUrl, signWithEmailWalletName, socialMediaLinkText, socialMediaIconUrl, socialMediaUrl, customTermsOfServices, termsOfServiceUrl, toolkitEnabled, siweStatement, shadowDOMEnabled = true, walletConnectors: walletConnectorsProp, socialProvidersFilter, showLockedWalletView = true, walletConnectPreferredChains, walletConnectorExtensions, } = settings;
     let enableForcedNetworkValidation = enableForcedNetworkValidationProp;
     if (bridgeChains) {
@@ -125,7 +125,8 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
     // Ties all client callbacks to dynamic's events, such that
     // when our events are triggered, so are the client callbacks
     useTieCallbacksToEvents(eventsCallbacks);
-    let { walletConnectV1Bridge, appLogoUrl = 'https://demo.dynamic.xyz/assets/dynamic-logo.svg', appName = 'Dynamic Example', } = settings;
+    let { appLogoUrl = 'https://demo.dynamic.xyz/assets/dynamic-logo.svg', appName = 'Dynamic Example', } = settings;
+    const { walletConnectV1Bridge } = settings;
     if (!environmentId) {
         throw new MissingEnvironmentIdError();
     }
@@ -140,7 +141,6 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
     const isAuthenticated = Boolean(getAuthToken());
     const isBridgeFlow = Boolean(bridgeChains);
     const [onboardingOnlyJwt, setOnboardingOnlyJwt] = useState(undefined);
-    const [showAuthFlow, setShowAuthFlow] = useState(false);
     // state to track the full connectivity status of the individual's wallets.
     // Set to true once the predetermined number of wallets is connected.
     const [isFullyConnected, setIsFullyConnected, removeIsFullyConnected] = useLocalStorage(IS_FULLY_CONNECTED, false);
@@ -160,15 +160,11 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
         dynamicContextProps: { settings },
         environmentId,
     });
-    const { multiWallet, setMultiWallet } = useMultiWallet(toolkitEnabled || false, (_b = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _b === void 0 ? void 0 : _b.multiWallet);
-    // for demo proposes when running single wallet
-    // it should not use bridge even having walletConnectV1Bridge set on settings
-    // but v2 if enabled
-    if (toolkitEnabled &&
-        ((_d = (_c = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _c === void 0 ? void 0 : _c.walletConnect) === null || _d === void 0 ? void 0 : _d.v2Enabled) &&
-        !multiWallet) {
-        walletConnectV1Bridge = undefined;
-    }
+    const { multiWallet, setMultiWallet } = useMultiWallet({
+        isBridgeFlow,
+        multiWalletSettings: (_b = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _b === void 0 ? void 0 : _b.multiWallet,
+        toolkitEnabled: toolkitEnabled || false,
+    });
     // ensures that when user comes back to site and primary wallet is out of sync, we don't show widget popup
     const [showWidgetStatePopup, setShowWidgetStatePopup] = useState(!multiWallet);
     // Used inside useVerifyOnAwaitingSignature. Is legacy and should be removed asap
@@ -208,6 +204,14 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
     });
     const [authMode, setAuthMode] = useLocalStorage(AUTH_MODE, initialAuthenticationMode);
     const { clearPrimaryWalletId, primaryWalletId, setPrimaryWalletId } = usePrimaryWalletId();
+    const isUserAuthenticated = Boolean(authMode === 'connect-and-sign' ? user : isFullyConnected);
+    const isRenderingEmbeddedAuthFlow = useRef(false);
+    const [showAuthFlow, setShowAuthFlow] = useShowAuthFlow({
+        isAuthenticated: isUserAuthenticated,
+        isMultiWalletEnabled: multiWallet,
+        isRenderingEmbeddedAuthFlow,
+        walletConnectorOptions,
+    });
     const { connectWallet, removeConnectedWalletsInfo, connectedWalletsInfo, getConnectedWalletById, connectedWallets, disconnectWallet, refreshConnectedWallet, } = useConnectWallet({
         authMode,
         clearPrimaryWalletId,
@@ -239,12 +243,12 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
         removeUser();
     }, [removeUser]);
     // until user completes onboarding, jwt is only stored in onboardingOnlyJwt
-    const authToken = (_e = getAuthToken()) !== null && _e !== void 0 ? _e : onboardingOnlyJwt;
+    const authToken = (_c = getAuthToken()) !== null && _c !== void 0 ? _c : onboardingOnlyJwt;
     useSetWalletConnectorVerifiedCredentials(authToken, walletConnectorOptions);
     const { didConnectedStateLoad, primaryWallet, showQrcodeModal, secondaryWallets, setPrimaryWallet, setShowQrcodeModal, wallets: linkedOrConnectedWallets, } = useWalletConnectors({
         authMode,
         authToken: getAuthToken() || onboardingOnlyJwt,
-        canHaveMultipleWalletsConnected: multiWallet || isBridgeFlow,
+        canHaveMultipleWalletsConnected: multiWallet,
         connectedWallets,
         multiWalletWidgetState,
         onboardingOnlyJwt,
@@ -266,13 +270,10 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
         user,
         walletBook,
     });
-    const isRenderingEmbeddedAuthFlow = useRef(false);
-    const setShowAuthFlowWithInit = useSetShowAuthFlowWithInit({
+    const setShowLinkNewWalletModal = useSetShowLinkNewWalletModal({
+        isAuthenticated: isUserAuthenticated,
         isMultiWalletEnabled: multiWallet,
-        isRenderingEmbeddedAuthFlow,
         setShowAuthFlow,
-        user,
-        walletConnectorOptions,
     });
     const { getNameService, removeConnectedNameService } = useNameService({
         authToken,
@@ -285,7 +286,7 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
         clearOphanedWalletConnectSessions,
     ]);
     const handleLogOut = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
-        var _j, _k;
+        var _g, _h;
         setSdkHasLoaded(false);
         clearAllWalletConnectSessions();
         setBridgeChainsToConnect(bridgeChains);
@@ -311,7 +312,12 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
             setIsVerificationInProgress(false);
         setLegacyIsVerifying(false);
         setAuthMode(initialAuthenticationMode);
-        setShowAuthFlow(false);
+        setShowAuthFlow(false, {
+            emitCancelAuth: false,
+            ignoreIfIsEmbeddedWidget: false,
+            initializeWalletConnect: false,
+            performMultiWalletChecks: false,
+        });
         setMultiWalletWidgetState('idle');
         removeAuthTokenAndUser();
         removeLsSettings();
@@ -322,12 +328,12 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
         clearPrimaryWalletId();
         removeConnectedNameService();
         for (const connectedWallet of connectedWallets) {
-            (_j = eventsCallbacks === null || eventsCallbacks === void 0 ? void 0 : eventsCallbacks.onDisconnect) === null || _j === void 0 ? void 0 : _j.call(eventsCallbacks, {
+            (_g = eventsCallbacks === null || eventsCallbacks === void 0 ? void 0 : eventsCallbacks.onDisconnect) === null || _g === void 0 ? void 0 : _g.call(eventsCallbacks, {
                 wallet: connectedWallet,
                 walletConnector: connectedWallet === null || connectedWallet === void 0 ? void 0 : connectedWallet.connector,
             });
         }
-        (_k = eventsCallbacks === null || eventsCallbacks === void 0 ? void 0 : eventsCallbacks.onLogout) === null || _k === void 0 ? void 0 : _k.call(eventsCallbacks, user);
+        (_h = eventsCallbacks === null || eventsCallbacks === void 0 ? void 0 : eventsCallbacks.onLogout) === null || _h === void 0 ? void 0 : _h.call(eventsCallbacks, user);
         dynamicEvents.emit('logout');
     }), [
         setSdkHasLoaded,
@@ -339,6 +345,7 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
         setIsVerificationInProgress,
         setAuthMode,
         initialAuthenticationMode,
+        setShowAuthFlow,
         setMultiWalletWidgetState,
         removeAuthTokenAndUser,
         removeLsSettings,
@@ -356,7 +363,7 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
     let wcVersion;
     if (projectSettings) {
         wcVersion =
-            ((_g = (_f = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _f === void 0 ? void 0 : _f.walletConnect) === null || _g === void 0 ? void 0 : _g.v2Enabled) && !walletConnectV1Bridge
+            ((_e = (_d = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _d === void 0 ? void 0 : _d.walletConnect) === null || _e === void 0 ? void 0 : _e.v2Enabled) && !walletConnectV1Bridge
                 ? 2
                 : 1;
     }
@@ -444,7 +451,7 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
         }
         if (selectedWalletConnector &&
             (!primaryWallet ||
-                !isSameWalletName(primaryWallet.connector.name, selectedWalletConnector.name))) {
+                primaryWallet.connector.key !== selectedWalletConnector.key)) {
             yield (selectedWalletConnector === null || selectedWalletConnector === void 0 ? void 0 : selectedWalletConnector.endSession());
         }
     }), [
@@ -495,7 +502,6 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
             handleLogOut,
             handleUnlinkWallet: authMode === 'connect-only' ? disconnectWallet : handleUnlinkWallet,
             i18nSDKInstance,
-            internalSetShowAuthFlow: setShowAuthFlow,
             isAuthenticated,
             isBridgeFlow,
             isFullyConnected,
@@ -551,9 +557,10 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
             setSdkHasLoaded,
             setSelectedWalletConnectorKey,
             setSelectedWalletWithAction,
-            setShowAuthFlow: setShowAuthFlowWithInit,
+            setShowAuthFlow,
             setShowBridgeWidget,
             setShowDynamicUserProfile,
+            setShowLinkNewWalletModal,
             setShowPasskeyCreatedSuccess,
             setShowQrcodeModal,
             setShowWidgetStatePopup,
@@ -659,7 +666,8 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
         setPrimaryWalletId,
         setSdkHasLoaded,
         setSelectedWalletConnectorKey,
-        setShowAuthFlowWithInit,
+        setShowAuthFlow,
+        setShowLinkNewWalletModal,
         setShowPasskeyCreatedSuccess,
         setShowQrcodeModal,
         setUser,
@@ -720,7 +728,7 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
             setShowDynamicUserProfile(true);
         }
     }, [multiWallet, multiWalletWidgetState, showDynamicUserProfile, user]);
-    return (jsx(I18nextProvider, { i18n: i18nSDKInstance, children: jsx(DynamicContext.Provider, { value: value, children: jsx(WalletBookContextProvider, { walletBook: walletBook, children: jsx(ThemeContextProvider, { customerTheme: parseTheme(theme, ((_h = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.design) === null || _h === void 0 ? void 0 : _h.modal) || undefined), designSettings: projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.design, children: jsx(LoadingContextProvider, { children: jsx(ErrorContextProvider, { children: jsxs(ViewContextProvider, { initialView: getInitialView({
+    return (jsx(I18nextProvider, { i18n: i18nSDKInstance, children: jsx(DynamicContext.Provider, { value: value, children: jsx(WalletBookContextProvider, { walletBook: walletBook, children: jsx(ThemeContextProvider, { customerTheme: parseTheme(theme, ((_f = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.design) === null || _f === void 0 ? void 0 : _f.modal) || undefined), designSettings: projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.design, children: jsx(LoadingContextProvider, { children: jsx(ErrorContextProvider, { children: jsxs(ViewContextProvider, { initialView: getInitialView({
                                     connectedWallets,
                                     isAuthenticated,
                                     isBridgeFlow,

package/src/lib/context/DynamicContext/hooks/index.d.ts

@@ -2,7 +2,7 @@ export * from './useDisplayOrderState';
 export * from './useEmailLoginState';
 export * from './useNameService';
 export * from './useSelectedWalletConnector';
-export * from './useSetShowAuthFlowWithInit';
+export * from './useShowAuthFlow';
 export * from './useShowPasskeyCreateSuccess';
 export * from './useTieCallbacksToEvents';
 export * from './useVerificationInProgress';

package/src/lib/context/DynamicContext/hooks/useSetShowLinkNewWalletModal/index.d.ts

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

package/src/lib/context/DynamicContext/hooks/useSetShowLinkNewWalletModal/useSetShowLinkNewWalletModal.cjs

@@ -0,0 +1,48 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var React = require('react');
+require('@dynamic-labs/sdk-api');
+var logger = require('../../../../shared/logger.cjs');
+require('@dynamic-labs/iconic');
+require('@dynamic-labs/wallet-connector-core');
+require('react/jsx-runtime');
+require('../../../ViewContext/ViewContext.cjs');
+require('@dynamic-labs/wallet-book');
+require('../../../../utils/constants/colors.cjs');
+require('../../../../shared/utils/classes/storage/localStorage.cjs');
+require('viem');
+require('@dynamic-labs/utils');
+require('../../../../shared/consts/index.cjs');
+
+/**
+ * this hook wraps `setShowAuthFlow`. WalletConnect requires initialization
+ * before we can connect a wallet. The goal here is that when a user clicks
+ * on the "Connect your wallet" button, the SDK starts initializing WalletConnect
+ * and will prime it for connection. This way, when the user clicks on the
+ * "Connect" button in the WalletConnect modal, there is a uri ready to go
+ * to immediately trigger the deep link on mobile
+ */
+const useSetShowLinkNewWalletModal = ({ setShowAuthFlow, isMultiWalletEnabled, isAuthenticated, }) => {
+    const setSetShowLinkNewWalletModalWithInit = React.useCallback((value) => {
+        if (value) {
+            // Do not change state if the user is already signed in and multi-wallet is not enabled
+            if (!isAuthenticated)
+                return;
+            if (!isMultiWalletEnabled) {
+                logger.logger.warn('setShowLinkNewWalletModal was called while the user was not logged in. This results in a no-op. To log the user in, use setShowAuthFlow. For more information, see: https://docs.dynamic.xyz/react-sdk/hooks/usedynamiccontext');
+                return;
+            }
+        }
+        setShowAuthFlow(value, {
+            emitCancelAuth: true,
+            ignoreIfIsEmbeddedWidget: true,
+            initializeWalletConnect: true,
+            performMultiWalletChecks: false,
+        });
+    }, [setShowAuthFlow, isAuthenticated, isMultiWalletEnabled]);
+    return setSetShowLinkNewWalletModalWithInit;
+};
+
+exports.useSetShowLinkNewWalletModal = useSetShowLinkNewWalletModal;

package/src/lib/context/DynamicContext/hooks/{useSetShowAuthFlowWithInit/useSetShowAuthFlowWithInit.d.ts → useSetShowLinkNewWalletModal/useSetShowLinkNewWalletModal.d.ts}

@@ -1,6 +1,5 @@
 import { Dispatch, SetStateAction } from 'react';
-import { UserProfile, WalletOption } from '../../../../shared';
-import { IDynamicContext } from '../../types';
+import { SetShowAuthFlow } from '../useShowAuthFlow';
 /**
  * this hook wraps `setShowAuthFlow`. WalletConnect requires initialization
  * before we can connect a wallet. The goal here is that when a user clicks
@@ -9,10 +8,8 @@ import { IDynamicContext } from '../../types';
  * "Connect" button in the WalletConnect modal, there is a uri ready to go
  * to immediately trigger the deep link on mobile
  */
-export declare const useSetShowAuthFlowWithInit: ({ setShowAuthFlow, walletConnectorOptions, user, isMultiWalletEnabled, isRenderingEmbeddedAuthFlow, }: {
-    setShowAuthFlow: Dispatch<SetStateAction<boolean>>;
-    isRenderingEmbeddedAuthFlow: IDynamicContext['isRenderingEmbeddedAuthFlow'];
-    walletConnectorOptions: WalletOption[];
-    user?: UserProfile | undefined;
+export declare const useSetShowLinkNewWalletModal: ({ setShowAuthFlow, isMultiWalletEnabled, isAuthenticated, }: {
+    setShowAuthFlow: SetShowAuthFlow;
     isMultiWalletEnabled?: boolean | undefined;
+    isAuthenticated: boolean;
 }) => Dispatch<SetStateAction<boolean>>;

package/src/lib/context/DynamicContext/hooks/useSetShowLinkNewWalletModal/useSetShowLinkNewWalletModal.js

@@ -0,0 +1,44 @@
+import { useCallback } from 'react';
+import '@dynamic-labs/sdk-api';
+import { logger } from '../../../../shared/logger.js';
+import '@dynamic-labs/iconic';
+import '@dynamic-labs/wallet-connector-core';
+import 'react/jsx-runtime';
+import '../../../ViewContext/ViewContext.js';
+import '@dynamic-labs/wallet-book';
+import '../../../../utils/constants/colors.js';
+import '../../../../shared/utils/classes/storage/localStorage.js';
+import 'viem';
+import '@dynamic-labs/utils';
+import '../../../../shared/consts/index.js';
+
+/**
+ * this hook wraps `setShowAuthFlow`. WalletConnect requires initialization
+ * before we can connect a wallet. The goal here is that when a user clicks
+ * on the "Connect your wallet" button, the SDK starts initializing WalletConnect
+ * and will prime it for connection. This way, when the user clicks on the
+ * "Connect" button in the WalletConnect modal, there is a uri ready to go
+ * to immediately trigger the deep link on mobile
+ */
+const useSetShowLinkNewWalletModal = ({ setShowAuthFlow, isMultiWalletEnabled, isAuthenticated, }) => {
+    const setSetShowLinkNewWalletModalWithInit = useCallback((value) => {
+        if (value) {
+            // Do not change state if the user is already signed in and multi-wallet is not enabled
+            if (!isAuthenticated)
+                return;
+            if (!isMultiWalletEnabled) {
+                logger.warn('setShowLinkNewWalletModal was called while the user was not logged in. This results in a no-op. To log the user in, use setShowAuthFlow. For more information, see: https://docs.dynamic.xyz/react-sdk/hooks/usedynamiccontext');
+                return;
+            }
+        }
+        setShowAuthFlow(value, {
+            emitCancelAuth: true,
+            ignoreIfIsEmbeddedWidget: true,
+            initializeWalletConnect: true,
+            performMultiWalletChecks: false,
+        });
+    }, [setShowAuthFlow, isAuthenticated, isMultiWalletEnabled]);
+    return setSetShowLinkNewWalletModalWithInit;
+};
+
+export { useSetShowLinkNewWalletModal };

package/src/lib/context/DynamicContext/hooks/useShowAuthFlow/index.d.ts

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

package/src/lib/context/DynamicContext/hooks/useShowAuthFlow/useShowAuthFlow.cjs

@@ -0,0 +1,59 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var React = require('react');
+var dynamicEvents = require('../../../../events/dynamicEvents.cjs');
+require('@dynamic-labs/sdk-api');
+var logger = require('../../../../shared/logger.cjs');
+require('@dynamic-labs/iconic');
+require('@dynamic-labs/wallet-connector-core');
+require('react/jsx-runtime');
+require('../../../ViewContext/ViewContext.cjs');
+require('@dynamic-labs/wallet-book');
+require('../../../../utils/constants/colors.cjs');
+require('../../../../shared/utils/classes/storage/localStorage.cjs');
+require('viem');
+require('@dynamic-labs/utils');
+require('../../../../shared/consts/index.cjs');
+
+/**
+ * There are a multitude of scenarios where we want to ignore or insert functionality to calls
+ * to setShowAuthFlow. This hook wraps it with an options parameter to allow encapsulating these
+ * different scenarios and makes it especially easy to customize exactly which version of this method
+ * is being passed to useDynamicContext.
+ */
+const useShowAuthFlow = ({ isAuthenticated, isRenderingEmbeddedAuthFlow, isMultiWalletEnabled, walletConnectorOptions, }) => {
+    const [showAuthFlow, _setShowAuthFlow] = React.useState(false);
+    const setShowAuthFlow = React.useCallback((value, options = {}) => {
+        var _a;
+        const { emitCancelAuth, ignoreIfIsEmbeddedWidget, initializeWalletConnect, performMultiWalletChecks, } = Object.assign({ emitCancelAuth: false, ignoreIfIsEmbeddedWidget: true, initializeWalletConnect: true, performMultiWalletChecks: false }, options);
+        if (value) {
+            if (ignoreIfIsEmbeddedWidget && isRenderingEmbeddedAuthFlow.current)
+                return;
+            if (performMultiWalletChecks && isAuthenticated) {
+                if (!isMultiWalletEnabled) {
+                    logger.logger.warn('setShowAuthFlow was called while the user is logged in, but Dynamic is not configured with multi-wallet enabled. This results in a no-op.');
+                    return;
+                }
+                logger.logger.warn('Using setShowAuthFlow to render the wallet list when the user is logged in is deprecated. Use setShowLinkNewWalletModal instead. For more information, see: https://docs.dynamic.xyz/react-sdk/hooks/usedynamiccontext');
+            }
+            if (initializeWalletConnect) {
+                (_a = walletConnectorOptions
+                    .find((wallet) => wallet.walletConnector.key === 'walletconnect')) === null || _a === void 0 ? void 0 : _a.walletConnector.init();
+            }
+        }
+        else if (emitCancelAuth && showAuthFlow)
+            dynamicEvents.dynamicEvents.emit('authFlowCancelled');
+        _setShowAuthFlow(value);
+    }, [
+        isAuthenticated,
+        isMultiWalletEnabled,
+        isRenderingEmbeddedAuthFlow,
+        showAuthFlow,
+        walletConnectorOptions,
+    ]);
+    return [showAuthFlow, setShowAuthFlow];
+};
+
+exports.useShowAuthFlow = useShowAuthFlow;

package/src/lib/context/DynamicContext/hooks/useShowAuthFlow/useShowAuthFlow.d.ts

@@ -0,0 +1,37 @@
+import { SetStateAction } from 'react';
+import { WalletOption } from '../../../../shared';
+import { IDynamicContext } from '../../types';
+export type SetShowAuthFlowOptions = {
+    /**
+     * WalletConnect requires initialization before we can connect a wallet.
+     * The goal here is that when the auth flow opens, the
+     * SDK starts initializing WalletConnect and will prime it for connection.
+     * This way, when the user clicks on the "Connect" button in the WalletConnect modal,
+     * there is a uri ready to go to immediately trigger the deep link on mobile
+     */
+    initializeWalletConnect?: boolean;
+    /** Makes this call be ignored if setting to true when there is an embedded widget on screen  */
+    ignoreIfIsEmbeddedWidget?: boolean;
+    /**
+     * When setting to true while logged in:
+     *   1. If multi wallet is false, ignores the call — handy to prevent users from
+     *   getting to the link new wallet screen without multi wallet
+     *   2. If multi wallet is true, logs a warning to use setShowLinkNewWalletModal instead
+     */
+    performMultiWalletChecks?: boolean;
+    /** When setting to false, emits authFlowCancelled event and callback */
+    emitCancelAuth?: boolean;
+};
+export type SetShowAuthFlow = (value: SetStateAction<boolean>, options?: SetShowAuthFlowOptions) => void;
+/**
+ * There are a multitude of scenarios where we want to ignore or insert functionality to calls
+ * to setShowAuthFlow. This hook wraps it with an options parameter to allow encapsulating these
+ * different scenarios and makes it especially easy to customize exactly which version of this method
+ * is being passed to useDynamicContext.
+ */
+export declare const useShowAuthFlow: ({ isAuthenticated, isRenderingEmbeddedAuthFlow, isMultiWalletEnabled, walletConnectorOptions, }: {
+    isMultiWalletEnabled: boolean;
+    isRenderingEmbeddedAuthFlow: IDynamicContext['isRenderingEmbeddedAuthFlow'];
+    walletConnectorOptions: WalletOption[];
+    isAuthenticated: boolean;
+}) => [boolean, SetShowAuthFlow];

package/src/lib/context/DynamicContext/hooks/useShowAuthFlow/useShowAuthFlow.js

@@ -0,0 +1,55 @@
+import { useState, useCallback } from 'react';
+import { dynamicEvents } from '../../../../events/dynamicEvents.js';
+import '@dynamic-labs/sdk-api';
+import { logger } from '../../../../shared/logger.js';
+import '@dynamic-labs/iconic';
+import '@dynamic-labs/wallet-connector-core';
+import 'react/jsx-runtime';
+import '../../../ViewContext/ViewContext.js';
+import '@dynamic-labs/wallet-book';
+import '../../../../utils/constants/colors.js';
+import '../../../../shared/utils/classes/storage/localStorage.js';
+import 'viem';
+import '@dynamic-labs/utils';
+import '../../../../shared/consts/index.js';
+
+/**
+ * There are a multitude of scenarios where we want to ignore or insert functionality to calls
+ * to setShowAuthFlow. This hook wraps it with an options parameter to allow encapsulating these
+ * different scenarios and makes it especially easy to customize exactly which version of this method
+ * is being passed to useDynamicContext.
+ */
+const useShowAuthFlow = ({ isAuthenticated, isRenderingEmbeddedAuthFlow, isMultiWalletEnabled, walletConnectorOptions, }) => {
+    const [showAuthFlow, _setShowAuthFlow] = useState(false);
+    const setShowAuthFlow = useCallback((value, options = {}) => {
+        var _a;
+        const { emitCancelAuth, ignoreIfIsEmbeddedWidget, initializeWalletConnect, performMultiWalletChecks, } = Object.assign({ emitCancelAuth: false, ignoreIfIsEmbeddedWidget: true, initializeWalletConnect: true, performMultiWalletChecks: false }, options);
+        if (value) {
+            if (ignoreIfIsEmbeddedWidget && isRenderingEmbeddedAuthFlow.current)
+                return;
+            if (performMultiWalletChecks && isAuthenticated) {
+                if (!isMultiWalletEnabled) {
+                    logger.warn('setShowAuthFlow was called while the user is logged in, but Dynamic is not configured with multi-wallet enabled. This results in a no-op.');
+                    return;
+                }
+                logger.warn('Using setShowAuthFlow to render the wallet list when the user is logged in is deprecated. Use setShowLinkNewWalletModal instead. For more information, see: https://docs.dynamic.xyz/react-sdk/hooks/usedynamiccontext');
+            }
+            if (initializeWalletConnect) {
+                (_a = walletConnectorOptions
+                    .find((wallet) => wallet.walletConnector.key === 'walletconnect')) === null || _a === void 0 ? void 0 : _a.walletConnector.init();
+            }
+        }
+        else if (emitCancelAuth && showAuthFlow)
+            dynamicEvents.emit('authFlowCancelled');
+        _setShowAuthFlow(value);
+    }, [
+        isAuthenticated,
+        isMultiWalletEnabled,
+        isRenderingEmbeddedAuthFlow,
+        showAuthFlow,
+        walletConnectorOptions,
+    ]);
+    return [showAuthFlow, setShowAuthFlow];
+};
+
+export { useShowAuthFlow };

package/src/lib/context/DynamicContext/hooks/useTieCallbacksToEvents/useTieCallbacksToEvents.cjs

@@ -70,6 +70,7 @@ const useTieCallbacksToEvents = (clientCallbacks) => {
         else
             (_b = clientCallbacks === null || clientCallbacks === void 0 ? void 0 : clientCallbacks.onEmailVerificationFailure) === null || _b === void 0 ? void 0 : _b.call(clientCallbacks, email);
     });
+    useDynamicEvents.useInternalDynamicEvents('authFlowCancelled', () => { var _a; return (_a = clientCallbacks === null || clientCallbacks === void 0 ? void 0 : clientCallbacks.onAuthFlowCancel) === null || _a === void 0 ? void 0 : _a.call(clientCallbacks); });
 };
 
 exports.useTieCallbacksToEvents = useTieCallbacksToEvents;

package/src/lib/context/DynamicContext/hooks/useTieCallbacksToEvents/useTieCallbacksToEvents.js

@@ -66,6 +66,7 @@ const useTieCallbacksToEvents = (clientCallbacks) => {
         else
             (_b = clientCallbacks === null || clientCallbacks === void 0 ? void 0 : clientCallbacks.onEmailVerificationFailure) === null || _b === void 0 ? void 0 : _b.call(clientCallbacks, email);
     });
+    useInternalDynamicEvents('authFlowCancelled', () => { var _a; return (_a = clientCallbacks === null || clientCallbacks === void 0 ? void 0 : clientCallbacks.onAuthFlowCancel) === null || _a === void 0 ? void 0 : _a.call(clientCallbacks); });
 };
 
 export { useTieCallbacksToEvents };

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

@@ -6,7 +6,7 @@ import { AccessDeniedCustomButton, AccountSwitchState, AuthModeType, AwaitingSig
 import { SocialNetworkIconType } from '../../../utils/functions/getSocialNetworkIcon';
 import { MultiWalletWidgetStateSetter } from '../../../utils/hooks/multiWallet';
 import { ThemeData, ThemeSetting } from '../../ThemeContext';
-import { DisplayOrder, SetDisplayOrderPriority } from '../hooks';
+import { DisplayOrder, SetDisplayOrderPriority, SetShowAuthFlow } from '../hooks';
 import { SetCallbackType } from '../useCustomerCallbacks';
 export type ChainsToConnect = {
     chain: Chain;
@@ -101,9 +101,8 @@ export interface IDynamicContext {
     setQrcodeUri: Dispatch<SetStateAction<string>>;
     setSelectedWalletConnectorKey: (key: string | null) => void;
     setSelectedWalletWithAction: (walletWithAction: WalletWithAction | null) => void;
-    setShowAuthFlow: Dispatch<SetStateAction<boolean>>;
-    /** The unwrapped version of setShowAuthFlow. See useSetShowAuthFlowWithInit.ts for context */
-    internalSetShowAuthFlow: Dispatch<SetStateAction<boolean>>;
+    setShowAuthFlow: SetShowAuthFlow;
+    setShowLinkNewWalletModal: Dispatch<SetStateAction<boolean>>;
     setShowDynamicUserProfile: Dispatch<SetStateAction<boolean>>;
     setShowPasskeyCreatedSuccess: VoidFunction;
     setShowQrcodeModal: Dispatch<SetStateAction<boolean>>;
@@ -140,18 +139,23 @@ export interface IDynamicContext {
     walletConnectorOptions: WalletOption[];
     walletsFilter?: (options: WalletOption[]) => WalletOption[];
     removeConnectedWalletsInfo: () => void;
-    /** Whether any verifications are ongoing for the current user (ex. connect, sign and email login verifications) */
+    /** Whether any verifications are ongoing for the current user (ex. connect, sign and email login verifications
+     * @deprecated Listen to our callbacks instead: https://docs.dynamic.xyz/react-sdk/callbacks/callbacks-introduction
+     */
     isVerificationInProgress: boolean;
     /** State setter for isVerificationInProgress
      * @param checkWasSetOnDisable when true, if newValue is false, logs a message if the flag wasn't set to true before
+     * @deprecated This will be dropped in v2
      */
     setIsVerificationInProgress: (newValue: boolean, checkWasSetOnDisable?: boolean) => void;
     /** Legacy boolean flag used in useVerifyOnAwaitingSignature. Used to be called "isVerifying".
      * Was meant to prevent an effect from accidentally triggering again when it shouldn't.
-     * Should be removed asap.
+     * @deprecated Should be removed asap.
      */
     legacyIsVerifying: boolean;
-    /** Legacy setter for legacyIsVerifying */
+    /** Legacy setter for legacyIsVerifying
+     * @deprecated Should be removed asap.
+     */
     setLegacyIsVerifying: Dispatch<SetStateAction<boolean>>;
     /** Whether there is an instance of DynamicEmbeddedAuthFlow being rendered */
     isRenderingEmbeddedAuthFlow: MutableRefObject<boolean>;

package/src/lib/context/DynamicContext/useDynamicContext.cjs

@@ -11,7 +11,7 @@ const useDynamicContext = () => {
     if (context === undefined) {
         throw new Error('useDynamicContext must be used within a DynamicContextProvider');
     }
-    const { accountSwitchState, authMode, authToken, awaitingSignatureState, getNameService, handleLogOut, handleUnlinkWallet, isAuthenticated, isFullyConnected, isVerificationInProgress, loadingNetwork, locale, loginWithEmail, multiWalletWidgetState, network, networkConfigurations, qrcodeUri, rpcProviders, sdkHasLoaded, setLogInWithEmail, setMultiWalletWidgetState, setNetwork, setPrimaryWallet, setShowAuthFlow, setShowDynamicUserProfile, setShowQrcodeModal, shadowDOMEnabled, showAuthFlow, showQrcodeModal, user, walletConnector, walletConnectorOptions, bridgeChains, bridgeChainsToConnect, primaryWallet, setShowBridgeWidget, sendWagmiSettings, showDynamicUserProfile, } = context;
+    const { accountSwitchState, authMode, authToken, awaitingSignatureState, getNameService, handleLogOut, handleUnlinkWallet, isAuthenticated, isFullyConnected, isVerificationInProgress, loadingNetwork, locale, loginWithEmail, multiWalletWidgetState, network, networkConfigurations, qrcodeUri, rpcProviders, sdkHasLoaded, setLogInWithEmail, setMultiWalletWidgetState, setNetwork, setPrimaryWallet, setShowAuthFlow, setShowDynamicUserProfile, setShowQrcodeModal, shadowDOMEnabled, showAuthFlow, showQrcodeModal, user, walletConnector, walletConnectorOptions, bridgeChains, bridgeChainsToConnect, primaryWallet, setShowBridgeWidget, sendWagmiSettings, showDynamicUserProfile, setShowLinkNewWalletModal, } = context;
     return {
         accountSwitchState,
         authMode,
@@ -40,9 +40,15 @@ const useDynamicContext = () => {
         setMultiWalletWidgetState,
         setNetwork,
         setPrimaryWallet,
-        setShowAuthFlow,
+        setShowAuthFlow: (value) => setShowAuthFlow(value, {
+            emitCancelAuth: true,
+            ignoreIfIsEmbeddedWidget: true,
+            initializeWalletConnect: true,
+            performMultiWalletChecks: true,
+        }),
         setShowBridgeWidget,
         setShowDynamicUserProfile,
+        setShowLinkNewWalletModal,
         setShowQrcodeModal,
         shadowDOMEnabled,
         showAuthFlow,