@dynamic-labs/sdk-react-core 4.91.2 → 4.91.4

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/functions/getVerifyArgs/getVerifyArgs.cjs

@@ -59,6 +59,10 @@ const getVerifyArgs = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* (
         });
         return result;
     }
+    if (!nonce.getNonce()) {
+        logger.logger.debug('[getVerifyArgs] Nonce missing, attempting to fetch');
+        yield nonce.fetchAndStoreNonce();
+    }
     const nonce$1 = nonce.consumeNonce();
     // generate message to sign and then initiate signing step to prove ownership
     const { messageToSign, signedMessage } = yield index.generateMessages(publicWalletAddress, walletConnector, nonce$1, environmentId, displaySiweStatement, siweStatement);

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

@@ -2,7 +2,7 @@
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
 import { logger } from '../../../shared/logger.js';
 import { generateMessages } from '../generateMessages/index.js';
-import { consumeNonce } from '../../../store/state/nonce/nonce.js';
+import { getNonce, fetchAndStoreNonce, consumeNonce } from '../../../store/state/nonce/nonce.js';
 
 // TODO - This function is doing too much we should split it up.
 const getVerifyArgs = (_a) => __awaiter(void 0, [_a], void 0, function* ({ walletConnector, walletProvider, environmentId, displaySiweStatement, skipEmptyAccountCheck, siweStatement, publicWalletAddress, signedMessageOverride, messageToSignOverride, }) {
@@ -55,6 +55,10 @@ const getVerifyArgs = (_a) => __awaiter(void 0, [_a], void 0, function* ({ walle
         });
         return result;
     }
+    if (!getNonce()) {
+        logger.debug('[getVerifyArgs] Nonce missing, attempting to fetch');
+        yield fetchAndStoreNonce();
+    }
     const nonce = consumeNonce();
     // generate message to sign and then initiate signing step to prove ownership
     const { messageToSign, signedMessage } = yield generateMessages(publicWalletAddress, walletConnector, nonce, environmentId, displaySiweStatement, siweStatement);

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

@@ -76,7 +76,7 @@ const useConnectAndSign = ({ shouldUpdateWallets = true, shouldCallCallback = tr
     });
     const handleWalletVerifyError = (err) => {
         var _a;
-        const userCancelled = (err === null || err === void 0 ? void 0 : err.code) === 'user-cancelled';
+        const userCancelled = (err === null || err === void 0 ? void 0 : err.code) === utils.SdkErrorCode.USER_CANCELLED;
         if (!userCancelled)
             logger.logger.debug(err);
         instrumentAuthLoginFailed.instrumentAuthLoginFailed(err, {

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

@@ -1,6 +1,6 @@
 'use client'
 import { __awaiter } from '../../../../../../_virtual/_tslib.js';
-import { DeferredPromise, StorageService, CustomError, GetAddressCancelledError } from '@dynamic-labs/utils';
+import { DeferredPromise, StorageService, SdkErrorCode, CustomError, GetAddressCancelledError } from '@dynamic-labs/utils';
 import { isEmailWalletConnector, isEmailOTPWalletConnector, isBloctoConnector, getWalletProvider, isSameAddress } from '@dynamic-labs/wallet-connector-core';
 import { useCaptchaContext } from '../../../../context/CaptchaContext/CaptchaContext.js';
 import '../../../../context/DynamicContext/useDynamicContext/useDynamicContext.js';
@@ -72,7 +72,7 @@ const useConnectAndSign = ({ shouldUpdateWallets = true, shouldCallCallback = tr
     });
     const handleWalletVerifyError = (err) => {
         var _a;
-        const userCancelled = (err === null || err === void 0 ? void 0 : err.code) === 'user-cancelled';
+        const userCancelled = (err === null || err === void 0 ? void 0 : err.code) === SdkErrorCode.USER_CANCELLED;
         if (!userCancelled)
             logger.debug(err);
         instrumentAuthLoginFailed(err, {

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.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,
@@ -410,7 +410,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
     const sendOneTimeCode = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         var _2, _3;
         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 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)) {
@@ -425,7 +425,7 @@ const useSecureEnclaveEmbeddedWallet = () => {
         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));
         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',