@getpara/react-sdk-lite 2.10.0 → 2.12.0

package/dist/modal/hooks/useSendMutations.d.ts

@@ -0,0 +1,51 @@
+import { BroadcastTransactionResult, EstimateTransactionResult } from '@getpara/web-sdk';
+import { EstimateTransactionOpts, NetworkDefinition, RpcMetadata, TransactionType } from '@getpara/shared';
+type BroadcastOpts = Omit<NetworkDefinition, 'type'> & {
+    userId: string;
+    walletId: string;
+    walletAddress: string;
+    walletType: TransactionType;
+    txSerialized: string;
+    message?: string;
+    txUrlFormat?: string;
+    rpc?: RpcMetadata;
+    simulateFailure?: boolean;
+};
+export declare function useSendMutations({ estimateOnSuccess, estimateOnError, broadcastOnSuccess, broadcastOnError, }: {
+    estimateOnSuccess: (data: EstimateTransactionResult) => void;
+    estimateOnError: (error: Error) => void;
+    broadcastOnSuccess?: (data: BroadcastTransactionResult) => void;
+    broadcastOnError: (error: Error) => void;
+}): {
+    estimateMutate: import("@tanstack/react-query").UseMutateFunction<Partial<{
+        result: Pick<import("@getpara/shared").CreateTransactionSuccess, "txSerialized" | "message">;
+        error: import("@getpara/shared").TransactionError;
+        feeAmount: string;
+        feeValue: string;
+        transferAmount: string;
+        transferValue: string;
+    }> | null, Error, {
+        userId: string;
+        walletId: string;
+        opts: EstimateTransactionOpts;
+    }, unknown>;
+    estimateMutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<Partial<{
+        result: Pick<import("@getpara/shared").CreateTransactionSuccess, "txSerialized" | "message">;
+        error: import("@getpara/shared").TransactionError;
+        feeAmount: string;
+        feeValue: string;
+        transferAmount: string;
+        transferValue: string;
+    }> | null, Error, {
+        userId: string;
+        walletId: string;
+        opts: EstimateTransactionOpts;
+    }, unknown>;
+    broadcastMutate: import("@tanstack/react-query").UseMutateFunction<BroadcastTransactionResult | null, Error, BroadcastOpts, unknown>;
+    broadcastMutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<BroadcastTransactionResult | null, Error, BroadcastOpts, unknown>;
+    estimateIsPending: boolean;
+    estimateIsError: boolean;
+    broadcastIsPending: boolean;
+    broadcastIsError: boolean;
+};
+export {};

package/dist/modal/hooks/useSendMutations.js

@@ -0,0 +1,170 @@
+"use client";
+import {
+  __async,
+  __spreadProps,
+  __spreadValues
+} from "../../chunk-MMUBH76A.js";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { useInternalClient } from "../../provider/hooks/utils/useInternalClient.js";
+import { useModalStore, useModalSessionStore } from "../stores/index.js";
+import { useSignMessage, useSignTransaction, useWalletState } from "../../provider/index.js";
+import {
+  hexStringToBase64
+} from "@getpara/web-sdk";
+import { useMemo, useCallback } from "react";
+import { ModalStep } from "../utils/steps.js";
+import { useStore } from "../../provider/stores/useStore.js";
+function useSendMutations({
+  estimateOnSuccess,
+  estimateOnError,
+  broadcastOnSuccess,
+  broadcastOnError
+}) {
+  const para = useInternalClient();
+  const setStep = useModalStore((state) => state.setStep);
+  const setSendTx = useModalSessionStore((state) => state.setSendTx);
+  const { signTransactionAsync } = useSignTransaction();
+  const { signMessageAsync } = useSignMessage();
+  const { selectedWallet } = useWalletState();
+  const queryClient = useQueryClient();
+  const refs = useStore((state) => state.refs);
+  const defaultBroadcastOnSuccess = useCallback(
+    (data) => {
+      if (!!(data == null ? void 0 : data.error)) {
+        return;
+      } else if (!!data) {
+        const currentSendTx = useModalSessionStore.getState().sendTx;
+        if (currentSendTx) {
+          setSendTx(__spreadProps(__spreadValues({}, currentSendTx), { result: data }));
+        }
+        setStep(ModalStep.ACCOUNT_MAIN);
+        refs.balancesInvalidationTime.current = Date.now();
+        queryClient.invalidateQueries({
+          queryKey: ["useProfileBalance"],
+          refetchType: "active"
+        });
+      }
+    },
+    [setSendTx, setStep, queryClient, refs]
+  );
+  const handleBroadcastSuccess = useCallback(
+    (data) => {
+      defaultBroadcastOnSuccess(data);
+      broadcastOnSuccess == null ? void 0 : broadcastOnSuccess(data);
+    },
+    [defaultBroadcastOnSuccess, broadcastOnSuccess]
+  );
+  const {
+    mutate: estimateMutate,
+    mutateAsync: estimateMutateAsync,
+    isPending: estimateIsPending,
+    isError: estimateIsError
+  } = useMutation({
+    mutationKey: ["estimate-tx"],
+    mutationFn: (_0) => __async(this, [_0], function* ({ userId, walletId, opts }) {
+      if (!para.userId || !selectedWallet.id) {
+        return null;
+      }
+      const result = yield para.ctx.client.estimateSendTransaction({
+        userId,
+        walletId,
+        opts
+      });
+      return result;
+    }),
+    onSuccess: (data, variables) => {
+      setSendTx(__spreadValues({}, variables));
+      estimateOnSuccess(data);
+    },
+    onError: estimateOnError
+  });
+  const {
+    mutate: broadcastMutate,
+    mutateAsync: broadcastMutateAsync,
+    isPending: broadcastIsPending,
+    isError: broadcastIsError
+  } = useMutation({
+    mutationKey: ["broadcast-tx"],
+    mutationFn: (_0) => __async(this, [_0], function* ({
+      userId,
+      walletId,
+      walletAddress,
+      walletType,
+      txSerialized,
+      message,
+      evmChainId,
+      isDevnet,
+      txUrlFormat,
+      rpc,
+      simulateFailure
+    }) {
+      var _a, _b;
+      if (!para.userId || !selectedWallet.id) {
+        return null;
+      }
+      let signature;
+      switch (walletType) {
+        case "SOLANA":
+          signature = (_a = yield signMessageAsync({
+            walletId,
+            messageBase64: message
+          })) == null ? void 0 : _a.signature;
+          break;
+        case "EVM":
+        default:
+          signature = (_b = yield signTransactionAsync({
+            walletId,
+            rlpEncodedTxBase64: hexStringToBase64(txSerialized),
+            chainId: evmChainId
+          })) == null ? void 0 : _b.signature;
+          if (!!signature) {
+            signature = `0x${signature}`;
+          }
+          break;
+      }
+      const result = yield para.ctx.client.broadcastSendTransaction({
+        userId,
+        walletId,
+        opts: {
+          type: walletType,
+          evmChainId,
+          isDevnet,
+          tx: txSerialized,
+          signature,
+          sourceAddress: walletAddress,
+          txUrlFormat,
+          rpc,
+          simulateFailure
+        }
+      });
+      return result;
+    }),
+    onSuccess: handleBroadcastSuccess,
+    onError: broadcastOnError
+  });
+  return useMemo(
+    () => ({
+      estimateMutate,
+      estimateMutateAsync,
+      broadcastMutate,
+      broadcastMutateAsync,
+      estimateIsPending,
+      estimateIsError,
+      broadcastIsPending,
+      broadcastIsError
+    }),
+    [
+      estimateMutate,
+      estimateMutateAsync,
+      broadcastMutate,
+      broadcastMutateAsync,
+      estimateIsPending,
+      estimateIsError,
+      broadcastIsPending,
+      broadcastIsError
+    ]
+  );
+}
+export {
+  useSendMutations
+};

package/dist/modal/hooks/useTelegramLogin.js

@@ -50,7 +50,7 @@ const useTelegramLogin = ({
           if (!!event.data.payload) {
             const authObject = event.data.payload;
             try {
-              yield onSubmit == null ? void 0 : onSubmit(authObject);
+              onSubmit == null ? void 0 : onSubmit(authObject);
             } catch (e) {
               (_b = (_a = refs.telegramIFrame.current) == null ? void 0 : _a.contentWindow) == null ? void 0 : _b.postMessage({ type: "TELEGRAM_RETRY" }, "*");
             }

package/dist/modal/hooks/useTransactionMonitoring.d.ts

@@ -0,0 +1 @@
+export declare function useTransactionMonitoring(): void;

package/dist/modal/hooks/useTransactionMonitoring.js

@@ -0,0 +1,175 @@
+"use client";
+import {
+  __objRest,
+  __spreadProps,
+  __spreadValues
+} from "../../chunk-MMUBH76A.js";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { useInternalClient } from "../../provider/hooks/utils/useInternalClient.js";
+import { useModalStore, useModalSessionStore } from "../stores/index.js";
+import { getBaseUrl } from "@getpara/web-sdk";
+import { useAccount } from "../../provider/index.js";
+import { ModalStep } from "../utils/steps.js";
+import { SESSION_COOKIE_HEADER_NAME } from "@getpara/user-management-client";
+const TRANSACTION_CLEANUP_DELAY_MS = 3e4;
+function useTransactionMonitoring() {
+  var _a, _b, _c, _d, _e, _f;
+  const sendTx = useModalSessionStore((state) => state.sendTx);
+  const setSendTx = useModalSessionStore((state) => state.setSendTx);
+  const currentStep = useModalStore((state) => state.step);
+  const para = useInternalClient();
+  const socketRef = useRef(null);
+  const subscribedDataRef = useRef(null);
+  const socketIoModuleRef = useRef(null);
+  const [isLoadingSocketIo, setIsLoadingSocketIo] = useState(false);
+  const {
+    embedded: { userId },
+    isConnected
+  } = useAccount();
+  const socketUrl = useMemo(() => {
+    var _a2;
+    if (!((_a2 = para.ctx) == null ? void 0 : _a2.env)) return null;
+    return getBaseUrl(para.ctx.env, "ws");
+  }, [(_a = para.ctx) == null ? void 0 : _a.env]);
+  useEffect(() => {
+    var _a2, _b2, _c2, _d2;
+    if (typeof window === "undefined") {
+      return;
+    }
+    const shouldMonitor = isConnected && userId && userId === (sendTx == null ? void 0 : sendTx.userId) && ((_a2 = sendTx == null ? void 0 : sendTx.result) == null ? void 0 : _a2.status) && ((_b2 = sendTx == null ? void 0 : sendTx.result) == null ? void 0 : _b2.txHash) && ((_c2 = sendTx == null ? void 0 : sendTx.result) == null ? void 0 : _c2.network) && socketUrl;
+    if (!shouldMonitor) {
+      if (socketRef.current) {
+        if (subscribedDataRef.current) {
+          socketRef.current.emit("tx:unsubscribe", subscribedDataRef.current);
+          subscribedDataRef.current = null;
+        }
+        socketRef.current.disconnect();
+        socketRef.current = null;
+      }
+      if (sendTx && (!isConnected || !userId || userId !== sendTx.userId)) {
+        setSendTx(null);
+      }
+      return;
+    }
+    const subscribeData = __spreadValues({
+      txHash: sendTx.result.txHash
+    }, sendTx.result.network);
+    if (!socketRef.current && !isLoadingSocketIo) {
+      setIsLoadingSocketIo(true);
+      import("socket.io-client").then((socketIoModule) => {
+        var _a3, _b3;
+        socketIoModuleRef.current = socketIoModule;
+        const { io } = socketIoModule;
+        const sessionCookie = (_a3 = para == null ? void 0 : para.retrieveSessionCookie) == null ? void 0 : _a3.call(para);
+        if (!sessionCookie) {
+          setIsLoadingSocketIo(false);
+          return;
+        }
+        socketRef.current = io(socketUrl, {
+          transports: ["polling", "websocket"],
+          reconnection: true,
+          reconnectionAttempts: 5,
+          reconnectionDelay: 1e3,
+          upgrade: true,
+          extraHeaders: {
+            [SESSION_COOKIE_HEADER_NAME]: sessionCookie
+          }
+        });
+        socketRef.current.on("connect_error", () => {
+          var _a4;
+          const sendTx2 = useModalSessionStore.getState().sendTx;
+          if ((_a4 = sendTx2 == null ? void 0 : sendTx2.result) == null ? void 0 : _a4.explorerUrl) {
+            const _b4 = sendTx2.result, { status: _status } = _b4, rest = __objRest(_b4, ["status"]);
+            setSendTx(__spreadProps(__spreadValues({}, sendTx2), {
+              result: __spreadValues({}, rest)
+            }));
+          }
+          return;
+        });
+        socketRef.current.on("tx:error", (error) => {
+          console.error("Transaction monitoring error:", error);
+        });
+        if (((_b3 = subscribedDataRef.current) == null ? void 0 : _b3.txHash) !== subscribeData.txHash) {
+          socketRef.current.emit("tx:subscribe", subscribeData);
+          subscribedDataRef.current = subscribeData;
+        }
+        socketRef.current.on("tx:status", (status) => {
+          if (!status || typeof status !== "object") {
+            return;
+          }
+          if (!status.status || !["PENDING", "CONFIRMED", "FAILED"].includes(status.status)) {
+            return;
+          }
+          if (status.confirmations !== void 0 && (typeof status.confirmations !== "number" || status.confirmations < 0)) {
+            return;
+          }
+          if (status.blockNumber !== void 0 && (typeof status.blockNumber !== "number" || status.blockNumber < 0)) {
+            return;
+          }
+          const currentSendTx = useModalSessionStore.getState().sendTx;
+          if (currentSendTx && currentSendTx.userId === para.userId) {
+            const updatedSendTx = __spreadProps(__spreadValues({}, currentSendTx), {
+              result: __spreadProps(__spreadValues({}, currentSendTx.result), {
+                status: __spreadValues({}, status)
+              })
+            });
+            setSendTx(updatedSendTx);
+          }
+        });
+        setIsLoadingSocketIo(false);
+      }).catch((err) => {
+        console.error("[useTransactionMonitoring] Failed to load socket.io-client:", err);
+        setIsLoadingSocketIo(false);
+      });
+    }
+    if (((_d2 = subscribedDataRef.current) == null ? void 0 : _d2.txHash) !== subscribeData.txHash && socketRef.current) {
+      socketRef.current.emit("tx:subscribe", subscribeData);
+      subscribedDataRef.current = subscribeData;
+    }
+    return () => {
+      var _a3, _b3;
+      if (socketRef.current && ((_a3 = subscribedDataRef.current) == null ? void 0 : _a3.txHash) === subscribeData.txHash) {
+        socketRef.current.emit("tx:unsubscribe", subscribedDataRef.current);
+        subscribedDataRef.current = null;
+        if (!((_b3 = sendTx == null ? void 0 : sendTx.result) == null ? void 0 : _b3.status) || !isConnected) {
+          socketRef.current.disconnect();
+          socketRef.current = null;
+        }
+      }
+    };
+  }, [(_b = sendTx == null ? void 0 : sendTx.result) == null ? void 0 : _b.txHash, (_c = sendTx == null ? void 0 : sendTx.result) == null ? void 0 : _c.network, socketUrl, setSendTx, isConnected, userId, isLoadingSocketIo, para]);
+  useEffect(() => {
+    return () => {
+      if (socketRef.current) {
+        socketRef.current.disconnect();
+        socketRef.current = null;
+      }
+    };
+  }, []);
+  useEffect(() => {
+    var _a2, _b2, _c2;
+    if (typeof window === "undefined") return;
+    const status = (_b2 = (_a2 = sendTx == null ? void 0 : sendTx.result) == null ? void 0 : _a2.status) == null ? void 0 : _b2.status;
+    const isCompleted = status === "CONFIRMED" || status === "FAILED";
+    const isOnAccountOrMonitor = currentStep === ModalStep.ACCOUNT_MAIN || currentStep === ModalStep.ACCOUNT_MONITOR_TX;
+    if (isCompleted && sendTx && !isOnAccountOrMonitor) {
+      setSendTx(null);
+      return;
+    }
+    if (isCompleted && currentStep === ModalStep.ACCOUNT_MAIN && ((_c2 = sendTx == null ? void 0 : sendTx.result) == null ? void 0 : _c2.txHash)) {
+      const txHash = sendTx.result.txHash;
+      const timeoutId = setTimeout(() => {
+        var _a3, _b3;
+        const sessionState = useModalSessionStore.getState();
+        const modalState = useModalStore.getState();
+        if (((_b3 = (_a3 = sessionState.sendTx) == null ? void 0 : _a3.result) == null ? void 0 : _b3.txHash) === txHash && modalState.step === ModalStep.ACCOUNT_MAIN) {
+          setSendTx(null);
+        }
+      }, TRANSACTION_CLEANUP_DELAY_MS);
+      return () => clearTimeout(timeoutId);
+    }
+  }, [(_e = (_d = sendTx == null ? void 0 : sendTx.result) == null ? void 0 : _d.status) == null ? void 0 : _e.status, (_f = sendTx == null ? void 0 : sendTx.result) == null ? void 0 : _f.txHash, currentStep, setSendTx]);
+}
+export {
+  useTransactionMonitoring
+};

package/dist/modal/index.d.ts

@@ -5,4 +5,4 @@ export { AuthLayout } from './types/modalProps.js';
 export * from './utils/openPopup.js';
 export { ON_RAMP_PROVIDERS, ON_RAMP_ASSETS, NETWORKS, getAssetIcon, getAssetCode, getNetworkIcon, getNetworkName, } from '@getpara/react-common';
 export { SaveRecoverySecret } from './components/RecoverySecretStep/RecoverySecretStep.js';
-export * from './utils/validateOnRampConfig.js';
+export * from './utils/onramps.js';

package/dist/modal/index.js

@@ -14,7 +14,7 @@ import {
   getNetworkName
 } from "@getpara/react-common";
 import { SaveRecoverySecret } from "./components/RecoverySecretStep/RecoverySecretStep.js";
-export * from "./utils/validateOnRampConfig.js";
+export * from "./utils/onramps.js";
 export {
   AuthLayout,
   ModalStep,

package/dist/modal/stores/index.d.ts

@@ -1 +1,2 @@
 export * from './modal/useModalStore.js';
+export * from './modal/useModalSessionStore.js';

package/dist/modal/stores/index.js

@@ -1,2 +1,3 @@
 "use client";
 export * from "./modal/useModalStore.js";
+export * from "./modal/useModalSessionStore.js";

package/dist/modal/stores/modal/actions.js

@@ -139,7 +139,6 @@ const getActions = (set, get) => ({
   setIsPasskeySupported: (isPasskeySupported) => set({ isPasskeySupported }),
   setAccountLinkOptions: (accountLinkOptions) => set({ accountLinkOptions }),
   setProfileWallet: (profileWallet) => set({ profileWallet }),
-  setSendTx: (sendTx) => set({ sendTx }),
   setIsTestModeAlertDismissed: (isTestModeAlertDismissed) => set({ isTestModeAlertDismissed })
 });
 export {

package/dist/modal/stores/modal/useModalSessionStore.d.ts

@@ -0,0 +1,28 @@
+import { BroadcastTransactionResult } from '@getpara/web-sdk';
+import { CreateTransactionOpts } from '@getpara/shared';
+export type SendTx = {
+    userId: string;
+    walletId: string;
+    opts: CreateTransactionOpts;
+    transferAmount?: string;
+    result?: BroadcastTransactionResult;
+};
+interface ModalSessionState {
+    sendTx: SendTx | null;
+}
+interface ModalSessionActions {
+    setSendTx: (_: SendTx | null) => void;
+}
+export type ModalSessionStore = ModalSessionState & ModalSessionActions;
+export declare const useModalSessionStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<ModalSessionStore>, "persist"> & {
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<ModalSessionStore, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: ModalSessionStore) => void) => () => void;
+        onFinishHydration: (fn: (state: ModalSessionStore) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<ModalSessionStore, unknown>>;
+    };
+}>;
+export {};

package/dist/modal/stores/modal/useModalSessionStore.js

@@ -0,0 +1,26 @@
+"use client";
+import {
+  __spreadProps,
+  __spreadValues
+} from "../../../chunk-MMUBH76A.js";
+import { create } from "zustand";
+import { persist, createJSONStorage } from "zustand/middleware";
+import { PARA_STORAGE_PREFIX } from "@getpara/core-sdk";
+const DEFAULT_SESSION_STATE = {
+  sendTx: null
+};
+const useModalSessionStore = create()(
+  persist(
+    (set) => __spreadProps(__spreadValues({}, DEFAULT_SESSION_STATE), {
+      setSendTx: (sendTx) => set({ sendTx })
+    }),
+    {
+      version: 1,
+      name: `${PARA_STORAGE_PREFIX}modalSessionState`,
+      storage: createJSONStorage(() => sessionStorage)
+    }
+  )
+);
+export {
+  useModalSessionStore
+};

package/dist/modal/stores/modal/useModalStore.d.ts

@@ -1,6 +1,6 @@
 import { AvailableWallet } from '@getpara/core-sdk';
 import { ModalStep } from '../../utils/steps.js';
-import { AuthStateLogin, AuthStateSignup, AuthState, AuthStateVerify, OnRampConfig as OnRampConfigBase, OnRampPurchase, TWalletType, Setup2faResponse, SupportedAccountLinks, BroadcastTransactionResult } from '@getpara/web-sdk';
+import { AuthStateLogin, AuthStateSignup, AuthState, AuthStateVerify, OnRampConfig as OnRampConfigBase, OnRampPurchase, TWalletType, Setup2faResponse, SupportedAccountLinks } from '@getpara/web-sdk';
 import { Tab as AddFundsTabType } from '../../components/AddFunds/AddFundsContext.js';
 import { TAuthLayout } from '../../types/modalProps.js';
 import { MutableRefObject } from 'react';
@@ -57,11 +57,11 @@ interface ModalState {
         wasSignedIn: MutableRefObject<boolean | null>;
         initialFarcasterConnected: MutableRefObject<boolean | null>;
         iFrame: MutableRefObject<HTMLIFrameElement | null>;
+        modalContainer: MutableRefObject<HTMLElement | null>;
     };
     isPasskeySupported: boolean;
     accountLinkOptions: SupportedAccountLinks;
     profileWallet?: AvailableWallet;
-    sendTx: BroadcastTransactionResult | null;
     isTestModeAlertDismissed: boolean;
 }
 export interface ModalActions {
@@ -102,7 +102,6 @@ export interface ModalActions {
     setIsPasskeySupported: (_: boolean) => void;
     setAccountLinkOptions: (_: SupportedAccountLinks) => void;
     setProfileWallet: (_?: AvailableWallet) => void;
-    setSendTx: (_: BroadcastTransactionResult | null) => void;
     setIsTestModeAlertDismissed: (_: boolean) => void;
 }
 export type ModalStore = ModalState & ModalActions;

package/dist/modal/stores/modal/useModalStore.js

@@ -45,12 +45,12 @@ const DEFAULT_MODAL_STATE = {
     telegramIFrame: createRef(),
     wasSignedIn: createRef(),
     initialFarcasterConnected: createRef(),
-    iFrame: createRef()
+    iFrame: createRef(),
+    modalContainer: createRef()
   },
   isPasskeySupported: true,
   accountLinkOptions: [...LINKED_ACCOUNT_TYPES],
   profileWallet: void 0,
-  sendTx: null,
   isTestModeAlertDismissed: false
 };
 const useModalStore = create()(

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

@@ -0,0 +1,61 @@
+import { OnRampConfig, OnRampProvider, OnRampPurchaseType, TNetwork, TOnRampAsset, TWalletType } from '@getpara/web-sdk';
+export declare class OnRampConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * Provider-specific transaction amount limits (in USD).
+ * These limits are enforced client-side to prevent users from selecting
+ * providers that don't support their desired transaction amount.
+ *
+ * Last verified: February 2025
+ * Sources:
+ * - MoonPay: https://support.moonpay.com/customers/docs/moonpay-transaction-limits
+ * - Stripe: https://docs.stripe.com/crypto/using-the-dashboard#onramp-minimums-and-maximums
+ * - Ramp: https://support.ramp.network/en/articles/471-transaction-limits
+ */
+export declare const PROVIDER_LIMITS: Record<OnRampProvider, Record<OnRampPurchaseType, {
+    min: number | null;
+    max: number | null;
+}>>;
+export declare function validateOnRampConfig(obj?: OnRampConfig): obj is OnRampConfig;
+/**
+ * Gets a default asset and network combination that are guaranteed to work together.
+ *
+ * When preferredAsset is provided:
+ * - Locks in that asset and finds the best compatible network
+ * - Returns { asset: preferredAsset, network: <compatible network> }
+ *
+ * When preferredAsset is not provided:
+ * - Finds the best asset+network combination
+ * - Priority order:
+ *   1. Partner's defaults (if both are valid together)
+ *   2. Wallet-type-specific combo (COSMOS→ATOM on COSMOS, SOLANA→SOL on SOLANA, etc.)
+ *   3. First valid asset+network combination from available lists
+ *
+ * @param params - Configuration object
+ * @param params.walletType - The wallet type (EVM, SOLANA, COSMOS)
+ * @param params.onRampConfig - OnRamp configuration
+ * @param params.networks - Available networks (from getOnRampNetworks)
+ * @param params.assets - Available assets (from assets calculation)
+ * @param params.preferredAsset - Optional asset to lock in (will only find compatible network)
+ * @returns Object with asset and network, both null if no valid combination exists
+ */
+export declare function getDefaultAssetAndNetwork({ walletType, onRampConfig, networks, assets, preferredAsset, }: {
+    walletType: TWalletType | undefined;
+    onRampConfig: OnRampConfig | undefined;
+    networks: TNetwork[];
+    assets: TOnRampAsset[];
+    preferredAsset?: TOnRampAsset | null;
+}): {
+    asset: TOnRampAsset | null;
+    network: TNetwork | null;
+};
+/**
+ * Checks if an amount falls within the provider's limits for a given operation type.
+ * @param amount - The amount to check (can be undefined for invalid inputs)
+ * @param provider - The provider to check limits for
+ * @param type - The transaction type (BUY or SELL)
+ * @param limits - Optional provider limits object (defaults to PROVIDER_LIMITS)
+ * @returns true if the amount is within limits, false otherwise
+ */
+export declare function isAmountWithinProviderLimits(amount: number | undefined, provider: OnRampProvider, type: OnRampPurchaseType, limits?: typeof PROVIDER_LIMITS): boolean;