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

package/src/lib/utils/functions/getTransactionLink/getTransactionLink.cjs

@@ -4,9 +4,11 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _tslib = require('../../../../../_virtual/_tslib.cjs');
+var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
 var blockExplorerPatterns = require('./blockExplorerPatterns.cjs');
 
-const getTransactionLink = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ walletConnector, transactionHash, }) {
+const USER_OP_PATH_PREFIX = '/op/';
+const getTransactionLink = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ walletConnector, transactionHash, userOpSupportedExplorers, }) {
     try {
         if (!walletConnector) {
             return undefined;
@@ -14,6 +16,16 @@ const getTransactionLink = (_a) => _tslib.__awaiter(void 0, [_a], void 0, functi
         const [blockExplorerUrl] = yield walletConnector.getBlockExplorerUrlsForCurrentNetwork();
         if (!blockExplorerUrl)
             return undefined;
+        // AA connectors (e.g. ZeroDev) return a userOp hash, which should
+        // link to /op/{hash} on supported block explorers instead of /tx/{hash}.
+        // Not all block explorers support the /op/ route, so we check against
+        // a known list plus any customer-provided overrides.
+        if (walletConnectorCore.isAccountAbstractionConnector(walletConnector) &&
+            blockExplorerPatterns.supportsUserOpPath(blockExplorerUrl, userOpSupportedExplorers)) {
+            const url = new URL(blockExplorerUrl);
+            url.pathname = `${USER_OP_PATH_PREFIX}${transactionHash}`;
+            return url.toString();
+        }
         // Find the appropriate pattern for this block explorer
         const pattern = blockExplorerPatterns.findBlockExplorerPattern(blockExplorerUrl);
         // Generate the transaction URL using the pattern

package/src/lib/utils/functions/getTransactionLink/getTransactionLink.d.ts

@@ -1,5 +1,6 @@
 import { WalletConnector } from '@dynamic-labs/wallet-connector-core';
-export declare const getTransactionLink: ({ walletConnector, transactionHash, }: {
+export declare const getTransactionLink: ({ walletConnector, transactionHash, userOpSupportedExplorers, }: {
     walletConnector?: WalletConnector;
     transactionHash: string;
+    userOpSupportedExplorers?: string[];
 }) => Promise<string | undefined>;

package/src/lib/utils/functions/getTransactionLink/getTransactionLink.js

@@ -1,8 +1,10 @@
 'use client'
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
-import { findBlockExplorerPattern } from './blockExplorerPatterns.js';
+import { isAccountAbstractionConnector } from '@dynamic-labs/wallet-connector-core';
+import { supportsUserOpPath, findBlockExplorerPattern } from './blockExplorerPatterns.js';
 
-const getTransactionLink = (_a) => __awaiter(void 0, [_a], void 0, function* ({ walletConnector, transactionHash, }) {
+const USER_OP_PATH_PREFIX = '/op/';
+const getTransactionLink = (_a) => __awaiter(void 0, [_a], void 0, function* ({ walletConnector, transactionHash, userOpSupportedExplorers, }) {
     try {
         if (!walletConnector) {
             return undefined;
@@ -10,6 +12,16 @@ const getTransactionLink = (_a) => __awaiter(void 0, [_a], void 0, function* ({
         const [blockExplorerUrl] = yield walletConnector.getBlockExplorerUrlsForCurrentNetwork();
         if (!blockExplorerUrl)
             return undefined;
+        // AA connectors (e.g. ZeroDev) return a userOp hash, which should
+        // link to /op/{hash} on supported block explorers instead of /tx/{hash}.
+        // Not all block explorers support the /op/ route, so we check against
+        // a known list plus any customer-provided overrides.
+        if (isAccountAbstractionConnector(walletConnector) &&
+            supportsUserOpPath(blockExplorerUrl, userOpSupportedExplorers)) {
+            const url = new URL(blockExplorerUrl);
+            url.pathname = `${USER_OP_PATH_PREFIX}${transactionHash}`;
+            return url.toString();
+        }
         // Find the appropriate pattern for this block explorer
         const pattern = findBlockExplorerPattern(blockExplorerUrl);
         // Generate the transaction URL using the pattern

package/src/lib/utils/hooks/authenticationHooks/useOtpVerificationRequest/useOtpVerificationRequest.cjs

@@ -129,11 +129,11 @@ const useOtpVerificationRequestRaw = () => {
     const verifyOtp = React.useCallback((handleVerificationRequired, verificationToken, destination, localVerificationUUID) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         var _a;
         if (!user && !userWithMissingInfo)
-            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN);
+            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN, 'user_not_logged_in');
         // VerificationUUID is saved in the context in case the view changes
         // after a profile update (changing the view from edit profile to verify email)
         if (!localVerificationUUID && !contextVerificationUUID)
-            throw new utils.DynamicError('No verification UUID is available');
+            throw new utils.DynamicError('No verification UUID is available', 'no_verification_uuid_is_available');
         const verificationUUID = (localVerificationUUID !== null && localVerificationUUID !== void 0 ? localVerificationUUID : contextVerificationUUID);
         const verify = destination === 'email' ? email.verifyEmail : sms.verifySms;
         const updateSelfResponse = yield verify({

package/src/lib/utils/hooks/authenticationHooks/useOtpVerificationRequest/useOtpVerificationRequest.js

@@ -125,11 +125,11 @@ const useOtpVerificationRequestRaw = () => {
     const verifyOtp = useCallback((handleVerificationRequired, verificationToken, destination, localVerificationUUID) => __awaiter(void 0, void 0, void 0, function* () {
         var _a;
         if (!user && !userWithMissingInfo)
-            throw new DynamicError(USER_NOT_LOGGED_IN);
+            throw new DynamicError(USER_NOT_LOGGED_IN, 'user_not_logged_in');
         // VerificationUUID is saved in the context in case the view changes
         // after a profile update (changing the view from edit profile to verify email)
         if (!localVerificationUUID && !contextVerificationUUID)
-            throw new DynamicError('No verification UUID is available');
+            throw new DynamicError('No verification UUID is available', 'no_verification_uuid_is_available');
         const verificationUUID = (localVerificationUUID !== null && localVerificationUUID !== void 0 ? localVerificationUUID : contextVerificationUUID);
         const verify = destination === 'email' ? verifyEmail : verifySms;
         const updateSelfResponse = yield verify({

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

@@ -120,10 +120,10 @@ const useAuthenticateConnectedUser = () => {
     const [isAuthenticating, setIsAuthenticating] = React.useState(false);
     const authenticateUser = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         if (user) {
-            throw new utils.DynamicError('User is already authenticated');
+            throw new utils.DynamicError('User is already authenticated', 'user_is_already_authenticated');
         }
         if (connectedWallets.length === 0) {
-            throw new utils.DynamicError('No connected wallet');
+            throw new utils.DynamicError('No connected wallet', 'no_connected_wallet');
         }
         const connectedWallet = connectedWallets[0];
         setIsAuthenticating(true);

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

@@ -116,10 +116,10 @@ const useAuthenticateConnectedUser = () => {
     const [isAuthenticating, setIsAuthenticating] = useState(false);
     const authenticateUser = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
         if (user) {
-            throw new DynamicError('User is already authenticated');
+            throw new DynamicError('User is already authenticated', 'user_is_already_authenticated');
         }
         if (connectedWallets.length === 0) {
-            throw new DynamicError('No connected wallet');
+            throw new DynamicError('No connected wallet', 'no_connected_wallet');
         }
         const connectedWallet = connectedWallets[0];
         setIsAuthenticating(true);

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

@@ -30,7 +30,7 @@ const useConfirmationPortal = ({ onResolve, onReject, defaultErrorMessage, }) =>
             return onResolve(successResponseRef.current);
         }
         const error = errorRef.current ||
-            new utils.DynamicError(defaultErrorMessage || 'Something went wrong');
+            new utils.DynamicError(defaultErrorMessage || 'Something went wrong', 'defaulterrormessage_something_went_wrong');
         return onReject(error);
     }, [onResolve, onReject, defaultErrorMessage]);
     const onSuccess = (response, closePortal = true) => {

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

@@ -26,7 +26,7 @@ const useConfirmationPortal = ({ onResolve, onReject, defaultErrorMessage, }) =>
             return onResolve(successResponseRef.current);
         }
         const error = errorRef.current ||
-            new DynamicError(defaultErrorMessage || 'Something went wrong');
+            new DynamicError(defaultErrorMessage || 'Something went wrong', 'defaulterrormessage_something_went_wrong');
         return onReject(error);
     }, [onResolve, onReject, defaultErrorMessage]);
     const onSuccess = (response, closePortal = true) => {

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

@@ -19,7 +19,7 @@ const useConnectExchangeForFunding = () => {
     const { selectExchangeConfig } = useFundingExchangeHelpers.useFundingExchangeHelpers();
     const promiseRef = React.useRef(null);
     useDynamicEvents.useInternalDynamicEvents('authFlowClose', () => {
-        rejectPromiseRef.rejectPromiseRef(promiseRef, new utils.DynamicError('User cancelled'));
+        rejectPromiseRef.rejectPromiseRef(promiseRef, new utils.DynamicError('User cancelled', 'user_cancelled'));
     });
     return React.useCallback((_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ initiatedByWidget }) {
         if (promiseRef.current)

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

@@ -15,7 +15,7 @@ const useConnectExchangeForFunding = () => {
     const { selectExchangeConfig } = useFundingExchangeHelpers();
     const promiseRef = useRef(null);
     useInternalDynamicEvents('authFlowClose', () => {
-        rejectPromiseRef(promiseRef, new DynamicError('User cancelled'));
+        rejectPromiseRef(promiseRef, new DynamicError('User cancelled', 'user_cancelled'));
     });
     return useCallback((_a) => __awaiter(void 0, [_a], void 0, function* ({ initiatedByWidget }) {
         if (promiseRef.current)

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

@@ -24,7 +24,7 @@ const useConnectUnifiedForFunding = () => {
     const { selectExchangeConfig } = useFundingExchangeHelpers.useFundingExchangeHelpers();
     const promiseRef = React.useRef(null);
     useDynamicEvents.useInternalDynamicEvents('authFlowClose', () => {
-        rejectPromiseRef.rejectPromiseRef(promiseRef, new utils.DynamicError('User cancelled'));
+        rejectPromiseRef.rejectPromiseRef(promiseRef, new utils.DynamicError('User cancelled', 'user_cancelled'));
     });
     const openList = React.useCallback((initiatedByWidget) => {
         const { onSelectExchange } = selectExchangeConfig({
@@ -61,7 +61,7 @@ const useConnectUnifiedForFunding = () => {
                     initiatedByWidgetRef.current = initiatedByWidget;
                     const walletAddress = yield getWalletAddress(walletConnector);
                     if (!walletAddress) {
-                        rejectPromiseRef.rejectPromiseRef(promiseRef, new utils.DynamicError('No wallet address found'));
+                        rejectPromiseRef.rejectPromiseRef(promiseRef, new utils.DynamicError('No wallet address found', 'no_wallet_address_found'));
                         return;
                     }
                     const wallet = walletConnector.createWallet({

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

@@ -20,7 +20,7 @@ const useConnectUnifiedForFunding = () => {
     const { selectExchangeConfig } = useFundingExchangeHelpers();
     const promiseRef = useRef(null);
     useInternalDynamicEvents('authFlowClose', () => {
-        rejectPromiseRef(promiseRef, new DynamicError('User cancelled'));
+        rejectPromiseRef(promiseRef, new DynamicError('User cancelled', 'user_cancelled'));
     });
     const openList = useCallback((initiatedByWidget) => {
         const { onSelectExchange } = selectExchangeConfig({
@@ -57,7 +57,7 @@ const useConnectUnifiedForFunding = () => {
                     initiatedByWidgetRef.current = initiatedByWidget;
                     const walletAddress = yield getWalletAddress(walletConnector);
                     if (!walletAddress) {
-                        rejectPromiseRef(promiseRef, new DynamicError('No wallet address found'));
+                        rejectPromiseRef(promiseRef, new DynamicError('No wallet address found', 'no_wallet_address_found'));
                         return;
                     }
                     const wallet = walletConnector.createWallet({

package/src/lib/utils/hooks/useConnectWallet/HandleConnectWalletRejectionError.cjs

@@ -7,7 +7,7 @@ var utils = require('@dynamic-labs/utils');
 
 class HandleConnectWalletRejectionError extends utils.DynamicError {
     constructor(walletConnector) {
-        super(`Connection was not established because handleConnectedWallet returned false for wallet connector ${walletConnector.key}`);
+        super(`Connection was not established because handleConnectedWallet returned false for wallet connector ${walletConnector.key}`, 'handle_connect_wallet_rejection');
         this.walletConnector = walletConnector;
     }
 }

package/src/lib/utils/hooks/useConnectWallet/HandleConnectWalletRejectionError.js

@@ -3,7 +3,7 @@ import { DynamicError } from '@dynamic-labs/utils';
 
 class HandleConnectWalletRejectionError extends DynamicError {
     constructor(walletConnector) {
-        super(`Connection was not established because handleConnectedWallet returned false for wallet connector ${walletConnector.key}`);
+        super(`Connection was not established because handleConnectedWallet returned false for wallet connector ${walletConnector.key}`, 'handle_connect_wallet_rejection');
         this.walletConnector = walletConnector;
     }
 }

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

@@ -66,7 +66,7 @@ const useCreateDynamicEmbeddedWalletMutation = () => {
         var _d, _e;
         setIsLoading(true);
         if (!user) {
-            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN);
+            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN, 'user_not_logged_in');
         }
         let sessionPublicKey;
         // get the session public key that was created in the login/signup flow

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

@@ -62,7 +62,7 @@ const useCreateDynamicEmbeddedWalletMutation = () => {
         var _d, _e;
         setIsLoading(true);
         if (!user) {
-            throw new DynamicError(USER_NOT_LOGGED_IN);
+            throw new DynamicError(USER_NOT_LOGGED_IN, 'user_not_logged_in');
         }
         let sessionPublicKey;
         // get the session public key that was created in the login/signup flow

package/src/lib/utils/hooks/useCreateWalletConnectorOptions/utils/errors/ConnectorSetupError.cjs

@@ -7,7 +7,7 @@ var utils = require('@dynamic-labs/utils');
 
 class ConnectorSetupError extends utils.DynamicError {
     constructor(providerName, connectorName) {
-        super(`${providerName} is enabled but ${connectorName} is not in your walletConnectors list. See https://docs.dynamic.xyz/react-sdk/wallet-connectors for more information.`);
+        super(`${providerName} is enabled but ${connectorName} is not in your walletConnectors list. See https://docs.dynamic.xyz/react-sdk/wallet-connectors for more information.`, 'connector_setup_error');
     }
 }
 

package/src/lib/utils/hooks/useCreateWalletConnectorOptions/utils/errors/ConnectorSetupError.js

@@ -3,7 +3,7 @@ import { DynamicError } from '@dynamic-labs/utils';
 
 class ConnectorSetupError extends DynamicError {
     constructor(providerName, connectorName) {
-        super(`${providerName} is enabled but ${connectorName} is not in your walletConnectors list. See https://docs.dynamic.xyz/react-sdk/wallet-connectors for more information.`);
+        super(`${providerName} is enabled but ${connectorName} is not in your walletConnectors list. See https://docs.dynamic.xyz/react-sdk/wallet-connectors for more information.`, 'connector_setup_error');
     }
 }
 

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

@@ -150,7 +150,7 @@ const useDynamicWaas = () => {
             normalizeWaasChainName.normalizeWaasChainName(option.walletConnector.connectedChain) ===
                 normalizeWaasChainName.normalizeWaasChainName(chainName))) === null || _a === void 0 ? void 0 : _a.walletConnector;
         if (!walletConnector) {
-            throw new utils.DynamicError(constants.DYNAMIC_WAAS_CONNECTOR_NOT_FOUND_ERROR);
+            throw new utils.DynamicError(constants.DYNAMIC_WAAS_CONNECTOR_NOT_FOUND_ERROR, 'dynamicwaasconnectornotfounderror');
         }
         const configuredWalletConnector = configWaasWalletConnector({
             apiBaseUrl: apiBaseUrl || apiUrl.DEFAULT_WAAS_API_URL,
@@ -282,7 +282,7 @@ const useDynamicWaas = () => {
             return;
         }
         if (!(enabledChainNames === null || enabledChainNames === void 0 ? void 0 : enabledChainNames.length)) {
-            throw new utils.DynamicError(constants.NO_ENABLED_CHAINS_ERROR);
+            throw new utils.DynamicError(constants.NO_ENABLED_CHAINS_ERROR, 'no_enabled_chains');
         }
         // Convert legacy ChainEnum[] format to WalletCreationRequirement[]
         const requirements = normalizeWalletRequirements.normalizeWalletRequirements(requirementsOrChainNames, bitcoinConfig);
@@ -291,7 +291,7 @@ const useDynamicWaas = () => {
             const allChains = reqs.map((req) => req.chain);
             const invalidChains = allChains.filter((chain) => !enabledChainNames.includes(chain));
             if (invalidChains.length > 0) {
-                throw new utils.DynamicError(`${constants.INVALID_CHAINS_ERROR}: ${invalidChains.join(', ')}`);
+                throw new utils.DynamicError(`${constants.INVALID_CHAINS_ERROR}: ${invalidChains.join(', ')}`, 'invalid_chains');
             }
         };
         validateChains(requirements);
@@ -324,7 +324,7 @@ const useDynamicWaas = () => {
             });
             if (failedChains.length > 0) {
                 refresh();
-                throw new utils.DynamicError(`${constants.WALLET_CREATION_FAILED_ERROR}: ${failedChains.join(', ')}. Errors: ${errors.join('; ')}`);
+                throw new utils.DynamicError(`${constants.WALLET_CREATION_FAILED_ERROR}: ${failedChains.join(', ')}. Errors: ${errors.join('; ')}`, 'wallet_creation_failed');
             }
             return settledResults.map((r) => r.status === 'fulfilled' ? r.value : undefined);
         };
@@ -474,13 +474,13 @@ const useDynamicWaas = () => {
     const upgradeToDynamicWaas = React.useCallback((_j) => _tslib.__awaiter(void 0, [_j], void 0, function* ({ privateKey, wallet, password, }) {
         isUpgrading.current = true;
         if (!wallet) {
-            throw new utils.DynamicError('Wallet to upgrade was not provided');
+            throw new utils.DynamicError('Wallet to upgrade was not provided', 'wallet_to_upgrade_was_not_provided');
         }
         const chainName = wallet.chain;
         const walletId = wallet.id;
         const walletConnector = getWaasWalletConnector(chainName);
         if (!walletConnector) {
-            throw new utils.DynamicError('Wallet connector not found');
+            throw new utils.DynamicError('Wallet connector not found', 'wallet_connector_not_found');
         }
         let softDeleteSucceeded = false;
         // 7702 wallets have a -zerodev suffix because it's a credential created on the fly
@@ -515,9 +515,9 @@ const useDynamicWaas = () => {
             }
             const errorMessage = (error === null || error === void 0 ? void 0 : error.message) || '';
             if (errorMessage.includes('Public address mismatch')) {
-                throw new utils.DynamicError('Public address mismatch. Ensure the private key is copied correctly.');
+                throw new utils.DynamicError('Public address mismatch. Ensure the private key is copied correctly.', 'public_address_mismatch');
             }
-            throw new utils.DynamicError('Upgrade failed, please try again.');
+            throw new utils.DynamicError('Upgrade failed, please try again.', 'upgrade_failed');
         }
     }), [environmentId, getWaasWalletConnector, refresh]);
     /**

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

@@ -146,7 +146,7 @@ const useDynamicWaas = () => {
             normalizeWaasChainName(option.walletConnector.connectedChain) ===
                 normalizeWaasChainName(chainName))) === null || _a === void 0 ? void 0 : _a.walletConnector;
         if (!walletConnector) {
-            throw new DynamicError(DYNAMIC_WAAS_CONNECTOR_NOT_FOUND_ERROR);
+            throw new DynamicError(DYNAMIC_WAAS_CONNECTOR_NOT_FOUND_ERROR, 'dynamicwaasconnectornotfounderror');
         }
         const configuredWalletConnector = configWaasWalletConnector({
             apiBaseUrl: apiBaseUrl || DEFAULT_WAAS_API_URL,
@@ -278,7 +278,7 @@ const useDynamicWaas = () => {
             return;
         }
         if (!(enabledChainNames === null || enabledChainNames === void 0 ? void 0 : enabledChainNames.length)) {
-            throw new DynamicError(NO_ENABLED_CHAINS_ERROR);
+            throw new DynamicError(NO_ENABLED_CHAINS_ERROR, 'no_enabled_chains');
         }
         // Convert legacy ChainEnum[] format to WalletCreationRequirement[]
         const requirements = normalizeWalletRequirements(requirementsOrChainNames, bitcoinConfig);
@@ -287,7 +287,7 @@ const useDynamicWaas = () => {
             const allChains = reqs.map((req) => req.chain);
             const invalidChains = allChains.filter((chain) => !enabledChainNames.includes(chain));
             if (invalidChains.length > 0) {
-                throw new DynamicError(`${INVALID_CHAINS_ERROR}: ${invalidChains.join(', ')}`);
+                throw new DynamicError(`${INVALID_CHAINS_ERROR}: ${invalidChains.join(', ')}`, 'invalid_chains');
             }
         };
         validateChains(requirements);
@@ -320,7 +320,7 @@ const useDynamicWaas = () => {
             });
             if (failedChains.length > 0) {
                 refresh();
-                throw new DynamicError(`${WALLET_CREATION_FAILED_ERROR}: ${failedChains.join(', ')}. Errors: ${errors.join('; ')}`);
+                throw new DynamicError(`${WALLET_CREATION_FAILED_ERROR}: ${failedChains.join(', ')}. Errors: ${errors.join('; ')}`, 'wallet_creation_failed');
             }
             return settledResults.map((r) => r.status === 'fulfilled' ? r.value : undefined);
         };
@@ -470,13 +470,13 @@ const useDynamicWaas = () => {
     const upgradeToDynamicWaas = useCallback((_j) => __awaiter(void 0, [_j], void 0, function* ({ privateKey, wallet, password, }) {
         isUpgrading.current = true;
         if (!wallet) {
-            throw new DynamicError('Wallet to upgrade was not provided');
+            throw new DynamicError('Wallet to upgrade was not provided', 'wallet_to_upgrade_was_not_provided');
         }
         const chainName = wallet.chain;
         const walletId = wallet.id;
         const walletConnector = getWaasWalletConnector(chainName);
         if (!walletConnector) {
-            throw new DynamicError('Wallet connector not found');
+            throw new DynamicError('Wallet connector not found', 'wallet_connector_not_found');
         }
         let softDeleteSucceeded = false;
         // 7702 wallets have a -zerodev suffix because it's a credential created on the fly
@@ -511,9 +511,9 @@ const useDynamicWaas = () => {
             }
             const errorMessage = (error === null || error === void 0 ? void 0 : error.message) || '';
             if (errorMessage.includes('Public address mismatch')) {
-                throw new DynamicError('Public address mismatch. Ensure the private key is copied correctly.');
+                throw new DynamicError('Public address mismatch. Ensure the private key is copied correctly.', 'public_address_mismatch');
             }
-            throw new DynamicError('Upgrade failed, please try again.');
+            throw new DynamicError('Upgrade failed, please try again.', 'upgrade_failed');
         }
     }), [environmentId, getWaasWalletConnector, refresh]);
     /**

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

@@ -67,10 +67,10 @@ const useEmbeddedWallet = () => {
     const userHasEmbeddedWallet = React.useCallback(() => hasEmbeddedWallet.hasEmbeddedWallet(user), [user]);
     const getWalletVersion = React.useCallback(() => {
         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 (!userHasEmbeddedWallet()) {
-            throw new utils.DynamicError('Embedded wallet not found');
+            throw new utils.DynamicError('Embedded wallet not found', 'embedded_wallet_not_found');
         }
         if (isTurnkeyWallet) {
             return getTurnkeyWalletVersion();
@@ -94,10 +94,10 @@ const useEmbeddedWallet = () => {
      */
     const revealWalletKey = (options) => _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');
         }
         if (!userHasEmbeddedWallet()) {
-            throw new utils.DynamicError('Embedded wallet not found');
+            throw new utils.DynamicError('Embedded wallet not found', 'embedded_wallet_not_found');
         }
         return revealTurnkeyEmbeddedWalletKey(options);
     });

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

@@ -36,7 +36,9 @@ export declare const useEmbeddedWallet: () => {
         type: "privateKey" | "recoveryPhrase";
         htmlContainerId?: string | undefined;
     } | undefined) => Promise<boolean>;
-    readonly sendOneTimeCode: () => Promise<string>;
+    readonly sendOneTimeCode: (options?: {
+        chainName?: import("@dynamic-labs/sdk-api-core").ChainEnum | undefined;
+    } | undefined) => Promise<string>;
     readonly shouldAutoCreateEmbeddedWallet: () => boolean;
     readonly shouldPromptForKeyExport: () => boolean;
     readonly userHasEmbeddedWallet: () => boolean;

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

@@ -63,10 +63,10 @@ const useEmbeddedWallet = () => {
     const userHasEmbeddedWallet = useCallback(() => hasEmbeddedWallet(user), [user]);
     const getWalletVersion = useCallback(() => {
         if (!user) {
-            throw new DynamicError(USER_NOT_LOGGED_IN);
+            throw new DynamicError(USER_NOT_LOGGED_IN, 'user_not_logged_in');
         }
         if (!userHasEmbeddedWallet()) {
-            throw new DynamicError('Embedded wallet not found');
+            throw new DynamicError('Embedded wallet not found', 'embedded_wallet_not_found');
         }
         if (isTurnkeyWallet) {
             return getTurnkeyWalletVersion();
@@ -90,10 +90,10 @@ const useEmbeddedWallet = () => {
      */
     const revealWalletKey = (options) => __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');
         }
         if (!userHasEmbeddedWallet()) {
-            throw new DynamicError('Embedded wallet not found');
+            throw new DynamicError('Embedded wallet not found', 'embedded_wallet_not_found');
         }
         return revealTurnkeyEmbeddedWalletKey(options);
     });

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

@@ -107,7 +107,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
     const createEmbeddedWallet = React.useCallback((chains, options) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         var _f;
         if (!user$1) {
-            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN);
+            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN, 'user_not_logged_in');
         }
         const userWalletsCredentials = getUserWalletsFromVerifiedCredentials.getUserWalletsFromVerifiedCredentials(user$1);
         const primaryChain = findPrimaryEmbeddedChain.findPrimaryEmbeddedChain(projectSettings);
@@ -185,7 +185,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
     const createOrRestoreSession = React.useCallback((options) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         var _l, _m, _o, _p, _q, _r, _s;
         if (!user$1) {
-            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN);
+            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN, 'user_not_logged_in');
         }
         const primaryConnector = primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.connector;
         if (primaryConnector &&
@@ -227,7 +227,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
             throw new utils.DynamicError('User does not have a secure enclave wallet or a verified email', errors.INVALID_WALLET_DATA);
         }
         if (!primaryWallet) {
-            throw new utils.DynamicError('No primary wallet found');
+            throw new utils.DynamicError('No primary wallet found', 'no_primary_wallet_found');
         }
         const primaryTurnkeyWalletId = getTurnkeyWalletId.getTurnkeyWalletId(primaryWallet.id, (user$1 === null || user$1 === void 0 ? void 0 : user$1.verifiedCredentials) || []);
         const organizationId = (_s = (_r = (_q = (_p = user$1 === null || user$1 === void 0 ? void 0 : user$1.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;
@@ -256,7 +256,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
     const createPasskey = React.useCallback((options) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         var _t, _u;
         if (!user$1) {
-            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN);
+            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN, 'user_not_logged_in');
         }
         validateTurnkeyProviderEnabled.validateTurnkeyProviderEnabled(projectSettings);
         const turnkeyWallet = findTurnkeyWallet.findTurnkeyWalletByPrimaryChain(walletConnectorOptions, (_t = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.embeddedWallets) === null || _t === void 0 ? void 0 : _t.chainConfigurations, user$1.verifiedCredentials);
@@ -294,7 +294,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
             walletId: turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.id,
         });
         if (!updatedUser) {
-            throw new utils.DynamicError('Error completing passkey recovery');
+            throw new utils.DynamicError('Error completing passkey recovery', 'completing_passkey_recovery');
         }
         return { attestation, challenge, displayName };
     }), [
@@ -310,7 +310,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
      */
     const getPasskeys = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         if (!user$1) {
-            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN);
+            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN, 'user_not_logged_in');
         }
         const data = yield embeddedWallets.getUserPasskeys({
             environmentId: environmentId,
@@ -341,7 +341,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
     const revealEmbeddedWalletKey = React.useCallback((_v) => _tslib.__awaiter(void 0, [_v], void 0, function* ({ type, htmlContainerId, }) {
         var _w, _x, _y, _z, _0, _1;
         if (!user$1) {
-            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN);
+            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN, 'user_not_logged_in');
         }
         yield turnkeyExport.cleanupExport({
             wallet: wallet,
@@ -405,14 +405,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 = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
-        var _2, _3;
+    const sendOneTimeCode = React.useCallback((options) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        var _2, _3, _4, _5, _6;
         if (!user$1) {
-            throw new utils.DynamicError(errors.USER_NOT_LOGGED_IN);
+            throw new utils.DynamicError(errors.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 : sdkApiCore.ChainEnum.Evm;
+        const targetChain = (options === null || options === void 0 ? void 0 : options.chainName) || primaryWalletChain || primaryConfiguredChain;
+        let targetTurnkeyWallet = findTurnkeyWallet.findTurnkeyWalletByTargetChain(walletConnectorOptions, targetChain, user$1.verifiedCredentials);
+        if (!(options === null || options === void 0 ? void 0 : options.chainName) &&
+            (!targetTurnkeyWallet || !('id' in targetTurnkeyWallet))) {
+            targetTurnkeyWallet = findTurnkeyWallet.findFirstAvailableTurnkeyWallet(walletConnectorOptions, chainConfigurations, user$1.verifiedCredentials);
         }
-        const targetTurnkeyWallet = findTurnkeyWallet.findTurnkeyWalletByPrimaryChain(walletConnectorOptions, (_2 = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.embeddedWallets) === null || _2 === void 0 ? void 0 : _2.chainConfigurations, user$1.verifiedCredentials);
         if (!targetTurnkeyWallet || !('id' in targetTurnkeyWallet)) {
             throw new utils.DynamicError('User does not have a valid secure enclave wallet', errors.INVALID_WALLET_DATA);
         }
@@ -423,9 +435,9 @@ const useSecureEnclaveEmbeddedWallet = () => {
             throw new utils.DynamicError('Session is active. No need to create a new one', errors.ACTIVE_SESSION);
         }
         const turnkeyAuthIframeContainerRef = createRootElement(constants.iframeContainerId);
-        const publicKey = yield turnkeyAuthenticatorHandler.initRecovery('email', turnkeyAuthIframeContainerRef.current, constants.iframeElementId, getEmbeddedWalletSessionExpiration.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, constants.iframeElementId, getEmbeddedWalletSessionExpiration.getEmbeddedWalletSessionExpiration((_6 = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.embeddedWallets) === null || _6 === void 0 ? void 0 : _6.sessionKeyDuration));
         if (!publicKey) {
-            throw new utils.DynamicError(errors.ERROR_SENDING_CODE);
+            throw new utils.DynamicError(errors.ERROR_SENDING_CODE, 'error_sending_code');
         }
         const response = yield embeddedWallets.initEmbeddedWalletSession({
             authenticatorType: 'email',
@@ -437,6 +449,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
         return errors.CODE_SENT;
     }), [
         createRootElement,
+        primaryWallet,
         user$1,
         environmentId,
         projectSettings,

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

@@ -1,4 +1,4 @@
-import { EmbeddedWalletChainEnum } from '@dynamic-labs/sdk-api-core';
+import { ChainEnum, EmbeddedWalletChainEnum } from '@dynamic-labs/sdk-api-core';
 import { Wallet, WalletConnector, WebAuthnAttestation } from '@dynamic-labs/wallet-connector-core';
 import { EmbeddedWalletVersion } from './constants';
 export declare const isConnectorSessionKeyActive: (connector: WalletConnector | undefined) => boolean;
@@ -37,6 +37,8 @@ export declare const useSecureEnclaveEmbeddedWallet: () => {
         type: 'recoveryPhrase' | 'privateKey';
         htmlContainerId?: string;
     }) => Promise<boolean>;
-    readonly sendOneTimeCode: () => Promise<string>;
+    readonly sendOneTimeCode: (options?: {
+        chainName?: ChainEnum;
+    }) => Promise<string>;
     readonly userHasEmbeddedWallet: () => boolean;
 };