@dynamic-labs/sdk-react-core 4.90.0 → 4.91.0

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

@@ -32,6 +32,18 @@ const BLOCK_EXPLORER_PATTERNS = [
             return url.toString();
         },
     },
+    {
+        // The Midnight explorer indexes by the canonical transaction hash and
+        // serves detail pages at `/transactions/{hash}`. Matching the bare
+        // `midnight.network` substring covers the preview/testnet subdomains.
+        description: 'Midnight - Uses /transactions/{hash}',
+        domain: 'midnight.network',
+        generateUrl: (baseUrl, hash) => {
+            const url = new URL(baseUrl);
+            url.pathname = `/transactions/${hash}`;
+            return url.toString();
+        },
+    },
 ];
 /**
  * Default pattern for standard block explorers

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

@@ -28,6 +28,18 @@ const BLOCK_EXPLORER_PATTERNS = [
             return url.toString();
         },
     },
+    {
+        // The Midnight explorer indexes by the canonical transaction hash and
+        // serves detail pages at `/transactions/{hash}`. Matching the bare
+        // `midnight.network` substring covers the preview/testnet subdomains.
+        description: 'Midnight - Uses /transactions/{hash}',
+        domain: 'midnight.network',
+        generateUrl: (baseUrl, hash) => {
+            const url = new URL(baseUrl);
+            url.pathname = `/transactions/${hash}`;
+            return url.toString();
+        },
+    },
 ];
 /**
  * Default pattern for standard block explorers

package/src/lib/utils/hooks/useCreateWalletConnectorOptions/utils/verifyZeroDevIsSetup/verifyZeroDevIsSetup.cjs

@@ -8,7 +8,7 @@ require('../../../../constants/values.cjs');
 require('@dynamic-labs/utils');
 require('../../../../../../../_virtual/_tslib.cjs');
 require('@dynamic-labs/multi-wallet');
-require('../../../../../shared/logger.cjs');
+var logger = require('../../../../../shared/logger.cjs');
 require('react-international-phone');
 require('../../../../constants/colors.cjs');
 require('@dynamic-labs/iconic');
@@ -31,7 +31,6 @@ require('../../../../../store/state/dynamicContextProps/dynamicContextProps.cjs'
 require('../../../../../store/state/primaryWalletId/primaryWalletId.cjs');
 require('../../../../../store/state/connectedWalletsInfo/connectedWalletsInfo.cjs');
 require('../../../../functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.cjs');
-var ConnectorSetupError = require('../errors/ConnectorSetupError.cjs');
 
 const zeroDevWalletConnectorKey = 'zerodev';
 const verifyZeroDevIsSetup = (projectSettings, walletConnectors) => {
@@ -39,7 +38,12 @@ const verifyZeroDevIsSetup = (projectSettings, walletConnectors) => {
     const isZeroDevEnabled = isProviderEnabled.isProviderEnabled((_a = projectSettings.providers) !== null && _a !== void 0 ? _a : [], sdkApiCore.ProviderEnum.Zerodev);
     const isZeroDevWalletConnectorPresent = walletConnectors.some(({ key }) => key === zeroDevWalletConnectorKey);
     if (isZeroDevEnabled && !isZeroDevWalletConnectorPresent) {
-        throw new ConnectorSetupError.ConnectorSetupError('ZeroDev', 'ZeroDevSmartWalletConnectors');
+        // A ZeroDev connector that's enabled in project settings but absent from
+        // `walletConnectors` is an explicit decision to migrate off ZeroDev —
+        // whether to native EVM gas sponsorship or to plain EOAs with no
+        // sponsorship at all. Warn and continue (wallets fall back to the embedded
+        // EOA) instead of hard-throwing and white-screening the app.
+        logger.logger.warn('ZeroDev is enabled in project settings but ZeroDevSmartWalletConnectors is not in walletConnectors. Continuing without ZeroDev — wallets will fall back to the embedded EOA (gas is sponsored only if native EVM gas sponsorship is enabled).');
     }
 };
 

package/src/lib/utils/hooks/useCreateWalletConnectorOptions/utils/verifyZeroDevIsSetup/verifyZeroDevIsSetup.js

@@ -4,7 +4,7 @@ import '../../../../constants/values.js';
 import '@dynamic-labs/utils';
 import '../../../../../../../_virtual/_tslib.js';
 import '@dynamic-labs/multi-wallet';
-import '../../../../../shared/logger.js';
+import { logger } from '../../../../../shared/logger.js';
 import 'react-international-phone';
 import '../../../../constants/colors.js';
 import '@dynamic-labs/iconic';
@@ -27,7 +27,6 @@ import '../../../../../store/state/dynamicContextProps/dynamicContextProps.js';
 import '../../../../../store/state/primaryWalletId/primaryWalletId.js';
 import '../../../../../store/state/connectedWalletsInfo/connectedWalletsInfo.js';
 import '../../../../functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.js';
-import { ConnectorSetupError } from '../errors/ConnectorSetupError.js';
 
 const zeroDevWalletConnectorKey = 'zerodev';
 const verifyZeroDevIsSetup = (projectSettings, walletConnectors) => {
@@ -35,7 +34,12 @@ const verifyZeroDevIsSetup = (projectSettings, walletConnectors) => {
     const isZeroDevEnabled = isProviderEnabled((_a = projectSettings.providers) !== null && _a !== void 0 ? _a : [], ProviderEnum.Zerodev);
     const isZeroDevWalletConnectorPresent = walletConnectors.some(({ key }) => key === zeroDevWalletConnectorKey);
     if (isZeroDevEnabled && !isZeroDevWalletConnectorPresent) {
-        throw new ConnectorSetupError('ZeroDev', 'ZeroDevSmartWalletConnectors');
+        // A ZeroDev connector that's enabled in project settings but absent from
+        // `walletConnectors` is an explicit decision to migrate off ZeroDev —
+        // whether to native EVM gas sponsorship or to plain EOAs with no
+        // sponsorship at all. Warn and continue (wallets fall back to the embedded
+        // EOA) instead of hard-throwing and white-screening the app.
+        logger.warn('ZeroDev is enabled in project settings but ZeroDevSmartWalletConnectors is not in walletConnectors. Continuing without ZeroDev — wallets will fall back to the embedded EOA (gas is sponsored only if native EVM gas sponsorship is enabled).');
     }
 };
 

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

@@ -39,6 +39,7 @@ var useProjectSettings = require('../../../client/extension/projectSettings/useP
 var isCookieEnabled = require('../../../client/extension/functions/isCookieEnabled/isCookieEnabled.cjs');
 var getMinAuthToken = require('../../../client/extension/functions/getMinAuthToken/getMinAuthToken.cjs');
 var generateChainingSignature = require('../../../client/extension/functions/generateChainingSignature/generateChainingSignature.cjs');
+var getSessionPublicKey = require('../../../client/extension/functions/getSessionPublicKey/getSessionPublicKey.cjs');
 require('../../../context/DynamicContext/useDynamicContext/useDynamicContext.cjs');
 var useInternalDynamicContext = require('../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.cjs');
 var UserWalletsContext = require('../../../context/UserWalletsContext/UserWalletsContext.cjs');
@@ -55,8 +56,8 @@ var normalizeWaasChainName = require('./normalizeWaasChainName.cjs');
 var normalizeWalletRequirements = require('./normalizeWalletRequirements.cjs');
 
 const dynamicWaasKey = 'dynamicwaas';
-const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode = 'header', getSignedSessionId, getMfaToken, getWalletPassword, getSvmGasSponsorshipEnabled = () => false, getElevatedAccessToken, }) => {
-    var _a;
+const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode = 'header', getSignedSessionId, getSessionPublicKey, getMfaToken, getWalletPassword, getSvmGasSponsorshipEnabled = () => false, getElevatedAccessToken, onUnauthorized, }) => {
+    var _a, _b;
     walletConnector.setEnvironmentId(environmentId);
     walletConnector.setBaseApiUrl((_a = (apiBaseUrl || apiUrl.DEFAULT_WAAS_API_URL)) === null || _a === void 0 ? void 0 : _a.replace('/api/v0', ''));
     if (authMode === 'cookie') {
@@ -68,6 +69,11 @@ const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl,
         walletConnector.setGetAuthTokenFunction(getMinAuthToken.getMinAuthToken);
     }
     walletConnector.setGetSignedSessionIdFunction(getSignedSessionId);
+    // Optional + best-effort: a connector build predating this method must not
+    // break wiring — the backup pubkey header simply stays absent.
+    if (getSessionPublicKey) {
+        (_b = walletConnector.setGetSessionPublicKeyFunction) === null || _b === void 0 ? void 0 : _b.call(walletConnector, getSessionPublicKey);
+    }
     walletConnector.setRelayUrl(relayUrl);
     walletConnector.setGetMfaTokenFunction(getMfaToken);
     walletConnector.setBaseClientKeysharesRelayApiUrl(baseClientKeysharesRelayApiUrl);
@@ -79,6 +85,10 @@ const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl,
     if (getWalletPassword) {
         walletConnector.setGetWalletPasswordFunction(getWalletPassword);
     }
+    // Log the user out when the iframe reports a 401 (e.g. token forcibly revoked)
+    if (onUnauthorized) {
+        walletConnector.setOnUnauthorizedFunction(onUnauthorized);
+    }
     // Sync SVM gas sponsorship setting for SOL connectors
     const isSolConnector = walletConnector.connectedChain === 'SOL';
     const supportsSponsorshipSetting = 'setSvmGasSponsorshipEnabled' in walletConnector;
@@ -89,7 +99,7 @@ const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl,
 };
 const useDynamicWaas = () => {
     var _a, _b, _c, _d, _e, _f;
-    const { setShowAuthFlow } = useInternalDynamicContext.useInternalDynamicContext();
+    const { setShowAuthFlow, handleLogOutWithReason } = useInternalDynamicContext.useInternalDynamicContext();
     const { addedWalletsIds, userWallets } = UserWalletsContext.useInternalUserWallets();
     const user = useUser.useUser();
     const apiBaseUrl = dynamicContextProps.useApiBaseUrl();
@@ -149,9 +159,11 @@ const useDynamicWaas = () => {
             environmentId,
             getElevatedAccessToken,
             getMfaToken,
+            getSessionPublicKey: getSessionPublicKey.getSessionPublicKey,
             getSignedSessionId: generateChainingSignature.generateChainingSignature,
             getSvmGasSponsorshipEnabled: () => svmGasSponsorshipEnabledRef.current,
             getWalletPassword,
+            onUnauthorized: () => handleLogOutWithReason('session-refresh-unauthorized'),
             relayUrl: relayUrl !== null && relayUrl !== void 0 ? relayUrl : '',
             walletConnector,
         });
@@ -165,6 +177,7 @@ const useDynamicWaas = () => {
         getElevatedAccessToken,
         getMfaToken,
         getWalletPassword,
+        handleLogOutWithReason,
         relayUrl,
         baseClientKeysharesRelayApiUrl,
     ]);

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

@@ -12,7 +12,7 @@ export type WalletCreationRequirement = {
         network?: string;
     };
 };
-export declare const configWaasWalletConnector: ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode, getSignedSessionId, getMfaToken, getWalletPassword, getSvmGasSponsorshipEnabled, getElevatedAccessToken, }: {
+export declare const configWaasWalletConnector: ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode, getSignedSessionId, getSessionPublicKey, getMfaToken, getWalletPassword, getSvmGasSponsorshipEnabled, getElevatedAccessToken, onUnauthorized, }: {
     walletConnector: IDynamicWaasConnector;
     environmentId: string;
     apiBaseUrl: string;
@@ -20,6 +20,7 @@ export declare const configWaasWalletConnector: ({ walletConnector, environmentI
     baseClientKeysharesRelayApiUrl?: string;
     authMode?: 'cookie' | 'header';
     getSignedSessionId: () => Promise<string>;
+    getSessionPublicKey?: () => Promise<string | undefined>;
     getMfaToken: (props?: {
         mfaAction?: MFAAction;
     }) => Promise<string | undefined>;
@@ -28,6 +29,7 @@ export declare const configWaasWalletConnector: ({ walletConnector, environmentI
     getElevatedAccessToken?: (params: {
         scope: TokenScope;
     }) => Promise<string | undefined>;
+    onUnauthorized?: () => void | Promise<void>;
 }) => IDynamicWaasConnector;
 export declare const useDynamicWaas: () => {
     areWalletsReadyForSettings: () => boolean;

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

@@ -35,6 +35,7 @@ import { useProjectSettings } from '../../../client/extension/projectSettings/us
 import { isCookieEnabled } from '../../../client/extension/functions/isCookieEnabled/isCookieEnabled.js';
 import { getMinAuthToken } from '../../../client/extension/functions/getMinAuthToken/getMinAuthToken.js';
 import { generateChainingSignature } from '../../../client/extension/functions/generateChainingSignature/generateChainingSignature.js';
+import { getSessionPublicKey } from '../../../client/extension/functions/getSessionPublicKey/getSessionPublicKey.js';
 import '../../../context/DynamicContext/useDynamicContext/useDynamicContext.js';
 import { useInternalDynamicContext } from '../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.js';
 import { useInternalUserWallets } from '../../../context/UserWalletsContext/UserWalletsContext.js';
@@ -51,8 +52,8 @@ import { normalizeWaasChainName } from './normalizeWaasChainName.js';
 import { normalizeWalletRequirements } from './normalizeWalletRequirements.js';
 
 const dynamicWaasKey = 'dynamicwaas';
-const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode = 'header', getSignedSessionId, getMfaToken, getWalletPassword, getSvmGasSponsorshipEnabled = () => false, getElevatedAccessToken, }) => {
-    var _a;
+const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode = 'header', getSignedSessionId, getSessionPublicKey, getMfaToken, getWalletPassword, getSvmGasSponsorshipEnabled = () => false, getElevatedAccessToken, onUnauthorized, }) => {
+    var _a, _b;
     walletConnector.setEnvironmentId(environmentId);
     walletConnector.setBaseApiUrl((_a = (apiBaseUrl || DEFAULT_WAAS_API_URL)) === null || _a === void 0 ? void 0 : _a.replace('/api/v0', ''));
     if (authMode === 'cookie') {
@@ -64,6 +65,11 @@ const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl,
         walletConnector.setGetAuthTokenFunction(getMinAuthToken);
     }
     walletConnector.setGetSignedSessionIdFunction(getSignedSessionId);
+    // Optional + best-effort: a connector build predating this method must not
+    // break wiring — the backup pubkey header simply stays absent.
+    if (getSessionPublicKey) {
+        (_b = walletConnector.setGetSessionPublicKeyFunction) === null || _b === void 0 ? void 0 : _b.call(walletConnector, getSessionPublicKey);
+    }
     walletConnector.setRelayUrl(relayUrl);
     walletConnector.setGetMfaTokenFunction(getMfaToken);
     walletConnector.setBaseClientKeysharesRelayApiUrl(baseClientKeysharesRelayApiUrl);
@@ -75,6 +81,10 @@ const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl,
     if (getWalletPassword) {
         walletConnector.setGetWalletPasswordFunction(getWalletPassword);
     }
+    // Log the user out when the iframe reports a 401 (e.g. token forcibly revoked)
+    if (onUnauthorized) {
+        walletConnector.setOnUnauthorizedFunction(onUnauthorized);
+    }
     // Sync SVM gas sponsorship setting for SOL connectors
     const isSolConnector = walletConnector.connectedChain === 'SOL';
     const supportsSponsorshipSetting = 'setSvmGasSponsorshipEnabled' in walletConnector;
@@ -85,7 +95,7 @@ const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl,
 };
 const useDynamicWaas = () => {
     var _a, _b, _c, _d, _e, _f;
-    const { setShowAuthFlow } = useInternalDynamicContext();
+    const { setShowAuthFlow, handleLogOutWithReason } = useInternalDynamicContext();
     const { addedWalletsIds, userWallets } = useInternalUserWallets();
     const user = useUser();
     const apiBaseUrl = useApiBaseUrl();
@@ -145,9 +155,11 @@ const useDynamicWaas = () => {
             environmentId,
             getElevatedAccessToken,
             getMfaToken,
+            getSessionPublicKey,
             getSignedSessionId: generateChainingSignature,
             getSvmGasSponsorshipEnabled: () => svmGasSponsorshipEnabledRef.current,
             getWalletPassword,
+            onUnauthorized: () => handleLogOutWithReason('session-refresh-unauthorized'),
             relayUrl: relayUrl !== null && relayUrl !== void 0 ? relayUrl : '',
             walletConnector,
         });
@@ -161,6 +173,7 @@ const useDynamicWaas = () => {
         getElevatedAccessToken,
         getMfaToken,
         getWalletPassword,
+        handleLogOutWithReason,
         relayUrl,
         baseClientKeysharesRelayApiUrl,
     ]);

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

@@ -31,6 +31,7 @@ require('@dynamic-labs-sdk/client');
 require('../../../config/ApiEndpoint.cjs');
 var isCookieEnabled = require('../../../client/extension/functions/isCookieEnabled/isCookieEnabled.cjs');
 var generateChainingSignature = require('../../../client/extension/functions/generateChainingSignature/generateChainingSignature.cjs');
+var getSessionPublicKey = require('../../../client/extension/functions/getSessionPublicKey/getSessionPublicKey.cjs');
 var apiUrl = require('../../constants/waas/apiUrl.cjs');
 require('@dynamic-labs/locale');
 var dynamicContextProps = require('../../../store/state/dynamicContextProps/dynamicContextProps.cjs');
@@ -118,7 +119,11 @@ require('../../../store/state/multichainBalances.cjs');
 require('@dynamic-labs/store');
 require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
 
-const useSetWalletConnectorFetchers = (walletOptions, environmentId, projectSettings) => {
+const useSetWalletConnectorFetchers = (walletOptions, environmentId, projectSettings, 
+// Logs the user out when the iframe reports a 401. Passed in (rather than read
+// from context) because this hook runs inside DynamicContextProvider itself,
+// where the context value isn't available to consume.
+onUnauthorized) => {
     var _a, _b, _c;
     const apiBaseUrl = dynamicContextProps.useApiBaseUrl();
     const { registerEmbeddedWalletSessionKey, removeSessionKey } = useEmbeddedWalletSessionKeys.useEmbeddedWalletSessionKeys({ environmentId, projectSettings });
@@ -141,8 +146,10 @@ const useSetWalletConnectorFetchers = (walletOptions, environmentId, projectSett
                 authMode: isCookieAuthEnabled ? 'cookie' : 'header',
                 environmentId,
                 getMfaToken,
+                getSessionPublicKey: getSessionPublicKey.getSessionPublicKey,
                 getSignedSessionId: generateChainingSignature.generateChainingSignature,
                 getSvmGasSponsorshipEnabled: () => svmGasSponsorshipEnabledRef.current,
+                onUnauthorized,
                 relayUrl: (_e = (_d = (_c = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _c === void 0 ? void 0 : _c.waas) === null || _d === void 0 ? void 0 : _d.relayUrl) !== null && _e !== void 0 ? _e : '',
                 walletConnector: walletOption.walletConnector,
             });

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

@@ -1,3 +1,3 @@
 import { ProjectSettings } from '@dynamic-labs/sdk-api-core';
 import { WalletOption } from '../../../shared';
-export declare const useSetWalletConnectorFetchers: (walletOptions: WalletOption[] | undefined, environmentId: string, projectSettings: ProjectSettings | undefined) => void;
+export declare const useSetWalletConnectorFetchers: (walletOptions: WalletOption[] | undefined, environmentId: string, projectSettings: ProjectSettings | undefined, onUnauthorized?: () => void | Promise<void>) => void;

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

@@ -27,6 +27,7 @@ import '@dynamic-labs-sdk/client';
 import '../../../config/ApiEndpoint.js';
 import { isCookieEnabled } from '../../../client/extension/functions/isCookieEnabled/isCookieEnabled.js';
 import { generateChainingSignature } from '../../../client/extension/functions/generateChainingSignature/generateChainingSignature.js';
+import { getSessionPublicKey } from '../../../client/extension/functions/getSessionPublicKey/getSessionPublicKey.js';
 import { DEFAULT_WAAS_API_URL } from '../../constants/waas/apiUrl.js';
 import '@dynamic-labs/locale';
 import { useApiBaseUrl } from '../../../store/state/dynamicContextProps/dynamicContextProps.js';
@@ -114,7 +115,11 @@ import '../../../store/state/multichainBalances.js';
 import '@dynamic-labs/store';
 import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
 
-const useSetWalletConnectorFetchers = (walletOptions, environmentId, projectSettings) => {
+const useSetWalletConnectorFetchers = (walletOptions, environmentId, projectSettings, 
+// Logs the user out when the iframe reports a 401. Passed in (rather than read
+// from context) because this hook runs inside DynamicContextProvider itself,
+// where the context value isn't available to consume.
+onUnauthorized) => {
     var _a, _b, _c;
     const apiBaseUrl = useApiBaseUrl();
     const { registerEmbeddedWalletSessionKey, removeSessionKey } = useEmbeddedWalletSessionKeys({ environmentId, projectSettings });
@@ -137,8 +142,10 @@ const useSetWalletConnectorFetchers = (walletOptions, environmentId, projectSett
                 authMode: isCookieAuthEnabled ? 'cookie' : 'header',
                 environmentId,
                 getMfaToken,
+                getSessionPublicKey,
                 getSignedSessionId: generateChainingSignature,
                 getSvmGasSponsorshipEnabled: () => svmGasSponsorshipEnabledRef.current,
+                onUnauthorized,
                 relayUrl: (_e = (_d = (_c = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _c === void 0 ? void 0 : _c.waas) === null || _d === void 0 ? void 0 : _d.relayUrl) !== null && _e !== void 0 ? _e : '',
                 walletConnector: walletOption.walletConnector,
             });

package/src/lib/views/TransactionConfirmationView/helpers/transactionErrorMessage.cjs

@@ -57,6 +57,7 @@ const isPolicyViolationError = (error) => {
         (message === null || message === void 0 ? void 0 : message.toLowerCase().includes('explicitly denied by policy')));
 };
 const transactionErrorMessage = (err) => {
+    var _a, _b;
     let error = err;
     if (isTransactionExecutionError(err)) {
         error = err.walk();
@@ -84,6 +85,13 @@ const transactionErrorMessage = (err) => {
     if (isConfirmationTimeoutError(error)) {
         return undefined; // Use translation key in UI for timeout message
     }
+    // Midnight: every transaction needs DUST to pay fees. The wallet client throws
+    // "No dust balance — register dust first" when the wallet has no registered
+    // dust, so surface an actionable message instead of the generic fallback.
+    const message = (_b = (_a = getMessage(error)) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : '';
+    if (message.includes('no dust') || message.includes('register dust')) {
+        return 'You need DUST to pay network fees. Register DUST first, then try again.';
+    }
     return 'Something went wrong with the transaction. Please try again.';
 };
 const isMagicInsufficientFundsError = (error) => {

package/src/lib/views/TransactionConfirmationView/helpers/transactionErrorMessage.js

@@ -53,6 +53,7 @@ const isPolicyViolationError = (error) => {
         (message === null || message === void 0 ? void 0 : message.toLowerCase().includes('explicitly denied by policy')));
 };
 const transactionErrorMessage = (err) => {
+    var _a, _b;
     let error = err;
     if (isTransactionExecutionError(err)) {
         error = err.walk();
@@ -80,6 +81,13 @@ const transactionErrorMessage = (err) => {
     if (isConfirmationTimeoutError(error)) {
         return undefined; // Use translation key in UI for timeout message
     }
+    // Midnight: every transaction needs DUST to pay fees. The wallet client throws
+    // "No dust balance — register dust first" when the wallet has no registered
+    // dust, so surface an actionable message instead of the generic fallback.
+    const message = (_b = (_a = getMessage(error)) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : '';
+    if (message.includes('no dust') || message.includes('register dust')) {
+        return 'You need DUST to pay network fees. Register DUST first, then try again.';
+    }
     return 'Something went wrong with the transaction. Please try again.';
 };
 const isMagicInsufficientFundsError = (error) => {

package/src/lib/widgets/DynamicWidget/components/ActiveMidnightWalletBalance/ActiveMidnightWalletBalance.cjs

@@ -8,6 +8,7 @@ var jsxRuntime = require('react/jsx-runtime');
 var React = require('react');
 var reactI18next = require('react-i18next');
 var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
+var Button = require('../../../../components/Button/Button.cjs');
 var Skeleton = require('../../../../components/Skeleton/Skeleton.cjs');
 require('../../../../context/DynamicContext/useDynamicContext/useDynamicContext.cjs');
 var useInternalDynamicContext = require('../../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.cjs');
@@ -26,6 +27,9 @@ var classNames = require('../../../../utils/functions/classNames/classNames.cjs'
 var usePromise = require('../../../../utils/hooks/usePromise/usePromise.cjs');
 
 const DUST_SEGMENTS = 20;
+// Stable keys for the fixed-length decorative dust bar so the segments don't
+// rely on the array index as their React key.
+const DUST_SEGMENT_KEYS = Array.from({ length: DUST_SEGMENTS }, (_, i) => `dust-segment-${i}`);
 const truncateToDecimals = (value, decimals) => {
     const [whole, fractional] = value.split('.');
     if (!fractional || decimals <= 0)
@@ -61,6 +65,10 @@ const ActiveMidnightWalletBalance = ({ isLoading = false, }) => {
     const [activeTab, setActiveTab] = React.useState('shielded');
     const walletAddress = primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.address;
     const enabled = Boolean(!isLoading && primaryWallet && walletConnectorCore.isMidnightConnector(primaryWallet.connector));
+    // Balance reads resolve on shielded+unshielded; dust finishes in the
+    // background. While dust is still syncing we re-fetch on an interval so the
+    // dust gauge fills in once it's ready (shielded/unshielded already final).
+    const [dustPollTick, setDustPollTick] = React.useState(0);
     const { data: balances, isLoading: balancesLoading } = usePromise.usePromise(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         if (!primaryWallet ||
             !walletConnectorCore.isMidnightConnector(primaryWallet.connector) ||
@@ -69,11 +77,31 @@ const ActiveMidnightWalletBalance = ({ isLoading = false, }) => {
         }
         return primaryWallet.getFormattedBalances();
     }), {
-        deps: [walletAddress, primaryWallet],
+        deps: [walletAddress, primaryWallet, dustPollTick],
         enabled,
     });
-    const { dustBalance, shieldedBalance, unshieldedBalance } = balances !== null && balances !== void 0 ? balances : {};
-    if (isLoading || balancesLoading) {
+    const { dustBalance, shieldedBalance, unshieldedBalance, dustSyncing } = balances !== null && balances !== void 0 ? balances : {};
+    React.useEffect(() => {
+        if (!dustSyncing)
+            return undefined;
+        const id = setInterval(() => setDustPollTick((tick) => tick + 1), 15000);
+        return () => clearInterval(id);
+    }, [dustSyncing]);
+    // `registerDust` is a WaaS-only connector method (external/injected Midnight
+    // wallets manage dust themselves). When the embedded wallet has no dust
+    // registered yet, we surface a "Register DUST" button instead of the gauge.
+    const isWaasWallet = Boolean(primaryWallet && walletConnectorCore.isDynamicWaasConnector(primaryWallet.connector));
+    const handleRegisterDust = () => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        const connector = primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.connector;
+        if (!(connector === null || connector === void 0 ? void 0 : connector.registerDust))
+            return;
+        yield connector.registerDust();
+        // Dust generation begins after registration; re-fetch so the gauge appears.
+        setDustPollTick((tick) => tick + 1);
+    });
+    // Only show the full skeleton on the very first load; background dust polls
+    // keep `balances` populated so the view never flashes back to a skeleton.
+    if ((isLoading || balancesLoading) && !balances) {
         return (jsxRuntime.jsx("div", { className: 'active-midnight-balance', children: jsxRuntime.jsx(Skeleton.Skeleton, { className: 'active-midnight-balance__skeleton' }) }));
     }
     const dustFill = dustBalance
@@ -86,16 +114,31 @@ const ActiveMidnightWalletBalance = ({ isLoading = false, }) => {
         }
         : undefined;
     const activeBalance = activeTab === 'shielded' ? shieldedBalance : unshieldedBalance;
-    return (jsxRuntime.jsx("div", { className: 'active-midnight-balance', children: jsxRuntime.jsxs("div", { className: 'active-midnight-balance__card', children: [dustBalance && (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [jsxRuntime.jsxs("div", { className: 'active-midnight-balance__dust', children: [jsxRuntime.jsxs("div", { className: 'active-midnight-balance__dust-header', children: [jsxRuntime.jsxs("div", { className: 'active-midnight-balance__dust-title', children: [jsxRuntime.jsx("svg", { className: 'active-midnight-balance__dust-icon', width: '12', height: '12', viewBox: '0 0 24 24', children: jsxRuntime.jsx("path", { d: 'M13 2L3 14h9l-1 8 10-12h-9l1-8z' }) }), jsxRuntime.jsx("span", { className: 'active-midnight-balance__dust-label', "data-copykey": 'dyn_active_wallet_info.midnight_dust_generating', children: t('dyn_active_wallet_info.midnight_dust_generating') })] }), jsxRuntime.jsxs("span", { className: 'active-midnight-balance__dust-count', children: [dustBalanceDisplay === null || dustBalanceDisplay === void 0 ? void 0 : dustBalanceDisplay.balance, "/", dustBalanceDisplay === null || dustBalanceDisplay === void 0 ? void 0 : dustBalanceDisplay.cap] })] }), jsxRuntime.jsx("div", { className: 'active-midnight-balance__dust-bar', children: Array.from({ length: DUST_SEGMENTS }, (_, i) => (jsxRuntime.jsx("div", { className: [
-                                            'active-midnight-balance__dust-segment',
-                                            i === 0 && 'active-midnight-balance__dust-segment--first',
-                                            i === DUST_SEGMENTS - 1 &&
-                                                'active-midnight-balance__dust-segment--last',
-                                            i < dustFill &&
-                                                'active-midnight-balance__dust-segment--filled',
-                                        ]
-                                            .filter(Boolean)
-                                            .join(' ') }, i))) })] }), jsxRuntime.jsx("div", { className: 'active-midnight-balance__divider' })] })), jsxRuntime.jsx("div", { className: 'active-midnight-balance__tab-bar', children: TABS.map(({ id, copykey }) => (jsxRuntime.jsx("button", { className: classNames.classNames('active-midnight-balance__tab', {
+    // Dust section has three mutually exclusive states (syncing, generating with
+    // a balance, and the WaaS "register dust" prompt). Resolved via a helper to
+    // avoid nesting ternaries in the JSX below.
+    const renderDustSection = () => {
+        if (dustSyncing) {
+            return (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [jsxRuntime.jsx("div", { className: 'active-midnight-balance__dust', children: jsxRuntime.jsx("div", { className: 'active-midnight-balance__dust-header', children: jsxRuntime.jsxs("div", { className: 'active-midnight-balance__dust-title', children: [jsxRuntime.jsx("svg", { className: 'active-midnight-balance__dust-icon', width: '12', height: '12', viewBox: '0 0 24 24', children: jsxRuntime.jsx("path", { d: 'M13 2L3 14h9l-1 8 10-12h-9l1-8z' }) }), jsxRuntime.jsx("span", { className: 'active-midnight-balance__dust-label', "data-copykey": 'dyn_active_wallet_info.midnight_dust_syncing', children: t('dyn_active_wallet_info.midnight_dust_syncing') })] }) }) }), jsxRuntime.jsx("div", { className: 'active-midnight-balance__divider' })] }));
+        }
+        if (dustBalance) {
+            return (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [jsxRuntime.jsxs("div", { className: 'active-midnight-balance__dust', children: [jsxRuntime.jsxs("div", { className: 'active-midnight-balance__dust-header', children: [jsxRuntime.jsxs("div", { className: 'active-midnight-balance__dust-title', children: [jsxRuntime.jsx("svg", { className: 'active-midnight-balance__dust-icon', width: '12', height: '12', viewBox: '0 0 24 24', children: jsxRuntime.jsx("path", { d: 'M13 2L3 14h9l-1 8 10-12h-9l1-8z' }) }), jsxRuntime.jsx("span", { className: 'active-midnight-balance__dust-label', "data-copykey": 'dyn_active_wallet_info.midnight_dust_generating', children: t('dyn_active_wallet_info.midnight_dust_generating') })] }), jsxRuntime.jsxs("span", { className: 'active-midnight-balance__dust-count', children: [dustBalanceDisplay === null || dustBalanceDisplay === void 0 ? void 0 : dustBalanceDisplay.balance, "/", dustBalanceDisplay === null || dustBalanceDisplay === void 0 ? void 0 : dustBalanceDisplay.cap] })] }), jsxRuntime.jsx("div", { className: 'active-midnight-balance__dust-bar', children: DUST_SEGMENT_KEYS.map((segmentKey, i) => (jsxRuntime.jsx("div", { className: [
+                                        'active-midnight-balance__dust-segment',
+                                        i === 0 && 'active-midnight-balance__dust-segment--first',
+                                        i === DUST_SEGMENTS - 1 &&
+                                            'active-midnight-balance__dust-segment--last',
+                                        i < dustFill &&
+                                            'active-midnight-balance__dust-segment--filled',
+                                    ]
+                                        .filter(Boolean)
+                                        .join(' ') }, segmentKey))) })] }), jsxRuntime.jsx("div", { className: 'active-midnight-balance__divider' })] }));
+        }
+        if (isWaasWallet) {
+            return (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [jsxRuntime.jsxs("div", { className: 'active-midnight-balance__dust', children: [jsxRuntime.jsx("div", { className: 'active-midnight-balance__dust-header', children: jsxRuntime.jsxs("div", { className: 'active-midnight-balance__dust-title', children: [jsxRuntime.jsx("svg", { className: 'active-midnight-balance__dust-icon', width: '12', height: '12', viewBox: '0 0 24 24', children: jsxRuntime.jsx("path", { d: 'M13 2L3 14h9l-1 8 10-12h-9l1-8z' }) }), jsxRuntime.jsx("span", { className: 'active-midnight-balance__dust-label', "data-copykey": 'dyn_active_wallet_info.midnight_dust_generating', children: t('dyn_active_wallet_info.midnight_dust_generating') })] }) }), jsxRuntime.jsx(Button.Button, { buttonPadding: 'small', buttonVariant: 'secondary', buttonClassName: 'active-midnight-balance__register-dust-button', onClick: handleRegisterDust, "data-copykey": 'dyn_active_wallet_info.midnight_register_dust', children: t('dyn_active_wallet_info.midnight_register_dust') })] }), jsxRuntime.jsx("div", { className: 'active-midnight-balance__divider' })] }));
+        }
+        return null;
+    };
+    return (jsxRuntime.jsx("div", { className: 'active-midnight-balance', children: jsxRuntime.jsxs("div", { className: 'active-midnight-balance__card', children: [renderDustSection(), jsxRuntime.jsx("div", { className: 'active-midnight-balance__tab-bar', children: TABS.map(({ id, copykey }) => (jsxRuntime.jsx("button", { className: classNames.classNames('active-midnight-balance__tab', {
                             'active-midnight-balance__tab--active': activeTab === id,
                         }), "data-copykey": copykey, onClick: () => setActiveTab(id), children: t(copykey) }, id))) }), jsxRuntime.jsxs("div", { className: 'active-midnight-balance__pocket', children: [activeTab === 'shielded' ? (jsxRuntime.jsx(midnightShielded.ReactComponent, { className: 'active-midnight-balance__pocket-icon' })) : (jsxRuntime.jsx(midnightUnshielded.ReactComponent, { className: 'active-midnight-balance__pocket-icon' })), jsxRuntime.jsxs("span", { className: 'active-midnight-balance__amount', children: [activeBalance !== null && activeBalance !== void 0 ? activeBalance : '—', " NIGHT"] })] })] }) }));
 };