@funkit/connect 7.1.0-next.12 → 7.1.0-next.13

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @funkit/connect
 
+## 7.1.0-next.13
+
+### Minor Changes
+
+- f4552b0: Expose recent deposits hooks for SDK users with comprehensive documentation
+
+  Add two new public hooks for fetching recent deposits/direct executions:
+
+  - `useFunkitRecentDeposits`: Auto-integrates with FunkitProvider context
+  - `useFunkitRecentDepositsImpl`: Standalone implementation with explicit parameters
+
+  Both hooks return purified checkout history items suitable for external use and include full JSDoc documentation with usage examples.
+
+### Patch Changes
+
+- 2962aaa: feat(connect): remove persisted targetAssetAmount when source token changes - fixes default input amount logic
+- 6802246: feat(connect): remove no eth asset msg for lighter
+
 ## 7.1.0-next.12
 
 ### Patch Changes

package/dist/hooks/queries/useRecentDeposits.d.ts

@@ -19,13 +19,27 @@ interface RecentDirectExecutionsQuery {
      * Maximum number of deposits to fetch from the API.
      * @default 5
      */
-    batchSize?: number;
+    fetchSize?: number;
     /**
      * Custom cutoff time in milliseconds for determining which deposits are "recent".
      * Deposits created after this timestamp will be included.
      * If not provided, uses Fun's default strategy.
      */
     cutOffTimeMs?: number;
+    /**
+     * API key for authenticating requests to Fun's API server.
+     */
+    apiKey: string;
+    /**
+     * User ID for which to fetch direct executions.
+     * Usually user's connected wallet address.
+     */
+    userId: string;
+    /**
+     * Interval in milliseconds for how often to refetch the data.
+     * Determines the polling frequency for keeping deposit data up to date.
+     */
+    refreshIntervalMs: number;
 }
 export interface MergedMultiStepDirectExecution extends DirectExecution {
     /**
@@ -37,10 +51,66 @@ export interface MergedMultiStepDirectExecution extends DirectExecution {
 }
 export declare function isTokenTransferDirectExecution(de: DirectExecution): boolean;
 export declare function isWithdrawalDirectExecution(de: DirectExecution): boolean;
+type DefaultDEQueryKey = 'apiKey' | 'userId' | 'refreshIntervalMs';
+export type RecentDEQuerySimplified = Omit<RecentDirectExecutionsQuery, DefaultDEQueryKey>;
 /**
  * @returns recent direct executions tied to a recipient address used in the token transfer flow
  */
-export declare const useRecentDeposits: ({ isVisible, memoizedFilterFunc, batchSize, cutOffTimeMs, }: RecentDirectExecutionsQuery) => {
+export declare const useRecentDeposits: ({ isVisible, memoizedFilterFunc, fetchSize, cutOffTimeMs, }: RecentDEQuerySimplified) => {
     data: MergedMultiStepDirectExecution[] | undefined;
 };
+/**
+ * Hook for SDK users to fetch recent deposits/direct executions with automatic context integration.
+ *
+ * **Requirements**: Must be used inside FunkitProvider context as it automatically retrieves:
+ * - API key, User ID, Refresh interval from Fun
+ *
+ * Returns checkout history items
+ *
+ * @param query - Simplified query parameters (excludes apiKey, userId, refreshIntervalMs)
+ * @returns Object with `data` property containing array of purified direct executions or undefined if not loaded
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { data: recentDeposits } = useFunkitRecentDeposits({
+ *     isVisible: true,
+ *     fetchSize: 10,
+ *     cutOffTimeMs: 24 * 60 * 60 * 1000, // Last 24 hours
+ *   })
+ *   return <div>{recentDeposits?.length} recent deposits</div>
+ * }
+ * ```
+ */
+export declare function useFunkitRecentDeposits(query: RecentDEQuerySimplified): {
+    data: import("~/utils/purifyCheckoutHistoryItem").PurifiedCheckoutHistoryItem[] | undefined;
+};
+/**
+ * Implementation hook for SDK users to fetch recent deposits with explicit parameters.
+ *
+ * **Requirements**: Does NOT require FunkitProvider context. All parameters must be provided explicitly.
+ * This is useful for custom implementations or when using outside the standard Funkit provider hierarchy.
+ *
+ * Returns purified checkout history items
+ *
+ * @param query - Complete query parameters including apiKey, userId, and refreshIntervalMs
+ * @returns Object with `data` property containing array of purified direct executions or undefined if not loaded
+ *
+ * @example
+ * ```tsx
+ * function MyCustomComponent() {
+ *   const { data: recentDeposits } = useFunkitRecentDepositsImpl({
+ *     isVisible: true,
+ *     apiKey: 'your-api-key',
+ *     userId: 'user-wallet-address',
+ *     refreshIntervalMs: 5000,
+ *     fetchSize: 10,
+ *   })
+ *   return <div>{recentDeposits?.length} recent deposits</div>
+ * }
+ * ```
+ */
+export declare function useFunkitRecentDepositsImpl(query: RecentDirectExecutionsQuery): {
+    data: import("~/utils/purifyCheckoutHistoryItem").PurifiedCheckoutHistoryItem[] | undefined;
+};
 export {};

package/dist/index.d.ts

@@ -26,7 +26,7 @@ export type { FunkitConfig } from './providers/FunkitConfigContext';
 export type { FunkitConnectChain as Chain } from './providers/FunkitConnectChainContext';
 export type { ModalSizes } from './providers/ModalSizeContext';
 export { useCheckoutListenerByCheckoutId, useCheckoutsListenerByUserId, } from './providers/FunkitHistoryContext';
-export { useRecentDeposits } from './hooks/queries/useRecentDeposits';
+export { useFunkitRecentDeposits, useFunkitRecentDepositsImpl, } from './hooks/queries/useRecentDeposits';
 export type { FunkitWagmiConfig, FunkitProviderProps, } from './providers/FunkitProvider';
 export { FunkitProvider } from './providers/FunkitProvider';
 export type { Theme, ThemeSet } from './providers/FunkitThemeProvider';

package/dist/index.js

@@ -1122,11 +1122,6 @@ function isHyenaCustomer(apiKey) {
 function isLighterxyzCustomer(apiKey) {
   return apiKey === LIGHTERXYZ_API_KEY;
 }
-function isLighterEthSpot(apiKey, checkoutConfig) {
-  return checkoutConfig && isLighterxyzCustomer(apiKey) && ["LIGHTER_ETH_SPOT_NEW_USER", "LIGHTER_ETH_SPOT"].includes(
-    checkoutConfig.dynamicRoutingId || ""
-  );
-}
 function isLighterNativeFlow(apiKey, checkoutConfig) {
   return !!checkoutConfig && isLighterxyzCustomer(apiKey) && checkoutConfig.targetChain === mainnet4.id.toString();
 }
@@ -1432,7 +1427,7 @@ function setFunkitConnectVersion({ version }) {
   localStorage.setItem(storageKey, version);
 }
 function getCurrentSdkVersion() {
-  return "7.1.0-next.12";
+  return "7.1.0-next.13";
 }
 function useFingerprint() {
   const fingerprint = useCallback3(() => {
@@ -4327,6 +4322,15 @@ function useMultiStepDirectExecutionStatus(multiStepDirectExecution, disabled =
 }
 
 // src/utils/purifyCheckoutHistoryItem.ts
+function resolveLastDirectExecution(de) {
+  return de.latestStep ?? de;
+}
+function getTransactionHashes(first, last) {
+  const all = [first.txHash, first.toTxId, last.txHash, last.toTxId].filter(
+    Boolean
+  );
+  return Array.from(new Set(all));
+}
 var purifyCheckoutHistoryItem = (item) => {
   if ("depositAddr" in item) {
     return {
@@ -4345,22 +4349,26 @@ var purifyCheckoutHistoryItem = (item) => {
       additionalActions: item?.clientMetadata?.evaluatedActionsParams ?? []
     };
   }
+  const de = resolveLastDirectExecution(item);
   return {
     directExecution: true,
-    id: item.txHash,
+    id: de.txHash,
+    // use first step's deposit address for source
     fromAmountBaseUnit: item.fromAmountBaseUnit,
     fromChainId: item.fromChainId,
     fromTokenAddress: item.fromTokenAddress,
+    // use last step's status for target
+    toChainId: de.toChainId,
+    toTokenAddress: de.toTokenAddress,
+    toAmountBaseUnit: de.toAmountBaseUnit,
     state: mapRelayExecutionStatusToCheckoutState(
-      item?.listenerInfo?.status ?? RelayExecutionStatus2.SUCCESS
+      de?.listenerInfo?.status ?? RelayExecutionStatus2.SUCCESS
     ),
-    toChainId: item.toChainId,
-    toTokenAddress: item.toTokenAddress,
-    toAmountBaseUnit: item.toAmountBaseUnit,
-    txHash: item.txHash,
+    txHashes: getTransactionHashes(item, de),
+    // needs to use the original item's createdTimeMs for the earliest time
     createdTimeMs: item.createdTimeMs,
-    updatedTimeMs: getDirectExecutionUpdatedTimeMs(item),
-    additionalActions: item?.clientMetadata?.evaluatedActionsParams ?? []
+    updatedTimeMs: getDirectExecutionUpdatedTimeMs(de),
+    additionalActions: de?.clientMetadata?.evaluatedActionsParams ?? []
   };
 };
 
@@ -20408,28 +20416,28 @@ function isTokenTransferDirectExecution(de) {
 function isWithdrawalDirectExecution(de) {
   return !!de.clientMetadata.isWithdrawal;
 }
-var useRecentDeposits = ({
+function useRecentDepositsImpl({
   isVisible,
   // WARNING! memoizedFilterFunc must be a stable reference (ie: wrap it in useMemo), otherwise hook will constantly re-render
   memoizedFilterFunc,
-  batchSize = 5,
-  cutOffTimeMs = DEFAULT_NOTIF_CUTOFF
-}) => {
-  const { userInfo, isUserLoggedIn } = useGeneralWallet();
-  const { apiKey } = useFunkitConfig();
-  const { listRefresh } = useCheckoutRefreshInterval();
+  fetchSize = 5,
+  cutOffTimeMs = DEFAULT_NOTIF_CUTOFF,
+  userId,
+  refreshIntervalMs,
+  apiKey
+}) {
   const { data: directExecutions } = useQuery14({
-    queryKey: ["directExecutions", userInfo.id],
+    queryKey: ["useRecentDepositsImpl", userId, fetchSize],
     queryFn: async () => {
       const directExecutions2 = await getDirectExecutionsByUserId2({
-        userId: userInfo.id,
-        limit: batchSize,
+        userId,
+        limit: fetchSize,
         apiKey
       });
       return directExecutions2;
     },
-    refetchInterval: listRefresh,
-    enabled: isUserLoggedIn && isVisible
+    refetchInterval: refreshIntervalMs,
+    enabled: isVisible && !!userId
   });
   const data = useMemo24(() => {
     if (!directExecutions) {
@@ -20446,7 +20454,51 @@ var useRecentDeposits = ({
     ).sort((a, b) => b.createdTimeMs - a.createdTimeMs);
   }, [directExecutions, memoizedFilterFunc, cutOffTimeMs]);
   return { data };
+}
+function useDefaultParams() {
+  const { userInfo, isUserLoggedIn } = useGeneralWallet();
+  const { apiKey } = useFunkitConfig();
+  const { listRefresh } = useCheckoutRefreshInterval();
+  return {
+    apiKey,
+    userId: isUserLoggedIn ? userInfo.id : "",
+    refreshIntervalMs: listRefresh
+  };
+}
+var useRecentDeposits = ({
+  isVisible,
+  // WARNING! memoizedFilterFunc must be a stable reference (ie: wrap it in useMemo), otherwise hook will constantly re-render
+  memoizedFilterFunc,
+  fetchSize = 5,
+  cutOffTimeMs = DEFAULT_NOTIF_CUTOFF
+}) => {
+  const defaultParams = useDefaultParams();
+  return useRecentDepositsImpl({
+    isVisible,
+    memoizedFilterFunc,
+    fetchSize,
+    cutOffTimeMs,
+    ...defaultParams
+  });
 };
+function useFunkitRecentDeposits(query) {
+  const defaultParams = useDefaultParams();
+  return useFunkitRecentDepositsImpl({
+    ...query,
+    ...defaultParams
+  });
+}
+function useFunkitRecentDepositsImpl(query) {
+  const fetchSize = query.fetchSize ?? 5;
+  const { data } = useRecentDepositsImpl({
+    ...query,
+    fetchSize: fetchSize * 2
+    // fetch extra to account for merging
+  });
+  return {
+    data: data?.map((de) => purifyCheckoutHistoryItem(de)).slice(0, fetchSize)
+  };
+}
 
 // src/hooks/useOnNewNotification.ts
 import { safeParseJson as safeParseJson4 } from "@funkit/utils";
@@ -32309,6 +32361,7 @@ function AccountSelectAsset({
     checkoutItem,
     updateSourceAsset,
     updateTargetAsset,
+    updateTargetAssetAmount,
     applyDynamicRouting
   } = useCheckoutContext();
   const { walletAddress } = useGeneralWallet();
@@ -32411,6 +32464,17 @@ function AccountSelectAsset({
     if (!tokenItem) {
       return;
     }
+    const currentSourceAsset = checkoutItem?.selectedSourceAssetInfo;
+    const sourceAssetChanged = !isTokenEquivalent5({
+      firstTokenChainId: currentSourceAsset?.chainId || "",
+      firstTokenAddress: currentSourceAsset?.address || "",
+      secondTokenChainId: tokenItem.pickedChainId,
+      secondTokenAddress: tokenItem.tokenAddress
+    });
+    const shouldResetTargetAssetAmount = currentSourceAsset && sourceAssetChanged && !checkoutConfig?.isDefiMode && paymentMethodInfo.paymentMethod !== "card" /* CARD */;
+    if (shouldResetTargetAssetAmount) {
+      updateTargetAssetAmount(0);
+    }
     updateSourceAsset(tokenItem);
     if (isBrokerageAsset(tokenItem)) {
       setSelectedBrokerageAsset(tokenItem);
@@ -32454,7 +32518,6 @@ function AccountSelectAsset({
   const isAssetsEmpty = assetOptions.length === 0;
   const isDisabled = isAssetsEmpty || !selectedChainTokenSymbol || isLoading;
   const onBalanceTopUpSwitch = checkoutItem?.initSettings.onBalanceTopUpSwitch;
-  const showLighterEthMessage = isLighterEthSpot(apiKey, checkoutConfig) && assetOptions.every((asset) => asset.isDisabled);
   const checkoutId = checkoutItem?.id;
   useEffect50(() => {
     if (checkoutId && !isLoading) {
@@ -32484,26 +32547,6 @@ function AccountSelectAsset({
         }
       ) : void 0
     }
-  ) : showLighterEthMessage ? /* @__PURE__ */ React188.createElement(
-    FunNoResults,
-    {
-      title: t("checkout.insufficientEth"),
-      text: t("checkout.insufficientEthMessage"),
-      variant: "actionable",
-      actionButton: onBalanceTopUpSwitch ? /* @__PURE__ */ React188.createElement(
-        FunButton,
-        {
-          type: "tertiary",
-          onClick: () => {
-            if (onBalanceTopUpSwitch) {
-              onBalanceTopUpSwitch();
-            }
-            onClose?.();
-          },
-          title: t("checkout.topUpWallet")
-        }
-      ) : void 0
-    }
   ) : /* @__PURE__ */ React188.createElement(Box, { display: "flex", flexDirection: "column", gap: "4" }, assetOptions.map(({ asset, isDisabled: isDisabled2, badgeText, minUsdRequired }) => /* @__PURE__ */ React188.createElement(
     FunAssetItem,
     {
@@ -39508,11 +39551,12 @@ export {
   useFunkitCheckout,
   useFunkitDisconnect,
   useFunkitMaxCheckoutUsdInfo,
+  useFunkitRecentDeposits,
+  useFunkitRecentDepositsImpl,
   useFunkitReconnect,
   useFunkitSwitchChains,
   useFunkitTranslation,
   useFunkitUserInfo,
-  useRecentDeposits,
   useSoftHiddenCheckout,
   useUpdateActiveFunkitCheckout
 };

package/dist/utils/purifyCheckoutHistoryItem.d.ts

@@ -1,6 +1,7 @@
-import { type CheckoutHistoryItem, type CheckoutState, type DirectExecution } from '@funkit/api-base';
+import { type CheckoutHistoryItem, type CheckoutState } from '@funkit/api-base';
 import type { ApiFunkitCheckoutActionParams } from '@funkit/utils';
 import type { Address, Hex } from 'viem';
+import type { MergedMultiStepDirectExecution } from '~/hooks/queries/useRecentDeposits';
 export type PurifiedCheckoutHistoryItem = {
     depositAddr?: Address;
     directExecution: boolean;
@@ -15,14 +16,12 @@ export type PurifiedCheckoutHistoryItem = {
     createdTimeMs: number;
     updatedTimeMs: number;
     additionalActions: ApiFunkitCheckoutActionParams[];
-    txHash?: Hex;
 } & ({
     depositAddr: Address;
     directExecution: false;
-    txHash?: never;
 } | {
     depositAddr?: never;
     directExecution: true;
-    txHash: Hex;
+    txHashes: Hex[];
 });
-export declare const purifyCheckoutHistoryItem: (item: CheckoutHistoryItem | DirectExecution) => PurifiedCheckoutHistoryItem;
+export declare const purifyCheckoutHistoryItem: (item: CheckoutHistoryItem | MergedMultiStepDirectExecution) => PurifiedCheckoutHistoryItem;

package/dist/wallets/walletConnectors/index.js

@@ -11,30 +11,30 @@ import {
 import {
   talismanWallet
 } from "./chunk-JTLLKY2O.js";
-import {
-  tokenaryWallet
-} from "./chunk-M2HGGTFE.js";
 import {
   tokenPocketWallet
 } from "./chunk-47QF6EET.js";
+import {
+  tokenaryWallet
+} from "./chunk-M2HGGTFE.js";
 import {
   trustWallet
 } from "./chunk-JFHP4YJG.js";
 import {
   uniswapWallet
 } from "./chunk-LH7BMNFZ.js";
-import {
-  walletConnectWallet
-} from "./chunk-NP5QGWNL.js";
 import {
   xdefiWallet
 } from "./chunk-TMFH6GXS.js";
 import {
-  rainbowWallet
-} from "./chunk-77UTBHGP.js";
+  walletConnectWallet
+} from "./chunk-NP5QGWNL.js";
 import {
   rabbyWallet
 } from "./chunk-LW6S43RE.js";
+import {
+  rainbowWallet
+} from "./chunk-77UTBHGP.js";
 import {
   ramperWallet
 } from "./chunk-FCG5Q6JX.js";
@@ -59,12 +59,12 @@ import {
 import {
   mewWallet
 } from "./chunk-CF5HOLH2.js";
-import {
-  okxWallet
-} from "./chunk-U5QP7MI5.js";
 import {
   oktoWallet
 } from "./chunk-ADIXAKUL.js";
+import {
+  okxWallet
+} from "./chunk-U5QP7MI5.js";
 import {
   omniWallet
 } from "./chunk-7CUY5G6R.js";
@@ -80,24 +80,24 @@ import {
 import {
   foxWallet
 } from "./chunk-YLJDPTYF.js";
-import {
-  frameWallet
-} from "./chunk-AI55G5DD.js";
 import {
   frontierWallet
 } from "./chunk-T5KHVUFR.js";
+import {
+  frameWallet
+} from "./chunk-AI55G5DD.js";
 import {
   gateWallet
 } from "./chunk-MRRZOQGZ.js";
 import {
   imTokenWallet
 } from "./chunk-COZ7MIQS.js";
-import {
-  kresusWallet
-} from "./chunk-MJXPRJZT.js";
 import {
   injectedWallet
 } from "./chunk-MQSCN4BO.js";
+import {
+  kresusWallet
+} from "./chunk-MJXPRJZT.js";
 import {
   ledgerWallet
 } from "./chunk-BRBKM4PW.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funkit/connect",
-  "version": "7.1.0-next.12",
+  "version": "7.1.0-next.13",
   "description": "Funkit Connect SDK elevates DeFi apps via web2 sign-ins and one-click checkouts.",
   "files": [
     "dist",