@funkit/connect 9.26.1 → 9.27.1

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @funkit/connect
 
+## 9.27.1
+
+### Patch Changes
+
+- 2277277: Checksum the Polymarket deposit recipient (predictions/perps) so a lowercased integrator-supplied address can't cause a downstream recipient mismatch.
+- d59ac5d: Fix a layout jump on the checkout asset list for xStock (Nado) targets by resolving the wrapper-token address once at the `useWalletAssetHoldings` seam and awaiting it, so the list paints with the wrapper already recognized. Also bumps the wrapper-address query `staleTime` to 1h.
+- 7604174: fix(polymarket): lower Polymarket Perps minimum deposit from $10 to $5 (matches the updated `ExchangeV1.supportedAssets` on-chain minimum)
+- Updated dependencies [7880a7b]
+  - @funkit/fun-relay@2.9.0
+
+## 9.27.0
+
+### Minor Changes
+
+- 6e4aa57: Disable Swapped withdrawal cash methods with a "Low Balance" badge when the withdrawal balance is below the sell minimum.
+- 394a46c: Cap the Swapped withdrawal iframe input via a FOP `defaultMaxAmount` (EUR) derived from the user's source-token balance
+
+### Patch Changes
+
+- df21fd3: chore: update final rolly contract
+- 3e22665: patch(connect): fix ostium source change top spacing
+- cf7af7d: fix(connect): scope Nado direct-transfer fast-path to xStock targets
+- 78a888c: fix(connect): update Mallard deposit contract address
+- Updated dependencies [42aafd9]
+- Updated dependencies [394a46c]
+  - @funkit/fun-relay@2.8.7
+  - @funkit/api-base@5.1.0
+  - @funkit/connect-core@1.4.1
+
 ## 9.26.1
 
 ### Patch Changes

package/dist/clients/{chunk-F4SCUKY6.js → chunk-E36JOYL4.js}

@@ -11,7 +11,7 @@ import {
 } from "./chunk-O5CTDT3L.js";
 
 // src/clients/polymarket/createPolymarketDepositConfig.ts
-import { encodeFunctionData, erc20Abi, maxUint256 } from "viem";
+import { encodeFunctionData, erc20Abi, getAddress, maxUint256 } from "viem";
 import { polygon } from "viem/chains";
 var POLYMARKET_PREDICTIONS_ROUTING_ID = "POLYMARKET_PREDICTIONS";
 var POLYMARKET_PERPS_ROUTING_ID = "POLYMARKET_PERPS";
@@ -47,7 +47,7 @@ function createPredictionsGenerateActionParams(config) {
     ];
   };
 }
-var PERPS_MIN_DEPOSIT_USD = 10;
+var PERPS_MIN_DEPOSIT_USD = 5;
 function createPolymarketDepositConfig({
   predictions,
   perps,
@@ -57,6 +57,8 @@ function createPolymarketDepositConfig({
 }) {
   const isPerpsRoute = (routingId) => routingId === POLYMARKET_PERPS_ROUTING_ID;
   const defaultsToPerps = defaultAccount === "perps";
+  const predictionsRecipient = getAddress(predictions.address);
+  const perpsRecipient = getAddress(perps.address);
   return {
     targetChain: polygon.id.toString(),
     targetAsset: POLYGON_USDCE,
@@ -68,13 +70,15 @@ function createPolymarketDepositConfig({
     // The preselected destination (the "Deposit to" dropdown derives its
     // selection from `dynamicRoutingId`, so both fields must agree).
     dynamicRoutingId: defaultsToPerps ? POLYMARKET_PERPS_ROUTING_ID : POLYMARKET_PREDICTIONS_ROUTING_ID,
-    customRecipient: defaultsToPerps ? perps.address : predictions.address,
+    customRecipient: defaultsToPerps ? perpsRecipient : predictionsRecipient,
     modalTitle: ({ dynamicRoutingId }) => isPerpsRoute(dynamicRoutingId) ? modalTitles?.perps ?? "Deposit (Perps)" : modalTitles?.predictions ?? "Deposit (Predictions)",
     getMinDepositUSD: ({ dynamicRoutingId }) => isPerpsRoute(dynamicRoutingId) ? PERPS_MIN_DEPOSIT_USD : 0,
     generateActionsParams: (_targetAssetAmount, outputConfig) => isPerpsRoute(
       outputConfig?.dynamicRoutingId
-    ) ? createPerpsGenerateActionParams({ recipientAddress: perps.address })() : createPredictionsGenerateActionParams({
-      recipientAddress: predictions.address
+    ) ? createPerpsGenerateActionParams({
+      recipientAddress: perpsRecipient
+    })() : createPredictionsGenerateActionParams({
+      recipientAddress: predictionsRecipient
     })(),
     // Both transfer directions are integrator-owned; the step picks the source
     // account's transfer. The accounts already have exactly the handle shape

package/dist/clients/{chunk-4IWQ2UT5.js → chunk-UBBBMSKL.js}

@@ -18,7 +18,7 @@ import {
 import {
   POLYMARKET_PERPS_ROUTING_ID,
   POLYMARKET_PREDICTIONS_ROUTING_ID
-} from "./chunk-F4SCUKY6.js";
+} from "./chunk-E36JOYL4.js";
 import {
   POLYGON_USDCE,
   PUSD_TOKEN
@@ -29,6 +29,7 @@ import {
 
 // src/clients/polymarket/PolymarketDepositAccountDropdown.tsx
 import React12 from "react";
+import { getAddress } from "viem";
 import { polygon } from "viem/chains";
 
 // src/components/Dropdown/AccountSelectDropdown.tsx
@@ -1065,7 +1066,9 @@ function PolymarketDepositAccountDropdown({
     applyDynamicTargetAssetCandidate?.(
       accountCandidate(
         isPerps ? POLYMARKET_PERPS_ROUTING_ID : POLYMARKET_PREDICTIONS_ROUTING_ID,
-        isPerps ? perps.address : predictions.address
+        // Checksum so the recipient agrees with createPolymarketDepositConfig's
+        // initial customRecipient (integrator addresses aren't guaranteed EIP-55).
+        isPerps ? getAddress(perps.address) : getAddress(predictions.address)
       )
     );
   };

package/dist/clients/mallard.js

@@ -42,7 +42,7 @@ import {
 
 // src/clients/mallard.tsx
 var MALLARD_DEPOSIT_ADDRESS = getAddress(
-  "0xb272c91D84d6538C8F31ab092A53Bfe8916B5449"
+  "0xD42c46c7BaD6A54b38395F846b09981CE75fb8e2"
 );
 var VAULT_DEPOSITOR_ZORRO = getAddress(
   "0xec70919c52e56a197d2e13b78cb8511db54f3ca2"

package/dist/clients/polymarket/PolymarketDepositAccountDropdown.js

@@ -1,13 +1,13 @@
 "use client";
 import {
   PolymarketDepositAccountDropdown
-} from "../chunk-4IWQ2UT5.js";
+} from "../chunk-UBBBMSKL.js";
 import "../chunk-ZEXZQOAO.js";
 import "../chunk-VT3ERWXE.js";
 import "../chunk-LUHEVXPD.js";
 import "../chunk-UPZNKPYU.js";
 import "../chunk-STLOQEN7.js";
-import "../chunk-F4SCUKY6.js";
+import "../chunk-E36JOYL4.js";
 import "../chunk-O5CTDT3L.js";
 import "../chunk-AHYOV7AV.js";
 export {

package/dist/clients/polymarket/createPolymarketDepositConfig.js

@@ -4,7 +4,7 @@ import {
   POLYMARKET_PREDICTIONS_ROUTING_ID,
   createPolymarketDepositConfig,
   createPredictionsGenerateActionParams
-} from "../chunk-F4SCUKY6.js";
+} from "../chunk-E36JOYL4.js";
 import "../chunk-O5CTDT3L.js";
 import "../chunk-AHYOV7AV.js";
 export {

package/dist/clients/polymarket/index.js

@@ -1,7 +1,7 @@
 "use client";
 import {
   PolymarketDepositAccountDropdown
-} from "../chunk-4IWQ2UT5.js";
+} from "../chunk-UBBBMSKL.js";
 import "../chunk-ZEXZQOAO.js";
 import "../chunk-VT3ERWXE.js";
 import "../chunk-LUHEVXPD.js";
@@ -12,7 +12,7 @@ import {
   POLYMARKET_PREDICTIONS_ROUTING_ID,
   createPolymarketDepositConfig,
   createPredictionsGenerateActionParams
-} from "../chunk-F4SCUKY6.js";
+} from "../chunk-E36JOYL4.js";
 import {
   AMOUNT_PLACEHOLDER,
   COLLATERAL_ONRAMP_ABI,

package/dist/clients/rolly.js

@@ -9,7 +9,7 @@ import {
   maxUint256
 } from "viem";
 var ROLLY_VAULT_ADDRESS = getAddress(
-  "0x57d05CfC7bCAc9E7Ebf4D35a2b1725a83ADA771C"
+  "0xd40373CC943f32BAd15bF42d1580363f4D52739D"
 );
 var ARBITRUM_USDT0 = getAddress(
   "0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9"

package/dist/components/FunPayments/FunPaymentMethods.d.ts

@@ -86,9 +86,11 @@ export declare function PaymentMethodDisabledBadge(props: {
 /**
  * Payment method item for a Form of Payment from the fops API (Swapped providers)
  */
-export declare function FopPaymentMethodItem({ fop, isActive, onClick, testId, disclaimerLimit, disabled, }: BasePaymentMethodItemProps & {
+export declare function FopPaymentMethodItem({ fop, isActive, onClick, testId, disclaimerLimit, disabled, isBelowMinimum, }: BasePaymentMethodItemProps & {
     fop: SwappedFormOfPayment;
     disclaimerLimit: string;
     disabled?: boolean;
+    /** Withdrawal off-ramp only: balance can't meet the cash sell minimum. */
+    isBelowMinimum?: boolean;
 }): React.JSX.Element;
 export {};

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

@@ -1,4 +1,5 @@
 import { type GetFopsResponse } from '@funkit/api-base';
+export declare const SWAPPED_MIN_SELL_EUR = 7;
 /**
  * Hook to fetch available withdrawal (off-ramp) forms of payment from /fops.
  * Sends a CRYPTO_TO_FIAT rail config to get sell/payout methods.
@@ -6,6 +7,13 @@ import { type GetFopsResponse } from '@funkit/api-base';
 export declare const useWithdrawFops: (params: {
     sourceChainId: string;
     sourceTokenAddress: string;
+    /** Best-effort max sell amount in EUR; capped to the user's source balance. */
+    defaultMaxAmount?: number;
+    /**
+     * Gate the fetch. Default true. Pass false to hold the request until the cap
+     * is resolved, so the first /fops call never goes out uncapped.
+     */
+    enabled?: boolean;
 }) => {
     data: GetFopsResponse | undefined;
     isLoading: boolean;

package/dist/hooks/useInjectedAssetHoldings.d.ts

@@ -1,22 +1,19 @@
+import type { Address } from 'viem';
+import type { AssetHoldingsMap } from '../domains/wallet';
 /**
- * Note: this hook right now is only used for xStock targets for Nado.
- * Backend will add support here, at which point this can be retired.
+ * Merges payable sources the wallet-assets API doesn't index — an xStock the
+ * user holds + its wrapper — into the holdings map.
  *
- * Merges payable sources the wallet-assets API doesn't index — ones the user
- * already holds and can deposit directly (an xStock + its wrapper) — into the
- * holdings map.
+ * Note: xStock/Nado-only today; possibly deprecate once backend supports these natively.
  *
- * - Gated by the `enable-rpc-xstock-assets` feature gate (off by default): when
- *   off, no RPC reads fire and nothing is injected.
- * - Single seam composed into `useWalletAssetHoldings`, so every consumer sees
- *   the same map and keys can't drift across call sites.
- * - Injects only what the API doesn't already list, so we never clobber the API's
- *   price/USD with our on-chain read. Customer/asset gating lives upstream.
+ * - Gated by `enable-rpc-xstock-assets` (off by default) → no RPC reads, nothing injected.
+ * - Single seam in `useWalletAssetHoldings` so keys can't drift across consumers.
+ * - Injects only what the API omits (never clobbers its price/USD); gating lives upstream.
  */
-import type { AssetHoldingsMap } from '../domains/wallet';
-export declare function useInjectedAssetHoldings({ targetChainId, existingHoldings, }: {
+export declare function useInjectedAssetHoldings({ targetChainId, existingHoldings, xstockWrappedTokenAddress, }: {
     targetChainId: string;
     existingHoldings: AssetHoldingsMap | undefined;
+    xstockWrappedTokenAddress?: Address;
 }): {
     holdings: AssetHoldingsMap;
     isLoading: boolean;

package/dist/hooks/useXstockAssetHoldings.d.ts

@@ -5,9 +5,11 @@
  * - Fetch only. Scoped to xStock targets (`assetClass === 'xstock'`) so we don't
  *   fire RPC reads when there's nothing to read.
  */
+import type { Address } from 'viem';
 import type { AssetHoldingsItem } from '../domains/wallet';
-export declare function useXstockAssetHoldings({ targetChainId, enabled, }: {
+export declare function useXstockAssetHoldings({ targetChainId, wrappedTokenAddress, enabled, }: {
     targetChainId: string;
+    wrappedTokenAddress?: Address;
     enabled?: boolean;
 }): {
     data: AssetHoldingsItem[];

package/dist/index.js

@@ -1,10 +1,10 @@
 "use client";
-import {
-  lightTheme
-} from "./chunk-67BKQQNG.js";
 import {
   darkTheme
 } from "./chunk-36KVHK22.js";
+import {
+  lightTheme
+} from "./chunk-67BKQQNG.js";
 import {
   systemFontStack
 } from "./chunk-4YEAUICE.js";
@@ -1683,7 +1683,7 @@ function setFunkitConnectVersion({ version }) {
   localStorage.setItem(storageKey, version);
 }
 function getCurrentSdkVersion() {
-  return "9.26.1";
+  return "9.27.1";
 }
 function useFingerprint() {
   const fingerprint = useCallback3(() => {
@@ -3968,51 +3968,10 @@ function useGetAssetHoldingsFromRpc({
   });
 }
 
-// src/hooks/useXstocksWrappedTokenAddress.ts
-import { getXstocksAsset, xstocksNetworkFromChainId } from "@funkit/api-base";
-import { useQuery as useQuery7 } from "@tanstack/react-query";
-function useXstocksWrappedTokenAddress({ enabled = true } = {}) {
-  const { checkoutItem } = useCheckoutContext();
-  const { apiKey } = useFunkitConfig();
-  const config = checkoutItem?.initSettings.config;
-  const targetChain = config?.targetChain;
-  const ticker = config?.targetAssetTicker;
-  const isXstockTarget = isXStockTargetAsset(
-    getActiveDynamicTargetAsset(config)
-  );
-  const network = targetChain ? xstocksNetworkFromChainId(targetChain) : void 0;
-  const isEnabled = enabled && isXstockTarget && !!targetChain && !!ticker && !!network;
-  const { data, isLoading } = useQuery7({
-    queryKey: ["nadoTargetWrappedTokenAddress", targetChain, ticker],
-    enabled: isEnabled,
-    // Wrapped token address is effectively immutable; cache aggressively.
-    staleTime: 5 * 60 * 1e3,
-    retry: false,
-    queryFn: async () => {
-      if (!ticker || !network) {
-        return null;
-      }
-      const symbol = parseXstocksSymbolFromTicker(ticker);
-      const asset = await getXstocksAsset({ symbol, network, logger, apiKey });
-      const deployment = asset.deployments?.find(
-        (d) => d.network?.toLowerCase() === network.toLowerCase()
-      );
-      const wrappedTokenAddress = deployment?.wrapperAddressV2;
-      logger.info("nadoTargetWrappedToken:resolved", {
-        ticker,
-        targetChain,
-        network,
-        hasWrappedToken: !!wrappedTokenAddress
-      });
-      return wrappedTokenAddress ? wrappedTokenAddress : null;
-    }
-  });
-  return { data: data ?? void 0, isLoading };
-}
-
 // src/hooks/useXstockAssetHoldings.ts
 function useXstockAssetHoldings({
   targetChainId,
+  wrappedTokenAddress,
   enabled = true
 }) {
   const { checkoutItem } = useCheckoutContext();
@@ -4023,7 +3982,6 @@ function useXstockAssetHoldings({
   const ticker = parseXstocksSymbolFromTicker(config?.targetAssetTicker ?? "");
   const dynamicTargetAsset = getActiveDynamicTargetAsset(config);
   const isEnabled = enabled && !!walletAddress && !!targetAsset && !!targetChain && targetChain === targetChainId && !!isXStockTargetAsset(dynamicTargetAsset);
-  const { data: wrappedTokenAddress, isLoading: isWrappedTokenAddressLoading } = useXstocksWrappedTokenAddress({ enabled: isEnabled });
   const targetTokenQuery = useGetAssetHoldingsFromRpc({
     chainId: targetChain,
     tokenAddress: targetAsset,
@@ -4049,7 +4007,7 @@ function useXstockAssetHoldings({
   );
   return {
     data,
-    isLoading: targetTokenQuery.isLoading || wrappedTokenQuery.isLoading || isWrappedTokenAddressLoading
+    isLoading: targetTokenQuery.isLoading || wrappedTokenQuery.isLoading
   };
 }
 
@@ -4057,11 +4015,13 @@ function useXstockAssetHoldings({
 var EMPTY_HOLDINGS = {};
 function useInjectedAssetHoldings({
   targetChainId,
-  existingHoldings
+  existingHoldings,
+  xstockWrappedTokenAddress
 }) {
   const isEnabled = useFeatureGate("enable-rpc-xstock-assets");
   const { data: injectableHoldings, isLoading } = useXstockAssetHoldings({
     targetChainId,
+    wrappedTokenAddress: xstockWrappedTokenAddress,
     enabled: isEnabled
   });
   const holdings = useMemo13(() => {
@@ -4084,7 +4044,49 @@ function useInjectedAssetHoldings({
     }
     return injected2;
   }, [isEnabled, injectableHoldings, existingHoldings]);
-  return { holdings, isLoading: isEnabled && isLoading };
+  return { holdings, isLoading };
+}
+
+// src/hooks/useXstocksWrappedTokenAddress.ts
+import { getXstocksAsset, xstocksNetworkFromChainId } from "@funkit/api-base";
+import { useQuery as useQuery7 } from "@tanstack/react-query";
+function useXstocksWrappedTokenAddress({ enabled = true } = {}) {
+  const { checkoutItem } = useCheckoutContext();
+  const { apiKey } = useFunkitConfig();
+  const config = checkoutItem?.initSettings.config;
+  const targetChain = config?.targetChain;
+  const ticker = config?.targetAssetTicker;
+  const isXstockTarget = isXStockTargetAsset(
+    getActiveDynamicTargetAsset(config)
+  );
+  const network = targetChain ? xstocksNetworkFromChainId(targetChain) : void 0;
+  const isEnabled = enabled && isXstockTarget && !!targetChain && !!ticker && !!network;
+  const { data, isLoading } = useQuery7({
+    queryKey: ["nadoTargetWrappedTokenAddress", targetChain, ticker],
+    enabled: isEnabled,
+    // Wrapped token address is effectively immutable
+    staleTime: 60 * 60 * 1e3,
+    retry: false,
+    queryFn: async () => {
+      if (!ticker || !network) {
+        return null;
+      }
+      const symbol = parseXstocksSymbolFromTicker(ticker);
+      const asset = await getXstocksAsset({ symbol, network, logger, apiKey });
+      const deployment = asset.deployments?.find(
+        (d) => d.network?.toLowerCase() === network.toLowerCase()
+      );
+      const wrappedTokenAddress = deployment?.wrapperAddressV2;
+      logger.info("nadoTargetWrappedToken:resolved", {
+        ticker,
+        targetChain,
+        network,
+        hasWrappedToken: !!wrappedTokenAddress
+      });
+      return wrappedTokenAddress ? wrappedTokenAddress : null;
+    }
+  });
+  return { data: data ?? void 0, isLoading };
 }
 
 // src/hooks/useWalletAssetHoldings.ts
@@ -4160,9 +4162,14 @@ function useWalletAssetHoldings(targetChain) {
     () => processWalletAssets(walletAssets, targetChain, isStablecoin),
     [targetChain, walletAssets, isStablecoin]
   );
-  const { holdings: injectedHoldings, isLoading: isLoadingInjected } = useInjectedAssetHoldings({
+  const {
+    data: xstockWrappedTokenAddress,
+    isLoading: isLoadingXstockWrappedTokenAddress
+  } = useXstocksWrappedTokenAddress();
+  const { holdings: injectedHoldings, isLoading: isLoadingInjectedAssets } = useInjectedAssetHoldings({
     targetChainId: targetChain,
-    existingHoldings: processedAssets
+    existingHoldings: processedAssets,
+    xstockWrappedTokenAddress
   });
   const holdings = useMemo14(() => {
     const hasInjected = Object.keys(injectedHoldings).length > 0;
@@ -4213,7 +4220,7 @@ function useWalletAssetHoldings(targetChain) {
   ]);
   return {
     data: holdings,
-    isLoading: isLoading || isAllowedAssetsLoading || isLoadingInjected,
+    isLoading: isLoading || isAllowedAssetsLoading || isLoadingInjectedAssets || isLoadingXstockWrappedTokenAddress,
     totalBalance: totalWalletAssetsUsd,
     hasUsableBalance,
     minValueThreshold
@@ -5177,6 +5184,18 @@ import {
 
 // src/utils/withdrawal.ts
 import { parseUnits } from "viem";
+function safeEvaluateWithdrawalSourceTokenBalance(fn) {
+  const raw = fn?.();
+  if (raw == null) {
+    return "0";
+  }
+  const str = String(raw);
+  if (str === "" || Number.isNaN(Number(str)) || Number(str) < 0) {
+    logger.warn("withdrawal:invalidSourceTokenBalance", { raw });
+    return "0";
+  }
+  return str;
+}
 function isWalletWithdrawalConfig(config) {
   return "wallet" in config;
 }
@@ -22087,18 +22106,40 @@ function PaymentMethodDisabledBadge(props) {
       return null;
   }
 }
+function getFopDisabledBadgeReason({
+  isDisabled,
+  isGeoblocked,
+  isBelowMinimum
+}) {
+  if (!isDisabled) {
+    return null;
+  }
+  if (isGeoblocked) {
+    return "geoblocked";
+  }
+  if (isBelowMinimum) {
+    return "lowBalance";
+  }
+  return "comingSoon";
+}
 function FopPaymentMethodItem({
   fop,
   isActive,
   onClick,
   testId,
   disclaimerLimit,
-  disabled
+  disabled,
+  isBelowMinimum
 }) {
   const { isUserGeoblocked } = useFunkitUserIp();
   const { geoblocked: isQrCodeGeoblocked } = useIsQRCodeTransferEnabled();
   const isGeoblocked = isQrCodeGeoblocked || isUserGeoblocked;
-  const isDisabled = disabled || isGeoblocked || !fop.embeddedFlowUrl;
+  const isDisabled = disabled || isGeoblocked || isBelowMinimum || !fop.embeddedFlowUrl;
+  const disabledBadgeReason = getFopDisabledBadgeReason({
+    isDisabled,
+    isGeoblocked,
+    isBelowMinimum
+  });
   const { activeTheme, darkTheme: darkTheme2 } = useActiveTheme();
   const { t } = useFunkitTranslation();
   const isDarkMode = activeTheme === darkTheme2;
@@ -22127,12 +22168,7 @@ function FopPaymentMethodItem({
         time: isBankTransfer ? FIAT_PROCESSING_TIME : t("payment.instant")
       }),
       testId: testId || `fop-${labelText.toLowerCase().replace(/\s+/g, "-")}`,
-      valueIcon: isDisabled ? /* @__PURE__ */ React92.createElement(
-        PaymentMethodDisabledBadge,
-        {
-          reason: isGeoblocked ? "geoblocked" : "comingSoon"
-        }
-      ) : void 0
+      valueIcon: disabledBadgeReason ? /* @__PURE__ */ React92.createElement(PaymentMethodDisabledBadge, { reason: disabledBadgeReason }) : void 0
     }
   );
 }
@@ -26661,18 +26697,6 @@ var FALLBACK_FEES = {
   totalFeesUsd: 0,
   totalFeesTokenWithoutGas: 0
 };
-function safeEvaluateWithdrawalSourceTokenBalance(fn) {
-  const raw = fn?.();
-  if (raw == null) {
-    return "0";
-  }
-  const str = String(raw);
-  if (str === "" || Number.isNaN(Number(str)) || Number(str) < 0) {
-    logger.warn("withdrawal:invalidSourceTokenBalance", { raw });
-    return "0";
-  }
-  return str;
-}
 function useWithdrawalAssets(config) {
   const enableEmptyWithdrawalSelection = useFeatureGate(
     "enable-empty-withdrawal-selection"
@@ -27401,6 +27425,7 @@ function findSwappedSourceOverride(overrides, source) {
 }
 
 // src/hooks/queries/useWithdrawFops.ts
+var SWAPPED_MIN_SELL_EUR = 7;
 var useWithdrawFops = (params) => {
   const { apiKey } = useFunkitConfig();
   const { userInfo } = useGeneralWallet();
@@ -27430,7 +27455,7 @@ var useWithdrawFops = (params) => {
   );
   const userId = userInfo.id;
   const countryCode = userIpInfo?.alpha2;
-  const isEnabled = !!apiKey && !!userId && !!userInfo.address && !!countryCode && !!params.sourceChainId && !!params.sourceTokenAddress && !isSwappedCurrencyCodeLoading;
+  const isEnabled = (params.enabled ?? true) && !!apiKey && !!userId && !!userInfo.address && !!countryCode && !!params.sourceChainId && !!params.sourceTokenAddress && !isSwappedCurrencyCodeLoading;
   const query = useQuery21({
     // `prefillFiatEmail` is intentionally NOT in the queryKey: it's read inside
     // `queryFn` and captured at fetch time, so post-mount changes don't trigger a refetch
@@ -27445,7 +27470,8 @@ var useWithdrawFops = (params) => {
       params.sourceChainId,
       params.sourceTokenAddress,
       acceptedToken.chainId,
-      acceptedToken.address
+      acceptedToken.address,
+      params.defaultMaxAmount
     ],
     queryFn: async () => {
       if (!isEnabled) {
@@ -27464,6 +27490,14 @@ var useWithdrawFops = (params) => {
         themeConfig,
         "useWithdrawFops"
       );
+      logger.info("withdrawFops:sellLimits", {
+        sourceChainId: params.sourceChainId,
+        sourceTokenAddress: params.sourceTokenAddress,
+        swappedCurrencyCode,
+        defaultMinAmountEur: SWAPPED_MIN_SELL_EUR,
+        defaultMaxAmountEur: params.defaultMaxAmount,
+        capApplied: params.defaultMaxAmount != null && params.defaultMaxAmount > SWAPPED_MIN_SELL_EUR
+      });
       const response = await getFops3({
         apiKey,
         logger,
@@ -27484,8 +27518,14 @@ var useWithdrawFops = (params) => {
               fiatCurrencyCode: swappedCurrencyCode,
               sourceToken: acceptedToken,
               thirdPartyPaymentConfigs,
-              checkoutLimitsCriteria: { defaultMinAmount: 7 }
-              // EUR — Swapped's hard minimum sell amount
+              checkoutLimitsCriteria: {
+                defaultMinAmount: SWAPPED_MIN_SELL_EUR,
+                // Only cap when the balance clears the minimum — a max at/below
+                // the min is a contradictory range for Swapped's iframe.
+                ...params.defaultMaxAmount != null && params.defaultMaxAmount > SWAPPED_MIN_SELL_EUR && {
+                  defaultMaxAmount: params.defaultMaxAmount
+                }
+              }
             }
           ]
         }
@@ -27710,7 +27750,8 @@ function FormOfPaymentsContent({
   exchangeRatesData,
   defaultMaxItems,
   enableSourceGroupLabels,
-  isDisabled
+  isDisabled,
+  isBelowMinimumBalance
 }) {
   const { t } = useFunkitTranslation();
   const [isExpanded, setIsExpanded] = useState42(false);
@@ -27760,7 +27801,8 @@ function FormOfPaymentsContent({
       disclaimerLimit: getFopsLimit(fop, exchangeRatesData),
       isActive: selectedFop?.embeddedFlowUrl === fop.embeddedFlowUrl,
       onClick: () => onFopSelect(fop),
-      disabled: isDisabled
+      disabled: isDisabled,
+      isBelowMinimum: isBelowMinimumBalance
     }
   );
   if (!enableSourceGroupLabels) {
@@ -27792,7 +27834,8 @@ function FormOfPaymentsList({
   onFopSelect,
   exchangeRatesData,
   enableSourceGroupLabels,
-  isDisabled
+  isDisabled,
+  isBelowMinimumBalance
 }) {
   const { uiCustomizations } = useFunkitConfig();
   const boxClassName = uiCustomizations.enableCompactList ? sourceListCompactBoxStyles : sourceListBoxStyles;
@@ -27823,7 +27866,8 @@ function FormOfPaymentsList({
         exchangeRatesData,
         defaultMaxItems,
         enableSourceGroupLabels,
-        isDisabled
+        isDisabled,
+        isBelowMinimumBalance
       }
     );
   }
@@ -27874,11 +27918,22 @@ function WithdrawalMethodSelect({
   onCryptoSelect,
   onCashFopSelect,
   sourceChainId,
-  sourceTokenAddress
+  sourceTokenAddress,
+  usdBalance = 0
 }) {
   const { t } = useFunkitTranslation();
-  const withdrawFops = useWithdrawFops({ sourceChainId, sourceTokenAddress });
   const exchangeRates = useFiatExchangeRates();
+  const eurRate = getExchangeRate("EUR", exchangeRates.data, 0);
+  const eurMax = eurRate && usdBalance > 0 ? Math.floor(usdBalance * eurRate) : void 0;
+  const cashMinUsd = eurRate ? SWAPPED_MIN_SELL_EUR / eurRate : void 0;
+  const isBelowMinimumBalance = cashMinUsd != null && usdBalance < cashMinUsd;
+  const isAwaitingCap = usdBalance > 0 && exchangeRates.isLoading;
+  const withdrawFops = useWithdrawFops({
+    sourceChainId,
+    sourceTokenAddress,
+    defaultMaxAmount: eurMax,
+    enabled: !isAwaitingCap
+  });
   useSwappedPreload(withdrawFops.data);
   return /* @__PURE__ */ React139.createElement(Box, { display: "flex", flexDirection: "column", gap: "8" }, /* @__PURE__ */ React139.createElement(
     Text,
@@ -27915,7 +27970,8 @@ function WithdrawalMethodSelect({
       isLoading: withdrawFops.isLoading || exchangeRates.isLoading,
       onFopSelect: onCashFopSelect,
       exchangeRatesData: exchangeRates.data,
-      enableSourceGroupLabels: false
+      enableSourceGroupLabels: false,
+      isBelowMinimumBalance
     }
   ));
 }
@@ -28893,6 +28949,11 @@ function WithdrawalModal({
           {
             sourceChainId: activeConfig.sourceChainId,
             sourceTokenAddress: activeConfig.sourceTokenAddress,
+            usdBalance: Number(
+              safeEvaluateWithdrawalSourceTokenBalance(
+                withdrawalItem?.withdrawalSourceTokenBalance
+              )
+            ),
             onCryptoSelect: () => {
               logEvent({
                 eventName: "fw::crypto_address_selected" /* CRYPTO_ADDRESS_SELECTED */,
@@ -33486,12 +33547,10 @@ function isNadoDirectTransferContext({
   apiKey,
   sourceAsset,
   checkoutConfig,
+  isXstockTarget,
   wrappedTokenAddress
 }) {
-  if (!isNadoCustomer(apiKey)) {
-    return false;
-  }
-  if (!checkoutConfig.customRecipient) {
+  if (!isNadoCustomer(apiKey) || !checkoutConfig.customRecipient || !isXstockTarget) {
     return false;
   }
   const matchesTarget = isTokenEquivalent9({
@@ -33518,14 +33577,18 @@ function useIsNadoDirectTransferSource() {
   const { checkoutItem } = useCheckoutContext();
   const { data: wrappedTokenAddress } = useXstocksWrappedTokenAddress();
   const config = checkoutItem?.initSettings.config;
+  const isXstockTarget = isXStockTargetAsset(
+    getActiveDynamicTargetAsset(config)
+  );
   return useCallback37(
     (source) => config != null && isNadoDirectTransferContext({
       apiKey,
       sourceAsset: source,
       checkoutConfig: config,
+      isXstockTarget,
       wrappedTokenAddress
     }),
-    [apiKey, config, wrappedTokenAddress]
+    [apiKey, config, isXstockTarget, wrappedTokenAddress]
   );
 }
 function useNadoDirectTransfer() {
@@ -40107,10 +40170,11 @@ function useSourceChangeLayout() {
     customTopComponent,
     showCustomTopComponentDivider
   } = uiCustomizations.sourceChangeScreen;
+  const { alwaysShowTopDivider } = uiCustomizations;
   const dynamicTargetAssets = checkoutItem?.initSettings.config?.dynamicTargetAssetCandidates;
   const isTargetAssetSelectable = !!(showTargetAssetSelection && dynamicTargetAssets && dynamicTargetAssets.length > 1);
   const showContentDivider = !!customTopComponent && !!showCustomTopComponentDivider || isTargetAssetSelectable && isSwappedEnabled;
-  const cryptoCashToggleMarginTop = customTopComponent && !showContentDivider ? "24" : "0";
+  const cryptoCashToggleMarginTop = customTopComponent && !showContentDivider ? "24" : !customTopComponent && !isTargetAssetSelectable && alwaysShowTopDivider ? "16" : "0";
   return {
     isTargetAssetSelectable,
     showContentDivider,

package/dist/modals/CheckoutModal/InputAmount/useNadoDirectTransfer.d.ts

@@ -21,11 +21,9 @@ interface UseNadoDirectTransferResult {
     isPending: boolean;
     error: CheckoutConfirmationError | null;
     /**
-     * Whether this checkout takes the direct-transfer fast-path. True when all
-     * hold: the customer is Nado, `customRecipient` is set, and the selected
-     * source token (`checkoutItem.selectedSourceAssetInfo`) is the target token
-     * or its wrapper on the same chain. False until a source is selected and,
-     * for a wrapper source, until the wrapper address resolves.
+     * Whether this checkout takes the direct-transfer fast-path — see
+     * `isNadoDirectTransferContext`. False until a source is selected and, for a
+     * wrapper source, until the wrapper address resolves.
      */
     isApplicable: boolean;
 }
@@ -37,22 +35,26 @@ interface NadoDirectTransferContextArgs {
     };
     checkoutConfig: Pick<FunkitCheckoutConfig, 'targetChain' | 'targetAsset' | 'customRecipient'>;
     /**
-     * The target token's wrapped version (xStocks `wrapperAddressV2`) on the target
-     * chain. A held wrapped-token balance (e.g. wSPYx for SPYx) is an equivalent
-     * direct-transfer source. Resolved by `useXstocksWrappedTokenAddress`; omit
-     * when there's none.
+     * Whether the target is an xStock asset (`assetClass === 'xstock'`). Gates the
+     * fast-path to xStocks so a same-token route like USDT → USDT keeps using Relay.
+     */
+    isXstockTarget: boolean;
+    /**
+     * Target token's wrapped version (xStocks `wrapperAddressV2`) on the target
+     * chain — a held balance (e.g. wSPYx for SPYx) is an equivalent source. From
+     * `useXstocksWrappedTokenAddress`; omit when there's none.
      */
     wrappedTokenAddress?: string;
 }
 /**
- * True when: the customer is Nado, the checkout has an explicit recipient (the
- * subaccount DDA), and the source matches the target token or its wrapper (same
- * chain). When true the deposit is a direct ERC-20 transfer, not a Relay swap.
+ * True when the customer is Nado, the target is an xStock, the checkout has an
+ * explicit recipient (the subaccount DDA), and the source matches the target
+ * token or its wrapper (same chain) — a direct ERC-20 transfer, not a Relay swap.
  *
- * Kept customer-gated (not purely config-driven) to bound blast radius — only
- * Nado should route through the direct-transfer path until it's proven out.
+ * - Customer-gated (not config-driven) to bound blast radius to Nado.
+ * - xStocks-gated so a same-token route (USDT → USDT) keeps using Relay.
  */
-export declare function isNadoDirectTransferContext({ apiKey, sourceAsset, checkoutConfig, wrappedTokenAddress, }: NadoDirectTransferContextArgs): boolean;
+export declare function isNadoDirectTransferContext({ apiKey, sourceAsset, checkoutConfig, isXstockTarget, wrappedTokenAddress, }: NadoDirectTransferContextArgs): boolean;
 /**
  * Predicate over a source asset: does it qualify for the Nado direct-transfer fast-path?
  */

package/dist/modals/CheckoutModal/SourceChange/FormOfPaymentsList.d.ts

@@ -8,6 +8,13 @@ interface FormOfPaymentsListProps {
     exchangeRatesData?: ExchangeRates;
     enableSourceGroupLabels: boolean;
     isDisabled?: boolean;
+    /**
+     * Withdrawal off-ramp only: balance is below the cash sell minimum, so every
+     * cash method is disabled with a "Low Balance" badge. A single flag is enough
+     * while all providers share one minimum — switch to a `(fop) => boolean`
+     * predicate if per-provider minimums ever diverge.
+     */
+    isBelowMinimumBalance?: boolean;
 }
 interface FormOfPaymentSection {
     items: SwappedFormOfPayment[];
@@ -17,5 +24,5 @@ export declare function getFormOfPaymentSections(fopsData: GetFopsResponse, fopP
     primary: FormOfPaymentSection;
     secondary: FormOfPaymentSection;
 };
-export declare function FormOfPaymentsList({ fopsData, isLoading, selectedFop, onFopSelect, exchangeRatesData, enableSourceGroupLabels, isDisabled, }: FormOfPaymentsListProps): React.JSX.Element;
+export declare function FormOfPaymentsList({ fopsData, isLoading, selectedFop, onFopSelect, exchangeRatesData, enableSourceGroupLabels, isDisabled, isBelowMinimumBalance, }: FormOfPaymentsListProps): React.JSX.Element;
 export {};

package/dist/modals/PolymarketPerpsTransfer/PolymarketPerpsTransferScreen.d.ts

@@ -14,7 +14,7 @@ export interface PolymarketPerpsTransferScreenProps {
      * below-minimum notice when the destination is Predictions. */
     predictionsMinTransferUsd?: number;
     /** Minimum pUSD to transfer *into* perps (USD). Drives the below-minimum
-     * notice when the destination is Perps (e.g. perps' 10 pUSD minimum). */
+     * notice when the destination is Perps (e.g. perps' 5 pUSD minimum). */
     perpsMinTransferUsd?: number;
     /** Initial transfer direction. Defaults to Predictions → Perps. */
     initialDirection?: PerpsTransferDirection;

package/dist/modals/WithdrawalModal/WithdrawalMethodSelect.d.ts

@@ -5,6 +5,12 @@ interface WithdrawalMethodSelectProps {
     onCashFopSelect: (fop: SwappedFormOfPayment) => void;
     sourceChainId: string;
     sourceTokenAddress: string;
+    /**
+     * Source-token balance in USD. MVP source is USDG (≈ $1) so the token balance
+     * ≈ USD; non-stable sources (e.g. ETH) would need `balance × USD price`.
+     * Omit/0 when unknown — no cap is sent and the iframe stays uncapped.
+     */
+    usdBalance?: number;
 }
-export declare function WithdrawalMethodSelect({ onCryptoSelect, onCashFopSelect, sourceChainId, sourceTokenAddress, }: WithdrawalMethodSelectProps): React.JSX.Element;
+export declare function WithdrawalMethodSelect({ onCryptoSelect, onCashFopSelect, sourceChainId, sourceTokenAddress, usdBalance, }: WithdrawalMethodSelectProps): React.JSX.Element;
 export {};

package/dist/utils/withdrawal.d.ts

@@ -1,4 +1,10 @@
 import type { CustomWithdrawalConfig, FunkitWithdrawalConfig, MultiMethodWithdrawalConfig, WalletWithdrawalConfig } from '../providers/FunkitCheckoutContext';
+/**
+ * Evaluates the integrator's `withdrawalSourceTokenBalance` callback to a safe
+ * numeric string. Returns `'0'` (with a warn) for missing/empty/NaN/negative
+ * values. Shared by the withdrawal amount screen and the Swapped cash cap.
+ */
+export declare function safeEvaluateWithdrawalSourceTokenBalance(fn: (() => string | number) | undefined): string;
 /**
  * Type guard to check if withdrawal config uses wallet-based flow
  */

package/dist/wallets/walletConnectors/index.js

@@ -1,25 +1,19 @@
 "use client";
 import {
-  zealWallet
-} from "./chunk-52QXXLDS.js";
-import {
-  zerionWallet
-} from "./chunk-SWFF3TWJ.js";
-import {
-  tahoWallet
-} from "./chunk-7ZYCBDQ4.js";
+  imTokenWallet
+} from "./chunk-WNAGGFMG.js";
 import {
-  talismanWallet
-} from "./chunk-4DCO3TGL.js";
+  injectedWallet
+} from "./chunk-T6LGKC3F.js";
 import {
   tokenPocketWallet
 } from "./chunk-WKNQMP4A.js";
-import {
-  tokenaryWallet
-} from "./chunk-VH3THHJY.js";
 import {
   trustWallet
 } from "./chunk-KCRO2AGO.js";
+import {
+  tokenaryWallet
+} from "./chunk-VH3THHJY.js";
 import {
   uniswapWallet
 } from "./chunk-Z3PPW6NC.js";
@@ -30,17 +24,11 @@ import {
   xdefiWallet
 } from "./chunk-JN5I3DNC.js";
 import {
-  rabbyWallet
-} from "./chunk-RB66PKPA.js";
-import {
-  rainbowWallet
-} from "./chunk-W2LCLDPX.js";
-import {
-  ramperWallet
-} from "./chunk-OQB55QXP.js";
+  zealWallet
+} from "./chunk-52QXXLDS.js";
 import {
-  roninWallet
-} from "./chunk-YQFGVZGR.js";
+  zerionWallet
+} from "./chunk-SWFF3TWJ.js";
 import {
   safeWallet
 } from "./chunk-RCY66YHF.js";
@@ -50,36 +38,45 @@ import {
 import {
   safepalWallet
 } from "./chunk-XCNHV3HS.js";
+import {
+  rainbowWallet
+} from "./chunk-W2LCLDPX.js";
+import {
+  ramperWallet
+} from "./chunk-OQB55QXP.js";
 import {
   subWallet
 } from "./chunk-NR2OGDHQ.js";
 import {
-  metaMaskWallet
-} from "./chunk-YO2K4MBH.js";
-import {
-  mewWallet
-} from "./chunk-MQM45ADF.js";
+  tahoWallet
+} from "./chunk-7ZYCBDQ4.js";
 import {
-  okxWallet
-} from "./chunk-KI5Y2BBF.js";
+  talismanWallet
+} from "./chunk-4DCO3TGL.js";
 import {
   oktoWallet
 } from "./chunk-YWOVAU6O.js";
+import {
+  okxWallet
+} from "./chunk-KI5Y2BBF.js";
 import {
   omniWallet
 } from "./chunk-2CX7LX4J.js";
-import {
-  oneKeyWallet
-} from "./chunk-WVT6BBJH.js";
 import {
   oneInchWallet
 } from "./chunk-QG6ZHI7B.js";
+import {
+  oneKeyWallet
+} from "./chunk-WVT6BBJH.js";
 import {
   phantomWallet
 } from "./chunk-QY53O7WG.js";
 import {
-  foxWallet
-} from "./chunk-GUQM4QSL.js";
+  rabbyWallet
+} from "./chunk-RB66PKPA.js";
+import {
+  roninWallet
+} from "./chunk-YQFGVZGR.js";
 import {
   frameWallet
 } from "./chunk-BU3ZAT5X.js";
@@ -90,41 +87,44 @@ import {
   gateWallet
 } from "./chunk-JPN6TWIT.js";
 import {
-  imTokenWallet
-} from "./chunk-WNAGGFMG.js";
-import {
-  injectedWallet
-} from "./chunk-T6LGKC3F.js";
+  enkryptWallet
+} from "./chunk-HBQK5RD5.js";
 import {
   kresusWallet
 } from "./chunk-RICTB3FA.js";
+import {
+  metaMaskWallet
+} from "./chunk-YO2K4MBH.js";
 import {
   ledgerWallet
 } from "./chunk-RPV27V2Y.js";
+import {
+  mewWallet
+} from "./chunk-MQM45ADF.js";
 import {
   clvWallet
 } from "./chunk-OEEGYENV.js";
 import {
-  coin98Wallet
-} from "./chunk-WAHGI5L7.js";
-import {
-  bybitWallet
-} from "./chunk-OX37G4YT.js";
+  bitskiWallet
+} from "./chunk-7HRFUZFX.js";
 import {
   coinbaseWallet
 } from "./chunk-2DLDAZRH.js";
+import {
+  coin98Wallet
+} from "./chunk-WAHGI5L7.js";
 import {
   coreWallet
 } from "./chunk-4NV5BYRP.js";
-import {
-  dawnWallet
-} from "./chunk-G2PHTVL6.js";
 import {
   desigWallet
 } from "./chunk-FW3WZETT.js";
 import {
-  enkryptWallet
-} from "./chunk-HBQK5RD5.js";
+  dawnWallet
+} from "./chunk-G2PHTVL6.js";
+import {
+  foxWallet
+} from "./chunk-GUQM4QSL.js";
 import {
   argentWallet
 } from "./chunk-NTMBEOR2.js";
@@ -134,15 +134,15 @@ import {
 import {
   bitgetWallet
 } from "./chunk-TKB2OY6G.js";
-import {
-  bitskiWallet
-} from "./chunk-7HRFUZFX.js";
 import {
   bitverseWallet
 } from "./chunk-NSK6A7TI.js";
 import {
   bloomWallet
 } from "./chunk-PJ7Y57EH.js";
+import {
+  bybitWallet
+} from "./chunk-OX37G4YT.js";
 import "./chunk-N4IJLYFY.js";
 import {
   braveWallet

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funkit/connect",
-  "version": "9.26.1",
+  "version": "9.27.1",
   "description": "Funkit Connect SDK elevates DeFi apps via web2 sign-ins and one-click checkouts.",
   "files": [
     "dist",
@@ -111,10 +111,10 @@
     "ua-parser-js": "^1.0.37",
     "use-debounce": "^10.0.5",
     "uuid": "^11.1.1",
-    "@funkit/api-base": "5.0.0",
+    "@funkit/api-base": "5.1.0",
     "@funkit/chains": "2.1.1",
-    "@funkit/connect-core": "1.4.0",
-    "@funkit/fun-relay": "2.8.6",
+    "@funkit/connect-core": "1.4.1",
+    "@funkit/fun-relay": "2.9.0",
     "@funkit/utils": "3.1.0"
   },
   "repository": {