@dynamic-labs/sdk-react-core 1.1.0-alpha.0 → 1.1.0-alpha.10

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

@@ -1,12 +1,14 @@
 import { __awaiter } from '../../../../_virtual/_tslib.js';
 import { jsx, jsxs } from 'react/jsx-runtime';
-import { createContext, useRef, useState, useEffect, useCallback, 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';
 import { useWalletBookCdn, getWalletBookCdnUrl, WalletBookContextProvider } from '@dynamic-labs/wallet-book';
 import { logger as logger$1 } from '@dynamic-labs/wallet-connector-core';
 import { DynamicAuthFlow } from '../../app.js';
+import { dynamicEvents } from '../../events/dynamicEvents.js';
+import { useEventListener } from '../../utils/hooks/events/useEventListener/useEventListener.js';
 import { CaptchaContextProvider } from '../CaptchaContext/CaptchaContext.js';
 import { ErrorContextProvider } from '../ErrorContext/ErrorContext.js';
 import { ViewContextProvider } from '../ViewContext/ViewContext.js';
@@ -28,8 +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 { useEventListener } from '../../utils/hooks/useEventListener/useEventListener.js';
 import { useFetchNonce } from '../../utils/hooks/useFetchNonce/useFetchNonce.js';
 import { useFetchProjectSettings } from '../../utils/hooks/useFetchProjectSettings/useFetchProjectSettings.js';
 import { ThemeContextProvider } from '../ThemeContext/ThemeContext.js';
@@ -67,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 { useFetchNetworkConfigurations } from '../../utils/hooks/useFetchNetworkConfigurations/useFetchNetworkConfigurations.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';
@@ -82,13 +82,15 @@ import '../SocialRedirectContext/SocialRedirectContext.js';
 import { QrCodeContextProvider } from '../QrCodeContext/QrCodeContext.js';
 import { WalletGroupContextProvider } from '../WalletGroupContext/WalletGroupContext.js';
 import '../../widgets/DynamicWidget/components/DynamicWidgetHeader/DynamicWidgetHeader.js';
-import 'qrcode';
 import { LoadingContextProvider } from '../LoadingContext/LoadingContext.js';
+import 'qrcode';
 import '@dynamic-labs/viem-utils';
 import '../../widgets/DynamicWidget/views/ManagePasskeysWidgetView/PasskeyCard/PasskeyCard.js';
 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';
@@ -100,10 +102,11 @@ import { useDisplayOrderState } from './hooks/useDisplayOrderState/useDisplayOrd
 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 { useVerificationInProgress } from './hooks/useVerificationInProgress/useVerificationInProgress.js';
+import { useShowAuthFlow } from './hooks/useShowAuthFlow/useShowAuthFlow.js';
 import { useShowPasskeyCreateSuccess } from './hooks/useShowPasskeyCreateSuccess/useShowPasskeyCreateSuccess.js';
-import { getInternalEvents } from './internalEvents/internalEvents.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';
@@ -113,15 +116,17 @@ 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) {
         enableForcedNetworkValidation = true;
     }
-    // The internalEventsRef is temporary and should be removed after QNTM-180 is done
-    const internalEventsRef = useRef(getInternalEvents());
-    let { walletConnectV1Bridge, appLogoUrl = 'https://demo.dynamic.xyz/assets/dynamic-logo.svg', appName = 'Dynamic Example', } = settings;
+    // Ties all client callbacks to dynamic's events, such that
+    // when our events are triggered, so are the client callbacks
+    useTieCallbacksToEvents(eventsCallbacks);
+    let { appLogoUrl = 'https://demo.dynamic.xyz/assets/dynamic-logo.svg', appName = 'Dynamic Example', } = settings;
+    const { walletConnectV1Bridge } = settings;
     if (!environmentId) {
         throw new MissingEnvironmentIdError();
     }
@@ -136,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);
@@ -156,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
@@ -172,10 +172,11 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
     // Set to true when a customer starts any auth verification process and set to false when it ends
     const [isVerificationInProgress, setIsVerificationInProgress] = useVerificationInProgress();
     const walletBook = useWalletBookCdn();
-    const { configurations: serverNetworkConfigurations, handleRemoveLsNetworks, } = useFetchNetworkConfigurations({
+    const { configurations: serverNetworkConfigurations, handleRemoveLsNetworks, } = useProcessNetworkConfigurations({
         authToken: getAuthToken(),
         environmentId,
         evmNetworks,
+        projectSettings,
     });
     const { imageUserInAccessList, imageUserNotInAccessList, displayName, appLogo, } = (projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.general) || {};
     appLogoUrl = appLogo || appLogoUrl;
@@ -203,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,
@@ -234,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,
@@ -261,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,
@@ -280,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);
@@ -306,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();
@@ -317,13 +328,13 @@ 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);
-        internalEventsRef.current.emit('logout');
+        (_h = eventsCallbacks === null || eventsCallbacks === void 0 ? void 0 : eventsCallbacks.onLogout) === null || _h === void 0 ? void 0 : _h.call(eventsCallbacks, user);
+        dynamicEvents.emit('logout');
     }), [
         setSdkHasLoaded,
         clearAllWalletConnectSessions,
@@ -334,6 +345,7 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
         setIsVerificationInProgress,
         setAuthMode,
         initialAuthenticationMode,
+        setShowAuthFlow,
         setMultiWalletWidgetState,
         removeAuthTokenAndUser,
         removeLsSettings,
@@ -351,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;
     }
@@ -394,23 +406,11 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
         initExpirationTime(handleLogOut);
     }, [handleLogOut]);
     useCustomerAuthFlowCallbacks({ eventsCallbacks, showAuthFlow });
-    const onEmailVerificationFailure = (email) => {
-        var _a;
-        (_a = eventsCallbacks === null || eventsCallbacks === void 0 ? void 0 : eventsCallbacks.onEmailVerificationFailure) === null || _a === void 0 ? void 0 : _a.call(eventsCallbacks, email);
-        internalEventsRef.current.emit('emailVerificationResult', false, email);
-    };
-    const onEmailVerificationSuccess = (email) => {
-        var _a;
-        (_a = eventsCallbacks === null || eventsCallbacks === void 0 ? void 0 : eventsCallbacks.onEmailVerificationSuccess) === null || _a === void 0 ? void 0 : _a.call(eventsCallbacks, email);
-        internalEventsRef.current.emit('emailVerificationResult', true, email);
-    };
     const { setCallback } = useCustomerCallbacks({
         authMode,
         callbacks: {
             onAuthSuccess: eventsCallbacks === null || eventsCallbacks === void 0 ? void 0 : eventsCallbacks.onAuthSuccess,
             onConnect: eventsCallbacks === null || eventsCallbacks === void 0 ? void 0 : eventsCallbacks.onConnect,
-            onEmailVerificationFailure,
-            onEmailVerificationSuccess,
             onEmbeddedWalletCreated: eventsCallbacks === null || eventsCallbacks === void 0 ? void 0 : eventsCallbacks.onEmbeddedWalletCreated,
             onLinkSuccess: eventsCallbacks === null || eventsCallbacks === void 0 ? void 0 : eventsCallbacks.onLinkSuccess,
             onUserProfileUpdate: eventsCallbacks === null || eventsCallbacks === void 0 ? void 0 : eventsCallbacks.onUserProfileUpdate,
@@ -451,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());
         }
     }), [
@@ -502,8 +502,6 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
             handleLogOut,
             handleUnlinkWallet: authMode === 'connect-only' ? disconnectWallet : handleUnlinkWallet,
             i18nSDKInstance,
-            internalEvents: internalEventsRef,
-            internalSetShowAuthFlow: setShowAuthFlow,
             isAuthenticated,
             isBridgeFlow,
             isFullyConnected,
@@ -559,9 +557,10 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
             setSdkHasLoaded,
             setSelectedWalletConnectorKey,
             setSelectedWalletWithAction,
-            setShowAuthFlow: setShowAuthFlowWithInit,
+            setShowAuthFlow,
             setShowBridgeWidget,
             setShowDynamicUserProfile,
+            setShowLinkNewWalletModal,
             setShowPasskeyCreatedSuccess,
             setShowQrcodeModal,
             setShowWidgetStatePopup,
@@ -667,7 +666,8 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
         setPrimaryWalletId,
         setSdkHasLoaded,
         setSelectedWalletConnectorKey,
-        setShowAuthFlowWithInit,
+        setShowAuthFlow,
+        setShowLinkNewWalletModal,
         setShowPasskeyCreatedSuccess,
         setShowQrcodeModal,
         setUser,
@@ -688,8 +688,8 @@ const InnerDynamicContextProvider = ({ children, theme, settings, locale, }) =>
         termsOfServiceUrl,
         theme,
         toolkitEnabled,
-        walletUiUtils,
         walletConnectorOptions,
+        walletUiUtils,
         walletsFilter,
     ]);
     useEffect(() => {
@@ -728,13 +728,13 @@ 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,
                                     isFullyConnected,
                                     isMultiWalletEnabled: multiWallet,
-                                }), internalEvents: internalEventsRef, children: [enableForcedNetworkValidation && jsx(UseNetworkValidation, {}), jsx(CaptchaContextProvider, { children: jsx(AccountExistsContextProvider, { children: jsx(WalletContextProvider, { canSync: didConnectedStateLoad, children: jsx(QrCodeContextProvider, { children: jsx(EmailVerificationContextProvider, { children: jsx(DynamicWidgetContextProvider, { children: jsx(DynamicBridgeWidgetContextProvider, { children: jsx(FundingContextProvider, { children: jsx(AccessDeniedContextProvider, { children: jsx(SendBalanceContextProvider, { children: jsx(WalletGroupContextProvider, { children: jsxs(UserFieldEditorContextProvider, { children: [jsx(DynamicAuthFlow, {}), jsx(Toolkit, {}), jsx(FundingWidget, {}), jsx(SyncPasskeyFlow, {}), confirmationModal, children] }) }) }) }) }) }) }) }) }) }) }) })] }) }) }) }) }) }) }));
+                                }), children: [enableForcedNetworkValidation && jsx(UseNetworkValidation, {}), jsx(CaptchaContextProvider, { children: jsx(AccountExistsContextProvider, { children: jsx(WalletContextProvider, { canSync: didConnectedStateLoad, children: jsx(QrCodeContextProvider, { children: jsx(EmailVerificationContextProvider, { children: jsx(DynamicWidgetContextProvider, { children: jsx(DynamicBridgeWidgetContextProvider, { children: jsx(FundingContextProvider, { children: jsx(AccessDeniedContextProvider, { children: jsx(SendBalanceContextProvider, { children: jsx(WalletGroupContextProvider, { children: jsx(UserFieldEditorContextProvider, { children: jsxs(ConnectWithEmailOtpProvider, { children: [jsx(DynamicAuthFlow, {}), jsx(Toolkit, {}), jsx(FundingWidget, {}), jsx(SyncPasskeyFlow, {}), confirmationModal, children] }) }) }) }) }) }) }) }) }) }) }) }) })] }) }) }) }) }) }) }));
 };
 /** The context provider you need to have access too all of Dynamic's hooks */
 const DynamicContextProvider = (props) => (jsx(UserWalletsProvider, { children: jsx(InnerDynamicContextProvider, Object.assign({}, props)) }));

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

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

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

@@ -11,7 +11,6 @@ require('react/jsx-runtime');
 require('../../../ViewContext/ViewContext.cjs');
 require('@dynamic-labs/wallet-book');
 var isDisplayOrderPriorityForWeb3 = require('../../../../shared/utils/functions/isDisplayOrderPriorityForWeb3/isDisplayOrderPriorityForWeb3.cjs');
-var isDisplayOrderPriorityForWeb2 = require('../../../../shared/utils/functions/isDisplayOrderPriorityForWeb2/isDisplayOrderPriorityForWeb2.cjs');
 require('../../../../utils/constants/colors.cjs');
 require('../../../../shared/utils/classes/storage/localStorage.cjs');
 require('viem');
@@ -21,28 +20,29 @@ require('../../../../shared/consts/index.cjs');
 const web2DisplayOrder = ['email', 'wallet'];
 const web3DisplayOrder = ['wallet', 'email'];
 const useDisplayOrderState = (projectSettings) => {
-    const [displayOrder, setDisplayOrder] = React.useState(web3DisplayOrder);
-    const setDisplayOrderPriority = React.useCallback((priority) => {
-        if (priority === 'web3') {
-            setDisplayOrder(web3DisplayOrder);
-        }
-        else {
-            setDisplayOrder(web2DisplayOrder);
-        }
-    }, [setDisplayOrder]);
-    React.useEffect(() => {
+    const [selectedDisplayOrder, setSelectedDisplayOrder] = React.useState(null);
+    const defaultDisplayOrder = React.useMemo(() => {
         var _a;
         const displayOrderFromApi = (_a = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.design.modal) === null || _a === void 0 ? void 0 : _a.displayOrder;
         if (!displayOrderFromApi)
-            return;
+            return web3DisplayOrder;
         if (isDisplayOrderPriorityForWeb3.isDisplayOrderPriorityForWeb3(displayOrderFromApi)) {
-            setDisplayOrder(web3DisplayOrder);
+            return web3DisplayOrder;
         }
-        else if (isDisplayOrderPriorityForWeb2.isDisplayOrderPriorityForWeb2(displayOrderFromApi)) {
-            setDisplayOrder(web2DisplayOrder);
+        if (web2DisplayOrder) {
+            return web2DisplayOrder;
         }
+        return web3DisplayOrder;
     }, [projectSettings]);
-    return [displayOrder, setDisplayOrderPriority];
+    const setDisplayOrderPriority = React.useCallback((priority) => {
+        if (priority === 'web3') {
+            setSelectedDisplayOrder(web3DisplayOrder);
+        }
+        else {
+            setSelectedDisplayOrder(web2DisplayOrder);
+        }
+    }, [setSelectedDisplayOrder]);
+    return [selectedDisplayOrder || defaultDisplayOrder, setDisplayOrderPriority];
 };
 
 exports.useDisplayOrderState = useDisplayOrderState;

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

@@ -1,4 +1,4 @@
-import { useState, useCallback, useEffect } from 'react';
+import { useState, useMemo, useCallback } from 'react';
 import '@dynamic-labs/sdk-api';
 import '../../../../shared/logger.js';
 import '@dynamic-labs/iconic';
@@ -7,7 +7,6 @@ import 'react/jsx-runtime';
 import '../../../ViewContext/ViewContext.js';
 import '@dynamic-labs/wallet-book';
 import { isDisplayOrderPriorityForWeb3 } from '../../../../shared/utils/functions/isDisplayOrderPriorityForWeb3/isDisplayOrderPriorityForWeb3.js';
-import { isDisplayOrderPriorityForWeb2 } from '../../../../shared/utils/functions/isDisplayOrderPriorityForWeb2/isDisplayOrderPriorityForWeb2.js';
 import '../../../../utils/constants/colors.js';
 import '../../../../shared/utils/classes/storage/localStorage.js';
 import 'viem';
@@ -17,28 +16,29 @@ import '../../../../shared/consts/index.js';
 const web2DisplayOrder = ['email', 'wallet'];
 const web3DisplayOrder = ['wallet', 'email'];
 const useDisplayOrderState = (projectSettings) => {
-    const [displayOrder, setDisplayOrder] = useState(web3DisplayOrder);
-    const setDisplayOrderPriority = useCallback((priority) => {
-        if (priority === 'web3') {
-            setDisplayOrder(web3DisplayOrder);
-        }
-        else {
-            setDisplayOrder(web2DisplayOrder);
-        }
-    }, [setDisplayOrder]);
-    useEffect(() => {
+    const [selectedDisplayOrder, setSelectedDisplayOrder] = useState(null);
+    const defaultDisplayOrder = useMemo(() => {
         var _a;
         const displayOrderFromApi = (_a = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.design.modal) === null || _a === void 0 ? void 0 : _a.displayOrder;
         if (!displayOrderFromApi)
-            return;
+            return web3DisplayOrder;
         if (isDisplayOrderPriorityForWeb3(displayOrderFromApi)) {
-            setDisplayOrder(web3DisplayOrder);
+            return web3DisplayOrder;
         }
-        else if (isDisplayOrderPriorityForWeb2(displayOrderFromApi)) {
-            setDisplayOrder(web2DisplayOrder);
+        if (web2DisplayOrder) {
+            return web2DisplayOrder;
         }
+        return web3DisplayOrder;
     }, [projectSettings]);
-    return [displayOrder, setDisplayOrderPriority];
+    const setDisplayOrderPriority = useCallback((priority) => {
+        if (priority === 'web3') {
+            setSelectedDisplayOrder(web3DisplayOrder);
+        }
+        else {
+            setSelectedDisplayOrder(web2DisplayOrder);
+        }
+    }, [setSelectedDisplayOrder]);
+    return [selectedDisplayOrder || defaultDisplayOrder, setDisplayOrderPriority];
 };
 
 export { useDisplayOrderState };

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;