@dynamic-labs/sdk-react-core 4.60.0 → 4.60.1

package/CHANGELOG.md

@@ -1,4 +1,19 @@
 
+### [4.60.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.60.0...v4.60.1) (2026-02-09)
+
+
+### Features
+
+* add WAAS password handlers to DynamicContextProvider settings ([#10360](https://github.com/dynamic-labs/dynamic-auth/issues/10360)) ([5fc3fa7](https://github.com/dynamic-labs/dynamic-auth/commit/5fc3fa7148c53b64d36672be2d1ae629cb9cdaf8))
+* improve password handling and UI for wallet protection ([#10386](https://github.com/dynamic-labs/dynamic-auth/issues/10386)) ([d27936e](https://github.com/dynamic-labs/dynamic-auth/commit/d27936e5bea37facceefccc0f2507d25a775ad33))
+* pass authToken to wallet recovery operations ([#10379](https://github.com/dynamic-labs/dynamic-auth/issues/10379)) ([294efc7](https://github.com/dynamic-labs/dynamic-auth/commit/294efc7ab5816f63b7e5cc49a150cf9d34d300af))
+
+
+### Bug Fixes
+
+* override fast-xml-parser to 5.3.4 for CVE-2026-25128 ([#10381](https://github.com/dynamic-labs/dynamic-auth/issues/10381)) ([7fb4c22](https://github.com/dynamic-labs/dynamic-auth/commit/7fb4c221252b84bf38bbdab0b37b8f9a981ebe1a))
+* unlock wallet view error handling and password error UI ([#10388](https://github.com/dynamic-labs/dynamic-auth/issues/10388)) ([5ffc8e1](https://github.com/dynamic-labs/dynamic-auth/commit/5ffc8e1e6dd0d7f32bb94c37ce3674be949f010b))
+
 ## [4.60.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.59.2...v4.60.0) (2026-02-05)
 
 

package/package.cjs

@@ -3,11 +3,11 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.60.0";
+var version = "4.60.1";
 var dependencies = {
-	"@dynamic-labs/sdk-api-core": "0.0.860",
-	"@dynamic-labs-sdk/client": "0.4.0",
-	"@dynamic-labs-wallet/browser-wallet-client": "0.0.259",
+	"@dynamic-labs/sdk-api-core": "0.0.864",
+	"@dynamic-labs-sdk/client": "0.8.0",
+	"@dynamic-labs-wallet/browser-wallet-client": "0.0.260",
 	"@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.60.0";
+var version = "4.60.1";
 var dependencies = {
-	"@dynamic-labs/sdk-api-core": "0.0.860",
-	"@dynamic-labs-sdk/client": "0.4.0",
-	"@dynamic-labs-wallet/browser-wallet-client": "0.0.259",
+	"@dynamic-labs/sdk-api-core": "0.0.864",
+	"@dynamic-labs-sdk/client": "0.8.0",
+	"@dynamic-labs-wallet/browser-wallet-client": "0.0.260",
 	"@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.60.0",
+  "version": "4.60.1",
   "dependencies": {
-    "@dynamic-labs/sdk-api-core": "0.0.860",
-    "@dynamic-labs-sdk/client": "0.4.0",
-    "@dynamic-labs-wallet/browser-wallet-client": "0.0.259",
+    "@dynamic-labs/sdk-api-core": "0.0.864",
+    "@dynamic-labs-sdk/client": "0.8.0",
+    "@dynamic-labs-wallet/browser-wallet-client": "0.0.260",
     "@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.60.0",
-    "@dynamic-labs/iconic": "4.60.0",
-    "@dynamic-labs/locale": "4.60.0",
-    "@dynamic-labs/logger": "4.60.0",
-    "@dynamic-labs/multi-wallet": "4.60.0",
-    "@dynamic-labs/rpc-providers": "4.60.0",
-    "@dynamic-labs/store": "4.60.0",
-    "@dynamic-labs/types": "4.60.0",
-    "@dynamic-labs/utils": "4.60.0",
-    "@dynamic-labs/wallet-book": "4.60.0",
-    "@dynamic-labs/wallet-connector-core": "4.60.0",
+    "@dynamic-labs/assert-package-version": "4.60.1",
+    "@dynamic-labs/iconic": "4.60.1",
+    "@dynamic-labs/locale": "4.60.1",
+    "@dynamic-labs/logger": "4.60.1",
+    "@dynamic-labs/multi-wallet": "4.60.1",
+    "@dynamic-labs/rpc-providers": "4.60.1",
+    "@dynamic-labs/store": "4.60.1",
+    "@dynamic-labs/types": "4.60.1",
+    "@dynamic-labs/utils": "4.60.1",
+    "@dynamic-labs/wallet-book": "4.60.1",
+    "@dynamic-labs/wallet-connector-core": "4.60.1",
     "eventemitter3": "5.0.1"
   },
   "devDependencies": {

package/src/index.cjs

@@ -155,9 +155,9 @@ var PendingSignatureView = require('./lib/views/PendingSignatureView/PendingSign
 var QrCodeView = require('./lib/views/QrCodeView/QrCodeView.cjs');
 var WalletList = require('./lib/views/WalletList/WalletList.cjs');
 var NetworkNotSupportedSwitchManual = require('./lib/views/NetworkNotSupportedSwitchManual/NetworkNotSupportedSwitchManual.cjs');
+var useDynamicWaas = require('./lib/utils/hooks/useDynamicWaas/useDynamicWaas.cjs');
 var viewToComponentMap = require('./lib/views/viewToComponentMap.cjs');
 require('./lib/store/state/connectorsInitializing/connectorsInitializing.cjs');
-var useDynamicWaas = require('./lib/utils/hooks/useDynamicWaas/useDynamicWaas.cjs');
 var useGetMfaToken = require('./lib/utils/hooks/useGetMfaToken/useGetMfaToken.cjs');
 var useDynamicModals = require('./lib/utils/hooks/useDynamicModals/useDynamicModals.cjs');
 var useMfa = require('./lib/utils/hooks/useMfa/useMfa.cjs');
@@ -184,7 +184,7 @@ var usePromptMfaAuth = require('./lib/utils/hooks/usePromptMfaAuth/usePromptMfaA
 var useUpgradeToDynamicWaasFlow = require('./lib/utils/hooks/useUpgradeToDynamicWaasFlow/useUpgradeToDynamicWaasFlow.cjs');
 var useIsMfaRequiredForAction = require('./lib/utils/hooks/useIsMfaRequiredForAction/useIsMfaRequiredForAction.cjs');
 var useRefreshAuth = require('./lib/utils/hooks/useRefreshAuth/useRefreshAuth.cjs');
-var useGetPasswordForSigning = require('./lib/utils/hooks/useGetPasswordForSigning/useGetPasswordForSigning.cjs');
+var useGetWalletPassword = require('./lib/utils/hooks/useGetWalletPassword/useGetWalletPassword.cjs');
 var DynamicConnectButton = require('./lib/components/DynamicConnectButton/DynamicConnectButton.cjs');
 require('./lib/components/InlineWidget/InlineWidget.cjs');
 var IsBrowser = require('./lib/components/IsBrowser/IsBrowser.cjs');
@@ -315,8 +315,8 @@ exports.PendingSignatureView = PendingSignatureView.PendingSignatureView;
 exports.QrCodeView = QrCodeView.QrCodeView;
 exports.WalletList = WalletList.WalletList;
 exports.NetworkNotSupportedSwitchManual = NetworkNotSupportedSwitchManual.NetworkNotSupportedSwitchManual;
-exports.viewToComponentMap = viewToComponentMap.viewToComponentMap;
 exports.useDynamicWaas = useDynamicWaas.useDynamicWaas;
+exports.viewToComponentMap = viewToComponentMap.viewToComponentMap;
 exports.useGetMfaToken = useGetMfaToken.useGetMfaToken;
 exports.useDynamicModals = useDynamicModals.useDynamicModals;
 exports.useMfa = useMfa.useMfa;
@@ -346,7 +346,7 @@ exports.usePromptMfaAuth = usePromptMfaAuth.usePromptMfaAuth;
 exports.useUpgradeToDynamicWaasFlow = useUpgradeToDynamicWaasFlow.useUpgradeToDynamicWaasFlow;
 exports.useIsMfaRequiredForAction = useIsMfaRequiredForAction.useIsMfaRequiredForAction;
 exports.useRefreshAuth = useRefreshAuth.useRefreshAuth;
-exports.useGetPasswordForSigning = useGetPasswordForSigning.useGetPasswordForSigning;
+exports.useGetWalletPassword = useGetWalletPassword.useGetWalletPassword;
 exports.DynamicConnectButton = DynamicConnectButton.DynamicConnectButton;
 exports.IsBrowser = IsBrowser.IsBrowser;
 exports.DynamicBridgeWidget = DynamicBridgeWidget.DynamicBridgeWidget;

package/src/index.d.ts

@@ -123,7 +123,7 @@ export { FilterAndSortWallets, FilterBridgeChainsName, FilterChain, FilterWallet
 export { 
 /** @deprecated */
 DynamicWidgetContextProvider, } from './lib/widgets/DynamicWidget/context';
-export { useWalletItemActions, useAuthenticateConnectedUser, useSocialAccounts, useEmbeddedWallet, useEmbeddedWalletAuthenticator, usePasskeyRecovery, useEmbeddedReveal, useIsLoggedIn, useDynamicModals, useMfa, useTokenBalances, useMultichainTokenBalances, useSwitchWallet, useRpcProviders, useRefreshUser, useRefreshAuth, useWalletOptions, useSmartWallets, EmbeddedWalletVersion, useTelegramLogin, useUpgradeEmbeddedWallet, useEVMTransactionSimulation, useSVMTransactionSimulation, useDeleteUserAccount, useDynamicWaas, useGetPasskeys, useDeletePasskey, useRegisterPasskey, useAuthenticatePasskeyMFA, useGetUserMfaMethods, usePromptMfaAuth, useUpgradeToDynamicWaasFlow, useGetMfaToken, useGetPasswordForSigning, useIsMfaRequiredForAction, useWalletDelegation, useWalletBackup, useBackupWallets, isWalletBackedUp, CloudBackupProvider, useExchangeAccounts, } from './lib/utils/hooks';
+export { useWalletItemActions, useAuthenticateConnectedUser, useSocialAccounts, useEmbeddedWallet, useEmbeddedWalletAuthenticator, usePasskeyRecovery, useEmbeddedReveal, useIsLoggedIn, useDynamicModals, useMfa, useTokenBalances, useMultichainTokenBalances, useSwitchWallet, useRpcProviders, useRefreshUser, useRefreshAuth, useWalletOptions, useSmartWallets, EmbeddedWalletVersion, useTelegramLogin, useUpgradeEmbeddedWallet, useEVMTransactionSimulation, useSVMTransactionSimulation, useDeleteUserAccount, useDynamicWaas, useGetPasskeys, useDeletePasskey, useRegisterPasskey, useAuthenticatePasskeyMFA, useGetUserMfaMethods, usePromptMfaAuth, useUpgradeToDynamicWaasFlow, useGetMfaToken, useGetWalletPassword, useIsMfaRequiredForAction, useWalletDelegation, useWalletBackup, useBackupWallets, isWalletBackedUp, CloudBackupProvider, useExchangeAccounts, } from './lib/utils/hooks';
 export { 
 /** @deprecated use useOnramp instead */
 useFunding, } from './lib/utils/hooks/useFunding';

package/src/index.js

@@ -151,9 +151,9 @@ export { PendingSignatureView } from './lib/views/PendingSignatureView/PendingSi
 export { QrCodeView } from './lib/views/QrCodeView/QrCodeView.js';
 export { WalletList } from './lib/views/WalletList/WalletList.js';
 export { NetworkNotSupportedSwitchManual } from './lib/views/NetworkNotSupportedSwitchManual/NetworkNotSupportedSwitchManual.js';
+export { useDynamicWaas } from './lib/utils/hooks/useDynamicWaas/useDynamicWaas.js';
 export { viewToComponentMap } from './lib/views/viewToComponentMap.js';
 import './lib/store/state/connectorsInitializing/connectorsInitializing.js';
-export { useDynamicWaas } from './lib/utils/hooks/useDynamicWaas/useDynamicWaas.js';
 export { useGetMfaToken } from './lib/utils/hooks/useGetMfaToken/useGetMfaToken.js';
 export { useDynamicModals } from './lib/utils/hooks/useDynamicModals/useDynamicModals.js';
 export { useMfa } from './lib/utils/hooks/useMfa/useMfa.js';
@@ -180,7 +180,7 @@ export { usePromptMfaAuth } from './lib/utils/hooks/usePromptMfaAuth/usePromptMf
 export { useUpgradeToDynamicWaasFlow } from './lib/utils/hooks/useUpgradeToDynamicWaasFlow/useUpgradeToDynamicWaasFlow.js';
 export { useIsMfaRequiredForAction } from './lib/utils/hooks/useIsMfaRequiredForAction/useIsMfaRequiredForAction.js';
 export { useRefreshAuth } from './lib/utils/hooks/useRefreshAuth/useRefreshAuth.js';
-export { useGetPasswordForSigning } from './lib/utils/hooks/useGetPasswordForSigning/useGetPasswordForSigning.js';
+export { useGetWalletPassword } from './lib/utils/hooks/useGetWalletPassword/useGetWalletPassword.js';
 export { DynamicConnectButton } from './lib/components/DynamicConnectButton/DynamicConnectButton.js';
 import './lib/components/InlineWidget/InlineWidget.js';
 export { IsBrowser } from './lib/components/IsBrowser/IsBrowser.js';

package/src/lib/layout/DynamicAuthLayout/Header/header.cjs

@@ -130,7 +130,8 @@ const Header = ({ onClose: handleClose, heading, projectSettings, copykey, descr
     const closeButton = showCloseButton && handleClose && (jsxRuntime.jsx(IconButton.IconButton, { onClick: handleClose, type: 'button', id: 'close-button', "data-testid": 'close-button', className: 'layout-header__icon', children: jsxRuntime.jsx(close.ReactComponent, {}) }));
     const infoButton = showHelpContent && (jsxRuntime.jsx(Tooltip.Tooltip, { content: 'Need some help?', className: 'layout-header__tooltip', children: jsxRuntime.jsx(IconButton.IconButton, { type: 'button', onClick: () => setIsFooterExpanded(!isFooterExpanded), "data-testid": 'info-button', className: 'layout-header__icon', children: isWalletListTypeView ? jsxRuntime.jsx(questionMark.ReactComponent, {}) : jsxRuntime.jsx(footerInfoIcon.ReactComponent, {}) }) }, 'info-button'));
     const leadingButtons = [];
-    if (canGoBack) {
+    const showBackButton = canGoBack && view.type !== 'unlock-wallet';
+    if (showBackButton) {
         leadingButtons.push(jsxRuntime.jsx(IconButton.IconButton, { type: 'button', onClick: handleBackClick, "data-testid": 'back-button', className: 'layout-header__icon', children: jsxRuntime.jsx(arrowLeft.ReactComponent, {}) }, 'back-button'));
     }
     // if has close button and info button, info button should be on the right

package/src/lib/layout/DynamicAuthLayout/Header/header.js

@@ -126,7 +126,8 @@ const Header = ({ onClose: handleClose, heading, projectSettings, copykey, descr
     const closeButton = showCloseButton && handleClose && (jsx(IconButton, { onClick: handleClose, type: 'button', id: 'close-button', "data-testid": 'close-button', className: 'layout-header__icon', children: jsx(SvgClose, {}) }));
     const infoButton = showHelpContent && (jsx(Tooltip, { content: 'Need some help?', className: 'layout-header__tooltip', children: jsx(IconButton, { type: 'button', onClick: () => setIsFooterExpanded(!isFooterExpanded), "data-testid": 'info-button', className: 'layout-header__icon', children: isWalletListTypeView ? jsx(SvgQuestionMark, {}) : jsx(SvgFooterInfoIcon, {}) }) }, 'info-button'));
     const leadingButtons = [];
-    if (canGoBack) {
+    const showBackButton = canGoBack && view.type !== 'unlock-wallet';
+    if (showBackButton) {
         leadingButtons.push(jsx(IconButton, { type: 'button', onClick: handleBackClick, "data-testid": 'back-button', className: 'layout-header__icon', children: jsx(SvgArrowLeft, {}) }, 'back-button'));
     }
     // if has close button and info button, info button should be on the right

package/src/lib/shared/assets/error-circle-x.cjs

@@ -0,0 +1,54 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var React = require('react');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n["default"] = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+var _path;
+var _excluded = ["title", "titleId"];
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var s = Object.getOwnPropertySymbols(e); for (r = 0; r < s.length; r++) o = s[r], t.includes(o) || {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (e.includes(n)) continue; t[n] = r[n]; } return t; }
+var SvgErrorCircleX = function SvgErrorCircleX(_ref) {
+  var title = _ref.title,
+    titleId = _ref.titleId,
+    props = _objectWithoutProperties(_ref, _excluded);
+  return /*#__PURE__*/React__namespace.createElement("svg", _extends({
+    width: 17,
+    height: 17,
+    viewBox: "0 0 17 17",
+    fill: "none",
+    xmlns: "http://www.w3.org/2000/svg",
+    "aria-labelledby": titleId
+  }, props), title ? /*#__PURE__*/React__namespace.createElement("title", {
+    id: titleId
+  }, title) : null, _path || (_path = /*#__PURE__*/React__namespace.createElement("path", {
+    fillRule: "evenodd",
+    clipRule: "evenodd",
+    d: "M8.333 1.667a6.667 6.667 0 1 0 0 13.333 6.667 6.667 0 0 0 0-13.333ZM0 8.333a8.333 8.333 0 1 1 16.667 0A8.333 8.333 0 0 1 0 8.333Zm6.077-2.256a.833.833 0 0 1 1.179 0l1.077 1.078 1.078-1.078a.833.833 0 0 1 1.178 1.179L9.512 8.333l1.077 1.078a.833.833 0 0 1-1.178 1.178L8.333 9.512l-1.077 1.077a.833.833 0 0 1-1.179-1.178l1.078-1.078-1.078-1.077a.833.833 0 0 1 0-1.179Z",
+    fill: "currentColor"
+  })));
+};
+
+exports.ReactComponent = SvgErrorCircleX;

package/src/lib/shared/assets/error-circle-x.js

@@ -0,0 +1,30 @@
+'use client'
+import * as React from 'react';
+
+var _path;
+var _excluded = ["title", "titleId"];
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var s = Object.getOwnPropertySymbols(e); for (r = 0; r < s.length; r++) o = s[r], t.includes(o) || {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (e.includes(n)) continue; t[n] = r[n]; } return t; }
+var SvgErrorCircleX = function SvgErrorCircleX(_ref) {
+  var title = _ref.title,
+    titleId = _ref.titleId,
+    props = _objectWithoutProperties(_ref, _excluded);
+  return /*#__PURE__*/React.createElement("svg", _extends({
+    width: 17,
+    height: 17,
+    viewBox: "0 0 17 17",
+    fill: "none",
+    xmlns: "http://www.w3.org/2000/svg",
+    "aria-labelledby": titleId
+  }, props), title ? /*#__PURE__*/React.createElement("title", {
+    id: titleId
+  }, title) : null, _path || (_path = /*#__PURE__*/React.createElement("path", {
+    fillRule: "evenodd",
+    clipRule: "evenodd",
+    d: "M8.333 1.667a6.667 6.667 0 1 0 0 13.333 6.667 6.667 0 0 0 0-13.333ZM0 8.333a8.333 8.333 0 1 1 16.667 0A8.333 8.333 0 0 1 0 8.333Zm6.077-2.256a.833.833 0 0 1 1.179 0l1.077 1.078 1.078-1.078a.833.833 0 0 1 1.178 1.179L9.512 8.333l1.077 1.078a.833.833 0 0 1-1.178 1.178L8.333 9.512l-1.077 1.077a.833.833 0 0 1-1.179-1.178l1.078-1.078-1.078-1.077a.833.833 0 0 1 0-1.179Z",
+    fill: "currentColor"
+  })));
+};
+
+export { SvgErrorCircleX as ReactComponent };

package/src/lib/shared/assets/index.d.ts

@@ -44,6 +44,7 @@ export { ReactComponent as DownloadIcon } from './download.svg';
 export { ReactComponent as DynamicLogoIcon } from './dynamic-logo.svg';
 export { ReactComponent as DynamicRoundLogoIcon } from './dynamic-round-logo.svg';
 export { ReactComponent as EmbeddedWalletIcon } from './embedded-wallet-icon.svg';
+export { ReactComponent as ErrorCircleXIcon } from './error-circle-x.svg';
 export { ReactComponent as ErrorIcon } from './error.svg';
 export { ReactComponent as ExclamationCircleIcon } from './exclamation-circle.svg';
 export { ReactComponent as ExclamationIcon } from './exclamation.svg';

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

@@ -12,6 +12,44 @@ export type UserOnboardingFieldResponse = {
     value: string;
     isCustom: boolean;
 };
+/**
+ * Custom password provider for WAAS embedded wallets.
+ *
+ * This function is called when operations require access to the encrypted user share.
+ * The password is used to decrypt the user's keyshare, which is needed for:
+ * - Signing transactions/messages
+ * - Exporting private keys
+ * - Wallet delegation
+ * - Re-sharing keyshares
+ * - Any operation requiring the decrypted user share
+ *
+ * If not provided, the default UI unlock wallet modal will be shown.
+ *
+ * @param accountAddress - The wallet address that needs unlocking
+ * @param chainName - The chain name (e.g., 'EVM', 'SOL', 'BTC')
+ * @returns The password string to decrypt the user share, or undefined to fail the operation
+ *
+ * Note: Only called when wallet is locked. If already unlocked, this handler is not invoked.
+ * Runtime calls to walletConnector.setGetWalletPasswordFunction() will override this handler.
+ */
+export type GetWalletPasswordFn = (props: {
+    accountAddress: string;
+    chainName: string;
+}) => Promise<string | undefined>;
+/**
+ * Custom password setup function for WAAS embedded wallet creation.
+ *
+ * This function is called during wallet creation when passcodeRequired is enabled.
+ * The password provided will be used to encrypt the user's keyshare before backup.
+ * This is typically called during the auto-create process if "create on sign up" is enabled.
+ *
+ * If not provided, the default UI password setup modal will be shown.
+ *
+ * @returns The new password string to encrypt the user share, or undefined to create without password
+ *
+ * Note: Only called when passcodeRequired is true in project settings.
+ */
+export type SetupWalletPasswordFn = () => Promise<string | undefined>;
 /**
  * Handlers supported by dynamic. They always return a promise
  */
@@ -20,4 +58,30 @@ export type DynamicHandlers = {
         user: UserProfile;
     }) => Promise<void>;
     handleConnectedWallet?: HandleConnectedWallet;
+    /**
+     * Custom password provider for WAAS embedded wallets.
+     *
+     * Called when operations require decrypting the user's keyshare for:
+     * - Signing transactions/messages
+     * - Exporting private keys
+     * - Wallet delegation
+     * - Re-sharing keyshares
+     *
+     * The password is used to decrypt the encrypted user share stored in backup.
+     *
+     * @param accountAddress - The wallet address that needs unlocking
+     * @param chainName - The chain name (e.g., 'EVM', 'SOL', 'BTC')
+     * @returns The password string, or undefined to fail the operation
+     */
+    getWalletPassword?: GetWalletPasswordFn;
+    /**
+     * Custom password setup function for WAAS embedded wallet creation.
+     *
+     * Called during wallet creation when passcodeRequired is enabled to encrypt
+     * the user's keyshare before backup. Typically invoked during auto-create
+     * process if "create on sign up" is enabled.
+     *
+     * @returns The new password string to encrypt the user share, or undefined to create without password
+     */
+    setupWalletPassword?: SetupWalletPasswordFn;
 };

package/src/lib/shared/utils/functions/chain/getChainIcon.cjs

@@ -21,6 +21,7 @@ const chainIconMap = {
     solana: iconic.SolanaIcon,
     spark: iconic.SparkIcon,
     starknet: iconic.StarknetIcon,
+    stellar: iconic.StellarIcon,
     sui: iconic.SuiIcon,
     ton: iconic.TonIcon,
     tron: iconic.TronIcon,

package/src/lib/shared/utils/functions/chain/getChainIcon.js

@@ -1,5 +1,5 @@
 'use client'
-import { AlgorandIcon, AptosIcon, BitcoinIcon, CosmosIcon, EclipseIcon, EthereumIcon, FlowIcon, SolanaIcon, SparkIcon, StarknetIcon, SuiIcon, TonIcon, TronIcon } from '@dynamic-labs/iconic';
+import { AlgorandIcon, AptosIcon, BitcoinIcon, CosmosIcon, EclipseIcon, EthereumIcon, FlowIcon, SolanaIcon, SparkIcon, StarknetIcon, StellarIcon, SuiIcon, TonIcon, TronIcon } from '@dynamic-labs/iconic';
 import { getChainInfo } from '@dynamic-labs/wallet-connector-core';
 import 'react';
 import { ReactComponent as SvgError } from '../../../assets/error.js';
@@ -17,6 +17,7 @@ const chainIconMap = {
     solana: SolanaIcon,
     spark: SparkIcon,
     starknet: StarknetIcon,
+    stellar: StellarIcon,
     sui: SuiIcon,
     ton: TonIcon,
     tron: TronIcon,