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

package/src/lib/utils/hooks/useEmbeddedWallet/useTurnkey/useTurnkey.cjs

@@ -0,0 +1,194 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../../../_virtual/_tslib.cjs');
+var React = require('react');
+var sdkApi = require('@dynamic-labs/sdk-api');
+require('../../../../context/DynamicContext/DynamicContext.cjs');
+var decodeJwt = require('../../../../shared/utils/functions/decodeJwt/decodeJwt.cjs');
+require('@dynamic-labs/iconic');
+require('@dynamic-labs/wallet-connector-core');
+require('react/jsx-runtime');
+var ViewContext = require('../../../../context/ViewContext/ViewContext.cjs');
+var logger = require('../../../../shared/logger.cjs');
+require('@dynamic-labs/wallet-book');
+require('../../../constants/colors.cjs');
+require('../../../constants/values.cjs');
+require('../../../../shared/utils/classes/storage/localStorage.cjs');
+require('viem');
+require('@dynamic-labs/utils');
+require('../../../../shared/consts/index.cjs');
+var dynamicEvents = require('../../../../events/dynamicEvents.cjs');
+require('../../../../context/CaptchaContext/CaptchaContext.cjs');
+require('../../../../context/ErrorContext/ErrorContext.cjs');
+var findEmbeddedWalletFromVerifiedCredentials = require('../../../functions/findEmbeddedWalletFromVerifiedCredentials/findEmbeddedWalletFromVerifiedCredentials.cjs');
+var findTurnkeyWallet = require('../../../functions/findTurnkeyWallet/findTurnkeyWallet.cjs');
+require('@dynamic-labs/multi-wallet');
+var getUserWalletsFromVerifiedCredentials = require('../../../functions/getUserWalletsFromVerifiedCredentials/getUserWalletsFromVerifiedCredentials.cjs');
+require('viem/chains');
+require('../../../../context/AccessDeniedContext/AccessDeniedContext.cjs');
+require('../../../../context/AccountExistsContext/AccountExistsContext.cjs');
+require('../../../../config/ApiEndpoint.cjs');
+require('../../../../context/EmailVerificationContext/EmailVerificationContext.cjs');
+require('react-dom');
+var useCreateDynamicEmbeddedWalletMutation = require('../../useCreateDynamicEmbeddedWalletMutation/useCreateDynamicEmbeddedWalletMutation.cjs');
+var smartWallet = require('../../useWalletConnectors/utils/smartWallet/smartWallet.cjs');
+require('../../../../context/ThemeContext/ThemeContext.cjs');
+require('@dynamic-labs/types');
+require('yup');
+require('react-i18next');
+require('../../../../context/MockContext/MockContext.cjs');
+require('../../useUserUpdateRequest/useUpdateUser/useUpdateUser.cjs');
+require('../../../../context/UserFieldEditorContext/UserFieldEditorContext.cjs');
+require('@dynamic-labs/rpc-providers');
+require('../../../../context/UserWalletsContext/UserWalletsContext.cjs');
+require('../../../../components/Alert/Alert.cjs');
+require('../../../../components/ShadowDOM/ShadowDOM.cjs');
+require('../../../../components/IconButton/IconButton.cjs');
+require('../../../../components/InlineWidget/InlineWidget.cjs');
+require('../../../../components/MenuList/Dropdown/Dropdown.cjs');
+require('../../../../components/Transition/ZoomTransition/ZoomTransition.cjs');
+require('../../../../components/Transition/SlideInUpTransition/SlideInUpTransition.cjs');
+require('../../../../components/Transition/OpacityTransition/OpacityTransition.cjs');
+require('../../../../components/Popper/Popper/Popper.cjs');
+require('../../../../components/Popper/PopperContext/PopperContext.cjs');
+require('react-focus-lock');
+require('formik');
+require('i18next');
+require('../../../../components/OverlayCard/OverlayCard.context.cjs');
+require('../../../../components/PasskeyCreatedSuccessBanner/PasskeyCreatedSuccessBanner.cjs');
+require('../../../../context/PasskeyContext/PasskeyContext.cjs');
+require('../../../../views/WalletList/WalletList.cjs');
+require('qrcode');
+require('@hcaptcha/react-hcaptcha');
+require('../../../../context/LoadingContext/LoadingContext.cjs');
+require('../../../../context/SocialRedirectContext/SocialRedirectContext.cjs');
+require('../../../../context/WalletGroupContext/WalletGroupContext.cjs');
+require('../../../../widgets/DynamicBridgeWidget/views/WalletsView/components/SecondaryWallets/SecondaryWallets.cjs');
+require('../../../../context/FooterAnimationContext/index.cjs');
+require('../../../../widgets/DynamicWidget/components/DynamicWidgetHeader/DynamicWidgetHeader.cjs');
+require('../../../../widgets/DynamicWidget/context/DynamicWidgetContext.cjs');
+require('../../../../components/UserProfile/parts/UserProfileField/components/VerifiedEmailIcon/VerifiedEmailIcon.cjs');
+require('@dynamic-labs/viem-utils');
+require('../../../../widgets/DynamicWidget/views/ManagePasskeysWidgetView/PasskeyCard/PasskeyCard.cjs');
+var useInternalDynamicContext = require('../../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext.cjs');
+
+// Hook exposed to customers and used internally to trigger embedded wallet creation
+const useTurnkey = () => {
+    const { projectSettings, setPrimaryWalletId, walletConnectorOptions, setShowAuthFlow, primaryWallet, environmentId, } = useInternalDynamicContext.useInternalDynamicContext();
+    const { setView } = ViewContext.useViewContext();
+    const { createDynamicEmbeddedWalletMutation } = useCreateDynamicEmbeddedWalletMutation.useCreateDynamicEmbeddedWalletMutation();
+    const startPregeneratedWalletCreationFlow = React.useCallback((jwt, decodedJwt) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        yield createDynamicEmbeddedWalletMutation({
+            authToken: jwt,
+            decodedJwt,
+            environmentId,
+            walletConnectorOptions,
+            withAuthenticator: false,
+        });
+        setShowAuthFlow(false, { performMultiWalletChecks: false }); // close email otp pin modal
+        return new Promise((resolve, reject) => {
+            dynamicEvents.dynamicEvents.once('embeddedWalletCreated', (wallet) => resolve(wallet));
+            dynamicEvents.dynamicEvents.once('embeddedWalletFailed', (error) => reject(error));
+        });
+    }), [
+        createDynamicEmbeddedWalletMutation,
+        environmentId,
+        walletConnectorOptions,
+        setShowAuthFlow,
+    ]);
+    const startEmbeddedWalletCreationFlow = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        setShowAuthFlow(true, {
+            ignoreIfIsEmbeddedWidget: false,
+            performMultiWalletChecks: false,
+        });
+        setView('passkey-intro');
+        return new Promise((resolve, reject) => {
+            dynamicEvents.dynamicEvents.once('embeddedWalletCreated', (wallet) => resolve(wallet));
+            dynamicEvents.dynamicEvents.once('embeddedWalletFailed', (error) => {
+                // when creating a passkey, if user cancels the passkey modal more than once
+                // it will throw this DOMException, but we don't want to let user to have access
+                // to the app before they've a passkey correctly setup
+                if (error instanceof DOMException &&
+                    error.name === 'NotAllowedError') {
+                    logger.logger.error('User cancelled the passkey creation.', error);
+                    return;
+                }
+                reject(error);
+            });
+        });
+    }), [setShowAuthFlow, setView]);
+    const returnEmbeddedWallet = React.useCallback((jwt, embeddedWalletVerifiedCredential) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const decodedJwt = decodeJwt.decodeJwt(jwt);
+        const { chain } = embeddedWalletVerifiedCredential;
+        const turnkeyWallet = findTurnkeyWallet.findTurnkeyWallet(walletConnectorOptions, chain);
+        // if user already has embedded wallet, set it as primary wallet
+        if (decodedJwt) {
+            (_a = turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.walletConnector) === null || _a === void 0 ? void 0 : _a.setVerifiedCredentials(decodedJwt.verifiedCredentials);
+            const smartWallet$1 = smartWallet.findSmartWallet(embeddedWalletVerifiedCredential, decodedJwt.verifiedCredentials);
+            if (smartWallet$1) {
+                yield smartWallet.initializeSmartWallet({
+                    account: smartWallet$1,
+                    verifiedCredentials: decodedJwt.verifiedCredentials,
+                    walletConnectorOptions,
+                });
+                setPrimaryWalletId(smartWallet$1.id);
+            }
+            else {
+                setPrimaryWalletId(embeddedWalletVerifiedCredential.id);
+            }
+        }
+        /** It's not authenticated if it still hasn't created a passkey */
+        const authenticated = Boolean((_b = embeddedWalletVerifiedCredential.walletProperties) === null || _b === void 0 ? void 0 : _b.isAuthenticatorAttached);
+        const passkeyWallet = {
+            address: (yield ((_c = turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.walletConnector) === null || _c === void 0 ? void 0 : _c.fetchPublicAddress())) || '',
+            authenticated,
+            chain: ((_d = turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.walletConnector) === null || _d === void 0 ? void 0 : _d.connectedChain) || '',
+            connected: true,
+            connector: (turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.walletConnector) || {},
+            id: embeddedWalletVerifiedCredential.id,
+        };
+        return Promise.resolve(passkeyWallet);
+    }), [setPrimaryWalletId, walletConnectorOptions]);
+    const createTurnkeyWallet = React.useCallback((jwt, decodedJwt, chain = sdkApi.ChainEnum.Evm) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        var _e;
+        const userWaletsCredentials = getUserWalletsFromVerifiedCredentials.getUserWalletsFromVerifiedCredentials(jwt);
+        // if user doesn't have a wallet yet,
+        if (!(userWaletsCredentials === null || userWaletsCredentials === void 0 ? void 0 : userWaletsCredentials.length)) {
+            // create wallet without authenticator
+            if (!((_e = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.embeddedWallets) === null || _e === void 0 ? void 0 : _e.forceAuthenticatorAtSignup)) {
+                return startPregeneratedWalletCreationFlow(jwt, decodedJwt);
+            }
+            // show the passkey view to create an embedded wallet
+            return startEmbeddedWalletCreationFlow();
+        }
+        setShowAuthFlow(false, { performMultiWalletChecks: false });
+        const embeddedWalletVerifiedCredential = findEmbeddedWalletFromVerifiedCredentials.findEmbeddedWalletFromVerifiedCredentials(jwt, chain);
+        // if user logged in with MM for example, just continue the flow
+        if (!embeddedWalletVerifiedCredential) {
+            // user logged in through an email linked to a third party wallet
+            // at this point primary wallet is still undefined and we need to set it
+            if (!primaryWallet) {
+                setPrimaryWalletId(userWaletsCredentials[0].id);
+            }
+            return Promise.resolve(primaryWallet);
+        }
+        // if user already has embedded wallet, returns it
+        return returnEmbeddedWallet(jwt, embeddedWalletVerifiedCredential);
+    }), [
+        projectSettings,
+        setShowAuthFlow,
+        returnEmbeddedWallet,
+        startEmbeddedWalletCreationFlow,
+        startPregeneratedWalletCreationFlow,
+        primaryWallet,
+        setPrimaryWalletId,
+    ]);
+    return {
+        createTurnkeyWallet,
+    };
+};
+
+exports.useTurnkey = useTurnkey;

package/src/lib/utils/hooks/useEmbeddedWallet/useTurnkey/useTurnkey.d.ts

@@ -0,0 +1,5 @@
+import { DynamicJwt, ChainEnum } from '@dynamic-labs/sdk-api';
+import { Wallet } from '../../../../shared';
+export declare const useTurnkey: () => {
+    readonly createTurnkeyWallet: (jwt: string, decodedJwt: DynamicJwt, chain?: ChainEnum) => Promise<Wallet | undefined>;
+};

package/src/lib/utils/hooks/useEmbeddedWallet/useTurnkey/useTurnkey.js

@@ -0,0 +1,190 @@
+import { __awaiter } from '../../../../../../_virtual/_tslib.js';
+import { useCallback } from 'react';
+import { ChainEnum } from '@dynamic-labs/sdk-api';
+import '../../../../context/DynamicContext/DynamicContext.js';
+import { decodeJwt } from '../../../../shared/utils/functions/decodeJwt/decodeJwt.js';
+import '@dynamic-labs/iconic';
+import '@dynamic-labs/wallet-connector-core';
+import 'react/jsx-runtime';
+import { useViewContext } from '../../../../context/ViewContext/ViewContext.js';
+import { logger } from '../../../../shared/logger.js';
+import '@dynamic-labs/wallet-book';
+import '../../../constants/colors.js';
+import '../../../constants/values.js';
+import '../../../../shared/utils/classes/storage/localStorage.js';
+import 'viem';
+import '@dynamic-labs/utils';
+import '../../../../shared/consts/index.js';
+import { dynamicEvents } from '../../../../events/dynamicEvents.js';
+import '../../../../context/CaptchaContext/CaptchaContext.js';
+import '../../../../context/ErrorContext/ErrorContext.js';
+import { findEmbeddedWalletFromVerifiedCredentials } from '../../../functions/findEmbeddedWalletFromVerifiedCredentials/findEmbeddedWalletFromVerifiedCredentials.js';
+import { findTurnkeyWallet } from '../../../functions/findTurnkeyWallet/findTurnkeyWallet.js';
+import '@dynamic-labs/multi-wallet';
+import { getUserWalletsFromVerifiedCredentials } from '../../../functions/getUserWalletsFromVerifiedCredentials/getUserWalletsFromVerifiedCredentials.js';
+import 'viem/chains';
+import '../../../../context/AccessDeniedContext/AccessDeniedContext.js';
+import '../../../../context/AccountExistsContext/AccountExistsContext.js';
+import '../../../../config/ApiEndpoint.js';
+import '../../../../context/EmailVerificationContext/EmailVerificationContext.js';
+import 'react-dom';
+import { useCreateDynamicEmbeddedWalletMutation } from '../../useCreateDynamicEmbeddedWalletMutation/useCreateDynamicEmbeddedWalletMutation.js';
+import { findSmartWallet, initializeSmartWallet } from '../../useWalletConnectors/utils/smartWallet/smartWallet.js';
+import '../../../../context/ThemeContext/ThemeContext.js';
+import '@dynamic-labs/types';
+import 'yup';
+import 'react-i18next';
+import '../../../../context/MockContext/MockContext.js';
+import '../../useUserUpdateRequest/useUpdateUser/useUpdateUser.js';
+import '../../../../context/UserFieldEditorContext/UserFieldEditorContext.js';
+import '@dynamic-labs/rpc-providers';
+import '../../../../context/UserWalletsContext/UserWalletsContext.js';
+import '../../../../components/Alert/Alert.js';
+import '../../../../components/ShadowDOM/ShadowDOM.js';
+import '../../../../components/IconButton/IconButton.js';
+import '../../../../components/InlineWidget/InlineWidget.js';
+import '../../../../components/MenuList/Dropdown/Dropdown.js';
+import '../../../../components/Transition/ZoomTransition/ZoomTransition.js';
+import '../../../../components/Transition/SlideInUpTransition/SlideInUpTransition.js';
+import '../../../../components/Transition/OpacityTransition/OpacityTransition.js';
+import '../../../../components/Popper/Popper/Popper.js';
+import '../../../../components/Popper/PopperContext/PopperContext.js';
+import 'react-focus-lock';
+import 'formik';
+import 'i18next';
+import '../../../../components/OverlayCard/OverlayCard.context.js';
+import '../../../../components/PasskeyCreatedSuccessBanner/PasskeyCreatedSuccessBanner.js';
+import '../../../../context/PasskeyContext/PasskeyContext.js';
+import '../../../../views/WalletList/WalletList.js';
+import 'qrcode';
+import '@hcaptcha/react-hcaptcha';
+import '../../../../context/LoadingContext/LoadingContext.js';
+import '../../../../context/SocialRedirectContext/SocialRedirectContext.js';
+import '../../../../context/WalletGroupContext/WalletGroupContext.js';
+import '../../../../widgets/DynamicBridgeWidget/views/WalletsView/components/SecondaryWallets/SecondaryWallets.js';
+import '../../../../context/FooterAnimationContext/index.js';
+import '../../../../widgets/DynamicWidget/components/DynamicWidgetHeader/DynamicWidgetHeader.js';
+import '../../../../widgets/DynamicWidget/context/DynamicWidgetContext.js';
+import '../../../../components/UserProfile/parts/UserProfileField/components/VerifiedEmailIcon/VerifiedEmailIcon.js';
+import '@dynamic-labs/viem-utils';
+import '../../../../widgets/DynamicWidget/views/ManagePasskeysWidgetView/PasskeyCard/PasskeyCard.js';
+import { useInternalDynamicContext } from '../../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext.js';
+
+// Hook exposed to customers and used internally to trigger embedded wallet creation
+const useTurnkey = () => {
+    const { projectSettings, setPrimaryWalletId, walletConnectorOptions, setShowAuthFlow, primaryWallet, environmentId, } = useInternalDynamicContext();
+    const { setView } = useViewContext();
+    const { createDynamicEmbeddedWalletMutation } = useCreateDynamicEmbeddedWalletMutation();
+    const startPregeneratedWalletCreationFlow = useCallback((jwt, decodedJwt) => __awaiter(void 0, void 0, void 0, function* () {
+        yield createDynamicEmbeddedWalletMutation({
+            authToken: jwt,
+            decodedJwt,
+            environmentId,
+            walletConnectorOptions,
+            withAuthenticator: false,
+        });
+        setShowAuthFlow(false, { performMultiWalletChecks: false }); // close email otp pin modal
+        return new Promise((resolve, reject) => {
+            dynamicEvents.once('embeddedWalletCreated', (wallet) => resolve(wallet));
+            dynamicEvents.once('embeddedWalletFailed', (error) => reject(error));
+        });
+    }), [
+        createDynamicEmbeddedWalletMutation,
+        environmentId,
+        walletConnectorOptions,
+        setShowAuthFlow,
+    ]);
+    const startEmbeddedWalletCreationFlow = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
+        setShowAuthFlow(true, {
+            ignoreIfIsEmbeddedWidget: false,
+            performMultiWalletChecks: false,
+        });
+        setView('passkey-intro');
+        return new Promise((resolve, reject) => {
+            dynamicEvents.once('embeddedWalletCreated', (wallet) => resolve(wallet));
+            dynamicEvents.once('embeddedWalletFailed', (error) => {
+                // when creating a passkey, if user cancels the passkey modal more than once
+                // it will throw this DOMException, but we don't want to let user to have access
+                // to the app before they've a passkey correctly setup
+                if (error instanceof DOMException &&
+                    error.name === 'NotAllowedError') {
+                    logger.error('User cancelled the passkey creation.', error);
+                    return;
+                }
+                reject(error);
+            });
+        });
+    }), [setShowAuthFlow, setView]);
+    const returnEmbeddedWallet = useCallback((jwt, embeddedWalletVerifiedCredential) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const decodedJwt = decodeJwt(jwt);
+        const { chain } = embeddedWalletVerifiedCredential;
+        const turnkeyWallet = findTurnkeyWallet(walletConnectorOptions, chain);
+        // if user already has embedded wallet, set it as primary wallet
+        if (decodedJwt) {
+            (_a = turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.walletConnector) === null || _a === void 0 ? void 0 : _a.setVerifiedCredentials(decodedJwt.verifiedCredentials);
+            const smartWallet = findSmartWallet(embeddedWalletVerifiedCredential, decodedJwt.verifiedCredentials);
+            if (smartWallet) {
+                yield initializeSmartWallet({
+                    account: smartWallet,
+                    verifiedCredentials: decodedJwt.verifiedCredentials,
+                    walletConnectorOptions,
+                });
+                setPrimaryWalletId(smartWallet.id);
+            }
+            else {
+                setPrimaryWalletId(embeddedWalletVerifiedCredential.id);
+            }
+        }
+        /** It's not authenticated if it still hasn't created a passkey */
+        const authenticated = Boolean((_b = embeddedWalletVerifiedCredential.walletProperties) === null || _b === void 0 ? void 0 : _b.isAuthenticatorAttached);
+        const passkeyWallet = {
+            address: (yield ((_c = turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.walletConnector) === null || _c === void 0 ? void 0 : _c.fetchPublicAddress())) || '',
+            authenticated,
+            chain: ((_d = turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.walletConnector) === null || _d === void 0 ? void 0 : _d.connectedChain) || '',
+            connected: true,
+            connector: (turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.walletConnector) || {},
+            id: embeddedWalletVerifiedCredential.id,
+        };
+        return Promise.resolve(passkeyWallet);
+    }), [setPrimaryWalletId, walletConnectorOptions]);
+    const createTurnkeyWallet = useCallback((jwt, decodedJwt, chain = ChainEnum.Evm) => __awaiter(void 0, void 0, void 0, function* () {
+        var _e;
+        const userWaletsCredentials = getUserWalletsFromVerifiedCredentials(jwt);
+        // if user doesn't have a wallet yet,
+        if (!(userWaletsCredentials === null || userWaletsCredentials === void 0 ? void 0 : userWaletsCredentials.length)) {
+            // create wallet without authenticator
+            if (!((_e = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.embeddedWallets) === null || _e === void 0 ? void 0 : _e.forceAuthenticatorAtSignup)) {
+                return startPregeneratedWalletCreationFlow(jwt, decodedJwt);
+            }
+            // show the passkey view to create an embedded wallet
+            return startEmbeddedWalletCreationFlow();
+        }
+        setShowAuthFlow(false, { performMultiWalletChecks: false });
+        const embeddedWalletVerifiedCredential = findEmbeddedWalletFromVerifiedCredentials(jwt, chain);
+        // if user logged in with MM for example, just continue the flow
+        if (!embeddedWalletVerifiedCredential) {
+            // user logged in through an email linked to a third party wallet
+            // at this point primary wallet is still undefined and we need to set it
+            if (!primaryWallet) {
+                setPrimaryWalletId(userWaletsCredentials[0].id);
+            }
+            return Promise.resolve(primaryWallet);
+        }
+        // if user already has embedded wallet, returns it
+        return returnEmbeddedWallet(jwt, embeddedWalletVerifiedCredential);
+    }), [
+        projectSettings,
+        setShowAuthFlow,
+        returnEmbeddedWallet,
+        startEmbeddedWalletCreationFlow,
+        startPregeneratedWalletCreationFlow,
+        primaryWallet,
+        setPrimaryWalletId,
+    ]);
+    return {
+        createTurnkeyWallet,
+    };
+};
+
+export { useTurnkey };

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

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

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

@@ -0,0 +1,21 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../../_virtual/_tslib.cjs');
+var usePasskeyRecovery = require('../usePasskeyRecovery/usePasskeyRecovery.cjs');
+
+const useEmbeddedWalletAuthenticator = () => {
+    const { initPasskeyRecoveryProcess, shouldInitRecovery } = usePasskeyRecovery.usePasskeyRecovery();
+    const createOrRefreshAuthenticatorSession = (authenticatorType) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        // user has passkey authenticator set up OR active session
+        // there is no need to create or refresh the authenticator
+        if (authenticatorType !== 'passkey' && !(yield shouldInitRecovery())) {
+            return;
+        }
+        return initPasskeyRecoveryProcess(authenticatorType);
+    });
+    return { createOrRefreshAuthenticatorSession };
+};
+
+exports.useEmbeddedWalletAuthenticator = useEmbeddedWalletAuthenticator;

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

@@ -0,0 +1,4 @@
+import { AuthenticatorType } from '@dynamic-labs/wallet-connector-core';
+export declare const useEmbeddedWalletAuthenticator: () => {
+    createOrRefreshAuthenticatorSession: (authenticatorType?: AuthenticatorType) => Promise<import("../../../shared").Wallet | undefined>;
+};

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

@@ -0,0 +1,17 @@
+import { __awaiter } from '../../../../../_virtual/_tslib.js';
+import { usePasskeyRecovery } from '../usePasskeyRecovery/usePasskeyRecovery.js';
+
+const useEmbeddedWalletAuthenticator = () => {
+    const { initPasskeyRecoveryProcess, shouldInitRecovery } = usePasskeyRecovery();
+    const createOrRefreshAuthenticatorSession = (authenticatorType) => __awaiter(void 0, void 0, void 0, function* () {
+        // user has passkey authenticator set up OR active session
+        // there is no need to create or refresh the authenticator
+        if (authenticatorType !== 'passkey' && !(yield shouldInitRecovery())) {
+            return;
+        }
+        return initPasskeyRecoveryProcess(authenticatorType);
+    });
+    return { createOrRefreshAuthenticatorSession };
+};
+
+export { useEmbeddedWalletAuthenticator };

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

@@ -14,11 +14,12 @@ require('../../../context/ViewContext/ViewContext.cjs');
 require('@dynamic-labs/wallet-book');
 var localStorage = require('../../constants/localStorage.cjs');
 require('../../constants/colors.cjs');
+require('../../constants/values.cjs');
 require('../../../shared/utils/classes/storage/localStorage.cjs');
 require('viem');
 var useLocalStorage = require('../../../shared/utils/hooks/useLocalStorage/useLocalStorage.cjs');
 require('../../../shared/consts/index.cjs');
-var validators = require('../../../context/DynamicContext/validators.cjs');
+var validators = require('../../../context/DynamicContext/validators/validators.cjs');
 
 const useFetchNonce = (environmentId, maxRetries = 2) => {
     const [lsNonce, setLsNonce, removeLsNonce] = useLocalStorage.useLocalStorage(localStorage.NONCE_STORAGE_KEY, undefined, validators.validateLocalStorageExpiry);

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

@@ -10,11 +10,12 @@ import '../../../context/ViewContext/ViewContext.js';
 import '@dynamic-labs/wallet-book';
 import { NONCE_STORAGE_KEY } from '../../constants/localStorage.js';
 import '../../constants/colors.js';
+import '../../constants/values.js';
 import '../../../shared/utils/classes/storage/localStorage.js';
 import 'viem';
 import { useLocalStorage } from '../../../shared/utils/hooks/useLocalStorage/useLocalStorage.js';
 import '../../../shared/consts/index.js';
-import { validateLocalStorageExpiry } from '../../../context/DynamicContext/validators.js';
+import { validateLocalStorageExpiry } from '../../../context/DynamicContext/validators/validators.js';
 
 const useFetchNonce = (environmentId, maxRetries = 2) => {
     const [lsNonce, setLsNonce, removeLsNonce] = useLocalStorage(NONCE_STORAGE_KEY, undefined, validateLocalStorageExpiry);

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

@@ -14,12 +14,13 @@ require('../../../context/ViewContext/ViewContext.cjs');
 require('@dynamic-labs/wallet-book');
 var localStorage = require('../../constants/localStorage.cjs');
 require('../../constants/colors.cjs');
+require('../../constants/values.cjs');
 var localStorage$1 = require('../../../shared/utils/classes/storage/localStorage.cjs');
 require('viem');
-var useLocalStorage = require('../../../shared/utils/hooks/useLocalStorage/useLocalStorage.cjs');
 var useEffectOnce = require('../../../shared/utils/hooks/useEffectOnce/useEffectOnce.cjs');
+var useLocalStorage = require('../../../shared/utils/hooks/useLocalStorage/useLocalStorage.cjs');
 require('../../../shared/consts/index.cjs');
-var validators = require('../../../context/DynamicContext/validators.cjs');
+var validators = require('../../../context/DynamicContext/validators/validators.cjs');
 
 const useFetchProjectSettings = ({ authToken, environmentId, maxRetries = 2, dynamicContextProps, }) => {
     const [lsSettings, setLsSettings, removeLsSettings] = useLocalStorage.useLocalStorage(localStorage.PROJECT_SETTINGS_STORAGE_KEY, undefined, validators.validateLocalStorageExpiry);
@@ -61,6 +62,7 @@ const useFetchProjectSettings = ({ authToken, environmentId, maxRetries = 2, dyn
             const serializedDynamicContextProps = Object.assign(Object.assign({}, updatedDynamicProps), { settings: Object.assign(Object.assign({}, updatedDynamicProps.settings), { eventsCallbacks: serializedEventsCallbacks, walletConnectors: serializedWalletConnectors }) });
             api.sendDynamicProps(environmentId, {
                 dynamicContextProps: serializedDynamicContextProps,
+                frameworkSettings: getFrameworkSettings(),
             });
             api.fetchProjectSettings(environmentId)
                 .then((response) => {
@@ -123,6 +125,19 @@ const serializeWalletConnectors = (walletConnectors) => {
         return undefined;
     }
 };
+const getFrameworkSettings = () => {
+    var _a;
+    return ({
+        nextJs: {
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore
+            version: (_a = window.next) === null || _a === void 0 ? void 0 : _a.version,
+        },
+        react: {
+            version: React.version,
+        },
+    });
+};
 
 exports.serializeEventsCallbacks = serializeEventsCallbacks;
 exports.serializeWalletConnectors = serializeWalletConnectors;

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

@@ -1,4 +1,4 @@
-import { useState, useEffect, useMemo } from 'react';
+import { useState, useEffect, useMemo, version } from 'react';
 import { DynamicError } from '@dynamic-labs/utils';
 import { sendDynamicProps, fetchProjectSettings } from '../../../data/api.js';
 import '@dynamic-labs/sdk-api';
@@ -10,12 +10,13 @@ import '../../../context/ViewContext/ViewContext.js';
 import '@dynamic-labs/wallet-book';
 import { PROJECT_SETTINGS_STORAGE_KEY, CONNECTED_WALLETS_INFO } from '../../constants/localStorage.js';
 import '../../constants/colors.js';
+import '../../constants/values.js';
 import { LocalStorage } from '../../../shared/utils/classes/storage/localStorage.js';
 import 'viem';
-import { useLocalStorage } from '../../../shared/utils/hooks/useLocalStorage/useLocalStorage.js';
 import { useEffectOnce } from '../../../shared/utils/hooks/useEffectOnce/useEffectOnce.js';
+import { useLocalStorage } from '../../../shared/utils/hooks/useLocalStorage/useLocalStorage.js';
 import '../../../shared/consts/index.js';
-import { validateLocalStorageExpiry } from '../../../context/DynamicContext/validators.js';
+import { validateLocalStorageExpiry } from '../../../context/DynamicContext/validators/validators.js';
 
 const useFetchProjectSettings = ({ authToken, environmentId, maxRetries = 2, dynamicContextProps, }) => {
     const [lsSettings, setLsSettings, removeLsSettings] = useLocalStorage(PROJECT_SETTINGS_STORAGE_KEY, undefined, validateLocalStorageExpiry);
@@ -57,6 +58,7 @@ const useFetchProjectSettings = ({ authToken, environmentId, maxRetries = 2, dyn
             const serializedDynamicContextProps = Object.assign(Object.assign({}, updatedDynamicProps), { settings: Object.assign(Object.assign({}, updatedDynamicProps.settings), { eventsCallbacks: serializedEventsCallbacks, walletConnectors: serializedWalletConnectors }) });
             sendDynamicProps(environmentId, {
                 dynamicContextProps: serializedDynamicContextProps,
+                frameworkSettings: getFrameworkSettings(),
             });
             fetchProjectSettings(environmentId)
                 .then((response) => {
@@ -119,5 +121,18 @@ const serializeWalletConnectors = (walletConnectors) => {
         return undefined;
     }
 };
+const getFrameworkSettings = () => {
+    var _a;
+    return ({
+        nextJs: {
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore
+            version: (_a = window.next) === null || _a === void 0 ? void 0 : _a.version,
+        },
+        react: {
+            version,
+        },
+    });
+};
 
 export { serializeEventsCallbacks, serializeWalletConnectors, useFetchProjectSettings };

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

@@ -11,6 +11,7 @@ require('react/jsx-runtime');
 require('../../../context/ViewContext/ViewContext.cjs');
 require('@dynamic-labs/wallet-book');
 require('../../constants/colors.cjs');
+require('../../constants/values.cjs');
 require('../../../shared/utils/classes/storage/localStorage.cjs');
 require('viem');
 require('@dynamic-labs/utils');

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

@@ -7,6 +7,7 @@ import 'react/jsx-runtime';
 import '../../../context/ViewContext/ViewContext.js';
 import '@dynamic-labs/wallet-book';
 import '../../constants/colors.js';
+import '../../constants/values.js';
 import '../../../shared/utils/classes/storage/localStorage.js';
 import 'viem';
 import '@dynamic-labs/utils';

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

@@ -13,13 +13,14 @@ require('../../../context/ViewContext/ViewContext.cjs');
 require('@dynamic-labs/wallet-book');
 var localStorage$1 = require('../../constants/localStorage.cjs');
 require('../../constants/colors.cjs');
+require('../../constants/values.cjs');
 var localStorage = require('../../../shared/utils/classes/storage/localStorage.cjs');
 require('viem');
 require('@dynamic-labs/utils');
 require('../../../shared/consts/index.cjs');
 var handleUnlinkHelper = require('../../functions/handleUnlinkHelper/handleUnlinkHelper.cjs');
 
-const useHandleUnlinkWallet = ({ verifiedCredentials, environmentId, primaryWalletId, secondaryWallets, setUser, }) => {
+const useHandleUnlinkWallet = ({ verifiedCredentials, environmentId, primaryWalletId, secondaryWallets, setUser, user, eventsCallbacks, }) => {
     const callback = React.useCallback((walletId) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         var _a;
         // when we call handleUnlinkWallet on the same execution stack as setPrimaryWallet, the value of
@@ -34,6 +35,7 @@ const useHandleUnlinkWallet = ({ verifiedCredentials, environmentId, primaryWall
         const currentPrimaryWalletId = (_a = localStorage.LocalStorage.getFromLS(localStorage$1.PRIMARY_WALLET_ID)) !== null && _a !== void 0 ? _a : primaryWalletId;
         if (walletId === currentPrimaryWalletId)
             return;
+        const vcWalletFromId = user === null || user === void 0 ? void 0 : user.verifiedCredentials.find((wallet) => wallet.id === walletId);
         const newUser = yield handleUnlinkHelper.handleUnlinkHelper({
             environmentId,
             primaryWalletId: currentPrimaryWalletId,
@@ -52,12 +54,17 @@ const useHandleUnlinkWallet = ({ verifiedCredentials, environmentId, primaryWall
         if (numberOfLinkedWallets === 1) {
             yield (wallet === null || wallet === void 0 ? void 0 : wallet.connector.endSession());
         }
+        if (vcWalletFromId && (eventsCallbacks === null || eventsCallbacks === void 0 ? void 0 : eventsCallbacks.onUnlinkSuccess)) {
+            eventsCallbacks.onUnlinkSuccess(vcWalletFromId);
+        }
     }), [
         primaryWalletId,
         environmentId,
         secondaryWallets,
         setUser,
         verifiedCredentials,
+        eventsCallbacks,
+        user,
     ]);
     return callback;
 };