@getpara/react-sdk-lite 2.9.0 → 2.11.0

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,24 +1,25 @@
 {
   "name": "@getpara/react-sdk-lite",
-  "version": "2.9.0",
+  "version": "2.11.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.11.0",
+    "@getpara/react-components": "2.11.0",
+    "@getpara/web-sdk": "2.11.0",
     "date-fns": "^3.6.0",
     "framer-motion": "^11.3.31",
     "libphonenumber-js": "^1.11.7",
+    "socket.io-client": "^4.5.1",
     "styled-components": "^6.1.8",
     "zustand": "^4.5.2",
     "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.11.0",
+    "@getpara/evm-wallet-connectors": "2.11.0",
+    "@getpara/solana-wallet-connectors": "2.11.0",
     "@tanstack/react-query": "^5.74.0",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.3.0",
@@ -38,7 +39,7 @@
     "package.json",
     "styles.css"
   ],
-  "gitHead": "672cc943bc57cbeced8e79127c52a4fab0af4aed",
+  "gitHead": "1cce45857320460cca03c4a9d0a59db169b222d6",
   "main": "dist/index.js",
   "peerDependencies": {
     "@tanstack/react-query": ">=5.0.0",

package/dist/modal/utils/validateOnRampConfig.d.ts

@@ -1,5 +0,0 @@
-import { OnRampConfig } from '@getpara/web-sdk';
-export declare class OnRampConfigError extends Error {
-    constructor(message: any);
-}
-export declare function validateOnRampConfig(obj?: OnRampConfig): obj is OnRampConfig;

package/dist/modal/utils/validateOnRampConfig.js

@@ -1,32 +0,0 @@
-"use client";
-import "../../chunk-MMUBH76A.js";
-class OnRampConfigError extends Error {
-  constructor(message) {
-    super(`On-ramp configuration error: ${message}.`);
-    this.name = "OnRampConfigError";
-  }
-}
-function checkHasProviders({ providers }) {
-  if (!providers || providers.length < 1) {
-    throw new OnRampConfigError("No providers are configured");
-  }
-}
-function checkDuplicateProviders({ providers }) {
-  providers.forEach((id, index) => {
-    if (providers.findIndex((p) => p === id) !== index) {
-      throw new OnRampConfigError(`Provider ${id} is configured more than once`);
-    }
-  });
-}
-function validateOnRampConfig(obj) {
-  if (!obj) {
-    return false;
-  }
-  checkHasProviders(obj);
-  checkDuplicateProviders(obj);
-  return true;
-}
-export {
-  OnRampConfigError,
-  validateOnRampConfig
-};