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

package/CHANGELOG.md

@@ -1,4 +1,17 @@
 
+## [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.0";
 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.0";
 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.0",
   "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.0",
+    "@dynamic-labs/iconic": "4.63.0",
+    "@dynamic-labs/locale": "4.63.0",
+    "@dynamic-labs/logger": "4.63.0",
+    "@dynamic-labs/multi-wallet": "4.63.0",
+    "@dynamic-labs/rpc-providers": "4.63.0",
+    "@dynamic-labs/store": "4.63.0",
+    "@dynamic-labs/types": "4.63.0",
+    "@dynamic-labs/utils": "4.63.0",
+    "@dynamic-labs/wallet-book": "4.63.0",
+    "@dynamic-labs/wallet-connector-core": "4.63.0",
     "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/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/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/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/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 };