@dynamic-labs/sdk-react-core 4.62.0 → 4.63.1

package/CHANGELOG.md

@@ -1,4 +1,35 @@
 
+### [4.63.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.63.0...v4.63.1) (2026-02-24)
+
+
+### Features
+
+* add elevated access token to WaaS export ([#10481](https://github.com/dynamic-labs/dynamic-auth/issues/10481)) ([9a3c6a6](https://github.com/dynamic-labs/dynamic-auth/commit/9a3c6a6eaa4bd7ced5aeb873fe7872717d0e25d9))
+* add multi-wallet delegation support with React parity ([#10450](https://github.com/dynamic-labs/dynamic-auth/issues/10450)) ([e4d5135](https://github.com/dynamic-labs/dynamic-auth/commit/e4d5135c50595c022dfb02da2d9f05a389c0ee09))
+* add Stellar chain support with balance fetching and network mapping ([#10494](https://github.com/dynamic-labs/dynamic-auth/issues/10494)) ([f12553c](https://github.com/dynamic-labs/dynamic-auth/commit/f12553ce864a56a75f87d1d55c087e1fc9378cc6))
+* add Stellar WaaS transaction signing and broadcast UI ([#10495](https://github.com/dynamic-labs/dynamic-auth/issues/10495)) ([f87a860](https://github.com/dynamic-labs/dynamic-auth/commit/f87a860f59cdf5b0c4f99586c61e60186efc19f2))
+
+
+### Bug Fixes
+
+* cancel authFlowClose timeout when navigation occurs during delay ([#10487](https://github.com/dynamic-labs/dynamic-auth/issues/10487)) ([aef92b4](https://github.com/dynamic-labs/dynamic-auth/commit/aef92b4a80827c517819cc63414acdf3e9ad7b05))
+* **e2e:** update gating test to expect user:basic scope ([#10505](https://github.com/dynamic-labs/dynamic-auth/issues/10505)) ([56f449a](https://github.com/dynamic-labs/dynamic-auth/commit/56f449a282f37b33d365d60380c7a68c1cf5eced)), closes [dynamic-labs/redcoast#8339](https://github.com/dynamic-labs/redcoast/issues/8339)
+* use selected network for Horizon server and include WaaS connector in StellarWalletConnectors ([#10493](https://github.com/dynamic-labs/dynamic-auth/issues/10493)) ([f340c09](https://github.com/dynamic-labs/dynamic-auth/commit/f340c094f08afb39829f2d90db2ec665a69ba469))
+* **waas:** normalize SOL to SVM chain name when looking up WaaS connector ([#10506](https://github.com/dynamic-labs/dynamic-auth/issues/10506)) ([102d314](https://github.com/dynamic-labs/dynamic-auth/commit/102d3142d65d0e67338884affc736e5151a8e296))
+
+## [4.63.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.62.0...v4.63.0) (2026-02-24)
+
+
+### Features
+
+* **react-native:** raise walletReturnFromDeepLink event to allow redirecting back to the same route as before ([#10364](https://github.com/dynamic-labs/dynamic-auth/issues/10364)) ([cd56fd0](https://github.com/dynamic-labs/dynamic-auth/commit/cd56fd089e867bb5ed09a7c999b04480d8f59f81))
+
+
+### Bug Fixes
+
+* **react-native:** include redirectUrl in WalletConnect connection deep links on iOS and add session redirect metadata for Solana ([#10479](https://github.com/dynamic-labs/dynamic-auth/issues/10479)) ([68829f9](https://github.com/dynamic-labs/dynamic-auth/commit/68829f9ef39c845917ce49bfd63922e5252c2299))
+* ton external wallet connection ([#10460](https://github.com/dynamic-labs/dynamic-auth/issues/10460)) ([7431a74](https://github.com/dynamic-labs/dynamic-auth/commit/7431a74fcd0bcd04755e6a81b49aa24dfc261f09))
+
 ## [4.62.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.61.7...v4.62.0) (2026-02-23)
 
 

package/package.cjs

@@ -3,11 +3,11 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.62.0";
+var version = "4.63.1";
 var dependencies = {
-	"@dynamic-labs/sdk-api-core": "0.0.864",
-	"@dynamic-labs-sdk/client": "0.8.0",
-	"@dynamic-labs-wallet/browser-wallet-client": "0.0.269",
+	"@dynamic-labs/sdk-api-core": "0.0.875",
+	"@dynamic-labs-sdk/client": "0.12.1",
+	"@dynamic-labs-wallet/browser-wallet-client": "0.0.276",
 	"@hcaptcha/react-hcaptcha": "1.4.4",
 	"@thumbmarkjs/thumbmarkjs": "0.16.0",
 	"country-list": "2.3.0",

package/package.js

@@ -1,9 +1,9 @@
 'use client'
-var version = "4.62.0";
+var version = "4.63.1";
 var dependencies = {
-	"@dynamic-labs/sdk-api-core": "0.0.864",
-	"@dynamic-labs-sdk/client": "0.8.0",
-	"@dynamic-labs-wallet/browser-wallet-client": "0.0.269",
+	"@dynamic-labs/sdk-api-core": "0.0.875",
+	"@dynamic-labs-sdk/client": "0.12.1",
+	"@dynamic-labs-wallet/browser-wallet-client": "0.0.276",
 	"@hcaptcha/react-hcaptcha": "1.4.4",
 	"@thumbmarkjs/thumbmarkjs": "0.16.0",
 	"country-list": "2.3.0",

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@dynamic-labs/sdk-react-core",
-  "version": "4.62.0",
+  "version": "4.63.1",
   "dependencies": {
-    "@dynamic-labs/sdk-api-core": "0.0.864",
-    "@dynamic-labs-sdk/client": "0.8.0",
-    "@dynamic-labs-wallet/browser-wallet-client": "0.0.269",
+    "@dynamic-labs/sdk-api-core": "0.0.875",
+    "@dynamic-labs-sdk/client": "0.12.1",
+    "@dynamic-labs-wallet/browser-wallet-client": "0.0.276",
     "@hcaptcha/react-hcaptcha": "1.4.4",
     "@thumbmarkjs/thumbmarkjs": "0.16.0",
     "country-list": "2.3.0",
@@ -16,17 +16,17 @@
     "yup": "0.32.11",
     "react-international-phone": "4.5.0",
     "bs58": "5.0.0",
-    "@dynamic-labs/assert-package-version": "4.62.0",
-    "@dynamic-labs/iconic": "4.62.0",
-    "@dynamic-labs/locale": "4.62.0",
-    "@dynamic-labs/logger": "4.62.0",
-    "@dynamic-labs/multi-wallet": "4.62.0",
-    "@dynamic-labs/rpc-providers": "4.62.0",
-    "@dynamic-labs/store": "4.62.0",
-    "@dynamic-labs/types": "4.62.0",
-    "@dynamic-labs/utils": "4.62.0",
-    "@dynamic-labs/wallet-book": "4.62.0",
-    "@dynamic-labs/wallet-connector-core": "4.62.0",
+    "@dynamic-labs/assert-package-version": "4.63.1",
+    "@dynamic-labs/iconic": "4.63.1",
+    "@dynamic-labs/locale": "4.63.1",
+    "@dynamic-labs/logger": "4.63.1",
+    "@dynamic-labs/multi-wallet": "4.63.1",
+    "@dynamic-labs/rpc-providers": "4.63.1",
+    "@dynamic-labs/store": "4.63.1",
+    "@dynamic-labs/types": "4.63.1",
+    "@dynamic-labs/utils": "4.63.1",
+    "@dynamic-labs/wallet-book": "4.63.1",
+    "@dynamic-labs/wallet-connector-core": "4.63.1",
     "eventemitter3": "5.0.1"
   },
   "devDependencies": {

package/src/lib/context/DynamicContext/DynamicContext.cjs

@@ -153,6 +153,7 @@ var PhantomRedirectContext = require('../PhantomRedirectContext/PhantomRedirectC
 var ReinitializeContextProvider = require('../ReinitializeContext/ReinitializeContextProvider.cjs');
 var SendBalanceContext = require('../SendBalanceContext/SendBalanceContext.cjs');
 var UseNetworkValidation = require('../UseNetworkValidation/UseNetworkValidation.cjs');
+var useWalletReturnRoute = require('../../utils/hooks/useWalletReturnRoute/useWalletReturnRoute.cjs');
 var onReinitialize = require('./functions/onReinitialize/onReinitialize.cjs');
 var helpers = require('./helpers/helpers.cjs');
 var useDisplayOrderState = require('./hooks/useDisplayOrderState/useDisplayOrderState.cjs');
@@ -416,6 +417,8 @@ const InnerDynamicContextProvider = (props) => {
         clientCallbacks: settings$1.events,
         user,
     });
+    // Listen for wallet deep link returns and emit events (mobile only)
+    useWalletReturnRoute.useWalletReturnRoute();
     const removeWallet = useRemoveWallet.useRemoveWallet({
         handleLogOut,
         secondaryWallets,

package/src/lib/context/DynamicContext/DynamicContext.js

@@ -149,6 +149,7 @@ import { PhantomRedirectContextProvider } from '../PhantomRedirectContext/Phanto
 import { useReinitializeState, ReinitializeContextProvider } from '../ReinitializeContext/ReinitializeContextProvider.js';
 import { SendBalanceContextProvider } from '../SendBalanceContext/SendBalanceContext.js';
 import { UseNetworkValidation } from '../UseNetworkValidation/UseNetworkValidation.js';
+import { useWalletReturnRoute } from '../../utils/hooks/useWalletReturnRoute/useWalletReturnRoute.js';
 import { onReinitialize } from './functions/onReinitialize/onReinitialize.js';
 import { resolveNetworkValidationMode, getDeepLinkPreference } from './helpers/helpers.js';
 import { useDisplayOrderState } from './hooks/useDisplayOrderState/useDisplayOrderState.js';
@@ -412,6 +413,8 @@ const InnerDynamicContextProvider = (props) => {
         clientCallbacks: settings.events,
         user,
     });
+    // Listen for wallet deep link returns and emit events (mobile only)
+    useWalletReturnRoute();
     const removeWallet = useRemoveWallet({
         handleLogOut,
         secondaryWallets,

package/src/lib/context/DynamicContext/hooks/useTieCallbacksToEvents/useTieCallbacksToEvents.cjs

@@ -186,6 +186,10 @@ const useTieCallbacksToEvents = ({ clientCallbacks, user, }) => {
         var _a;
         (_a = clientCallbacks === null || clientCallbacks === void 0 ? void 0 : clientCallbacks.onWalletConnectionFailed) === null || _a === void 0 ? void 0 : _a.call(clientCallbacks, walletConnector, error);
     });
+    useDynamicEvents.useInternalDynamicEvents('walletReturnFromDeepLink', (params) => {
+        var _a;
+        (_a = clientCallbacks === null || clientCallbacks === void 0 ? void 0 : clientCallbacks.onWalletReturnFromDeepLink) === null || _a === void 0 ? void 0 : _a.call(clientCallbacks, params);
+    });
 };
 
 exports.useTieCallbacksToEvents = useTieCallbacksToEvents;

package/src/lib/context/DynamicContext/hooks/useTieCallbacksToEvents/useTieCallbacksToEvents.js

@@ -182,6 +182,10 @@ const useTieCallbacksToEvents = ({ clientCallbacks, user, }) => {
         var _a;
         (_a = clientCallbacks === null || clientCallbacks === void 0 ? void 0 : clientCallbacks.onWalletConnectionFailed) === null || _a === void 0 ? void 0 : _a.call(clientCallbacks, walletConnector, error);
     });
+    useInternalDynamicEvents('walletReturnFromDeepLink', (params) => {
+        var _a;
+        (_a = clientCallbacks === null || clientCallbacks === void 0 ? void 0 : clientCallbacks.onWalletReturnFromDeepLink) === null || _a === void 0 ? void 0 : _a.call(clientCallbacks, params);
+    });
 };
 
 export { useTieCallbacksToEvents };

package/src/lib/context/ViewContext/ViewContext.cjs

@@ -13,6 +13,13 @@ const ViewContext = React.createContext(undefined);
 const ViewContextProvider = ({ children, initialViewType }) => {
     var _a;
     const [stack, setStack] = React.useState([]);
+    const authFlowCloseTimeoutRef = React.useRef(null);
+    const cancelAuthFlowCloseTimeout = React.useCallback(() => {
+        if (authFlowCloseTimeoutRef.current !== null) {
+            clearTimeout(authFlowCloseTimeoutRef.current);
+            authFlowCloseTimeoutRef.current = null;
+        }
+    }, []);
     const initialView = React.useMemo(() => ({ type: initialViewType }), [initialViewType]);
     const view = (_a = stack[stack.length - 1]) !== null && _a !== void 0 ? _a : initialView;
     const { clearError } = ErrorContext.useErrorContext();
@@ -20,10 +27,12 @@ const ViewContextProvider = ({ children, initialViewType }) => {
         if (view.type === type) {
             // Update the current view props and events
             if (props !== view.props || events !== view.events) {
+                cancelAuthFlowCloseTimeout();
                 setStack((stack) => [...stack.slice(0, -1), { events, props, type }]);
             }
             return;
         }
+        cancelAuthFlowCloseTimeout();
         clearError();
         // If the stack was "empty" (i.e. showing a default view), let's make sure the stack
         // reflects this by having this default view as the first item in the stack
@@ -33,10 +42,11 @@ const ViewContextProvider = ({ children, initialViewType }) => {
             else
                 return [...stack, { events, props, type }];
         });
-    }, [clearError, view.type, initialViewType]);
+    }, [cancelAuthFlowCloseTimeout, clearError, view.type, initialViewType]);
     const replaceView = React.useCallback((type, props, events) => {
         if (view.type === type)
             return;
+        cancelAuthFlowCloseTimeout();
         clearError();
         setStack((prev) => {
             if (prev.length <= 1) {
@@ -44,7 +54,7 @@ const ViewContextProvider = ({ children, initialViewType }) => {
             }
             return [...prev.slice(0, -1), { events, props, type }];
         });
-    }, [clearError, initialViewType, view.type]);
+    }, [cancelAuthFlowCloseTimeout, clearError, initialViewType, view.type]);
     const canGoBack = stack.length > 1;
     const goBack = React.useCallback(() => {
         if (!canGoBack)
@@ -54,9 +64,10 @@ const ViewContextProvider = ({ children, initialViewType }) => {
         dynamicEvents.dynamicEvents.emit('goBack');
     }, [canGoBack, clearError]);
     const clearStackAndPush = React.useCallback((type, props, events) => {
+        cancelAuthFlowCloseTimeout();
         clearError();
         setStack([{ events, props, type }]);
-    }, [clearError]);
+    }, [cancelAuthFlowCloseTimeout, clearError]);
     const clearStackAndPushInitialView = React.useCallback(() => {
         clearError();
         setStack((stack) => {
@@ -67,7 +78,13 @@ const ViewContextProvider = ({ children, initialViewType }) => {
     }, [clearError]);
     useDynamicEvents.useInternalDynamicEvents('logout', clearStackAndPushInitialView);
     // Wait for the auth flow animation transition to finish before clearing the stack
-    useDynamicEvents.useInternalDynamicEvents('authFlowClose', () => setTimeout(clearStackAndPushInitialView, 100));
+    useDynamicEvents.useInternalDynamicEvents('authFlowClose', () => {
+        cancelAuthFlowCloseTimeout();
+        authFlowCloseTimeoutRef.current = setTimeout(() => {
+            authFlowCloseTimeoutRef.current = null;
+            clearStackAndPushInitialView();
+        }, 100);
+    });
     const value = React.useMemo(() => ({
         canGoBack: stack.length > 1,
         clearStackAndPush,

package/src/lib/context/ViewContext/ViewContext.js

@@ -1,6 +1,6 @@
 'use client'
 import { jsx } from 'react/jsx-runtime';
-import { createContext, useContext, useState, useMemo, useCallback } from 'react';
+import { createContext, useContext, useState, useRef, useCallback, useMemo } from 'react';
 import { useInternalDynamicEvents } from '../../utils/hooks/events/useDynamicEvents/useDynamicEvents.js';
 import { useErrorContext } from '../ErrorContext/ErrorContext.js';
 import { dynamicEvents } from '../../events/dynamicEvents.js';
@@ -9,6 +9,13 @@ const ViewContext = createContext(undefined);
 const ViewContextProvider = ({ children, initialViewType }) => {
     var _a;
     const [stack, setStack] = useState([]);
+    const authFlowCloseTimeoutRef = useRef(null);
+    const cancelAuthFlowCloseTimeout = useCallback(() => {
+        if (authFlowCloseTimeoutRef.current !== null) {
+            clearTimeout(authFlowCloseTimeoutRef.current);
+            authFlowCloseTimeoutRef.current = null;
+        }
+    }, []);
     const initialView = useMemo(() => ({ type: initialViewType }), [initialViewType]);
     const view = (_a = stack[stack.length - 1]) !== null && _a !== void 0 ? _a : initialView;
     const { clearError } = useErrorContext();
@@ -16,10 +23,12 @@ const ViewContextProvider = ({ children, initialViewType }) => {
         if (view.type === type) {
             // Update the current view props and events
             if (props !== view.props || events !== view.events) {
+                cancelAuthFlowCloseTimeout();
                 setStack((stack) => [...stack.slice(0, -1), { events, props, type }]);
             }
             return;
         }
+        cancelAuthFlowCloseTimeout();
         clearError();
         // If the stack was "empty" (i.e. showing a default view), let's make sure the stack
         // reflects this by having this default view as the first item in the stack
@@ -29,10 +38,11 @@ const ViewContextProvider = ({ children, initialViewType }) => {
             else
                 return [...stack, { events, props, type }];
         });
-    }, [clearError, view.type, initialViewType]);
+    }, [cancelAuthFlowCloseTimeout, clearError, view.type, initialViewType]);
     const replaceView = useCallback((type, props, events) => {
         if (view.type === type)
             return;
+        cancelAuthFlowCloseTimeout();
         clearError();
         setStack((prev) => {
             if (prev.length <= 1) {
@@ -40,7 +50,7 @@ const ViewContextProvider = ({ children, initialViewType }) => {
             }
             return [...prev.slice(0, -1), { events, props, type }];
         });
-    }, [clearError, initialViewType, view.type]);
+    }, [cancelAuthFlowCloseTimeout, clearError, initialViewType, view.type]);
     const canGoBack = stack.length > 1;
     const goBack = useCallback(() => {
         if (!canGoBack)
@@ -50,9 +60,10 @@ const ViewContextProvider = ({ children, initialViewType }) => {
         dynamicEvents.emit('goBack');
     }, [canGoBack, clearError]);
     const clearStackAndPush = useCallback((type, props, events) => {
+        cancelAuthFlowCloseTimeout();
         clearError();
         setStack([{ events, props, type }]);
-    }, [clearError]);
+    }, [cancelAuthFlowCloseTimeout, clearError]);
     const clearStackAndPushInitialView = useCallback(() => {
         clearError();
         setStack((stack) => {
@@ -63,7 +74,13 @@ const ViewContextProvider = ({ children, initialViewType }) => {
     }, [clearError]);
     useInternalDynamicEvents('logout', clearStackAndPushInitialView);
     // Wait for the auth flow animation transition to finish before clearing the stack
-    useInternalDynamicEvents('authFlowClose', () => setTimeout(clearStackAndPushInitialView, 100));
+    useInternalDynamicEvents('authFlowClose', () => {
+        cancelAuthFlowCloseTimeout();
+        authFlowCloseTimeoutRef.current = setTimeout(() => {
+            authFlowCloseTimeoutRef.current = null;
+            clearStackAndPushInitialView();
+        }, 100);
+    });
     const value = useMemo(() => ({
         canGoBack: stack.length > 1,
         clearStackAndPush,

package/src/lib/events/dynamicEvents.cjs

@@ -33,6 +33,7 @@ const externalEvents = [
     'walletConnectionFailed',
     'embeddedWalletRevealCompleted',
     'embeddedWalletRevealFailed',
+    'walletReturnFromDeepLink',
 ];
 // Full internal event emitter
 const dynamicEvents = new EventEmitter__default["default"]();

package/src/lib/events/dynamicEvents.d.ts

@@ -14,7 +14,7 @@ import { WalletEvents } from './wallets';
 export type DynamicEvents = AuthEvents & UIEvents & OTPEvents & WalletEvents & PasskeyEvents & SocialEvents & EmbeddedWalletEvents & MultiWalletInternalEvents & TokenBalancesEvents & UserEvents & FundingEvents;
 type PublicDynamicEvents = Pick<DynamicEvents, typeof externalEvents[number]>;
 /** Which events are accessible by our clients */
-export declare const externalEvents: ("authFailure" | "authInit" | "logout" | "mfaCompletionSuccess" | "mfaCompletionFailure" | "authFlowOpen" | "authFlowClose" | "authFlowCancelled" | "walletTabSelected" | "emailVerificationResult" | "smsVerificationResult" | "walletAdded" | "walletRemoved" | "primaryWalletChanged" | "primaryWalletNetworkChanged" | "userWalletsChanged" | "walletConnectionFailed" | "walletConnectionQrCodeReady" | "embeddedWalletCreated" | "embeddedWalletRevealCompleted" | "embeddedWalletRevealFailed" | "walletConnectedForFunding")[];
+export declare const externalEvents: ("authFailure" | "authInit" | "logout" | "mfaCompletionSuccess" | "mfaCompletionFailure" | "authFlowOpen" | "authFlowClose" | "authFlowCancelled" | "walletTabSelected" | "emailVerificationResult" | "smsVerificationResult" | "walletAdded" | "walletRemoved" | "primaryWalletChanged" | "primaryWalletNetworkChanged" | "userWalletsChanged" | "walletConnectionFailed" | "walletConnectionQrCodeReady" | "walletReturnFromDeepLink" | "embeddedWalletCreated" | "embeddedWalletRevealCompleted" | "embeddedWalletRevealFailed" | "walletConnectedForFunding")[];
 export declare const dynamicEvents: EventEmitter<DynamicEvents, any>;
 export declare const publicDynamicEvents: EventEmitter<PublicDynamicEvents, any>;
 export type DynamicEventEmitter = typeof dynamicEvents;

package/src/lib/events/dynamicEvents.js

@@ -25,6 +25,7 @@ const externalEvents = [
     'walletConnectionFailed',
     'embeddedWalletRevealCompleted',
     'embeddedWalletRevealFailed',
+    'walletReturnFromDeepLink',
 ];
 // Full internal event emitter
 const dynamicEvents = new EventEmitter();

package/src/lib/events/wallets.d.ts

@@ -39,4 +39,8 @@ export type WalletEvents = {
     walletConnectionFailed: (walletConnector: WalletConnector, error: unknown) => void;
     /** Triggered when a wallet connection QR code is ready */
     walletConnectionQrCodeReady: (qrCodeUri: string) => void;
+    /** Triggered when the app returns from a wallet deep link (mobile only) */
+    walletReturnFromDeepLink: (params: {
+        previousRoute: string;
+    }) => void;
 };

package/src/lib/shared/types/dynamicEventsCallbacks.d.ts

@@ -39,6 +39,14 @@ export type DynamicEventsCallbacks = {
         index: number;
         tab: WalletListViewTabItem;
     }) => void;
+    /**
+     * Called when the app returns from a wallet deep link (mobile only).
+     * Use this to navigate back to the route the user was on before
+     * the wallet operation.
+     */
+    onWalletReturnFromDeepLink?: (params: {
+        previousRoute: string;
+    }) => void;
 };
 export type OnAuthSuccess = (params: {
     handleLogOut: () => Promise<void>;

package/src/lib/utils/constants/values.cjs

@@ -18,6 +18,7 @@ const ChainEnumToVerifiedCredentialName = {
     FLOW: 'flow',
     SOL: 'solana',
     STARK: 'starknet',
+    STELLAR: 'stellar',
     TON: 'ton',
 };
 const VerifiedCredentialNameToChainEnum = {
@@ -28,6 +29,7 @@ const VerifiedCredentialNameToChainEnum = {
     flow: sdkApiCore.ChainEnum.Flow,
     solana: sdkApiCore.ChainEnum.Sol,
     starknet: sdkApiCore.ChainEnum.Stark,
+    stellar: sdkApiCore.ChainEnum.Stellar,
     sui: sdkApiCore.ChainEnum.Sui,
     ton: sdkApiCore.ChainEnum.Ton,
 };

package/src/lib/utils/constants/values.js

@@ -14,6 +14,7 @@ const ChainEnumToVerifiedCredentialName = {
     FLOW: 'flow',
     SOL: 'solana',
     STARK: 'starknet',
+    STELLAR: 'stellar',
     TON: 'ton',
 };
 const VerifiedCredentialNameToChainEnum = {
@@ -24,6 +25,7 @@ const VerifiedCredentialNameToChainEnum = {
     flow: ChainEnum.Flow,
     solana: ChainEnum.Sol,
     starknet: ChainEnum.Stark,
+    stellar: ChainEnum.Stellar,
     sui: ChainEnum.Sui,
     ton: ChainEnum.Ton,
 };

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

@@ -5,10 +5,19 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 const isSupportedNetwork = ({ walletConnector, network }) => {
     const enabledNetworks = walletConnector.getEnabledNetworks();
+    // If no networks are configured, all networks are supported
     if (!enabledNetworks.length) {
         return true;
     }
-    const isCurrentNetworkSupported = enabledNetworks.some(({ chainId }) => String(chainId) === String(network));
+    // If network is undefined, the connector hasn't determined the network yet
+    // This can happen during initial load before getNetwork() resolves
+    if (network === undefined) {
+        return false;
+    }
+    // Check if network matches either chainId or networkId
+    // This supports chains like Stellar where getNetwork() returns the chainId hash
+    const isCurrentNetworkSupported = enabledNetworks.some(({ chainId, networkId }) => String(chainId) === String(network) ||
+        String(networkId) === String(network));
     return isCurrentNetworkSupported;
 };
 

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

@@ -1,10 +1,19 @@
 'use client'
 const isSupportedNetwork = ({ walletConnector, network }) => {
     const enabledNetworks = walletConnector.getEnabledNetworks();
+    // If no networks are configured, all networks are supported
     if (!enabledNetworks.length) {
         return true;
     }
-    const isCurrentNetworkSupported = enabledNetworks.some(({ chainId }) => String(chainId) === String(network));
+    // If network is undefined, the connector hasn't determined the network yet
+    // This can happen during initial load before getNetwork() resolves
+    if (network === undefined) {
+        return false;
+    }
+    // Check if network matches either chainId or networkId
+    // This supports chains like Stellar where getNetwork() returns the chainId hash
+    const isCurrentNetworkSupported = enabledNetworks.some(({ chainId, networkId }) => String(chainId) === String(network) ||
+        String(networkId) === String(network));
     return isCurrentNetworkSupported;
 };
 

package/src/lib/utils/hooks/events/useDynamicEvents/useDynamicEvents.d.ts

@@ -4,5 +4,5 @@ type DynamicEventListener<E extends keyof DynamicEvents> = (...args: EventArgs<D
 /** Allows us to subscribe to all dynamicEvents with a hook, even the internal ones */
 export declare const useInternalDynamicEvents: <E extends keyof import("../../../../events/auth").AuthEvents | keyof import("../../../../events/ui").UIEvents | keyof import("../../../../events/otp").OTPEvents | keyof import("../../../../events/wallets").WalletEvents | keyof import("../../../../events/passkey").PasskeyEvents | "farcasterConnectCancelled" | keyof import("../../../../events/embeddedWallet").EmbeddedWalletEvents | keyof import("../../../../events/multiWallet").MultiWalletInternalEvents | "tokenBalancesChanged" | "userProfileUpdated" | "walletConnectedForFunding">(event: E, listener: DynamicEventListener<E>) => void;
 /** Allows subscribing to dynamic events directly inside components with a hook */
-export declare const useDynamicEvents: <E extends "authFailure" | "authInit" | "logout" | "mfaCompletionSuccess" | "mfaCompletionFailure" | "authFlowOpen" | "authFlowClose" | "authFlowCancelled" | "walletTabSelected" | "emailVerificationResult" | "smsVerificationResult" | "walletAdded" | "walletRemoved" | "primaryWalletChanged" | "primaryWalletNetworkChanged" | "userWalletsChanged" | "walletConnectionFailed" | "walletConnectionQrCodeReady" | "embeddedWalletCreated" | "embeddedWalletRevealCompleted" | "embeddedWalletRevealFailed" | "walletConnectedForFunding">(event: E, listener: DynamicEventListener<E>) => void;
+export declare const useDynamicEvents: <E extends "authFailure" | "authInit" | "logout" | "mfaCompletionSuccess" | "mfaCompletionFailure" | "authFlowOpen" | "authFlowClose" | "authFlowCancelled" | "walletTabSelected" | "emailVerificationResult" | "smsVerificationResult" | "walletAdded" | "walletRemoved" | "primaryWalletChanged" | "primaryWalletNetworkChanged" | "userWalletsChanged" | "walletConnectionFailed" | "walletConnectionQrCodeReady" | "walletReturnFromDeepLink" | "embeddedWalletCreated" | "embeddedWalletRevealCompleted" | "embeddedWalletRevealFailed" | "walletConnectedForFunding">(event: E, listener: DynamicEventListener<E>) => void;
 export {};

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

@@ -1 +1,2 @@
+export * from './normalizeWaasChainName';
 export * from './useDynamicWaas';

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

@@ -0,0 +1,11 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const connectedChainToWaasChainName = {
+    SOL: 'SVM',
+};
+const normalizeWaasChainName = (chainName) => { var _a; return (_a = connectedChainToWaasChainName[chainName]) !== null && _a !== void 0 ? _a : chainName; };
+
+exports.normalizeWaasChainName = normalizeWaasChainName;

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

@@ -0,0 +1 @@
+export declare const normalizeWaasChainName: (chainName: string) => string;

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

@@ -0,0 +1,7 @@
+'use client'
+const connectedChainToWaasChainName = {
+    SOL: 'SVM',
+};
+const normalizeWaasChainName = (chainName) => { var _a; return (_a = connectedChainToWaasChainName[chainName]) !== null && _a !== void 0 ? _a : chainName; };
+
+export { normalizeWaasChainName };

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

@@ -87,11 +87,13 @@ require('formik');
 require('../useSubdomainCheck/useSubdomainCheck.cjs');
 require('../../../context/WalletGroupContext/WalletGroupContext.cjs');
 require('../../../widgets/DynamicWidget/context/DynamicWidgetContext.cjs');
+var normalizeWaasChainName = require('./normalizeWaasChainName.cjs');
 var apiUrl = require('../../constants/waas/apiUrl.cjs');
 var useClientSessionKeys = require('../useClientSessionKeys/useClientSessionKeys.cjs');
 var useGetMfaToken = require('../useGetMfaToken/useGetMfaToken.cjs');
 var useGetWalletPassword = require('../useGetWalletPassword/useGetWalletPassword.cjs');
 var useRefreshAuth = require('../useRefreshAuth/useRefreshAuth.cjs');
+var useGetElevatedAccessToken = require('../useGetElevatedAccessToken/useGetElevatedAccessToken.cjs');
 var constants = require('./constants.cjs');
 var normalizeWalletRequirements = require('./normalizeWalletRequirements.cjs');
 require('../useWalletBackup/useWalletBackup.cjs');
@@ -123,7 +125,7 @@ require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
 var useInternalDynamicContext = require('../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.cjs');
 
 const dynamicWaasKey = 'dynamicwaas';
-const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode = 'header', getSignedSessionId, getMfaToken, getWalletPassword, getSvmGasSponsorshipEnabled = () => false, }) => {
+const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode = 'header', getSignedSessionId, getMfaToken, getWalletPassword, getSvmGasSponsorshipEnabled = () => false, getElevatedAccessToken, }) => {
     var _a;
     walletConnector.setEnvironmentId(environmentId);
     walletConnector.setBaseApiUrl((_a = (apiBaseUrl || apiUrl.DEFAULT_WAAS_API_URL)) === null || _a === void 0 ? void 0 : _a.replace('/api/v0', ''));
@@ -139,6 +141,10 @@ const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl,
     walletConnector.setRelayUrl(relayUrl);
     walletConnector.setGetMfaTokenFunction(getMfaToken);
     walletConnector.setBaseClientKeysharesRelayApiUrl(baseClientKeysharesRelayApiUrl);
+    // Set elevated access token provider
+    if (getElevatedAccessToken) {
+        walletConnector.setGetElevatedAccessTokenFunction(getElevatedAccessToken);
+    }
     // Set password provider for locked wallets
     if (getWalletPassword) {
         walletConnector.setGetWalletPasswordFunction(getWalletPassword);
@@ -178,6 +184,7 @@ const useDynamicWaas = () => {
     const { getSignedSessionId } = useClientSessionKeys.useClientSessionKeys();
     const getMfaToken = useGetMfaToken.useGetMfaToken();
     const getWalletPassword = useGetWalletPassword.useGetWalletPassword();
+    const getElevatedAccessToken = useGetElevatedAccessToken.useGetElevatedAccessToken();
     const isCookieAuthEnabled = projectSettings && isCookieEnabled.isCookieEnabled();
     const isUpgrading = React.useRef(false);
     const [recoveredWallets, setRecoveredWallets] = React.useState(() => new Set());
@@ -189,7 +196,8 @@ const useDynamicWaas = () => {
         if (!walletConnectorOptions.length || !environmentId)
             return undefined;
         const walletConnector = (_a = walletConnectorOptions.find((option) => option.key.includes(dynamicWaasKey) &&
-            option.walletConnector.connectedChain === chainName)) === null || _a === void 0 ? void 0 : _a.walletConnector;
+            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);
         }
@@ -198,6 +206,7 @@ const useDynamicWaas = () => {
             authMode: isCookieAuthEnabled ? 'cookie' : 'header',
             baseClientKeysharesRelayApiUrl,
             environmentId,
+            getElevatedAccessToken,
             getMfaToken,
             getSignedSessionId,
             getSvmGasSponsorshipEnabled: () => svmGasSponsorshipEnabledRef.current,
@@ -212,6 +221,7 @@ const useDynamicWaas = () => {
         walletConnectorOptions,
         environmentId,
         apiBaseUrl,
+        getElevatedAccessToken,
         getMfaToken,
         getWalletPassword,
         getSignedSessionId,

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

@@ -1,4 +1,4 @@
-import { ChainEnum, MFAAction } from '@dynamic-labs/sdk-api-core';
+import { ChainEnum, MFAAction, TokenScope } from '@dynamic-labs/sdk-api-core';
 import { GetWalletPasswordFn, IDynamicWaasConnector, Wallet, WalletConnectorCore } from '@dynamic-labs/wallet-connector-core';
 /**
  * Type for wallet creation requirements
@@ -12,7 +12,7 @@ export type WalletCreationRequirement = {
         network?: string;
     };
 };
-export declare const configWaasWalletConnector: ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode, getSignedSessionId, getMfaToken, getWalletPassword, getSvmGasSponsorshipEnabled, }: {
+export declare const configWaasWalletConnector: ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode, getSignedSessionId, getMfaToken, getWalletPassword, getSvmGasSponsorshipEnabled, getElevatedAccessToken, }: {
     walletConnector: IDynamicWaasConnector;
     environmentId: string;
     apiBaseUrl: string;
@@ -25,6 +25,9 @@ export declare const configWaasWalletConnector: ({ walletConnector, environmentI
     }) => Promise<string | undefined>;
     getWalletPassword?: GetWalletPasswordFn;
     getSvmGasSponsorshipEnabled?: () => boolean;
+    getElevatedAccessToken?: (params: {
+        scope: TokenScope;
+    }) => Promise<string | undefined>;
 }) => IDynamicWaasConnector;
 export declare const useDynamicWaas: () => {
     areWalletsReadyForSettings: () => boolean;

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

@@ -83,11 +83,13 @@ import 'formik';
 import '../useSubdomainCheck/useSubdomainCheck.js';
 import '../../../context/WalletGroupContext/WalletGroupContext.js';
 import '../../../widgets/DynamicWidget/context/DynamicWidgetContext.js';
+import { normalizeWaasChainName } from './normalizeWaasChainName.js';
 import { DEFAULT_WAAS_API_URL } from '../../constants/waas/apiUrl.js';
 import { useClientSessionKeys } from '../useClientSessionKeys/useClientSessionKeys.js';
 import { useGetMfaToken } from '../useGetMfaToken/useGetMfaToken.js';
 import { useGetWalletPassword } from '../useGetWalletPassword/useGetWalletPassword.js';
 import { useRefreshAuth } from '../useRefreshAuth/useRefreshAuth.js';
+import { useGetElevatedAccessToken } from '../useGetElevatedAccessToken/useGetElevatedAccessToken.js';
 import { DYNAMIC_WAAS_CONNECTOR_NOT_FOUND_ERROR, NO_ENABLED_CHAINS_ERROR, INVALID_CHAINS_ERROR, WALLET_CREATION_FAILED_ERROR } from './constants.js';
 import { normalizeWalletRequirements } from './normalizeWalletRequirements.js';
 import '../useWalletBackup/useWalletBackup.js';
@@ -119,7 +121,7 @@ import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
 import { useInternalDynamicContext } from '../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.js';
 
 const dynamicWaasKey = 'dynamicwaas';
-const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode = 'header', getSignedSessionId, getMfaToken, getWalletPassword, getSvmGasSponsorshipEnabled = () => false, }) => {
+const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl, relayUrl, baseClientKeysharesRelayApiUrl, authMode = 'header', getSignedSessionId, getMfaToken, getWalletPassword, getSvmGasSponsorshipEnabled = () => false, getElevatedAccessToken, }) => {
     var _a;
     walletConnector.setEnvironmentId(environmentId);
     walletConnector.setBaseApiUrl((_a = (apiBaseUrl || DEFAULT_WAAS_API_URL)) === null || _a === void 0 ? void 0 : _a.replace('/api/v0', ''));
@@ -135,6 +137,10 @@ const configWaasWalletConnector = ({ walletConnector, environmentId, apiBaseUrl,
     walletConnector.setRelayUrl(relayUrl);
     walletConnector.setGetMfaTokenFunction(getMfaToken);
     walletConnector.setBaseClientKeysharesRelayApiUrl(baseClientKeysharesRelayApiUrl);
+    // Set elevated access token provider
+    if (getElevatedAccessToken) {
+        walletConnector.setGetElevatedAccessTokenFunction(getElevatedAccessToken);
+    }
     // Set password provider for locked wallets
     if (getWalletPassword) {
         walletConnector.setGetWalletPasswordFunction(getWalletPassword);
@@ -174,6 +180,7 @@ const useDynamicWaas = () => {
     const { getSignedSessionId } = useClientSessionKeys();
     const getMfaToken = useGetMfaToken();
     const getWalletPassword = useGetWalletPassword();
+    const getElevatedAccessToken = useGetElevatedAccessToken();
     const isCookieAuthEnabled = projectSettings && isCookieEnabled();
     const isUpgrading = useRef(false);
     const [recoveredWallets, setRecoveredWallets] = useState(() => new Set());
@@ -185,7 +192,8 @@ const useDynamicWaas = () => {
         if (!walletConnectorOptions.length || !environmentId)
             return undefined;
         const walletConnector = (_a = walletConnectorOptions.find((option) => option.key.includes(dynamicWaasKey) &&
-            option.walletConnector.connectedChain === chainName)) === null || _a === void 0 ? void 0 : _a.walletConnector;
+            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);
         }
@@ -194,6 +202,7 @@ const useDynamicWaas = () => {
             authMode: isCookieAuthEnabled ? 'cookie' : 'header',
             baseClientKeysharesRelayApiUrl,
             environmentId,
+            getElevatedAccessToken,
             getMfaToken,
             getSignedSessionId,
             getSvmGasSponsorshipEnabled: () => svmGasSponsorshipEnabledRef.current,
@@ -208,6 +217,7 @@ const useDynamicWaas = () => {
         walletConnectorOptions,
         environmentId,
         apiBaseUrl,
+        getElevatedAccessToken,
         getMfaToken,
         getWalletPassword,
         getSignedSessionId,

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

@@ -0,0 +1 @@
+export { useGetElevatedAccessToken } from './useGetElevatedAccessToken';

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

@@ -0,0 +1,12 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../../_virtual/_tslib.cjs');
+var React = require('react');
+var client = require('@dynamic-labs-sdk/client');
+
+const useGetElevatedAccessToken = () => React.useCallback((_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ scope }) { return client.getElevatedAccessToken({ scope }); }), []);
+
+exports.useGetElevatedAccessToken = useGetElevatedAccessToken;

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

@@ -0,0 +1,6 @@
+import { TokenScope } from '@dynamic-labs/sdk-api-core';
+type UseGetElevatedAccessToken = (params: {
+    scope: TokenScope;
+}) => Promise<string | undefined>;
+export declare const useGetElevatedAccessToken: () => UseGetElevatedAccessToken;
+export {};

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

@@ -0,0 +1,8 @@
+'use client'
+import { __awaiter } from '../../../../../_virtual/_tslib.js';
+import { useCallback } from 'react';
+import { getElevatedAccessToken } from '@dynamic-labs-sdk/client';
+
+const useGetElevatedAccessToken = () => useCallback((_a) => __awaiter(void 0, [_a], void 0, function* ({ scope }) { return getElevatedAccessToken({ scope }); }), []);
+
+export { useGetElevatedAccessToken };

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

@@ -42,6 +42,10 @@ var client = require('@dynamic-labs-sdk/client');
  *  );
  * }
  */
-const useGetMultichainTokenBalances = () => React.useCallback((props) => _tslib.__awaiter(void 0, void 0, void 0, function* () { return client.getMultichainBalances({ balanceRequest: props }); }), []);
+const useGetMultichainTokenBalances = () => React.useCallback((props) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    return client.getMultichainBalances({
+        balanceRequest: props,
+    });
+}), []);
 
 exports.useGetMultichainTokenBalances = useGetMultichainTokenBalances;

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

@@ -38,6 +38,10 @@ import { getMultichainBalances } from '@dynamic-labs-sdk/client';
  *  );
  * }
  */
-const useGetMultichainTokenBalances = () => useCallback((props) => __awaiter(void 0, void 0, void 0, function* () { return getMultichainBalances({ balanceRequest: props }); }), []);
+const useGetMultichainTokenBalances = () => useCallback((props) => __awaiter(void 0, void 0, void 0, function* () {
+    return getMultichainBalances({
+        balanceRequest: props,
+    });
+}), []);
 
 export { useGetMultichainTokenBalances };

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

@@ -24,7 +24,7 @@ var errors = require('../../constants/errors.cjs');
 require('@dynamic-labs/multi-wallet');
 require('react-international-phone');
 require('../../../store/state/nonce/nonce.cjs');
-var utils = require('../../../data/api/utils.cjs');
+var utils$1 = require('../../../data/api/utils.cjs');
 require('@dynamic-labs/locale');
 var dynamicContextProps = require('../../../store/state/dynamicContextProps/dynamicContextProps.cjs');
 require('../../../store/state/primaryWalletId/primaryWalletId.cjs');
@@ -108,6 +108,7 @@ require('../../../../index.cjs');
 require('../../../widgets/DynamicWidget/views/ReceiveWalletFunds/ReceiveWalletFunds.cjs');
 var balances = require('../../../data/api/chains/balances.cjs');
 var tokenBalances = require('../../../store/state/tokenBalances.cjs');
+var utils = require('./utils.cjs');
 require('../../../store/state/multichainBalances.cjs');
 require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
 var useInternalDynamicContext = require('../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.cjs');
@@ -134,15 +135,12 @@ const useTokenBalances = ({ accountAddress, networkId, chainName, tokenAddresses
             !((_b = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.featureFlags) === null || _b === void 0 ? void 0 : _b.connectOnlyMultiAsset)) {
             return;
         }
-        // the reason why we need to get the network here again insteaf of using the value
+        // the reason why we need to get the network here again instead of using the value
         // from DynamicContext is because this function might run before the network state is
         // properly set when switching wallets, so we want to make sure we have the latest network
-        let requestNetwork = networkId !== null && networkId !== void 0 ? networkId : (yield (walletConnector === null || walletConnector === void 0 ? void 0 : walletConnector.getNetwork(true)));
-        if (requestChainName === sdkApiCore.ChainEnum.Btc) {
-            // Bitcoin does not need a network ID to fetch token balances but the request requires a network ID
-            requestNetwork = 1;
-        }
-        const isValidRequest = requestNetwork && !isNaN(Number(requestNetwork));
+        const rawNetworkId = networkId !== null && networkId !== void 0 ? networkId : (yield (walletConnector === null || walletConnector === void 0 ? void 0 : walletConnector.getNetwork(true)));
+        const requestNetwork = utils.resolveNetworkIdForRequest(requestChainName, rawNetworkId);
+        const isValidRequest = requestNetwork !== undefined;
         logger.logger.logVerboseTroubleshootingMessage('[useTokenBalances] will try to fetch token balances', {
             isLoading,
             isValidRequest,
@@ -166,7 +164,7 @@ const useTokenBalances = ({ accountAddress, networkId, chainName, tokenAddresses
                 forceRefresh,
                 includeNative: includeNativeBalance,
                 includePrices: includeFiat,
-                networkId: Number(requestNetwork),
+                networkId: requestNetwork,
                 whitelistedContracts,
             });
             if (!response) {
@@ -178,17 +176,8 @@ const useTokenBalances = ({ accountAddress, networkId, chainName, tokenAddresses
         }
         catch (e) {
             const logLevel = (e === null || e === void 0 ? void 0 : e.code) >= 500 || (e === null || e === void 0 ? void 0 : e.code) < 400 ? 'error' : 'warn';
-            yield utils.logResponseError(e, 'Error getting token balances', logLevel);
-            let errorMessage = '';
-            if ((e === null || e === void 0 ? void 0 : e.code) === 429) {
-                errorMessage = 'Too many requests fetching balances';
-            }
-            else if (e === null || e === void 0 ? void 0 : e.message) {
-                errorMessage = e.message;
-            }
-            else {
-                errorMessage = 'error fetching token balance';
-            }
+            yield utils$1.logResponseError(e, 'Error getting token balances', logLevel);
+            const errorMessage = utils.getTokenBalanceErrorMessage(e);
             tokenBalances.setTokenBalanceVariable('error', errorMessage);
         }
         finally {

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

@@ -104,6 +104,7 @@ import '../../../../index.js';
 import '../../../widgets/DynamicWidget/views/ReceiveWalletFunds/ReceiveWalletFunds.js';
 import { getAccountTokenBalances } from '../../../data/api/chains/balances.js';
 import { useTokenBalancesState, setTokenBalanceVariable } from '../../../store/state/tokenBalances.js';
+import { resolveNetworkIdForRequest, getTokenBalanceErrorMessage } from './utils.js';
 import '../../../store/state/multichainBalances.js';
 import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
 import { useInternalDynamicContext } from '../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.js';
@@ -130,15 +131,12 @@ const useTokenBalances = ({ accountAddress, networkId, chainName, tokenAddresses
             !((_b = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.featureFlags) === null || _b === void 0 ? void 0 : _b.connectOnlyMultiAsset)) {
             return;
         }
-        // the reason why we need to get the network here again insteaf of using the value
+        // the reason why we need to get the network here again instead of using the value
         // from DynamicContext is because this function might run before the network state is
         // properly set when switching wallets, so we want to make sure we have the latest network
-        let requestNetwork = networkId !== null && networkId !== void 0 ? networkId : (yield (walletConnector === null || walletConnector === void 0 ? void 0 : walletConnector.getNetwork(true)));
-        if (requestChainName === ChainEnum.Btc) {
-            // Bitcoin does not need a network ID to fetch token balances but the request requires a network ID
-            requestNetwork = 1;
-        }
-        const isValidRequest = requestNetwork && !isNaN(Number(requestNetwork));
+        const rawNetworkId = networkId !== null && networkId !== void 0 ? networkId : (yield (walletConnector === null || walletConnector === void 0 ? void 0 : walletConnector.getNetwork(true)));
+        const requestNetwork = resolveNetworkIdForRequest(requestChainName, rawNetworkId);
+        const isValidRequest = requestNetwork !== undefined;
         logger.logVerboseTroubleshootingMessage('[useTokenBalances] will try to fetch token balances', {
             isLoading,
             isValidRequest,
@@ -162,7 +160,7 @@ const useTokenBalances = ({ accountAddress, networkId, chainName, tokenAddresses
                 forceRefresh,
                 includeNative: includeNativeBalance,
                 includePrices: includeFiat,
-                networkId: Number(requestNetwork),
+                networkId: requestNetwork,
                 whitelistedContracts,
             });
             if (!response) {
@@ -175,16 +173,7 @@ const useTokenBalances = ({ accountAddress, networkId, chainName, tokenAddresses
         catch (e) {
             const logLevel = (e === null || e === void 0 ? void 0 : e.code) >= 500 || (e === null || e === void 0 ? void 0 : e.code) < 400 ? 'error' : 'warn';
             yield logResponseError(e, 'Error getting token balances', logLevel);
-            let errorMessage = '';
-            if ((e === null || e === void 0 ? void 0 : e.code) === 429) {
-                errorMessage = 'Too many requests fetching balances';
-            }
-            else if (e === null || e === void 0 ? void 0 : e.message) {
-                errorMessage = e.message;
-            }
-            else {
-                errorMessage = 'error fetching token balance';
-            }
+            const errorMessage = getTokenBalanceErrorMessage(e);
             setTokenBalanceVariable('error', errorMessage);
         }
         finally {

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

@@ -0,0 +1,77 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var sdkApiCore = require('@dynamic-labs/sdk-api-core');
+
+// Stellar mainnet network hash prefix
+const STELLAR_MAINNET_HASH_PREFIX = '7ac33997';
+// Stellar testnet network hash prefix
+const STELLAR_TESTNET_HASH_PREFIX = 'cee0302d';
+// Stellar CAIP-2 mainnet identifier
+const STELLAR_CAIP2_MAINNET = 'stellar:pubnet';
+// Stellar CAIP-2 testnet identifier
+const STELLAR_CAIP2_TESTNET = 'stellar:testnet';
+// Stellar mainnet numeric network ID
+const STELLAR_MAINNET_NETWORK_ID = 800;
+// Stellar testnet numeric network ID
+const STELLAR_TESTNET_NETWORK_ID = 801;
+/**
+ * Converts Stellar network identifiers to numeric network IDs.
+ * Supports both hash format (7ac33997...) and CAIP-2 format (stellar:pubnet).
+ */
+const convertStellarNetworkToNumeric = (networkId) => {
+    if (networkId === undefined) {
+        return undefined;
+    }
+    const networkStr = String(networkId);
+    const isMainnet = networkStr.startsWith(STELLAR_MAINNET_HASH_PREFIX) ||
+        networkStr === STELLAR_CAIP2_MAINNET;
+    if (isMainnet) {
+        return STELLAR_MAINNET_NETWORK_ID;
+    }
+    const isTestnet = networkStr.startsWith(STELLAR_TESTNET_HASH_PREFIX) ||
+        networkStr === STELLAR_CAIP2_TESTNET;
+    if (isTestnet) {
+        return STELLAR_TESTNET_NETWORK_ID;
+    }
+    // Return original if it's already numeric
+    const numericId = Number(networkId);
+    return isNaN(numericId) ? undefined : numericId;
+};
+/**
+ * Resolves the network ID for API requests, handling chain-specific conversions.
+ */
+const resolveNetworkIdForRequest = (chainName, networkId) => {
+    // Bitcoin does not need a network ID but the request requires one
+    if (chainName === sdkApiCore.ChainEnum.Btc) {
+        return 1;
+    }
+    if (chainName === sdkApiCore.ChainEnum.Stellar) {
+        return convertStellarNetworkToNumeric(networkId);
+    }
+    if (networkId === undefined) {
+        return undefined;
+    }
+    const numericId = Number(networkId);
+    return isNaN(numericId) ? undefined : numericId;
+};
+// Error code for rate limiting
+const RATE_LIMIT_CODE = 429;
+/**
+ * Extracts an appropriate error message from an error object.
+ */
+const getTokenBalanceErrorMessage = (error) => {
+    if ((error === null || error === void 0 ? void 0 : error.code) === RATE_LIMIT_CODE) {
+        return 'Too many requests fetching balances';
+    }
+    if (error === null || error === void 0 ? void 0 : error.message) {
+        return error.message;
+    }
+    return 'error fetching token balance';
+};
+
+exports.convertStellarNetworkToNumeric = convertStellarNetworkToNumeric;
+exports.getTokenBalanceErrorMessage = getTokenBalanceErrorMessage;
+exports.resolveNetworkIdForRequest = resolveNetworkIdForRequest;

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

@@ -0,0 +1,17 @@
+import { ChainEnum } from '@dynamic-labs/sdk-api-core';
+/**
+ * Converts Stellar network identifiers to numeric network IDs.
+ * Supports both hash format (7ac33997...) and CAIP-2 format (stellar:pubnet).
+ */
+export declare const convertStellarNetworkToNumeric: (networkId: string | number | undefined) => number | undefined;
+/**
+ * Resolves the network ID for API requests, handling chain-specific conversions.
+ */
+export declare const resolveNetworkIdForRequest: (chainName: ChainEnum, networkId: string | number | undefined) => number | undefined;
+/**
+ * Extracts an appropriate error message from an error object.
+ */
+export declare const getTokenBalanceErrorMessage: (error: {
+    code?: number;
+    message?: string;
+}) => string;

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

@@ -0,0 +1,71 @@
+'use client'
+import { ChainEnum } from '@dynamic-labs/sdk-api-core';
+
+// Stellar mainnet network hash prefix
+const STELLAR_MAINNET_HASH_PREFIX = '7ac33997';
+// Stellar testnet network hash prefix
+const STELLAR_TESTNET_HASH_PREFIX = 'cee0302d';
+// Stellar CAIP-2 mainnet identifier
+const STELLAR_CAIP2_MAINNET = 'stellar:pubnet';
+// Stellar CAIP-2 testnet identifier
+const STELLAR_CAIP2_TESTNET = 'stellar:testnet';
+// Stellar mainnet numeric network ID
+const STELLAR_MAINNET_NETWORK_ID = 800;
+// Stellar testnet numeric network ID
+const STELLAR_TESTNET_NETWORK_ID = 801;
+/**
+ * Converts Stellar network identifiers to numeric network IDs.
+ * Supports both hash format (7ac33997...) and CAIP-2 format (stellar:pubnet).
+ */
+const convertStellarNetworkToNumeric = (networkId) => {
+    if (networkId === undefined) {
+        return undefined;
+    }
+    const networkStr = String(networkId);
+    const isMainnet = networkStr.startsWith(STELLAR_MAINNET_HASH_PREFIX) ||
+        networkStr === STELLAR_CAIP2_MAINNET;
+    if (isMainnet) {
+        return STELLAR_MAINNET_NETWORK_ID;
+    }
+    const isTestnet = networkStr.startsWith(STELLAR_TESTNET_HASH_PREFIX) ||
+        networkStr === STELLAR_CAIP2_TESTNET;
+    if (isTestnet) {
+        return STELLAR_TESTNET_NETWORK_ID;
+    }
+    // Return original if it's already numeric
+    const numericId = Number(networkId);
+    return isNaN(numericId) ? undefined : numericId;
+};
+/**
+ * Resolves the network ID for API requests, handling chain-specific conversions.
+ */
+const resolveNetworkIdForRequest = (chainName, networkId) => {
+    // Bitcoin does not need a network ID but the request requires one
+    if (chainName === ChainEnum.Btc) {
+        return 1;
+    }
+    if (chainName === ChainEnum.Stellar) {
+        return convertStellarNetworkToNumeric(networkId);
+    }
+    if (networkId === undefined) {
+        return undefined;
+    }
+    const numericId = Number(networkId);
+    return isNaN(numericId) ? undefined : numericId;
+};
+// Error code for rate limiting
+const RATE_LIMIT_CODE = 429;
+/**
+ * Extracts an appropriate error message from an error object.
+ */
+const getTokenBalanceErrorMessage = (error) => {
+    if ((error === null || error === void 0 ? void 0 : error.code) === RATE_LIMIT_CODE) {
+        return 'Too many requests fetching balances';
+    }
+    if (error === null || error === void 0 ? void 0 : error.message) {
+        return error.message;
+    }
+    return 'error fetching token balance';
+};
+
+export { convertStellarNetworkToNumeric, getTokenBalanceErrorMessage, resolveNetworkIdForRequest };

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

@@ -50,7 +50,10 @@ const useWalletConnectorNetwork = (walletConnector, { onChange } = { onChange: (
         },
     });
     useWalletConnectorEvent.useWalletConnectorEvent(walletConnector || undefined, 'chainChange', ({ chain }) => {
-        const parsedChain = (walletConnector === null || walletConnector === void 0 ? void 0 : walletConnector.connectedChain) === 'STARK' ? chain : parseInt(chain);
+        // STARK and STELLAR use string chainIds; others use numeric
+        const useChainAsString = (walletConnector === null || walletConnector === void 0 ? void 0 : walletConnector.connectedChain) === 'STARK' ||
+            (walletConnector === null || walletConnector === void 0 ? void 0 : walletConnector.connectedChain) === 'STELLAR';
+        const parsedChain = useChainAsString ? chain : parseInt(chain);
         setNetwork(parsedChain);
         onChange === null || onChange === void 0 ? void 0 : onChange(parsedChain);
     });

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

@@ -46,7 +46,10 @@ const useWalletConnectorNetwork = (walletConnector, { onChange } = { onChange: (
         },
     });
     useWalletConnectorEvent(walletConnector || undefined, 'chainChange', ({ chain }) => {
-        const parsedChain = (walletConnector === null || walletConnector === void 0 ? void 0 : walletConnector.connectedChain) === 'STARK' ? chain : parseInt(chain);
+        // STARK and STELLAR use string chainIds; others use numeric
+        const useChainAsString = (walletConnector === null || walletConnector === void 0 ? void 0 : walletConnector.connectedChain) === 'STARK' ||
+            (walletConnector === null || walletConnector === void 0 ? void 0 : walletConnector.connectedChain) === 'STELLAR';
+        const parsedChain = useChainAsString ? chain : parseInt(chain);
         setNetwork(parsedChain);
         onChange === null || onChange === void 0 ? void 0 : onChange(parsedChain);
     });

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

@@ -0,0 +1 @@
+export { useWalletReturnRoute } from './useWalletReturnRoute';

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

@@ -0,0 +1,37 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var React = require('react');
+var utils = require('@dynamic-labs/utils');
+var dynamicEvents = require('../../../events/dynamicEvents.cjs');
+
+/**
+ * Hook that listens for URL updates (from wallet deep link returns) and
+ * emits the walletReturnFromDeepLink event with the previous route.
+ *
+ * This allows customers to navigate back to where the user was before
+ * the wallet operation.
+ */
+const useWalletReturnRoute = () => {
+    React.useEffect(() => {
+        // Check immediately on mount in case the WebView was unmounted while the wallet
+        // was open and the URL redirect arrived before listeners were registered
+        const routeOnMount = utils.walletReturnRoute.getAndClear();
+        if (routeOnMount) {
+            dynamicEvents.dynamicEvents.emit('walletReturnFromDeepLink', {
+                previousRoute: routeOnMount,
+            });
+        }
+        const unsubscribe = utils.PlatformService.onUrlUpdate(() => {
+            const previousRoute = utils.walletReturnRoute.getAndClear();
+            if (previousRoute) {
+                dynamicEvents.dynamicEvents.emit('walletReturnFromDeepLink', { previousRoute });
+            }
+        });
+        return unsubscribe;
+    }, []);
+};
+
+exports.useWalletReturnRoute = useWalletReturnRoute;

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

@@ -0,0 +1,8 @@
+/**
+ * Hook that listens for URL updates (from wallet deep link returns) and
+ * emits the walletReturnFromDeepLink event with the previous route.
+ *
+ * This allows customers to navigate back to where the user was before
+ * the wallet operation.
+ */
+export declare const useWalletReturnRoute: () => void;

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

@@ -0,0 +1,33 @@
+'use client'
+import { useEffect } from 'react';
+import { walletReturnRoute, PlatformService } from '@dynamic-labs/utils';
+import { dynamicEvents } from '../../../events/dynamicEvents.js';
+
+/**
+ * Hook that listens for URL updates (from wallet deep link returns) and
+ * emits the walletReturnFromDeepLink event with the previous route.
+ *
+ * This allows customers to navigate back to where the user was before
+ * the wallet operation.
+ */
+const useWalletReturnRoute = () => {
+    useEffect(() => {
+        // Check immediately on mount in case the WebView was unmounted while the wallet
+        // was open and the URL redirect arrived before listeners were registered
+        const routeOnMount = walletReturnRoute.getAndClear();
+        if (routeOnMount) {
+            dynamicEvents.emit('walletReturnFromDeepLink', {
+                previousRoute: routeOnMount,
+            });
+        }
+        const unsubscribe = PlatformService.onUrlUpdate(() => {
+            const previousRoute = walletReturnRoute.getAndClear();
+            if (previousRoute) {
+                dynamicEvents.emit('walletReturnFromDeepLink', { previousRoute });
+            }
+        });
+        return unsubscribe;
+    }, []);
+};
+
+export { useWalletReturnRoute };

package/src/lib/views/WalletList/data.cjs

@@ -24,6 +24,7 @@ require('../../shared/consts/index.cjs');
  */
 const chainInfoOverrides = {
     starknet: 'STARK',
+    stellar: 'STELLAR',
 };
 const getEnabledChains = (chains) => chains
     .filter(({ enabled }) => enabled)

package/src/lib/views/WalletList/data.d.ts

@@ -4,7 +4,7 @@ interface IChain {
     enabled: boolean;
     name: string;
 }
-export declare const getEnabledChains: (chains: IChain[]) => ("STARK" | "ALGO" | "APTOS" | "ATOM" | "BTC" | "COSMOS" | "ECLIPSE" | "ETH" | "EVM" | "FLOW" | "SOL" | "SPARK" | "STELLAR" | "SUI" | "TRON" | "TON")[];
+export declare const getEnabledChains: (chains: IChain[]) => ("STARK" | "STELLAR" | "ALGO" | "APTOS" | "ATOM" | "BTC" | "COSMOS" | "ECLIPSE" | "ETH" | "EVM" | "FLOW" | "SOL" | "SPARK" | "SUI" | "TRON" | "TON")[];
 type BaseGetSupportedWalletOpts = Omit<GetSupportedWalletsOpts, 'walletConnectProjectId' | 'chainRpcProviders'>;
 export declare const getWallets: (props: {
     getSupportedWalletOpts: BaseGetSupportedWalletOpts;

package/src/lib/views/WalletList/data.js

@@ -20,6 +20,7 @@ import '../../shared/consts/index.js';
  */
 const chainInfoOverrides = {
     starknet: 'STARK',
+    stellar: 'STELLAR',
 };
 const getEnabledChains = (chains) => chains
     .filter(({ enabled }) => enabled)