@dynamic-labs/sdk-react-core 4.84.1 → 4.85.0

package/CHANGELOG.md

@@ -1,4 +1,21 @@
 
+## [4.85.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.84.1...v4.85.0) (2026-05-29)
+
+
+### Features
+
+* **moonpay:** add getMoonPayCurrencies API, MOONPAY_PROVIDER_ID, and chain enum fix ([#11362](https://github.com/dynamic-labs/dynamic-auth/issues/11362)) ([8f1c841](https://github.com/dynamic-labs/dynamic-auth/commit/8f1c841dcab3249e82a7152be373c0e0204a2f47))
+* **sdk-react-core:** extend usePrivateTokenBalances with `accountAddress`, `tokenAddresses`, `includeNativeBalance`, `includeFiat` ([#11380](https://github.com/dynamic-labs/dynamic-auth/issues/11380)) ([ccb6d47](https://github.com/dynamic-labs/dynamic-auth/commit/ccb6d47b4683a12a13aaf8311ecffae3d46464a3))
+* **sdk-react-core:** forward `chainName` + `networkId` through `usePrivateTokenBalances` ([#11383](https://github.com/dynamic-labs/dynamic-auth/issues/11383)) ([c2ad110](https://github.com/dynamic-labs/dynamic-auth/commit/c2ad1103d4d4fdba67fc9b50b60945a843adae99))
+
+
+### Bug Fixes
+
+* **aleo:** drop optimistically deducted unshielded rows when balance hits zero ([#11371](https://github.com/dynamic-labs/dynamic-auth/issues/11371)) ([a3bb8e8](https://github.com/dynamic-labs/dynamic-auth/commit/a3bb8e8fa7e877340c829c991ba31eeb8fa4fcf1)), closes [#11337](https://github.com/dynamic-labs/dynamic-auth/issues/11337)
+* **aleo:** re-read gas sponsored flag after async fetchFee resolves ([#11375](https://github.com/dynamic-labs/dynamic-auth/issues/11375)) ([d27e74a](https://github.com/dynamic-labs/dynamic-auth/commit/d27e74a309aff18eb6b18046fe34e9e64363d331))
+* remediate high-severity dependency vulnerabilities ([#11339](https://github.com/dynamic-labs/dynamic-auth/issues/11339)) ([f025b30](https://github.com/dynamic-labs/dynamic-auth/commit/f025b308e29153de49c88d91233139bb00caaf4e))
+* **waas:** guard upgradeToDynamicWaas on the wallet arg, not primaryWallet ([#11324](https://github.com/dynamic-labs/dynamic-auth/issues/11324)) ([3e95eaf](https://github.com/dynamic-labs/dynamic-auth/commit/3e95eaf50afd2f49ff1cc416e5bf211ee04fbb23))
+
 ### [4.84.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.84.0...v4.84.1) (2026-05-28)
 
 

package/package.cjs

@@ -3,12 +3,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.84.1";
+var version = "4.85.0";
 var dependencies = {
 	"@dynamic-labs/sdk-api-core": "0.0.985",
 	"@dynamic-labs-sdk/client": "1.1.0",
-	"@dynamic-labs-wallet/browser-wallet-client": "0.0.351",
-	"@dynamic-labs-wallet/forward-mpc-client": "0.9.0",
+	"@dynamic-labs-wallet/browser-wallet-client": "1.0.7",
+	"@dynamic-labs-wallet/forward-mpc-client": "0.10.1",
 	"@hcaptcha/react-hcaptcha": "1.4.4",
 	"@thumbmarkjs/thumbmarkjs": "0.16.0",
 	"country-list": "2.3.0",

package/package.js

@@ -1,10 +1,10 @@
 'use client'
-var version = "4.84.1";
+var version = "4.85.0";
 var dependencies = {
 	"@dynamic-labs/sdk-api-core": "0.0.985",
 	"@dynamic-labs-sdk/client": "1.1.0",
-	"@dynamic-labs-wallet/browser-wallet-client": "0.0.351",
-	"@dynamic-labs-wallet/forward-mpc-client": "0.9.0",
+	"@dynamic-labs-wallet/browser-wallet-client": "1.0.7",
+	"@dynamic-labs-wallet/forward-mpc-client": "0.10.1",
 	"@hcaptcha/react-hcaptcha": "1.4.4",
 	"@thumbmarkjs/thumbmarkjs": "0.16.0",
 	"country-list": "2.3.0",

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dynamic-labs/sdk-react-core",
-  "version": "4.84.1",
+  "version": "4.85.0",
   "dependencies": {
     "@dynamic-labs/sdk-api-core": "0.0.985",
     "@dynamic-labs-sdk/client": "1.1.0",
-    "@dynamic-labs-wallet/browser-wallet-client": "0.0.351",
-    "@dynamic-labs-wallet/forward-mpc-client": "0.9.0",
+    "@dynamic-labs-wallet/browser-wallet-client": "1.0.7",
+    "@dynamic-labs-wallet/forward-mpc-client": "0.10.1",
     "@hcaptcha/react-hcaptcha": "1.4.4",
     "@thumbmarkjs/thumbmarkjs": "0.16.0",
     "country-list": "2.3.0",
@@ -17,17 +17,17 @@
     "yup": "0.32.11",
     "react-international-phone": "4.5.0",
     "bs58": "5.0.0",
-    "@dynamic-labs/assert-package-version": "4.84.1",
-    "@dynamic-labs/iconic": "4.84.1",
-    "@dynamic-labs/locale": "4.84.1",
-    "@dynamic-labs/logger": "4.84.1",
-    "@dynamic-labs/multi-wallet": "4.84.1",
-    "@dynamic-labs/rpc-providers": "4.84.1",
-    "@dynamic-labs/store": "4.84.1",
-    "@dynamic-labs/types": "4.84.1",
-    "@dynamic-labs/utils": "4.84.1",
-    "@dynamic-labs/wallet-book": "4.84.1",
-    "@dynamic-labs/wallet-connector-core": "4.84.1",
+    "@dynamic-labs/assert-package-version": "4.85.0",
+    "@dynamic-labs/iconic": "4.85.0",
+    "@dynamic-labs/locale": "4.85.0",
+    "@dynamic-labs/logger": "4.85.0",
+    "@dynamic-labs/multi-wallet": "4.85.0",
+    "@dynamic-labs/rpc-providers": "4.85.0",
+    "@dynamic-labs/store": "4.85.0",
+    "@dynamic-labs/types": "4.85.0",
+    "@dynamic-labs/utils": "4.85.0",
+    "@dynamic-labs/wallet-book": "4.85.0",
+    "@dynamic-labs/wallet-connector-core": "4.85.0",
     "eventemitter3": "5.0.1"
   },
   "devDependencies": {

package/src/index.d.ts

@@ -124,7 +124,7 @@ export {
 /** @deprecated */
 DynamicWidgetContextProvider, } from './lib/widgets/DynamicWidget/context';
 export { useWalletItemActions, useAuthenticateConnectedUser, useSocialAccounts, useEmbeddedWallet, useEmbeddedWalletAuthenticator, usePasskeyRecovery, useEmbeddedReveal, useIsLoggedIn, useDynamicModals, useMfa, useTokenBalances, useMultichainTokenBalances, usePrivateTokenBalances, useSwitchWallet, useRpcProviders, useRefreshUser, useRefreshAuth, useResetWaasSession, useWalletOptions, useSmartWallets, useSignEip7702Authorization, EmbeddedWalletVersion, useTelegramLogin, useUpgradeEmbeddedWallet, useEVMTransactionSimulation, useSVMTransactionSimulation, useDeleteUserAccount, useDynamicWaas, useGetPasskeys, useDeletePasskey, useRegisterPasskey, useAuthenticatePasskeyMFA, useGetUserMfaMethods, usePromptMfaAuth, useUpgradeToDynamicWaasFlow, useGetMfaToken, useGetWalletPassword, useIsPasswordEncrypted, useWalletPassword, useIsMfaRequiredForAction, useWalletDelegation, DelegationError, type DelegationOperation, type DelegationWalletRef, useWalletBackup, useBackupWallets, isWalletBackedUp, BackupError, CloudBackupProvider, GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES, findMissingGoogleDriveBackupScopes, hasAllGoogleDriveBackupScopes, isInsufficientGoogleDriveScopesError, useGoogleDriveBackupReadiness, useExchangeAccounts, useStepUpAuthentication, } from './lib/utils/hooks';
-export type { GoogleDriveBackupAccessError, GoogleDriveBackupReadiness, GoogleDriveBackupReadinessStatus, UseGoogleDriveBackupReadinessReturn, UsePrivateTokenBalancesReturn, } from './lib/utils/hooks';
+export type { GoogleDriveBackupAccessError, GoogleDriveBackupReadiness, GoogleDriveBackupReadinessStatus, UseGoogleDriveBackupReadinessReturn, UsePrivateTokenBalancesArgs, UsePrivateTokenBalancesReturn, } from './lib/utils/hooks';
 export type { IsStepUpRequiredParams, PromptMfaParams, StepUpAuthenticationState, UseStepUpAuthenticationParams, UseStepUpAuthenticationReturn, VerifyOtpParams, VerifyPasskeyMfaParams, VerifyRecoveryCodeParams, VerifySocialParams, VerifyTotpMfaParams, VerifyWalletParams, } from './lib/utils/hooks';
 export { 
 /** @deprecated use useOnramp instead */

package/src/lib/components/SendBalancePageLayout/components/TokensBalanceDropdown/TokensBalanceDropdown.cjs

@@ -123,7 +123,11 @@ require('../../../Popper/PopperContext/PopperContext.cjs');
 const TokensBalanceDropdown = ({ tokenBalances, currentToken, setCurrentToken, isLoading, setFieldValue, setErrors, }) => {
     const { t } = reactI18next.useTranslation();
     const [isDropdownOpen, setIsDropdownOpen] = React.useState(false);
-    const filteredTokenBalances = (tokenBalances === null || tokenBalances === void 0 ? void 0 : tokenBalances.filter((token) => token.name)) || [];
+    // Hide rows the user can't actually send from: anonymous tokens (no
+    //  `name` set — usually a server-side data hole) and tokens whose
+    //  on-chain balance is non-positive. The picker is a "pick what to
+    //  send" affordance, so an entry the user can't pick is just noise.
+    const filteredTokenBalances = (tokenBalances === null || tokenBalances === void 0 ? void 0 : tokenBalances.filter((token) => { var _a; return token.name && ((_a = token.rawBalance) !== null && _a !== void 0 ? _a : 0) > 0; })) || [];
     const { primaryWallet } = useInternalDynamicContext.useInternalDynamicContext();
     const anchorRef = React.useRef(null);
     const fetchTokenData = (selectedToken) => _tslib.__awaiter(void 0, void 0, void 0, function* () {

package/src/lib/components/SendBalancePageLayout/components/TokensBalanceDropdown/TokensBalanceDropdown.js

@@ -119,7 +119,11 @@ import '../../../Popper/PopperContext/PopperContext.js';
 const TokensBalanceDropdown = ({ tokenBalances, currentToken, setCurrentToken, isLoading, setFieldValue, setErrors, }) => {
     const { t } = useTranslation();
     const [isDropdownOpen, setIsDropdownOpen] = useState(false);
-    const filteredTokenBalances = (tokenBalances === null || tokenBalances === void 0 ? void 0 : tokenBalances.filter((token) => token.name)) || [];
+    // Hide rows the user can't actually send from: anonymous tokens (no
+    //  `name` set — usually a server-side data hole) and tokens whose
+    //  on-chain balance is non-positive. The picker is a "pick what to
+    //  send" affordance, so an entry the user can't pick is just noise.
+    const filteredTokenBalances = (tokenBalances === null || tokenBalances === void 0 ? void 0 : tokenBalances.filter((token) => { var _a; return token.name && ((_a = token.rawBalance) !== null && _a !== void 0 ? _a : 0) > 0; })) || [];
     const { primaryWallet } = useInternalDynamicContext();
     const anchorRef = useRef(null);
     const fetchTokenData = (selectedToken) => __awaiter(void 0, void 0, void 0, function* () {

package/src/lib/context/OnrampContext/utils/getOnrampProviders.cjs

@@ -9,18 +9,14 @@ var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
 var onramp = require('../../../data/api/onramp/onramp.cjs');
 var getWalletAdditionalAddressByType = require('../../../utils/functions/getWalletAdditionalAddressByType/getWalletAdditionalAddressByType.cjs');
 
-const DEFAULT_NETWORK = 'evm';
 const DEFAULT_CHAIN = '1';
 const getOnrampProviders = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ address, chainName, environmentId, network, primaryWallet, token, tokenAmount, currency, includeDisabled = false, merchantName, }) {
     var _b;
-    const tempChainNameToUse = (primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.chain)
-        ? (_b = walletConnectorCore.getChainInfo(primaryWallet.chain)) === null || _b === void 0 ? void 0 : _b.name
-        : undefined;
-    const chainNameToUse = chainName !== null && chainName !== void 0 ? chainName : tempChainNameToUse;
+    const chainNameToUse = (_b = chainName !== null && chainName !== void 0 ? chainName : primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.chain) !== null && _b !== void 0 ? _b : undefined;
     const bitcoinAddress = primaryWallet &&
         walletConnectorCore.isBitcoinConnector(primaryWallet.connector) &&
         getWalletAdditionalAddressByType.getWalletAdditionalAddressByType(sdkApiCore.WalletAddressType.Payment, primaryWallet);
-    const chainHasNetwork = network && chainNameToUse === DEFAULT_NETWORK;
+    const chainHasNetwork = network && chainNameToUse === sdkApiCore.ChainEnum.Evm;
     let networkToUse;
     if (chainHasNetwork) {
         networkToUse = (network === null || network === void 0 ? void 0 : network.toString()) || DEFAULT_CHAIN;

package/src/lib/context/OnrampContext/utils/getOnrampProviders.js

@@ -1,22 +1,18 @@
 'use client'
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
-import { WalletAddressType } from '@dynamic-labs/sdk-api-core';
-import { getChainInfo, isBitcoinConnector } from '@dynamic-labs/wallet-connector-core';
+import { WalletAddressType, ChainEnum } from '@dynamic-labs/sdk-api-core';
+import { isBitcoinConnector } from '@dynamic-labs/wallet-connector-core';
 import { getOnrampProviders as getOnrampProviders$1 } from '../../../data/api/onramp/onramp.js';
 import { getWalletAdditionalAddressByType } from '../../../utils/functions/getWalletAdditionalAddressByType/getWalletAdditionalAddressByType.js';
 
-const DEFAULT_NETWORK = 'evm';
 const DEFAULT_CHAIN = '1';
 const getOnrampProviders = (_a) => __awaiter(void 0, [_a], void 0, function* ({ address, chainName, environmentId, network, primaryWallet, token, tokenAmount, currency, includeDisabled = false, merchantName, }) {
     var _b;
-    const tempChainNameToUse = (primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.chain)
-        ? (_b = getChainInfo(primaryWallet.chain)) === null || _b === void 0 ? void 0 : _b.name
-        : undefined;
-    const chainNameToUse = chainName !== null && chainName !== void 0 ? chainName : tempChainNameToUse;
+    const chainNameToUse = (_b = chainName !== null && chainName !== void 0 ? chainName : primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.chain) !== null && _b !== void 0 ? _b : undefined;
     const bitcoinAddress = primaryWallet &&
         isBitcoinConnector(primaryWallet.connector) &&
         getWalletAdditionalAddressByType(WalletAddressType.Payment, primaryWallet);
-    const chainHasNetwork = network && chainNameToUse === DEFAULT_NETWORK;
+    const chainHasNetwork = network && chainNameToUse === ChainEnum.Evm;
     let networkToUse;
     if (chainHasNetwork) {
         networkToUse = (network === null || network === void 0 ? void 0 : network.toString()) || DEFAULT_CHAIN;

package/src/lib/data/api/onramp/onramp.cjs

@@ -4,9 +4,34 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _tslib = require('../../../../../_virtual/_tslib.cjs');
+require('../../../config/ApiEndpoint.cjs');
+require('@dynamic-labs-sdk/client/core');
+require('@dynamic-labs/sdk-api-core');
+require('react');
+require('eventemitter3');
+require('@dynamic-labs/utils');
+require('@dynamic-labs-sdk/client');
+require('@dynamic-labs/iconic');
+require('@dynamic-labs/wallet-connector-core');
+require('react/jsx-runtime');
+require('../../../context/ViewContext/ViewContext.cjs');
+require('../../../shared/logger.cjs');
+require('@dynamic-labs/wallet-book');
+require('../../../utils/constants/colors.cjs');
+require('../../../utils/constants/values.cjs');
+require('../../../shared/consts/index.cjs');
+require('@dynamic-labs/multi-wallet');
+require('react-international-phone');
+require('../../../store/state/nonce/nonce.cjs');
 var api = require('../api.cjs');
+require('@dynamic-labs/locale');
+require('../../../store/state/dynamicContextProps/dynamicContextProps.cjs');
+require('../../../store/state/primaryWalletId/primaryWalletId.cjs');
+require('../../../store/state/connectedWalletsInfo/connectedWalletsInfo.cjs');
+require('../../../utils/functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.cjs');
+require('../../../events/dynamicEvents.cjs');
 
-const getOnrampProviders = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ chain, environmentId, networkId, token, tokenAmount, walletAddress, currency, includeDisabled, merchantName, }) {
+const getOnrampProviders = (_c) => _tslib.__awaiter(void 0, [_c], void 0, function* ({ chain, environmentId, networkId, token, tokenAmount, walletAddress, currency, includeDisabled, merchantName, }) {
     const { onramps } = yield api.sdkApi().getSupportedOnramps({
         chain,
         currency,

package/src/lib/data/api/onramp/onramp.d.ts

@@ -1,4 +1,14 @@
-import { RampConfiguration } from '@dynamic-labs/sdk-api-core';
+import { ChainEnum, RampConfiguration } from '@dynamic-labs/sdk-api-core';
+export type MoonPayCurrency = {
+    code: string;
+    icon: string;
+    name: string;
+};
+export declare const getMoonPayCurrencies: ({ chain, environmentId, networkId, }: {
+    chain: ChainEnum;
+    environmentId: string;
+    networkId?: string;
+}) => Promise<MoonPayCurrency[]>;
 export declare const getOnrampProviders: ({ chain, environmentId, networkId, token, tokenAmount, walletAddress, currency, includeDisabled, merchantName, }: {
     chain: string;
     environmentId: string;

package/src/lib/data/api/onramp/onramp.js

@@ -1,8 +1,33 @@
 'use client'
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
+import '../../../config/ApiEndpoint.js';
+import '@dynamic-labs-sdk/client/core';
+import '@dynamic-labs/sdk-api-core';
+import 'react';
+import 'eventemitter3';
+import '@dynamic-labs/utils';
+import '@dynamic-labs-sdk/client';
+import '@dynamic-labs/iconic';
+import '@dynamic-labs/wallet-connector-core';
+import 'react/jsx-runtime';
+import '../../../context/ViewContext/ViewContext.js';
+import '../../../shared/logger.js';
+import '@dynamic-labs/wallet-book';
+import '../../../utils/constants/colors.js';
+import '../../../utils/constants/values.js';
+import '../../../shared/consts/index.js';
+import '@dynamic-labs/multi-wallet';
+import 'react-international-phone';
+import '../../../store/state/nonce/nonce.js';
 import { sdkApi } from '../api.js';
+import '@dynamic-labs/locale';
+import '../../../store/state/dynamicContextProps/dynamicContextProps.js';
+import '../../../store/state/primaryWalletId/primaryWalletId.js';
+import '../../../store/state/connectedWalletsInfo/connectedWalletsInfo.js';
+import '../../../utils/functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.js';
+import '../../../events/dynamicEvents.js';
 
-const getOnrampProviders = (_a) => __awaiter(void 0, [_a], void 0, function* ({ chain, environmentId, networkId, token, tokenAmount, walletAddress, currency, includeDisabled, merchantName, }) {
+const getOnrampProviders = (_c) => __awaiter(void 0, [_c], void 0, function* ({ chain, environmentId, networkId, token, tokenAmount, walletAddress, currency, includeDisabled, merchantName, }) {
     const { onramps } = yield sdkApi().getSupportedOnramps({
         chain,
         currency,

package/src/lib/utils/functions/onrampProviders/index.cjs

@@ -15,6 +15,7 @@ var sdkApiCore = require('@dynamic-labs/sdk-api-core');
 const providerDisplayModes = {
     [sdkApiCore.ProviderEnum.CoinbaseOnramp]: 'popup',
     [sdkApiCore.ProviderEnum.CryptoDotCom]: 'popup',
+    [sdkApiCore.ProviderEnum.MoonPay]: 'popup',
     // Default for other providers is iframe
 };
 

package/src/lib/utils/functions/onrampProviders/index.js

@@ -11,6 +11,7 @@ import { ProviderEnum } from '@dynamic-labs/sdk-api-core';
 const providerDisplayModes = {
     [ProviderEnum.CoinbaseOnramp]: 'popup',
     [ProviderEnum.CryptoDotCom]: 'popup',
+    [ProviderEnum.MoonPay]: 'popup',
     // Default for other providers is iframe
 };
 

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

@@ -57,7 +57,7 @@ export { useMergeUserAccounts } from './useMergeUserAccounts';
 export { useTokenBalances } from './useTokenBalances';
 export { useMultichainTokenBalances } from './useMultichainTokenBalances';
 export { usePrivateTokenBalances } from './usePrivateTokenBalances';
-export type { UsePrivateTokenBalancesReturn } from './usePrivateTokenBalances';
+export type { UsePrivateTokenBalancesArgs, UsePrivateTokenBalancesReturn, } from './usePrivateTokenBalances';
 export { useUserAuth } from './useUserAuth';
 export { useSwitchWallet } from './useSwitchWallet';
 export { useSyncEmbeddedWalletFlow } from './useSyncEmbeddedWalletFlow';

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

@@ -8,6 +8,7 @@ var React = require('react');
 var sdkApiCore = require('@dynamic-labs/sdk-api-core');
 require('../../../context/DynamicContext/useDynamicContext/useDynamicContext.cjs');
 var useInternalDynamicContext = require('../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.cjs');
+var UserWalletsContext = require('../../../context/UserWalletsContext/UserWalletsContext.cjs');
 var getAleoCuratedPrices = require('../../../data/api/aleo/getAleoCuratedPrices.cjs');
 var dynamicContextProps = require('../../../store/state/dynamicContextProps/dynamicContextProps.cjs');
 
@@ -283,14 +284,37 @@ const buildTokenBalances = (records, networkId, lookupCurated) => {
  *   - The connector doesn't expose `listOwnedRecords` (e.g. external Aleo wallet)
  *   - The user owns no records that match a known program/record pair
  */
-const useAleoShieldedBalances = () => {
+const useAleoShieldedBalances = (args = {}) => {
+    const { accountAddress, tokenAddresses, includeNativeBalance = true, includeFiat = true, chainName, networkId, } = args;
     const { primaryWallet, network } = useInternalDynamicContext.useInternalDynamicContext();
+    const { userWallets } = UserWalletsContext.useInternalUserWallets();
     const [tokenBalances, setTokenBalances] = React.useState([]);
     const [isLoading, setIsLoading] = React.useState(false);
     const [error, setError] = React.useState();
-    const connector = primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.connector;
+    // `accountAddress` is treated as an override of the primary wallet:
+    //  walk the user-wallets list looking for a matching address (case-
+    //  insensitive to be tolerant of how the address is formatted at the
+    //  call site — Aleo addresses are bech32 and casing-insensitive in
+    //  practice). When no `accountAddress` is provided, fall back to the
+    //  primary wallet to preserve the existing single-wallet semantics.
+    const targetWallet = React.useMemo(() => {
+        var _a;
+        if (!accountAddress)
+            return primaryWallet;
+        const normalized = accountAddress.toLowerCase();
+        return ((_a = userWallets.find((w) => { var _a; return ((_a = w.address) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === normalized; })) !== null && _a !== void 0 ? _a : undefined);
+    }, [accountAddress, primaryWallet, userWallets]);
+    const connector = targetWallet === null || targetWallet === void 0 ? void 0 : targetWallet.connector;
     const isAleo = (connector === null || connector === void 0 ? void 0 : connector.connectedChain) === sdkApiCore.ChainEnum.Aleo;
-    const supportsShielded = isAleo &&
+    // When a `chainName` override is passed, treat anything other than
+    //  `ChainEnum.Aleo` as "the caller explicitly asked for a non-Aleo
+    //  chain we don't support yet" and short-circuit. Today Aleo is the
+    //  only chain with a private-balance path, but customers should be
+    //  able to call the public hook with whatever `chainName` matches
+    //  their app's active chain and have it transparently no-op.
+    const chainNameSupported = chainName === undefined || chainName === sdkApiCore.ChainEnum.Aleo;
+    const supportsShielded = chainNameSupported &&
+        isAleo &&
         typeof (connector === null || connector === void 0 ? void 0 : connector.listOwnedRecords) === 'function';
     // Mirror the live connector into a ref so `fetchShielded` can read it
     //  without depending on the (often unstable) object reference. Some test
@@ -300,7 +324,36 @@ const useAleoShieldedBalances = () => {
     const connectorRef = React.useRef(connector);
     connectorRef.current = connector;
     const connectorKey = connector === null || connector === void 0 ? void 0 : connector.key;
-    const networkKey = network !== undefined && network !== null ? String(network) : undefined;
+    // When a `networkId` override is provided, use it instead of the
+    //  context's `network` value when resolving the Aleo network param.
+    //  Empty string falls back to undefined so `resolveAleoNetwork`
+    //  returns `aleoNetworkParam: undefined` and the prices fetch is
+    //  skipped (matching the behaviour when no network is known).
+    const effectiveNetwork = networkId !== null && networkId !== void 0 ? networkId : network;
+    const networkKey = effectiveNetwork !== undefined && effectiveNetwork !== null
+        ? String(effectiveNetwork)
+        : undefined;
+    // Normalise the address filter once per render into a stable
+    //  primitive key (sorted, comma-joined, lowercased) so the
+    //  `useCallback` dep below doesn't invalidate on every render when the
+    //  caller passes a fresh array literal each time (which is the typical
+    //  pattern in React function components). The matching Set is derived
+    //  from the same key to keep both memos in lockstep.
+    const tokenAddressFilterKey = React.useMemo(() => {
+        if (!tokenAddresses)
+            return undefined;
+        return [...tokenAddresses]
+            .map((a) => a.toLowerCase())
+            .sort((a, b) => a.localeCompare(b))
+            .join('|');
+    }, [tokenAddresses]);
+    const tokenAddressFilter = React.useMemo(() => {
+        if (tokenAddressFilterKey === undefined)
+            return undefined;
+        if (tokenAddressFilterKey === '')
+            return new Set();
+        return new Set(tokenAddressFilterKey.split('|'));
+    }, [tokenAddressFilterKey]);
     const fetchShielded = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         var _a;
         const liveConnector = connectorRef.current;
@@ -319,9 +372,15 @@ const useAleoShieldedBalances = () => {
             //  token row, leaving the widget with no price source. Prices are
             //  best-effort: a failure leaves balances unpriced rather than
             //  dropping the shielded list entirely.
+            //
+            //  When the caller opts out of fiat (`includeFiat: false`) we skip
+            //  the curated-prices fetch entirely — same semantic as
+            //  `useTokenBalances` honouring its own `includeFiat` flag. Logos
+            //  for matched tokens then fall through to the bundled defaults
+            //  (`ALEO_CREDITS_LOGO`, `UNKNOWN_TOKEN_LOGO`, spec overrides).
             const { safeNetworkId, aleoNetworkParam } = resolveAleoNetwork(networkKey);
             const environmentId = dynamicContextProps.getEnvironmentId();
-            const shouldFetchPrices = Boolean(aleoNetworkParam && environmentId);
+            const shouldFetchPrices = Boolean(includeFiat && aleoNetworkParam && environmentId);
             const [result, priceList] = yield Promise.all([
                 liveConnector.listOwnedRecords(),
                 shouldFetchPrices && aleoNetworkParam
@@ -334,11 +393,16 @@ const useAleoShieldedBalances = () => {
             const records = (_a = result === null || result === void 0 ? void 0 : result.records) !== null && _a !== void 0 ? _a : [];
             const lookupCurated = buildCuratedTokenLookup(priceList);
             const balances = [];
-            const credits = buildCreditsBalance(records, safeNetworkId, lookupCurated);
-            if (credits)
-                balances.push(credits);
+            if (includeNativeBalance) {
+                const credits = buildCreditsBalance(records, safeNetworkId, lookupCurated);
+                if (credits)
+                    balances.push(credits);
+            }
             balances.push(...buildTokenBalances(records, safeNetworkId, lookupCurated));
-            setTokenBalances(balances);
+            const filtered = tokenAddressFilter
+                ? balances.filter((b) => { var _a; return tokenAddressFilter.has(((_a = b.address) !== null && _a !== void 0 ? _a : '').toLowerCase()); })
+                : balances;
+            setTokenBalances(filtered);
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
@@ -348,7 +412,14 @@ const useAleoShieldedBalances = () => {
         finally {
             setIsLoading(false);
         }
-    }), [connectorKey, networkKey, supportsShielded]);
+    }), [
+        connectorKey,
+        includeFiat,
+        includeNativeBalance,
+        networkKey,
+        supportsShielded,
+        tokenAddressFilter,
+    ]);
     React.useEffect(() => {
         if (!supportsShielded) {
             setTokenBalances((prev) => (prev.length === 0 ? prev : []));

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

@@ -1,4 +1,20 @@
-import { TokenBalance } from '@dynamic-labs/sdk-api-core';
+import { ChainEnum, TokenBalance } from '@dynamic-labs/sdk-api-core';
+/**
+ * Optional inputs that mirror the corresponding `useTokenBalances`
+ *  params so the public `usePrivateTokenBalances` hook can pass through
+ *  the same shape. Defaults here are tuned for the **widget's existing
+ *  consumer** (`ActiveWalletBalance`), which expects the native ALEO
+ *  row + fiat lookup to be on by default. The public hook overrides
+ *  these defaults to match `useTokenBalances`' false / false.
+ */
+export type UseAleoShieldedBalancesArgs = {
+    accountAddress?: string;
+    tokenAddresses?: string[];
+    includeNativeBalance?: boolean;
+    includeFiat?: boolean;
+    chainName?: ChainEnum;
+    networkId?: number;
+};
 /**
  * Hook that returns the active wallet's shielded (private) Aleo token
  * balances as a `TokenBalance[]` so the widget can render them through the
@@ -15,7 +31,7 @@ import { TokenBalance } from '@dynamic-labs/sdk-api-core';
  *   - The connector doesn't expose `listOwnedRecords` (e.g. external Aleo wallet)
  *   - The user owns no records that match a known program/record pair
  */
-export declare const useAleoShieldedBalances: () => {
+export declare const useAleoShieldedBalances: (args?: UseAleoShieldedBalancesArgs) => {
     tokenBalances: TokenBalance[];
     isLoading: boolean;
     error: string | undefined;