@getpara/react-sdk-lite 2.9.0 → 2.10.0

package/dist/modal/ParaModal.js

@@ -110,7 +110,7 @@ const ParaModal = forwardRef((props, ref) => {
             onClose,
             defaultAuthIdentifier
           }), rest),
-          reactSdkVersion: "2.9.0"
+          reactSdkVersion: "2.10.0"
         });
       } catch (e) {
       }

package/dist/modal/components/AddFunds/AddFundsContext.d.ts

@@ -24,6 +24,8 @@ type Value = {
     tab: Tab;
     activeWallet: ReturnType<typeof useWallet>['data'];
     onRampConfig: OnRampConfig;
+    /** On-ramp test mode: only respects config in PROD; non-PROD always behaves as test mode. */
+    isTestMode: boolean;
     settingsStep: SettingsStep | null;
     TestModeAlert: ReactNode;
 };

package/dist/modal/components/AddFunds/AddFundsContext.js

@@ -18,7 +18,8 @@ import {
   EnabledFlow,
   getOnRampAssets,
   getOnRampNetworks,
-  OnRampPurchaseType
+  OnRampPurchaseType,
+  Environment
 } from "@getpara/web-sdk";
 import { getNetworkFromChainId, getNetworkOrMainNetEquivalent, safeStyled } from "@getpara/react-common";
 import { CpslAlert, CpslIcon } from "@getpara/react-components";
@@ -45,6 +46,7 @@ const DEFAULT = {
   },
   onRampConfig: {},
   activeWallet: {},
+  isTestMode: true,
   settingsStep: "FORM",
   TestModeAlert: null
 };
@@ -54,29 +56,31 @@ function isValid(onRampConfig, walletType, network, asset) {
 }
 const AddFundsContext = createContext(DEFAULT);
 function AddFundsContextProvider({ tab, children }) {
-  var _a, _b;
+  var _a, _b, _c, _d, _e;
   const appName = useStore((state) => state.appName);
+  const client = useStore((state) => state.client);
   const onRampConfig = useModalStore((state) => state.onRampConfig);
   const onRampStep = useModalStore((state) => state.onRampStep);
   const setOnRampStep = useModalStore((state) => state.setOnRampStep);
   const isTestModeAlertDismissed = useModalStore((state) => state.isTestModeAlertDismissed);
   const setIsTestModeAlertDismissed = useModalStore((state) => state.setIsTestModeAlertDismissed);
   const { chainId } = useExternalWallets();
+  const isTestMode = ((_a = client == null ? void 0 : client.ctx) == null ? void 0 : _a.env) === Environment.PROD ? (_b = onRampConfig == null ? void 0 : onRampConfig.testMode) != null ? _b : false : true;
   const { data: activeWallet } = useWallet();
-  const [fiatQuantity, setFiatQuantity] = useState((_b = (_a = onRampConfig == null ? void 0 : onRampConfig.defaultBuyAmount) == null ? void 0 : _a[0]) != null ? _b : "25.00");
+  const [fiatQuantity, setFiatQuantity] = useState((_d = (_c = onRampConfig == null ? void 0 : onRampConfig.defaultBuyAmount) == null ? void 0 : _c[0]) != null ? _d : "25.00");
   const networks = useMemo(() => {
     if (!onRampConfig) {
       return [];
     }
     const detectedNetwork = getNetworkFromChainId(chainId);
     const isExternal = (activeWallet == null ? void 0 : activeWallet.isExternal) && !!detectedNetwork;
-    return isExternal ? [getNetworkOrMainNetEquivalent(detectedNetwork, onRampConfig.testMode)] : getOnRampNetworks(onRampConfig.assetInfo, {
+    return isExternal ? [getNetworkOrMainNetEquivalent(detectedNetwork, isTestMode)] : getOnRampNetworks(onRampConfig.assetInfo, {
       walletType: activeWallet == null ? void 0 : activeWallet.type,
       allowed: onRampConfig.allowedAssets ? Object.keys(onRampConfig.allowedAssets) : void 0,
       providers: onRampConfig.providers,
       action: OnRampPurchaseType[tab === EnabledFlow.BUY ? "BUY" : "SELL"]
     });
-  }, [chainId, activeWallet, onRampConfig, tab]);
+  }, [chainId, activeWallet, onRampConfig, tab, isTestMode]);
   const assets = useMemo(() => {
     if (!onRampConfig) {
       return [];
@@ -116,9 +120,9 @@ function AddFundsContextProvider({ tab, children }) {
   const isProviderAllowed = useMemo(
     () => onRampConfig && !!(activeWallet == null ? void 0 : activeWallet.type) ? onRampConfig.providers.reduce(
       (acc, id) => {
-        var _a2, _b2, _c, _d, _e;
+        var _a2, _b2, _c2, _d2, _e2;
         return __spreadProps(__spreadValues({}, acc), {
-          [id]: !!network && !!asset && !!((_e = (_d = (_c = (_b2 = (_a2 = onRampConfig.assetInfo[activeWallet.type]) == null ? void 0 : _a2[network]) == null ? void 0 : _b2[asset]) == null ? void 0 : _c[id]) == null ? void 0 : _d[1]) == null ? void 0 : _e[tab === EnabledFlow.BUY ? "BUY" : "SELL"])
+          [id]: !!network && !!asset && !!((_e2 = (_d2 = (_c2 = (_b2 = (_a2 = onRampConfig.assetInfo[activeWallet.type]) == null ? void 0 : _a2[network]) == null ? void 0 : _b2[asset]) == null ? void 0 : _c2[id]) == null ? void 0 : _d2[1]) == null ? void 0 : _e2[tab === EnabledFlow.BUY ? "BUY" : "SELL"])
         });
       },
       {}
@@ -140,17 +144,23 @@ function AddFundsContextProvider({ tab, children }) {
     }
   }, [asset, network, assets.length, networks.length]);
   const TestModeAlert = useMemo(() => {
-    return (onRampConfig == null ? void 0 : onRampConfig.testMode) && !isTestModeAlertDismissed ? /* @__PURE__ */ jsx(CpslAlert, { variant: "error", filled: true, children: /* @__PURE__ */ jsxs(Fragment, { children: [
-      /* @__PURE__ */ jsxs("span", { children: [
+    var _a2;
+    const isProd = ((_a2 = client == null ? void 0 : client.ctx) == null ? void 0 : _a2.env) === Environment.PROD;
+    return isTestMode && !isTestModeAlertDismissed ? /* @__PURE__ */ jsx(CpslAlert, { variant: "error", filled: true, children: /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("span", { children: isProd ? /* @__PURE__ */ jsxs(Fragment, { children: [
         "This Para Modal is configured to run on-ramp services in ",
         /* @__PURE__ */ jsx("b", { children: "test mode" }),
         " only, for development purposes. If you are a user of ",
         appName,
         ", please contact support."
-      ] }),
+      ] }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+        "On-ramp services are configured to run in ",
+        /* @__PURE__ */ jsx("b", { children: "test mode" }),
+        " only outside of the PROD environment."
+      ] }) }),
       /* @__PURE__ */ jsx(CloseButton, { onClick: () => setIsTestModeAlertDismissed(true), children: /* @__PURE__ */ jsx(CloseX, { icon: "x" }) })
     ] }) }) : null;
-  }, [isTestModeAlertDismissed, appName, onRampConfig == null ? void 0 : onRampConfig.testMode, setIsTestModeAlertDismissed]);
+  }, [isTestModeAlertDismissed, appName, isTestMode, setIsTestModeAlertDismissed, (_e = client == null ? void 0 : client.ctx) == null ? void 0 : _e.env]);
   useEffect(() => {
     if (!!asset && !network && narrowedNetworks.length === 1) {
       setNetwork(narrowedNetworks[0]);
@@ -174,6 +184,7 @@ function AddFundsContextProvider({ tab, children }) {
       setFiatQuantity,
       activeWallet,
       onRampConfig,
+      isTestMode,
       settingsStep,
       TestModeAlert
     };
@@ -189,6 +200,7 @@ function AddFundsContextProvider({ tab, children }) {
     setFiatQuantity,
     activeWallet,
     onRampConfig,
+    isTestMode,
     settingsStep,
     TestModeAlert
   ]);

package/dist/modal/components/AddFunds/AddFundsProvider.js

@@ -20,7 +20,7 @@ function AddFundsProvider() {
   const setOnRampStep = useModalStore((state) => state.setOnRampStep);
   const onRampConfig = useModalStore((state) => state.onRampConfig);
   const setOnRampPurchase = useModalStore((state) => state.setOnRampPurchase);
-  const { asset, network, fiatQuantity, isProviderAllowed, tab, TestModeAlert } = useAddFunds();
+  const { asset, network, fiatQuantity, isProviderAllowed, tab, TestModeAlert, isTestMode } = useAddFunds();
   const { data: activeWallet } = useWallet();
   useEffect(() => {
     if (Object.values(isProviderAllowed).every((v) => !v)) {
@@ -57,7 +57,7 @@ function AddFundsProvider() {
                     network,
                     asset: asset || void 0,
                     fiatQuantity,
-                    testMode: onRampConfig == null ? void 0 : onRampConfig.testMode
+                    testMode: isTestMode
                   }
                 });
                 setOnRampPurchase(__spreadProps(__spreadValues({}, newOnRampPurchase), { fiat: "USD" }));

package/dist/modal/types/modalProps.d.ts

@@ -74,7 +74,9 @@ export interface ParaModalProps {
      */
     logo?: string;
     /**
-     * Whether or not to run configured on-ramp providers in test mode.
+     * Whether to run configured on-ramp providers in test mode in the PROD environment.
+     *
+     * On-ramp and off-ramp widgets will always run in test mode outside of PROD.
      */
     onRampTestMode?: boolean;
     /**

package/dist/provider/hooks/queries/useProfileBalance.js

@@ -1,13 +1,15 @@
 "use client";
 import {
-  __async
+  __async,
+  __spreadProps,
+  __spreadValues
 } from "../../../chunk-MMUBH76A.js";
 import { useQuery } from "@tanstack/react-query";
-import { useRef, useEffect } from "react";
+import { useRef, useEffect, useMemo } from "react";
 import { useStore } from "../../stores/useStore.js";
 import { useInternalClient } from "../utils/useInternalClient.js";
 import { useIsFullyLoggedIn } from "./useIsFullyLoggedIn.js";
-import { filterProfileBalance } from "@getpara/shared";
+import { filterProfileBalance, formatCurrency } from "@getpara/shared";
 const useProfileBalance = (options) => {
   var _a, _b, _c;
   const client = useInternalClient();
@@ -17,6 +19,7 @@ const useProfileBalance = (options) => {
     return (_a2 = state.modalConfig) == null ? void 0 : _a2.balances;
   });
   const refs = useStore((state) => state.refs);
+  const balanceOverrides = useStore((state) => state.balanceOverrides);
   const isComprehensive = (_a = options == null ? void 0 : options.isComprehensive) != null ? _a : false;
   const previousTriggerRef = useRef(options == null ? void 0 : options.refetchTrigger);
   const shouldRefetchRef = useRef(false);
@@ -28,8 +31,10 @@ const useProfileBalance = (options) => {
       previousTriggerRef.current = options == null ? void 0 : options.refetchTrigger;
     }
   }, [options == null ? void 0 : options.refetchTrigger]);
-  return useQuery({
-    enabled: isSuccess && !!client,
+  const requiresOverrides = (config == null ? void 0 : config.useBalanceOverrides) && (config == null ? void 0 : config.displayType) === "AGGREGATED";
+  const shouldUseOverrides = requiresOverrides && !!balanceOverrides;
+  const query = useQuery({
+    enabled: isSuccess && !!client && (!requiresOverrides || !!balanceOverrides),
     queryKey: [
       "useProfileBalance",
       isFullyLoggedIn != null ? isFullyLoggedIn : null,
@@ -56,9 +61,31 @@ const useProfileBalance = (options) => {
       isInitialLoadRef.current = false;
       return isComprehensive ? profileBalance : filterProfileBalance(profileBalance, config || { displayType: "AGGREGATED" });
     }),
-    // We handle refetch manually
     refetchOnWindowFocus: false
   });
+  const data = useMemo(() => {
+    var _a2;
+    const raw = query.data;
+    if (!raw || !shouldUseOverrides) return raw;
+    const overrides = balanceOverrides.value;
+    const result = structuredClone(raw);
+    for (const [walletAddress, override] of Object.entries(overrides)) {
+      const wallet = result.wallets.find((w) => w.address === walletAddress);
+      if (((_a2 = wallet == null ? void 0 : wallet.value) == null ? void 0 : _a2.value) === void 0) continue;
+      if (typeof override !== "number" || !Number.isFinite(override)) continue;
+      wallet.value.value = override;
+      wallet.formattedValue = formatCurrency(wallet.value);
+    }
+    if (result.value) {
+      result.value.value = result.wallets.reduce((sum, wallet) => {
+        var _a3, _b2;
+        return sum + ((_b2 = (_a3 = wallet.value) == null ? void 0 : _a3.value) != null ? _b2 : 0);
+      }, 0);
+      result.formattedValue = formatCurrency(result.value);
+    }
+    return result;
+  }, [query.data, shouldUseOverrides, balanceOverrides == null ? void 0 : balanceOverrides.version]);
+  return __spreadProps(__spreadValues({}, query), { data: data != null ? data : void 0 });
 };
 export {
   useProfileBalance

package/dist/provider/hooks/utils/index.d.ts

@@ -1,3 +1,4 @@
 export { useClient } from './useClient.js';
 export { useModal } from './useModal.js';
 export { useWalletState } from './useWalletState.js';
+export { useSetBalanceOverrides } from './useSetBalanceOverrides.js';

package/dist/provider/hooks/utils/index.js

@@ -3,8 +3,10 @@ import "../../../chunk-MMUBH76A.js";
 import { useClient } from "./useClient.js";
 import { useModal } from "./useModal.js";
 import { useWalletState } from "./useWalletState.js";
+import { useSetBalanceOverrides } from "./useSetBalanceOverrides.js";
 export {
   useClient,
   useModal,
+  useSetBalanceOverrides,
   useWalletState
 };

package/dist/provider/hooks/utils/useSetBalanceOverrides.d.ts

@@ -0,0 +1,34 @@
+import { BalanceOverrides } from '@getpara/shared';
+/**
+ * Returns a function to set the balance overrides, similar to React `setState`. Use this once your balance overrides are available to modify or replace the displayed wallet balances in the Para Modal. Both the individual wallet and the cumulative total balance will be modified.
+ *
+ * If you have set `useBalanceOverrides` to `true` in your configuration, you must call this function at least once with a non-null value for balances to be displayed.
+ *
+ * **Behavior notes:**
+ * - Both numeric `value.value` and `formattedValue` strings are recalculated after overrides.
+ * - Wallets not present in the override map retain their original values.
+ * - Overrides are re-applied whenever the underlying balance data refetches; they do not need to be re-set.
+ * - Non-finite values (`NaN`, `Infinity`) are silently skipped.
+ *
+ * @example
+ * ```tsx
+ * import { useAccount, useSetBalanceOverrides } from '@getpara/react-sdk';
+ *
+ * const ComponentWithinParaProvider = () => {
+ *   const setBalanceOverrides = useSetBalanceOverrides();
+ *   const { embedded: embeddedWallets } = useAccount();
+ *
+ *   useEffect(() => {
+ *     const interval = setInterval(async () => {
+ *       const balances = await getBalancesFromYourApi({ addresses: embeddedWallets.map(w => w.address!) });
+ *
+ *       // Pass a Record<string, number> mapping wallet addresses to their new balance values:
+ *       setBalanceOverrides(balances);
+ *     }, 10000);
+ *     return () => clearInterval(interval);
+ *   }, [embeddedWallets, setBalanceOverrides]);
+ *
+ *   // ...
+ * ```
+ */
+export declare const useSetBalanceOverrides: () => (balanceOverrides: BalanceOverrides) => void;

package/dist/provider/hooks/utils/useSetBalanceOverrides.js

@@ -0,0 +1,12 @@
+"use client";
+import "../../../chunk-MMUBH76A.js";
+import { useStore } from "../../stores/useStore.js";
+const useSetBalanceOverrides = () => {
+  const setBalanceOverrides = useStore((state) => state.setBalanceOverrides);
+  return (balanceOverrides) => {
+    setBalanceOverrides(balanceOverrides);
+  };
+};
+export {
+  useSetBalanceOverrides
+};

package/dist/provider/stores/slices/modal.js

@@ -18,7 +18,17 @@ const createModalSlice = (set) => ({
   refs: {
     openedToStep: createRef(),
     balancesInvalidationTime: createRef()
-  }
+  },
+  balanceOverrides: null,
+  setBalanceOverrides: (balanceOverrides) => set((state) => {
+    var _a, _b;
+    return {
+      balanceOverrides: balanceOverrides ? {
+        version: ((_b = (_a = state.balanceOverrides) == null ? void 0 : _a.version) != null ? _b : 0) + 1,
+        value: balanceOverrides
+      } : null
+    };
+  })
 });
 export {
   createModalSlice

package/dist/provider/stores/types.d.ts

@@ -7,6 +7,12 @@ import { ParaSolanaProvider, SolanaExternalWalletContextType, WalletList as Sola
 import { ModalStep, ParaModalProps } from '../../modal/index.js';
 import { OAuthLogoVariantType } from '../../modal/types/modalProps.js';
 import { type TExternalWallet } from '@getpara/react-common';
+import { BalanceOverrides } from '@getpara/shared';
+/** Balance overrides with a version field for React Query cache invalidation (version must be serializable). */
+export type BalanceOverridesWithVersion = {
+    version: number;
+    value: BalanceOverrides;
+};
 export type FarcasterMiniAppConfig = {
     /**
      * Whether to disable automatic sign-in via the Farcaster user's existing miniapp wallet(s).
@@ -40,6 +46,8 @@ export interface ModalSlice {
         openedToStep: MutableRefObject<ModalStep | null>;
         balancesInvalidationTime: MutableRefObject<number | null>;
     };
+    balanceOverrides: BalanceOverridesWithVersion | null;
+    setBalanceOverrides: (_: BalanceOverrides | null) => void;
 }
 export interface WalletSlice {
     rpcUrl?: string;

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@getpara/react-sdk-lite",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "bin": {
     "setup-para": "dist/cli/cli.mjs"
   },
   "dependencies": {
-    "@getpara/react-common": "2.9.0",
-    "@getpara/react-components": "2.9.0",
-    "@getpara/web-sdk": "2.9.0",
+    "@getpara/react-common": "2.10.0",
+    "@getpara/react-components": "2.10.0",
+    "@getpara/web-sdk": "2.10.0",
     "date-fns": "^3.6.0",
     "framer-motion": "^11.3.31",
     "libphonenumber-js": "^1.11.7",
@@ -16,9 +16,9 @@
     "zustand-sync-tabs": "^0.2.2"
   },
   "devDependencies": {
-    "@getpara/cosmos-wallet-connectors": "2.9.0",
-    "@getpara/evm-wallet-connectors": "2.9.0",
-    "@getpara/solana-wallet-connectors": "2.9.0",
+    "@getpara/cosmos-wallet-connectors": "2.10.0",
+    "@getpara/evm-wallet-connectors": "2.10.0",
+    "@getpara/solana-wallet-connectors": "2.10.0",
     "@tanstack/react-query": "^5.74.0",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.3.0",
@@ -38,7 +38,7 @@
     "package.json",
     "styles.css"
   ],
-  "gitHead": "672cc943bc57cbeced8e79127c52a4fab0af4aed",
+  "gitHead": "8da2c51cc91f021acbc2ec7373b9ca0638fc840a",
   "main": "dist/index.js",
   "peerDependencies": {
     "@tanstack/react-query": ">=5.0.0",