@dynamic-labs/sdk-react-core 4.64.0 → 4.66.0

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

@@ -0,0 +1,162 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../../_virtual/_tslib.cjs');
+var React = require('react');
+var utils = require('@dynamic-labs/utils');
+require('../../../context/DynamicContext/DynamicContext.cjs');
+require('../../../store/state/loadingAndLifecycle/loadingAndLifecycle.cjs');
+require('@dynamic-labs/iconic');
+require('@dynamic-labs/wallet-connector-core');
+require('react/jsx-runtime');
+require('../../../context/ViewContext/ViewContext.cjs');
+require('../../../shared/logger.cjs');
+require('@dynamic-labs/wallet-book');
+require('../../constants/colors.cjs');
+require('../../constants/values.cjs');
+require('@dynamic-labs/sdk-api-core');
+require('../../../shared/consts/index.cjs');
+require('../../../events/dynamicEvents.cjs');
+require('../../../context/CaptchaContext/CaptchaContext.cjs');
+require('../../../context/ErrorContext/ErrorContext.cjs');
+require('@dynamic-labs/multi-wallet');
+require('react-international-phone');
+require('../../../store/state/nonce/nonce.cjs');
+require('@dynamic-labs-sdk/client/core');
+require('../../../client/client.cjs');
+require('@dynamic-labs-sdk/client');
+require('../../../config/ApiEndpoint.cjs');
+require('@dynamic-labs/locale');
+require('../../../store/state/dynamicContextProps/dynamicContextProps.cjs');
+require('../../../store/state/primaryWalletId/primaryWalletId.cjs');
+require('../../../store/state/connectedWalletsInfo/connectedWalletsInfo.cjs');
+require('../../functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.cjs');
+require('../../../context/AccessDeniedContext/AccessDeniedContext.cjs');
+require('../../../context/AccountExistsContext/AccountExistsContext.cjs');
+require('../../../context/UserWalletsContext/UserWalletsContext.cjs');
+require('../../../store/state/authMode/authMode.cjs');
+require('../../../context/VerificationContext/VerificationContext.cjs');
+require('react-dom');
+require('../../functions/compareChains/compareChains.cjs');
+require('../../../views/Passkey/utils/findPrimaryEmbeddedChain/findPrimaryEmbeddedChain.cjs');
+require('../../../context/ThemeContext/ThemeContext.cjs');
+require('../useUserUpdateRequest/useUpdateUser/userFieldsSchema.cjs');
+require('bs58');
+require('@dynamic-labs/types');
+require('../../../context/SocialRedirectContext/SocialRedirectContext.cjs');
+require('../../../context/LoadingContext/LoadingContext.cjs');
+require('../../../context/WalletContext/WalletContext.cjs');
+require('../useEmbeddedWallet/useSecureEnclaveEmbeddedWallet/constants.cjs');
+require('yup');
+require('../../../context/MockContext/MockContext.cjs');
+require('../../../views/CollectUserDataView/useFields.cjs');
+require('../../../context/FieldsStateContext/FieldsStateContext.cjs');
+require('../../../context/UserFieldEditorContext/UserFieldEditorContext.cjs');
+require('@dynamic-labs/rpc-providers');
+require('../../../store/state/walletOptions/walletOptions.cjs');
+require('react-i18next');
+require('../../../components/Accordion/components/AccordionItem/AccordionItem.cjs');
+require('../../../components/Alert/Alert.cjs');
+require('../../../components/ShadowDOM/ShadowDOM.cjs');
+require('../../../components/IconButton/IconButton.cjs');
+require('../../../components/InlineWidget/InlineWidget.cjs');
+require('../../../components/Input/Input.cjs');
+require('../../../components/IsBrowser/IsBrowser.cjs');
+require('../../../components/MenuList/Dropdown/Dropdown.cjs');
+require('../../../components/OverlayCard/OverlayCard.cjs');
+require('../../../components/Transition/ZoomTransition/ZoomTransition.cjs');
+require('../../../components/Transition/SlideInUpTransition/SlideInUpTransition.cjs');
+require('../../../components/Transition/OpacityTransition/OpacityTransition.cjs');
+require('../../../components/PasskeyCreatedSuccessBanner/PasskeyCreatedSuccessBanner.cjs');
+require('../../../components/Popper/Popper/Popper.cjs');
+require('../../../components/Popper/PopperContext/PopperContext.cjs');
+require('react-focus-lock');
+require('qrcode');
+require('formik');
+require('../useSubdomainCheck/useSubdomainCheck.cjs');
+require('../../../context/WalletGroupContext/WalletGroupContext.cjs');
+require('../../../widgets/DynamicWidget/context/DynamicWidgetContext.cjs');
+require('../useWalletBackup/useWalletBackup.cjs');
+require('../useWalletBackup/types.cjs');
+require('../useWalletBackup/cloudProviders.cjs');
+require('../../../context/IpConfigurationContext/IpConfigurationContext.cjs');
+require('../../../context/ConnectWithOtpContext/ConnectWithOtpContext.cjs');
+require('../../../widgets/DynamicBridgeWidget/views/WalletsView/components/SecondaryWallets/SecondaryWallets.cjs');
+require('@hcaptcha/react-hcaptcha');
+require('../../../widgets/DynamicWidget/helpers/convertExchangeKeyAndProviderEnum.cjs');
+require('../../../views/ExchangeWhitelistWarning/ExchangeWhitelistWarning.cjs');
+require('../../../context/ErrorContext/hooks/useErrorText/useErrorText.cjs');
+require('../../../context/FooterAnimationContext/index.cjs');
+require('../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.cjs');
+require('../../../context/PasskeyContext/PasskeyContext.cjs');
+require('../../../context/OnrampContext/OnrampContext.cjs');
+require('../../../store/state/sendBalances.cjs');
+require('../../../store/state/connectorsInitializing/connectorsInitializing.cjs');
+require('../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.cjs');
+require('../../../widgets/DynamicWidget/components/DynamicWidgetHeader/DynamicWidgetHeader.cjs');
+require('../../../views/TransactionConfirmationView/TransactionConfirmationView.cjs');
+require('../../../widgets/DynamicWidget/components/PasskeyCard/PasskeyCard.cjs');
+require('../../../widgets/DynamicWidget/views/CryptoComOnramp/CryptoComOnramp.cjs');
+require('../../../../index.cjs');
+require('../../../widgets/DynamicWidget/views/ReceiveWalletFunds/ReceiveWalletFunds.cjs');
+require('../../../store/state/tokenBalances.cjs');
+require('../../../store/state/multichainBalances.cjs');
+require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
+var useInternalDynamicContext = require('../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.cjs');
+
+/**
+ * Hook for signing EIP-7702 authorizations for ZeroDev kernel delegation.
+ *
+ * This hook provides a way to sign EIP-7702 authorizations that enable
+ * single-use MFA flows where the authorization signing step is separated
+ * from the transaction execution step.
+ *
+ * The signed authorization can be passed to kernel account client creation
+ * functions like `createEcdsaKernelAccountClientWith7702`.
+ *
+ * @returns An object containing the `signEip7702Authorization` function
+ *
+ * @example
+ * ```tsx
+ * import { useSignEip7702Authorization } from '@dynamic-labs/sdk-react-core';
+ *
+ * function MyComponent() {
+ *   const { signEip7702Authorization } = useSignEip7702Authorization();
+ *
+ *   const handleSign = async () => {
+ *     try {
+ *       const auth = await signEip7702Authorization();
+ *       console.log('Signed authorization:', auth);
+ *       // Use auth with kernel client creation
+ *     } catch (error) {
+ *       console.error('Failed to sign authorization:', error);
+ *     }
+ *   };
+ *
+ *   return <button onClick={handleSign}>Sign Authorization</button>;
+ * }
+ * ```
+ */
+const useSignEip7702Authorization = () => {
+    const { primaryWallet } = useInternalDynamicContext.useInternalDynamicContext();
+    const signEip7702Auth = React.useCallback((params) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const { wallet: providedWallet, chainId: providedChainId } = params !== null && params !== void 0 ? params : {};
+        // Use provided wallet or fallback to primary wallet
+        const wallet = providedWallet !== null && providedWallet !== void 0 ? providedWallet : primaryWallet;
+        if (!wallet) {
+            throw new utils.DynamicError('No wallet available. Please connect a wallet first.');
+        }
+        if (((_a = wallet.connector) === null || _a === void 0 ? void 0 : _a.key) !== 'zerodev') {
+            throw new utils.DynamicError('The wallet connector must be a ZeroDev connector to sign EIP-7702 authorizations.');
+        }
+        return wallet.connector.signEip7702PreAuth(providedChainId);
+    }), [primaryWallet]);
+    return {
+        signEip7702Authorization: signEip7702Auth,
+    };
+};
+
+exports.useSignEip7702Authorization = useSignEip7702Authorization;

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

@@ -0,0 +1,78 @@
+import { IZeroDevConnector, Wallet } from '@dynamic-labs/wallet-connector-core';
+export type Eip7702Authorization = Awaited<ReturnType<IZeroDevConnector['signEip7702PreAuth']>>;
+export type SignEip7702AuthorizationParams = {
+    /**
+     * The wallet to sign the EIP-7702 authorization with.
+     * If not provided, uses the primary wallet.
+     */
+    wallet?: Wallet;
+    /**
+     * The chain ID to sign the authorization for.
+     * If not provided, uses the wallet's current network chain ID.
+     */
+    chainId?: number;
+};
+export type UseSignEip7702AuthorizationReturn = {
+    /**
+     * Signs an EIP-7702 authorization for ZeroDev kernel delegation.
+     *
+     * This creates a signed authorization that allows a wallet to delegate
+     * its execution to the ZeroDev kernel contract. The signed authorization can then
+     * be passed to kernel account client creation functions.
+     *
+     * @param params - Optional parameters for signing the authorization
+     * @returns A promise that resolves to the signed EIP-7702 authorization
+     * @throws {DynamicError} If the wallet connector is not a ZeroDev connector
+     * @throws {DynamicError} If no wallet is available
+     * @throws {DynamicError} If the connector does not support EIP-7702 authorization
+     *
+     * @example
+     * ```tsx
+     * const { signEip7702Authorization } = useSignEip7702Authorization();
+     *
+     * // Sign with primary wallet and current network
+     * const auth = await signEip7702Authorization();
+     *
+     * // Sign with specific wallet and chain ID
+     * const auth = await signEip7702Authorization({
+     *   wallet: myWallet,
+     *   chainId: 1, // Ethereum mainnet
+     * });
+     * ```
+     */
+    signEip7702Authorization: (params?: SignEip7702AuthorizationParams) => Promise<Eip7702Authorization>;
+};
+/**
+ * Hook for signing EIP-7702 authorizations for ZeroDev kernel delegation.
+ *
+ * This hook provides a way to sign EIP-7702 authorizations that enable
+ * single-use MFA flows where the authorization signing step is separated
+ * from the transaction execution step.
+ *
+ * The signed authorization can be passed to kernel account client creation
+ * functions like `createEcdsaKernelAccountClientWith7702`.
+ *
+ * @returns An object containing the `signEip7702Authorization` function
+ *
+ * @example
+ * ```tsx
+ * import { useSignEip7702Authorization } from '@dynamic-labs/sdk-react-core';
+ *
+ * function MyComponent() {
+ *   const { signEip7702Authorization } = useSignEip7702Authorization();
+ *
+ *   const handleSign = async () => {
+ *     try {
+ *       const auth = await signEip7702Authorization();
+ *       console.log('Signed authorization:', auth);
+ *       // Use auth with kernel client creation
+ *     } catch (error) {
+ *       console.error('Failed to sign authorization:', error);
+ *     }
+ *   };
+ *
+ *   return <button onClick={handleSign}>Sign Authorization</button>;
+ * }
+ * ```
+ */
+export declare const useSignEip7702Authorization: () => UseSignEip7702AuthorizationReturn;

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

@@ -0,0 +1,158 @@
+'use client'
+import { __awaiter } from '../../../../../_virtual/_tslib.js';
+import { useCallback } from 'react';
+import { DynamicError } from '@dynamic-labs/utils';
+import '../../../context/DynamicContext/DynamicContext.js';
+import '../../../store/state/loadingAndLifecycle/loadingAndLifecycle.js';
+import '@dynamic-labs/iconic';
+import '@dynamic-labs/wallet-connector-core';
+import 'react/jsx-runtime';
+import '../../../context/ViewContext/ViewContext.js';
+import '../../../shared/logger.js';
+import '@dynamic-labs/wallet-book';
+import '../../constants/colors.js';
+import '../../constants/values.js';
+import '@dynamic-labs/sdk-api-core';
+import '../../../shared/consts/index.js';
+import '../../../events/dynamicEvents.js';
+import '../../../context/CaptchaContext/CaptchaContext.js';
+import '../../../context/ErrorContext/ErrorContext.js';
+import '@dynamic-labs/multi-wallet';
+import 'react-international-phone';
+import '../../../store/state/nonce/nonce.js';
+import '@dynamic-labs-sdk/client/core';
+import '../../../client/client.js';
+import '@dynamic-labs-sdk/client';
+import '../../../config/ApiEndpoint.js';
+import '@dynamic-labs/locale';
+import '../../../store/state/dynamicContextProps/dynamicContextProps.js';
+import '../../../store/state/primaryWalletId/primaryWalletId.js';
+import '../../../store/state/connectedWalletsInfo/connectedWalletsInfo.js';
+import '../../functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.js';
+import '../../../context/AccessDeniedContext/AccessDeniedContext.js';
+import '../../../context/AccountExistsContext/AccountExistsContext.js';
+import '../../../context/UserWalletsContext/UserWalletsContext.js';
+import '../../../store/state/authMode/authMode.js';
+import '../../../context/VerificationContext/VerificationContext.js';
+import 'react-dom';
+import '../../functions/compareChains/compareChains.js';
+import '../../../views/Passkey/utils/findPrimaryEmbeddedChain/findPrimaryEmbeddedChain.js';
+import '../../../context/ThemeContext/ThemeContext.js';
+import '../useUserUpdateRequest/useUpdateUser/userFieldsSchema.js';
+import 'bs58';
+import '@dynamic-labs/types';
+import '../../../context/SocialRedirectContext/SocialRedirectContext.js';
+import '../../../context/LoadingContext/LoadingContext.js';
+import '../../../context/WalletContext/WalletContext.js';
+import '../useEmbeddedWallet/useSecureEnclaveEmbeddedWallet/constants.js';
+import 'yup';
+import '../../../context/MockContext/MockContext.js';
+import '../../../views/CollectUserDataView/useFields.js';
+import '../../../context/FieldsStateContext/FieldsStateContext.js';
+import '../../../context/UserFieldEditorContext/UserFieldEditorContext.js';
+import '@dynamic-labs/rpc-providers';
+import '../../../store/state/walletOptions/walletOptions.js';
+import 'react-i18next';
+import '../../../components/Accordion/components/AccordionItem/AccordionItem.js';
+import '../../../components/Alert/Alert.js';
+import '../../../components/ShadowDOM/ShadowDOM.js';
+import '../../../components/IconButton/IconButton.js';
+import '../../../components/InlineWidget/InlineWidget.js';
+import '../../../components/Input/Input.js';
+import '../../../components/IsBrowser/IsBrowser.js';
+import '../../../components/MenuList/Dropdown/Dropdown.js';
+import '../../../components/OverlayCard/OverlayCard.js';
+import '../../../components/Transition/ZoomTransition/ZoomTransition.js';
+import '../../../components/Transition/SlideInUpTransition/SlideInUpTransition.js';
+import '../../../components/Transition/OpacityTransition/OpacityTransition.js';
+import '../../../components/PasskeyCreatedSuccessBanner/PasskeyCreatedSuccessBanner.js';
+import '../../../components/Popper/Popper/Popper.js';
+import '../../../components/Popper/PopperContext/PopperContext.js';
+import 'react-focus-lock';
+import 'qrcode';
+import 'formik';
+import '../useSubdomainCheck/useSubdomainCheck.js';
+import '../../../context/WalletGroupContext/WalletGroupContext.js';
+import '../../../widgets/DynamicWidget/context/DynamicWidgetContext.js';
+import '../useWalletBackup/useWalletBackup.js';
+import '../useWalletBackup/types.js';
+import '../useWalletBackup/cloudProviders.js';
+import '../../../context/IpConfigurationContext/IpConfigurationContext.js';
+import '../../../context/ConnectWithOtpContext/ConnectWithOtpContext.js';
+import '../../../widgets/DynamicBridgeWidget/views/WalletsView/components/SecondaryWallets/SecondaryWallets.js';
+import '@hcaptcha/react-hcaptcha';
+import '../../../widgets/DynamicWidget/helpers/convertExchangeKeyAndProviderEnum.js';
+import '../../../views/ExchangeWhitelistWarning/ExchangeWhitelistWarning.js';
+import '../../../context/ErrorContext/hooks/useErrorText/useErrorText.js';
+import '../../../context/FooterAnimationContext/index.js';
+import '../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.js';
+import '../../../context/PasskeyContext/PasskeyContext.js';
+import '../../../context/OnrampContext/OnrampContext.js';
+import '../../../store/state/sendBalances.js';
+import '../../../store/state/connectorsInitializing/connectorsInitializing.js';
+import '../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.js';
+import '../../../widgets/DynamicWidget/components/DynamicWidgetHeader/DynamicWidgetHeader.js';
+import '../../../views/TransactionConfirmationView/TransactionConfirmationView.js';
+import '../../../widgets/DynamicWidget/components/PasskeyCard/PasskeyCard.js';
+import '../../../widgets/DynamicWidget/views/CryptoComOnramp/CryptoComOnramp.js';
+import '../../../../index.js';
+import '../../../widgets/DynamicWidget/views/ReceiveWalletFunds/ReceiveWalletFunds.js';
+import '../../../store/state/tokenBalances.js';
+import '../../../store/state/multichainBalances.js';
+import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
+import { useInternalDynamicContext } from '../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.js';
+
+/**
+ * Hook for signing EIP-7702 authorizations for ZeroDev kernel delegation.
+ *
+ * This hook provides a way to sign EIP-7702 authorizations that enable
+ * single-use MFA flows where the authorization signing step is separated
+ * from the transaction execution step.
+ *
+ * The signed authorization can be passed to kernel account client creation
+ * functions like `createEcdsaKernelAccountClientWith7702`.
+ *
+ * @returns An object containing the `signEip7702Authorization` function
+ *
+ * @example
+ * ```tsx
+ * import { useSignEip7702Authorization } from '@dynamic-labs/sdk-react-core';
+ *
+ * function MyComponent() {
+ *   const { signEip7702Authorization } = useSignEip7702Authorization();
+ *
+ *   const handleSign = async () => {
+ *     try {
+ *       const auth = await signEip7702Authorization();
+ *       console.log('Signed authorization:', auth);
+ *       // Use auth with kernel client creation
+ *     } catch (error) {
+ *       console.error('Failed to sign authorization:', error);
+ *     }
+ *   };
+ *
+ *   return <button onClick={handleSign}>Sign Authorization</button>;
+ * }
+ * ```
+ */
+const useSignEip7702Authorization = () => {
+    const { primaryWallet } = useInternalDynamicContext();
+    const signEip7702Auth = useCallback((params) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const { wallet: providedWallet, chainId: providedChainId } = params !== null && params !== void 0 ? params : {};
+        // Use provided wallet or fallback to primary wallet
+        const wallet = providedWallet !== null && providedWallet !== void 0 ? providedWallet : primaryWallet;
+        if (!wallet) {
+            throw new DynamicError('No wallet available. Please connect a wallet first.');
+        }
+        if (((_a = wallet.connector) === null || _a === void 0 ? void 0 : _a.key) !== 'zerodev') {
+            throw new DynamicError('The wallet connector must be a ZeroDev connector to sign EIP-7702 authorizations.');
+        }
+        return wallet.connector.signEip7702PreAuth(providedChainId);
+    }), [primaryWallet]);
+    return {
+        signEip7702Authorization: signEip7702Auth,
+    };
+};
+
+export { useSignEip7702Authorization };

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

@@ -0,0 +1,2 @@
+export { useStepUpAuthentication } from './useStepUpAuthentication';
+export type { StepUpAuthenticationState, UseStepUpAuthenticationParams, UseStepUpAuthenticationReturn, VerifyOtpParams, VerifyWalletParams, } from './useStepUpAuthentication';

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

@@ -0,0 +1,197 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../../_virtual/_tslib.cjs');
+var React = require('react');
+var client = require('@dynamic-labs-sdk/client');
+var sdkApiCore = require('@dynamic-labs/sdk-api-core');
+require('@dynamic-labs-sdk/client/core');
+require('../../../client/client.cjs');
+require('../../../config/ApiEndpoint.cjs');
+require('@dynamic-labs/iconic');
+require('@dynamic-labs/wallet-connector-core');
+require('react/jsx-runtime');
+require('../../../context/ViewContext/ViewContext.cjs');
+var logger = require('../../../shared/logger.cjs');
+require('@dynamic-labs/wallet-book');
+require('@dynamic-labs/utils');
+require('../../constants/colors.cjs');
+require('../../constants/values.cjs');
+require('../../../shared/consts/index.cjs');
+require('@dynamic-labs/multi-wallet');
+require('react-international-phone');
+require('../../../store/state/nonce/nonce.cjs');
+require('@dynamic-labs/locale');
+require('../../../store/state/dynamicContextProps/dynamicContextProps.cjs');
+require('../../../store/state/primaryWalletId/primaryWalletId.cjs');
+require('../../../store/state/connectedWalletsInfo/connectedWalletsInfo.cjs');
+require('../../functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.cjs');
+require('../../../events/dynamicEvents.cjs');
+var useUser = require('../../../client/extension/user/useUser/useUser.cjs');
+var useConnectAndSign = require('../authenticationHooks/useConnectAndSign/useConnectAndSign.cjs');
+var UserWalletsContext = require('../../../context/UserWalletsContext/UserWalletsContext.cjs');
+
+const INITIAL_STATE = {
+    error: null,
+    isLoading: false,
+    otpVerification: null,
+};
+const isCountryCode = (value) => value !== undefined && value in client.supportedCountries;
+const isOtpCapableCredential = (cred) => cred.format === sdkApiCore.JwtVerifiedCredentialFormatEnum.Email ||
+    cred.format === sdkApiCore.JwtVerifiedCredentialFormatEnum.PhoneNumber;
+const resolveTargetCredential = (credentials, credentialId) => {
+    var _a, _b;
+    if (credentialId) {
+        return ((_a = credentials.find((cred) => cred.id === credentialId)) !== null && _a !== void 0 ? _a : `Credential with id "${credentialId}" not found`);
+    }
+    return ((_b = credentials.find((cred) => cred.signInEnabled && isOtpCapableCredential(cred))) !== null && _b !== void 0 ? _b : 'No sign-in enabled email or SMS credential found for step-up authentication');
+};
+const sendEmailOtp = (credential) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    if (!credential.email) {
+        throw new Error('Email credential is missing email address');
+    }
+    return client.sendEmailOTP({ email: credential.email });
+});
+const sendSmsOtp = (credential) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const normalizedPhoneCountryCode = (_a = credential.phoneCountryCode) === null || _a === void 0 ? void 0 : _a.replace(/^\+/, '');
+    const matchedCountryCode = Object.keys(client.supportedCountries).find((key) => client.supportedCountries[key].code === normalizedPhoneCountryCode);
+    const isoCountryCode = isCountryCode(credential.isoCountryCode)
+        ? credential.isoCountryCode
+        : matchedCountryCode;
+    if (!credential.phoneNumber || !isoCountryCode) {
+        throw new Error('SMS credential is missing phone number or country code');
+    }
+    return client.sendSmsOTP({ isoCountryCode, phoneNumber: credential.phoneNumber });
+});
+const dispatchOtp = (credential) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    return credential.format === sdkApiCore.JwtVerifiedCredentialFormatEnum.Email
+        ? sendEmailOtp(credential)
+        : sendSmsOtp(credential);
+});
+/**
+ * Perform step-up authentication for an already-authenticated user via OTP.
+ *
+ * Automatically selects the first sign-in enabled email or SMS credential on
+ * the user, or targets a specific credential when `credentialId` is provided.
+ *
+ * @param params.credentialId - Optional id of a specific verified credential to
+ *   use. Must be an email or SMS credential. Defaults to the first sign-in
+ *   enabled email or SMS credential on the authenticated user.
+ *
+ * @returns `sendOtp` – sends the OTP to the resolved credential.
+ * @returns `verifyOtp` – verifies the OTP code supplied by the user.
+ * @returns `state` – current loading / error / otpVerification state.
+ * @returns `resetState` – resets state back to its initial value.
+ *
+ * @example
+ * ```tsx
+ * const { sendOtp, verifyOtp, state } = useStepUpAuthentication();
+ *
+ * // Step 1: send OTP
+ * await sendOtp();
+ *
+ * // Step 2: after the user enters the code
+ * const result = await verifyOtp({ verificationToken: '123456' });
+ * ```
+ */
+const useStepUpAuthentication = ({ credentialId, } = {}) => {
+    const user = useUser.useUser();
+    const [state, setState] = React.useState(INITIAL_STATE);
+    const connectAndSign = useConnectAndSign.useConnectAndSign();
+    const { userWallets } = UserWalletsContext.useInternalUserWallets();
+    // Ref keeps the latest otpVerification available inside the verifyOtp
+    // callback without creating a stale closure over state.
+    const otpVerificationRef = React.useRef(null);
+    const resetState = React.useCallback(() => {
+        otpVerificationRef.current = null;
+        setState(INITIAL_STATE);
+    }, []);
+    const setError = React.useCallback((errorMessage) => {
+        setState((prev) => (Object.assign(Object.assign({}, prev), { error: errorMessage, isLoading: false })));
+        logger.logger.error(errorMessage);
+    }, []);
+    const sendOtp = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        const credentials = user === null || user === void 0 ? void 0 : user.verifiedCredentials;
+        if (!(credentials === null || credentials === void 0 ? void 0 : credentials.length)) {
+            setError('No verified credentials found for the authenticated user');
+            return null;
+        }
+        const result = resolveTargetCredential(credentials, credentialId);
+        if (typeof result === 'string') {
+            setError(result);
+            return null;
+        }
+        if (!isOtpCapableCredential(result)) {
+            setError(`Credential format "${result.format}" does not support OTP verification. Only email and SMS credentials are supported`);
+            return null;
+        }
+        setState((prev) => (Object.assign(Object.assign({}, prev), { error: null, isLoading: true })));
+        try {
+            const otpVerification = yield dispatchOtp(result);
+            otpVerificationRef.current = otpVerification;
+            setState((prev) => (Object.assign(Object.assign({}, prev), { error: null, isLoading: false, otpVerification })));
+            return otpVerification;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Failed to send OTP';
+            setState((prev) => (Object.assign(Object.assign({}, prev), { error: errorMessage, isLoading: false })));
+            logger.logger.error('Failed to send OTP for step-up authentication', { error });
+            return null;
+        }
+    }), [credentialId, setError, user === null || user === void 0 ? void 0 : user.verifiedCredentials]);
+    const verifyOtp = React.useCallback((_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ requestedScopes, verificationToken, }) {
+        const otpVerification = otpVerificationRef.current;
+        if (!otpVerification) {
+            setError('OTP verification has not been initiated. Call sendOtp() first');
+            return null;
+        }
+        setState((prev) => (Object.assign(Object.assign({}, prev), { error: null, isLoading: true })));
+        try {
+            const response = yield client.verifyOTP({
+                otpVerification,
+                requestedScopes,
+                verificationToken,
+            });
+            setState((prev) => (Object.assign(Object.assign({}, prev), { error: null, isLoading: false })));
+            return response;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Failed to verify OTP';
+            setState((prev) => (Object.assign(Object.assign({}, prev), { error: errorMessage, isLoading: false })));
+            logger.logger.error('Failed to verify OTP for step-up authentication', {
+                error,
+            });
+            return null;
+        }
+    }), [setError]);
+    const verifyWallet = React.useCallback((_b) => _tslib.__awaiter(void 0, [_b], void 0, function* ({ requestedScopes }) {
+        setState((prev) => (Object.assign(Object.assign({}, prev), { error: null, isLoading: true })));
+        const wallet = userWallets.find((w) => w.id === credentialId);
+        if (!wallet) {
+            setError(`Wallet with id "${credentialId}" not found`);
+            return;
+        }
+        try {
+            yield connectAndSign({
+                requestedScopes,
+                walletConnector: wallet.connector,
+            });
+            setState((prev) => (Object.assign(Object.assign({}, prev), { isLoading: false })));
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error
+                ? error.message
+                : 'Failed to verify wallet for step-up authentication';
+            setState((prev) => (Object.assign(Object.assign({}, prev), { error: errorMessage, isLoading: false })));
+            logger.logger.error('Failed to verify wallet for step-up authentication', {
+                error,
+            });
+        }
+    }), [connectAndSign, credentialId, setError, userWallets]);
+    return { resetState, sendOtp, state, verifyOtp, verifyWallet };
+};
+
+exports.useStepUpAuthentication = useStepUpAuthentication;

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

@@ -0,0 +1,51 @@
+import type { OTPVerification } from '@dynamic-labs-sdk/client';
+import { TokenScope, VerifyResponse } from '@dynamic-labs/sdk-api-core';
+export type StepUpAuthenticationState = {
+    error: string | null;
+    isLoading: boolean;
+    otpVerification: OTPVerification | null;
+};
+export type VerifyOtpParams = {
+    requestedScopes?: TokenScope[];
+    verificationToken: string;
+};
+export type VerifyWalletParams = {
+    requestedScopes?: TokenScope[];
+};
+export type UseStepUpAuthenticationParams = {
+    credentialId?: string;
+};
+export type UseStepUpAuthenticationReturn = {
+    resetState: () => void;
+    sendOtp: () => Promise<OTPVerification | null>;
+    state: StepUpAuthenticationState;
+    verifyOtp: (params: VerifyOtpParams) => Promise<VerifyResponse | null>;
+    verifyWallet: (params: VerifyWalletParams) => Promise<void>;
+};
+/**
+ * Perform step-up authentication for an already-authenticated user via OTP.
+ *
+ * Automatically selects the first sign-in enabled email or SMS credential on
+ * the user, or targets a specific credential when `credentialId` is provided.
+ *
+ * @param params.credentialId - Optional id of a specific verified credential to
+ *   use. Must be an email or SMS credential. Defaults to the first sign-in
+ *   enabled email or SMS credential on the authenticated user.
+ *
+ * @returns `sendOtp` – sends the OTP to the resolved credential.
+ * @returns `verifyOtp` – verifies the OTP code supplied by the user.
+ * @returns `state` – current loading / error / otpVerification state.
+ * @returns `resetState` – resets state back to its initial value.
+ *
+ * @example
+ * ```tsx
+ * const { sendOtp, verifyOtp, state } = useStepUpAuthentication();
+ *
+ * // Step 1: send OTP
+ * await sendOtp();
+ *
+ * // Step 2: after the user enters the code
+ * const result = await verifyOtp({ verificationToken: '123456' });
+ * ```
+ */
+export declare const useStepUpAuthentication: ({ credentialId, }?: UseStepUpAuthenticationParams) => UseStepUpAuthenticationReturn;