@dynamic-labs/sdk-react-core 4.91.3 → 4.91.5

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

@@ -1,7 +1,7 @@
 'use client'
 import { __awaiter } from '../../../../../../_virtual/_tslib.js';
 import { useCallback, useMemo } from 'react';
-import { JwtVerifiedCredentialFormatEnum } from '@dynamic-labs/sdk-api-core';
+import { JwtVerifiedCredentialFormatEnum, ChainEnum } from '@dynamic-labs/sdk-api-core';
 import { DynamicError, EmbeddedWalletException, StorageService } from '@dynamic-labs/utils';
 import { isSessionKeyCompatibleWalletConnector } from '@dynamic-labs/wallet-connector-core';
 import '../../../../context/DynamicContext/useDynamicContext/useDynamicContext.js';
@@ -22,7 +22,7 @@ import '../../../constants/colors.js';
 import '../../../constants/values.js';
 import '../../../../shared/consts/index.js';
 import { findEmbeddedWalletFromVerifiedCredentials } from '../../../functions/findEmbeddedWalletFromVerifiedCredentials/findEmbeddedWalletFromVerifiedCredentials.js';
-import { findTurnkeyWalletByPrimaryChain } from '../../../functions/findTurnkeyWallet/findTurnkeyWallet.js';
+import { findTurnkeyWalletByPrimaryChain, findTurnkeyWalletByTargetChain, findFirstAvailableTurnkeyWallet } from '../../../functions/findTurnkeyWallet/findTurnkeyWallet.js';
 import '@dynamic-labs/multi-wallet';
 import 'react-international-phone';
 import { getUserWalletsFromVerifiedCredentials } from '../../../functions/getUserWalletsFromVerifiedCredentials/getUserWalletsFromVerifiedCredentials.js';
@@ -103,7 +103,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
     const createEmbeddedWallet = useCallback((chains, options) => __awaiter(void 0, void 0, void 0, function* () {
         var _f;
         if (!user) {
-            throw new DynamicError(USER_NOT_LOGGED_IN);
+            throw new DynamicError(USER_NOT_LOGGED_IN, 'user_not_logged_in');
         }
         const userWalletsCredentials = getUserWalletsFromVerifiedCredentials(user);
         const primaryChain = findPrimaryEmbeddedChain(projectSettings);
@@ -181,7 +181,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
     const createOrRestoreSession = useCallback((options) => __awaiter(void 0, void 0, void 0, function* () {
         var _l, _m, _o, _p, _q, _r, _s;
         if (!user) {
-            throw new DynamicError(USER_NOT_LOGGED_IN);
+            throw new DynamicError(USER_NOT_LOGGED_IN, 'user_not_logged_in');
         }
         const primaryConnector = primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.connector;
         if (primaryConnector &&
@@ -223,7 +223,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
             throw new DynamicError('User does not have a secure enclave wallet or a verified email', INVALID_WALLET_DATA);
         }
         if (!primaryWallet) {
-            throw new DynamicError('No primary wallet found');
+            throw new DynamicError('No primary wallet found', 'no_primary_wallet_found');
         }
         const primaryTurnkeyWalletId = getTurnkeyWalletId(primaryWallet.id, (user === null || user === void 0 ? void 0 : user.verifiedCredentials) || []);
         const organizationId = (_s = (_r = (_q = (_p = user === null || user === void 0 ? void 0 : user.verifiedCredentials) === null || _p === void 0 ? void 0 : _p.find(({ walletName, id }) => (walletName === null || walletName === void 0 ? void 0 : walletName.startsWith('turnkey')) && id === primaryTurnkeyWalletId)) === null || _q === void 0 ? void 0 : _q.walletProperties) === null || _r === void 0 ? void 0 : _r.turnkeySubOrganizationId) !== null && _s !== void 0 ? _s : undefined;
@@ -252,7 +252,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
     const createPasskey = useCallback((options) => __awaiter(void 0, void 0, void 0, function* () {
         var _t, _u;
         if (!user) {
-            throw new DynamicError(USER_NOT_LOGGED_IN);
+            throw new DynamicError(USER_NOT_LOGGED_IN, 'user_not_logged_in');
         }
         validateTurnkeyProviderEnabled(projectSettings);
         const turnkeyWallet = findTurnkeyWalletByPrimaryChain(walletConnectorOptions, (_t = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.embeddedWallets) === null || _t === void 0 ? void 0 : _t.chainConfigurations, user.verifiedCredentials);
@@ -290,7 +290,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
             walletId: turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.id,
         });
         if (!updatedUser) {
-            throw new DynamicError('Error completing passkey recovery');
+            throw new DynamicError('Error completing passkey recovery', 'completing_passkey_recovery');
         }
         return { attestation, challenge, displayName };
     }), [
@@ -306,7 +306,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
      */
     const getPasskeys = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
         if (!user) {
-            throw new DynamicError(USER_NOT_LOGGED_IN);
+            throw new DynamicError(USER_NOT_LOGGED_IN, 'user_not_logged_in');
         }
         const data = yield getUserPasskeys({
             environmentId: environmentId,
@@ -337,7 +337,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
     const revealEmbeddedWalletKey = useCallback((_v) => __awaiter(void 0, [_v], void 0, function* ({ type, htmlContainerId, }) {
         var _w, _x, _y, _z, _0, _1;
         if (!user) {
-            throw new DynamicError(USER_NOT_LOGGED_IN);
+            throw new DynamicError(USER_NOT_LOGGED_IN, 'user_not_logged_in');
         }
         yield cleanupExport({
             wallet: wallet,
@@ -401,14 +401,26 @@ const useSecureEnclaveEmbeddedWallet = () => {
     ]);
     /**
      * Sends a one-time code to the user so they can create a session or add a new passkey
+     * @param options - optional parameter to target a specific wallet by chain
      * @returns Promise<'code_sent'>
      */
-    const sendOneTimeCode = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
-        var _2, _3;
+    const sendOneTimeCode = useCallback((options) => __awaiter(void 0, void 0, void 0, function* () {
+        var _2, _3, _4, _5, _6;
         if (!user) {
-            throw new DynamicError(USER_NOT_LOGGED_IN);
+            throw new DynamicError(USER_NOT_LOGGED_IN, 'user_not_logged_in');
+        }
+        const chainConfigurations = (_2 = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.embeddedWallets) === null || _2 === void 0 ? void 0 : _2.chainConfigurations;
+        const primaryWalletIsTurnkey = (_3 = primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.connector) === null || _3 === void 0 ? void 0 : _3.key.startsWith('turnkey');
+        const primaryWalletChain = primaryWalletIsTurnkey
+            ? primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.chain
+            : undefined;
+        const primaryConfiguredChain = (_5 = (_4 = chainConfigurations === null || chainConfigurations === void 0 ? void 0 : chainConfigurations.find((chain) => chain.primary)) === null || _4 === void 0 ? void 0 : _4.name) !== null && _5 !== void 0 ? _5 : ChainEnum.Evm;
+        const targetChain = (options === null || options === void 0 ? void 0 : options.chainName) || primaryWalletChain || primaryConfiguredChain;
+        let targetTurnkeyWallet = findTurnkeyWalletByTargetChain(walletConnectorOptions, targetChain, user.verifiedCredentials);
+        if (!(options === null || options === void 0 ? void 0 : options.chainName) &&
+            (!targetTurnkeyWallet || !('id' in targetTurnkeyWallet))) {
+            targetTurnkeyWallet = findFirstAvailableTurnkeyWallet(walletConnectorOptions, chainConfigurations, user.verifiedCredentials);
         }
-        const targetTurnkeyWallet = findTurnkeyWalletByPrimaryChain(walletConnectorOptions, (_2 = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.embeddedWallets) === null || _2 === void 0 ? void 0 : _2.chainConfigurations, user.verifiedCredentials);
         if (!targetTurnkeyWallet || !('id' in targetTurnkeyWallet)) {
             throw new DynamicError('User does not have a valid secure enclave wallet', INVALID_WALLET_DATA);
         }
@@ -419,9 +431,9 @@ const useSecureEnclaveEmbeddedWallet = () => {
             throw new DynamicError('Session is active. No need to create a new one', ACTIVE_SESSION);
         }
         const turnkeyAuthIframeContainerRef = createRootElement(iframeContainerId);
-        const publicKey = yield turnkeyAuthenticatorHandler.initRecovery('email', turnkeyAuthIframeContainerRef.current, iframeElementId, getEmbeddedWalletSessionExpiration((_3 = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.embeddedWallets) === null || _3 === void 0 ? void 0 : _3.sessionKeyDuration));
+        const publicKey = yield turnkeyAuthenticatorHandler.initRecovery('email', turnkeyAuthIframeContainerRef.current, iframeElementId, getEmbeddedWalletSessionExpiration((_6 = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.embeddedWallets) === null || _6 === void 0 ? void 0 : _6.sessionKeyDuration));
         if (!publicKey) {
-            throw new DynamicError(ERROR_SENDING_CODE);
+            throw new DynamicError(ERROR_SENDING_CODE, 'error_sending_code');
         }
         const response = yield initEmbeddedWalletSession({
             authenticatorType: 'email',
@@ -433,6 +445,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
         return CODE_SENT;
     }), [
         createRootElement,
+        primaryWallet,
         user,
         environmentId,
         projectSettings,

package/src/lib/utils/hooks/useFundWithWallet/useConnectWalletForFunding/useConnectWalletForFunding.cjs

@@ -24,7 +24,7 @@ const useConnectWalletForFunding = () => {
     const { initiatedByWidgetRef, getWalletAddress, resetWalletConnectSession } = useFundingHelpers.useFundingHelpers();
     const connectWalletPromiseRef = React.useRef(null);
     useDynamicEvents.useInternalDynamicEvents('authFlowClose', () => {
-        rejectPromiseRef.rejectPromiseRef(connectWalletPromiseRef, new utils.DynamicError('User cancelled'));
+        rejectPromiseRef.rejectPromiseRef(connectWalletPromiseRef, new utils.DynamicError('User cancelled', 'user_cancelled'));
     });
     const openWalletList = React.useCallback((initiatedByWidget) => {
         const onSelectWallet = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ walletConnector, }) {
@@ -35,7 +35,7 @@ const useConnectWalletForFunding = () => {
                 initiatedByWidgetRef.current = initiatedByWidget;
                 const walletAddress = yield getWalletAddress(walletConnector);
                 if (!walletAddress) {
-                    rejectPromiseRef.rejectPromiseRef(connectWalletPromiseRef, new utils.DynamicError('No wallet address found'));
+                    rejectPromiseRef.rejectPromiseRef(connectWalletPromiseRef, new utils.DynamicError('No wallet address found', 'no_wallet_address_found'));
                     return;
                 }
                 if (walletAddress === (primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.address)) {

package/src/lib/utils/hooks/useFundWithWallet/useConnectWalletForFunding/useConnectWalletForFunding.js

@@ -20,7 +20,7 @@ const useConnectWalletForFunding = () => {
     const { initiatedByWidgetRef, getWalletAddress, resetWalletConnectSession } = useFundingHelpers();
     const connectWalletPromiseRef = useRef(null);
     useInternalDynamicEvents('authFlowClose', () => {
-        rejectPromiseRef(connectWalletPromiseRef, new DynamicError('User cancelled'));
+        rejectPromiseRef(connectWalletPromiseRef, new DynamicError('User cancelled', 'user_cancelled'));
     });
     const openWalletList = useCallback((initiatedByWidget) => {
         const onSelectWallet = (_a) => __awaiter(void 0, [_a], void 0, function* ({ walletConnector, }) {
@@ -31,7 +31,7 @@ const useConnectWalletForFunding = () => {
                 initiatedByWidgetRef.current = initiatedByWidget;
                 const walletAddress = yield getWalletAddress(walletConnector);
                 if (!walletAddress) {
-                    rejectPromiseRef(connectWalletPromiseRef, new DynamicError('No wallet address found'));
+                    rejectPromiseRef(connectWalletPromiseRef, new DynamicError('No wallet address found', 'no_wallet_address_found'));
                     return;
                 }
                 if (walletAddress === (primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.address)) {

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

@@ -27,7 +27,7 @@ const useFundingHelpers = () => {
         utils.StorageService.setItem(utils.PHANTOM_REDIRECT_CONNECTION_TYPE_KEY, connectionType);
         const address = yield props.walletConnector.getAddress(props.getAddressOpts);
         if (!address) {
-            rejectPromiseRef.rejectPromiseRef(internalConnectionPromiseRef, new utils.DynamicError('No wallet address found'));
+            rejectPromiseRef.rejectPromiseRef(internalConnectionPromiseRef, new utils.DynamicError('No wallet address found', 'no_wallet_address_found'));
             return;
         }
         resolvePromiseRef.resolvePromiseRef(internalConnectionPromiseRef, address);
@@ -43,7 +43,7 @@ const useFundingHelpers = () => {
         var _a;
         const walletOption = walletOptions$1.find(({ key }) => key === walletConnector.key);
         if (!walletOption) {
-            return Promise.reject(new utils.DynamicError(`Connect wallet for funding error: wallet option for ${walletConnector.key} not found`));
+            return Promise.reject(new utils.DynamicError(`Connect wallet for funding error: wallet option for ${walletConnector.key} not found`, 'wallet_option_not_found'));
         }
         internalConnectionPromiseRef.current = new utils.DeferredPromise();
         handleWalletItemClick(Object.assign(Object.assign({}, walletOption), { group: (_a = walletOption.group) !== null && _a !== void 0 ? _a : undefined, walletConnector }));

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

@@ -23,7 +23,7 @@ const useFundingHelpers = () => {
         StorageService.setItem(PHANTOM_REDIRECT_CONNECTION_TYPE_KEY, connectionType);
         const address = yield props.walletConnector.getAddress(props.getAddressOpts);
         if (!address) {
-            rejectPromiseRef(internalConnectionPromiseRef, new DynamicError('No wallet address found'));
+            rejectPromiseRef(internalConnectionPromiseRef, new DynamicError('No wallet address found', 'no_wallet_address_found'));
             return;
         }
         resolvePromiseRef(internalConnectionPromiseRef, address);
@@ -39,7 +39,7 @@ const useFundingHelpers = () => {
         var _a;
         const walletOption = walletOptions.find(({ key }) => key === walletConnector.key);
         if (!walletOption) {
-            return Promise.reject(new DynamicError(`Connect wallet for funding error: wallet option for ${walletConnector.key} not found`));
+            return Promise.reject(new DynamicError(`Connect wallet for funding error: wallet option for ${walletConnector.key} not found`, 'wallet_option_not_found'));
         }
         internalConnectionPromiseRef.current = new DeferredPromise();
         handleWalletItemClick(Object.assign(Object.assign({}, walletOption), { group: (_a = walletOption.group) !== null && _a !== void 0 ? _a : undefined, walletConnector }));

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

@@ -93,7 +93,7 @@ const useGetMfaToken = () => {
             }
             const errorMessage = `MFA Token required for this action: ${mfaAction}`;
             logger.logger.error(errorMessage, error);
-            throw new utils.DynamicError(errorMessage);
+            throw new utils.DynamicError(errorMessage, 'mfa_token_required');
         }
     }), [shouldConsumeMfaToken]);
 };

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

@@ -89,7 +89,7 @@ const useGetMfaToken = () => {
             }
             const errorMessage = `MFA Token required for this action: ${mfaAction}`;
             logger.error(errorMessage, error);
-            throw new DynamicError(errorMessage);
+            throw new DynamicError(errorMessage, 'mfa_token_required');
         }
     }), [shouldConsumeMfaToken]);
 };

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

@@ -50,10 +50,10 @@ const useSignEip7702Authorization = () => {
         // 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.');
+            throw new utils.DynamicError('No wallet available. Please connect a wallet first.', 'no_wallet_available');
         }
         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.');
+            throw new utils.DynamicError('The wallet connector must be a ZeroDev connector to sign EIP-7702 authorizations.', 'invalid_connector_for_eip7702');
         }
         return wallet.connector.signEip7702PreAuth(providedChainId);
     }), [primaryWallet]);

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

@@ -46,10 +46,10 @@ const useSignEip7702Authorization = () => {
         // 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.');
+            throw new DynamicError('No wallet available. Please connect a wallet first.', 'no_wallet_available');
         }
         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.');
+            throw new DynamicError('The wallet connector must be a ZeroDev connector to sign EIP-7702 authorizations.', 'invalid_connector_for_eip7702');
         }
         return wallet.connector.signEip7702PreAuth(providedChainId);
     }), [primaryWallet]);

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

@@ -455,11 +455,11 @@ const useSocialAuth = ({ onSettled, onError, onFarcasterUrl, }) => {
     const checkCaptchaAndConnect = React.useCallback((props) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         var _m;
         if (props.authMode === 'signin' && client.getDynamicClient().user) {
-            throw new utils.DynamicError('User is already logged in');
+            throw new utils.DynamicError('User is already logged in', 'user_is_already_logged_in');
         }
         else if ((props.authMode === 'link' || props.authMode === 'stepup') &&
             !client.getDynamicClient().user) {
-            throw new utils.DynamicError('User is not logged in');
+            throw new utils.DynamicError('User is not logged in', 'user_is_not_logged_in');
         }
         if (!((_m = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.security.hCaptcha) === null || _m === void 0 ? void 0 : _m.enabled)) {
             yield connectSocialAccount(props);

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

@@ -451,11 +451,11 @@ const useSocialAuth = ({ onSettled, onError, onFarcasterUrl, }) => {
     const checkCaptchaAndConnect = useCallback((props) => __awaiter(void 0, void 0, void 0, function* () {
         var _m;
         if (props.authMode === 'signin' && getDynamicClient().user) {
-            throw new DynamicError('User is already logged in');
+            throw new DynamicError('User is already logged in', 'user_is_already_logged_in');
         }
         else if ((props.authMode === 'link' || props.authMode === 'stepup') &&
             !getDynamicClient().user) {
-            throw new DynamicError('User is not logged in');
+            throw new DynamicError('User is not logged in', 'user_is_not_logged_in');
         }
         if (!((_m = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.security.hCaptcha) === null || _m === void 0 ? void 0 : _m.enabled)) {
             yield connectSocialAccount(props);

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

@@ -58,7 +58,7 @@ const useTransferWallet = () => {
     }, [primaryWallet]);
     return React.useCallback((props) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         if (!user)
-            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN);
+            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN, 'user_not_logged_in');
         const { overrideSiweStatement, walletConnector } = props;
         const args = Object.assign(Object.assign({}, props), { displaySiweStatement,
             environmentId, siweStatement: overrideSiweStatement, walletProvider: walletConnectorCore.getWalletProvider(walletConnector) });
@@ -76,7 +76,7 @@ const useTransferWallet = () => {
         }
         const userProfile = yield wallets.transferWallet(environmentId, verifyArgs);
         if (!userProfile) {
-            throw new utils.DynamicError('Error transferring wallet.');
+            throw new utils.DynamicError('Error transferring wallet.', 'transferring_wallet');
         }
         updatePrimaryWallet(walletConnector, userProfile);
         const walletId = userProfile.lastVerifiedCredentialId;

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

@@ -54,7 +54,7 @@ const useTransferWallet = () => {
     }, [primaryWallet]);
     return useCallback((props) => __awaiter(void 0, void 0, void 0, function* () {
         if (!user)
-            throw new DynamicError(USER_NOT_LOGGED_IN);
+            throw new DynamicError(USER_NOT_LOGGED_IN, 'user_not_logged_in');
         const { overrideSiweStatement, walletConnector } = props;
         const args = Object.assign(Object.assign({}, props), { displaySiweStatement,
             environmentId, siweStatement: overrideSiweStatement, walletProvider: getWalletProvider(walletConnector) });
@@ -72,7 +72,7 @@ const useTransferWallet = () => {
         }
         const userProfile = yield transferWallet(environmentId, verifyArgs);
         if (!userProfile) {
-            throw new DynamicError('Error transferring wallet.');
+            throw new DynamicError('Error transferring wallet.', 'transferring_wallet');
         }
         updatePrimaryWallet(walletConnector, userProfile);
         const walletId = userProfile.lastVerifiedCredentialId;

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

@@ -63,14 +63,14 @@ const useUpgradeEmbeddedWallet = () => {
     const upgradeEmbeddedWallet = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         var _a, _b, _c, _d;
         if (!user)
-            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN);
+            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN, 'user_not_logged_in');
         const userHasV2EmbeddedWallet = user.verifiedCredentials.some((credential) => { var _a; return ((_a = credential.walletProperties) === null || _a === void 0 ? void 0 : _a.version) === sdkApiCore.EmbeddedWalletVersionEnum.V2; });
         if (userHasV2EmbeddedWallet) {
-            throw new utils.DynamicError(errors.USER_HAS_V2_EMBEDDED_WALLET);
+            throw new utils.DynamicError(errors.USER_HAS_V2_EMBEDDED_WALLET, 'user_has_v2_embedded_wallet');
         }
         const requiredSessionKey = shouldRegisterSessionKeysOnSignin();
         if (!requiredSessionKey) {
-            throw new utils.DynamicError(errors.INCOMPATIBLE_SDK_VERSION);
+            throw new utils.DynamicError(errors.INCOMPATIBLE_SDK_VERSION, 'incompatible_sdk_version');
         }
         const sessionPublicKey = getSessionPublicKey();
         const verifyResponse = yield wallets.upgradeEmbeddedWalletToV2({

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

@@ -59,14 +59,14 @@ const useUpgradeEmbeddedWallet = () => {
     const upgradeEmbeddedWallet = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
         var _a, _b, _c, _d;
         if (!user)
-            throw new DynamicError(USER_NOT_LOGGED_IN);
+            throw new DynamicError(USER_NOT_LOGGED_IN, 'user_not_logged_in');
         const userHasV2EmbeddedWallet = user.verifiedCredentials.some((credential) => { var _a; return ((_a = credential.walletProperties) === null || _a === void 0 ? void 0 : _a.version) === EmbeddedWalletVersionEnum.V2; });
         if (userHasV2EmbeddedWallet) {
-            throw new DynamicError(USER_HAS_V2_EMBEDDED_WALLET);
+            throw new DynamicError(USER_HAS_V2_EMBEDDED_WALLET, 'user_has_v2_embedded_wallet');
         }
         const requiredSessionKey = shouldRegisterSessionKeysOnSignin();
         if (!requiredSessionKey) {
-            throw new DynamicError(INCOMPATIBLE_SDK_VERSION);
+            throw new DynamicError(INCOMPATIBLE_SDK_VERSION, 'incompatible_sdk_version');
         }
         const sessionPublicKey = getSessionPublicKey();
         const verifyResponse = yield upgradeEmbeddedWalletToV2({

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

@@ -157,7 +157,7 @@ const useUserAuth = ({ authMethod, }) => {
             const verifyResponse = yield verifyFunction();
             if (!verifyResponse) {
                 yield cancelAuth();
-                throw new utils.DynamicError('No user returned from verify function');
+                throw new utils.DynamicError('No user returned from verify function', 'no_user_returned_from_verify_function');
             }
             let verifiedUser;
             if (isVerifyResponse(verifyResponse)) {

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

@@ -153,7 +153,7 @@ const useUserAuth = ({ authMethod, }) => {
             const verifyResponse = yield verifyFunction();
             if (!verifyResponse) {
                 yield cancelAuth();
-                throw new DynamicError('No user returned from verify function');
+                throw new DynamicError('No user returned from verify function', 'no_user_returned_from_verify_function');
             }
             let verifiedUser;
             if (isVerifyResponse(verifyResponse)) {

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

@@ -89,7 +89,7 @@ const useUserDataForm = ({ onSubmit, onError, userProfile, shouldEnforcePolicies
             return;
         try {
             if (!(userProfile === null || userProfile === void 0 ? void 0 : userProfile.environmentId))
-                throw new utils.DynamicError('Invalid environment ID');
+                throw new utils.DynamicError('Invalid environment ID', 'invalid_environment_id');
             setFetch(true);
             let updatedUserFields = values;
             // all kyc fields including custom are in the object, move custom fields to the object.metadata

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

@@ -85,7 +85,7 @@ const useUserDataForm = ({ onSubmit, onError, userProfile, shouldEnforcePolicies
             return;
         try {
             if (!(userProfile === null || userProfile === void 0 ? void 0 : userProfile.environmentId))
-                throw new DynamicError('Invalid environment ID');
+                throw new DynamicError('Invalid environment ID', 'invalid_environment_id');
             setFetch(true);
             let updatedUserFields = values;
             // all kyc fields including custom are in the object, move custom fields to the object.metadata

package/src/lib/utils/hooks/useUserUpdateRequest/unlinkUserEmail/unlinkUserEmail.cjs

@@ -20,14 +20,14 @@ const useUnlinkUserEmail = () => {
         const user$1 = (_b = client.getDynamicClient()) === null || _b === void 0 ? void 0 : _b.user;
         const primaryWalletId$1 = primaryWalletId.getPrimaryWalletId();
         if (!primaryWalletId$1) {
-            throw new utils.DynamicError('Primary wallet not found');
+            throw new utils.DynamicError('Primary wallet not found', 'primary_wallet_not_found');
         }
         const verifiedCredential = user$1 === null || user$1 === void 0 ? void 0 : user$1.verifiedCredentials.find((credential) => credential.id === verifiedCredentialId);
         if (!verifiedCredential) {
-            throw new utils.DynamicError('Verified credential not found');
+            throw new utils.DynamicError('Verified credential not found', 'verified_credential_not_found');
         }
         if (verifiedCredential.format !== sdkApiCore.JwtVerifiedCredentialFormatEnum.Email) {
-            throw new utils.DynamicError('Verified credential is not an email');
+            throw new utils.DynamicError('Verified credential is not an email', 'verified_credential_is_not_an_email');
         }
         return user.unlinkEmail({
             environmentId,

package/src/lib/utils/hooks/useUserUpdateRequest/unlinkUserEmail/unlinkUserEmail.js

@@ -16,14 +16,14 @@ const useUnlinkUserEmail = () => {
         const user = (_b = getDynamicClient()) === null || _b === void 0 ? void 0 : _b.user;
         const primaryWalletId = getPrimaryWalletId();
         if (!primaryWalletId) {
-            throw new DynamicError('Primary wallet not found');
+            throw new DynamicError('Primary wallet not found', 'primary_wallet_not_found');
         }
         const verifiedCredential = user === null || user === void 0 ? void 0 : user.verifiedCredentials.find((credential) => credential.id === verifiedCredentialId);
         if (!verifiedCredential) {
-            throw new DynamicError('Verified credential not found');
+            throw new DynamicError('Verified credential not found', 'verified_credential_not_found');
         }
         if (verifiedCredential.format !== JwtVerifiedCredentialFormatEnum.Email) {
-            throw new DynamicError('Verified credential is not an email');
+            throw new DynamicError('Verified credential is not an email', 'verified_credential_is_not_an_email');
         }
         return unlinkEmail({
             environmentId,

package/src/lib/utils/hooks/useUserUpdateRequest/useUpdateUserWithModal/useUpdateUserWithModal.cjs

@@ -56,7 +56,7 @@ const useUpdateUserWithModal = (updateUser) => {
     const { pushView } = ViewContext.useViewContext();
     const editorContext = React.useContext(UserFieldEditorContext.UserFieldEditorContext);
     if (!editorContext)
-        throw new utils.DynamicError('useUserUpdateRequest can only be used inside the context of DynamicContextProvider');
+        throw new utils.DynamicError('useUserUpdateRequest can only be used inside the context of DynamicContextProvider', 'missing_dynamic_context');
     const { open: promptUserForValues } = editorContext;
     const updateUserWithModal = React.useCallback((fields, options) => new Promise((resolve, reject) => {
         // Catch invalid requests

package/src/lib/utils/hooks/useUserUpdateRequest/useUpdateUserWithModal/useUpdateUserWithModal.js

@@ -52,7 +52,7 @@ const useUpdateUserWithModal = (updateUser) => {
     const { pushView } = useViewContext();
     const editorContext = useContext(UserFieldEditorContext);
     if (!editorContext)
-        throw new DynamicError('useUserUpdateRequest can only be used inside the context of DynamicContextProvider');
+        throw new DynamicError('useUserUpdateRequest can only be used inside the context of DynamicContextProvider', 'missing_dynamic_context');
     const { open: promptUserForValues } = editorContext;
     const updateUserWithModal = useCallback((fields, options) => new Promise((resolve, reject) => {
         // Catch invalid requests

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

@@ -279,7 +279,7 @@ const useVerifyWallet = ({ displaySiweStatement, environmentId, projectSettings,
         }
         const authMode$1 = authMode.getAuthMode();
         if (connectedWallets.length && authMode$1 === 'connect-only') {
-            throw new utils.DynamicError(e.message);
+            throw new utils.DynamicError(e.message, 'unknown');
         }
         const userRejectedRequestError = (_a = e === null || e === void 0 ? void 0 : e.message) === null || _a === void 0 ? void 0 : _a.includes('User rejected the request');
         const fallbackToConnectOnly = shouldFallbackToConnectOnly && !userRejectedRequestError;
@@ -323,7 +323,7 @@ const useVerifyWallet = ({ displaySiweStatement, environmentId, projectSettings,
                 onVerifySuccess: (user) => {
                     var _a;
                     if (!user) {
-                        throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN);
+                        throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN, 'user_not_logged_in');
                     }
                     try {
                         (_a = events === null || events === void 0 ? void 0 : events.onSignedMessage) === null || _a === void 0 ? void 0 : _a.call(events, {

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

@@ -275,7 +275,7 @@ const useVerifyWallet = ({ displaySiweStatement, environmentId, projectSettings,
         }
         const authMode = getAuthMode();
         if (connectedWallets.length && authMode === 'connect-only') {
-            throw new DynamicError(e.message);
+            throw new DynamicError(e.message, 'unknown');
         }
         const userRejectedRequestError = (_a = e === null || e === void 0 ? void 0 : e.message) === null || _a === void 0 ? void 0 : _a.includes('User rejected the request');
         const fallbackToConnectOnly = shouldFallbackToConnectOnly && !userRejectedRequestError;
@@ -319,7 +319,7 @@ const useVerifyWallet = ({ displaySiweStatement, environmentId, projectSettings,
                 onVerifySuccess: (user) => {
                     var _a;
                     if (!user) {
-                        throw new DynamicError(USER_NOT_LOGGED_IN);
+                        throw new DynamicError(USER_NOT_LOGGED_IN, 'user_not_logged_in');
                     }
                     try {
                         (_a = events === null || events === void 0 ? void 0 : events.onSignedMessage) === null || _a === void 0 ? void 0 : _a.call(events, {

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

@@ -1,9 +1,13 @@
-export declare const useViewSettings: <T extends import("@dynamic-labs/sdk-api-core").SdkViewType | "wallet-list", R extends Extract<import("@dynamic-labs/sdk-api-core").SdkView, {
+export declare const useViewSettings: <T extends import("@dynamic-labs/sdk-api-core").SdkViewType | "wallet-list" | "transaction-confirmation", R extends Extract<import("@dynamic-labs/sdk-api-core").SdkView, {
     type: T;
 }> | Extract<import("../../../context/DynamicContext/types").WalletListViewSettings, {
     type: T;
+}> | Extract<import("../../../context/DynamicContext/types").TransactionConfirmationViewSettings, {
+    type: T;
 }> | undefined = Extract<import("@dynamic-labs/sdk-api-core").SdkView, {
     type: T;
 }> | Extract<import("../../../context/DynamicContext/types").WalletListViewSettings, {
     type: T;
+}> | Extract<import("../../../context/DynamicContext/types").TransactionConfirmationViewSettings, {
+    type: T;
 }> | undefined>(viewType: T) => R;

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

@@ -94,7 +94,7 @@ const useWalletConnectors = ({ connectedWallets, walletConnectorOptions, setMult
     const getSelectedWallet = React.useCallback((walletId) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         const newWallet = wallets.find(({ id }) => id === walletId);
         if (!newWallet) {
-            throw new utils.DynamicError(`Wallet with id: ${walletId} not found`);
+            throw new utils.DynamicError(`Wallet with id: ${walletId} not found`, 'wallet_with_id_not_found');
         }
         return newWallet;
     }), [wallets]);

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

@@ -90,7 +90,7 @@ const useWalletConnectors = ({ connectedWallets, walletConnectorOptions, setMult
     const getSelectedWallet = useCallback((walletId) => __awaiter(void 0, void 0, void 0, function* () {
         const newWallet = wallets.find(({ id }) => id === walletId);
         if (!newWallet) {
-            throw new DynamicError(`Wallet with id: ${walletId} not found`);
+            throw new DynamicError(`Wallet with id: ${walletId} not found`, 'wallet_with_id_not_found');
         }
         return newWallet;
     }), [wallets]);

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

@@ -111,7 +111,7 @@ const useWalletOptions = () => {
             const errorMessage = chain
                 ? `No wallet found with key "${walletKey}" for chain "${chain}".`
                 : `No wallet found with key "${walletKey}".`;
-            reject(new utils.DynamicError(errorMessage));
+            reject(new utils.DynamicError(errorMessage, 'wallet_not_found'));
             return;
         }
         addListenersToHandleWalletSelectionPromise({

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

@@ -107,7 +107,7 @@ const useWalletOptions = () => {
             const errorMessage = chain
                 ? `No wallet found with key "${walletKey}" for chain "${chain}".`
                 : `No wallet found with key "${walletKey}".`;
-            reject(new DynamicError(errorMessage));
+            reject(new DynamicError(errorMessage, 'wallet_not_found'));
             return;
         }
         addListenersToHandleWalletSelectionPromise({

package/src/lib/views/BridgeNextWalletConnectionView/BridgeNextWalletConnectionView.cjs

@@ -24,7 +24,7 @@ const BridgeNextWalletConnectionView = () => {
     const { setShowAuthFlow, bridgeChainsToConnect } = useInternalDynamicContext.useInternalDynamicContext();
     const { pushView } = ViewContext.useViewContext();
     if (!(bridgeChainsToConnect === null || bridgeChainsToConnect === void 0 ? void 0 : bridgeChainsToConnect.length)) {
-        throw new utils.DynamicError('No wallets to connect');
+        throw new utils.DynamicError('No wallets to connect', 'no_wallets_to_connect');
     }
     const [nextWalletToConnect] = bridgeChainsToConnect;
     const { chain } = nextWalletToConnect;

package/src/lib/views/BridgeNextWalletConnectionView/BridgeNextWalletConnectionView.js

@@ -20,7 +20,7 @@ const BridgeNextWalletConnectionView = () => {
     const { setShowAuthFlow, bridgeChainsToConnect } = useInternalDynamicContext();
     const { pushView } = useViewContext();
     if (!(bridgeChainsToConnect === null || bridgeChainsToConnect === void 0 ? void 0 : bridgeChainsToConnect.length)) {
-        throw new DynamicError('No wallets to connect');
+        throw new DynamicError('No wallets to connect', 'no_wallets_to_connect');
     }
     const [nextWalletToConnect] = bridgeChainsToConnect;
     const { chain } = nextWalletToConnect;

package/src/lib/views/EmbeddedReveal/utils/turnkeyExport/turnkeyExport.cjs

@@ -59,7 +59,7 @@ const initExport = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ i
 const handleExportInitCheck = ({ user, wallet, }) => {
     var _a, _b, _c, _d, _e;
     if (!user) {
-        throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN);
+        throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN, 'user_not_logged_in');
     }
     if (!(wallet === null || wallet === void 0 ? void 0 : wallet.connector) ||
         !(wallet === null || wallet === void 0 ? void 0 : wallet.id) ||
@@ -74,7 +74,7 @@ const handleExportInitCheck = ({ user, wallet, }) => {
     const organizationId = (_e = walletProperties === null || walletProperties === void 0 ? void 0 : walletProperties.turnkeySubOrganizationId) !== null && _e !== void 0 ? _e : undefined;
     if (!organizationId ||
         (turnkeyHDWalletId === undefined && privateKeyId === undefined)) {
-        throw new utils.DynamicError('Invalid token!');
+        throw new utils.DynamicError('Invalid token!', 'invalid_token');
     }
     return {
         connector,