@funkit/connect 10.0.0 → 10.1.0-next.0

package/dist/index.js

@@ -1687,7 +1687,7 @@ function setFunkitConnectVersion({ version }) {
   localStorage.setItem(storageKey, version);
 }
 function getCurrentSdkVersion() {
-  return "10.0.0";
+  return "10.1.0-next.0";
 }
 function useFingerprint() {
   const fingerprint = useCallback3(() => {
@@ -19096,6 +19096,17 @@ var getTokenIconUrl = (symbol, tokens) => {
 
 // src/modals/WithdrawalModal/LighterWithdrawal.tsx
 var LIGHTER_SECURE_METHOD_ID = "lighter-secure";
+var LIGHTER_USDC_SPOT_SYMBOL = "USDC (Spot)";
+var LIGHTER_ROUTE_TYPE = {
+  PERPS: 0,
+  SPOT: 1
+};
+function getLighterBaseSymbol(symbol) {
+  return symbol.replace(/\s*\((?:spot|perps)\)\s*$/i, "");
+}
+function resolveLighterSecureRouteType(selectedSourceToken) {
+  return selectedSourceToken.toUpperCase() === "USDC" ? LIGHTER_ROUTE_TYPE.PERPS : LIGHTER_ROUTE_TYPE.SPOT;
+}
 var LIGHTER_SECURE_MAINNET_ADDRESS = {
   ETH: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
   LIT: "0x232CE3bd40fCd6f80f3d55A522d03f25Df784Ee2",
@@ -19108,7 +19119,7 @@ var LIGHTER_SECURE_MAINNET_ADDRESS = {
   AZTEC: "0xA27EC0006e59f245217Ff08CD52A7E8b169E62D2"
 };
 function getLighterSecureMainnetAddress(symbol) {
-  return LIGHTER_SECURE_MAINNET_ADDRESS[symbol.toUpperCase()];
+  return LIGHTER_SECURE_MAINNET_ADDRESS[getLighterBaseSymbol(symbol).toUpperCase()];
 }
 var LIGHTER_FAST_MAX_WITHDRAWAL_LABEL = "$3M";
 function LighterFastMaxExceededMessage({
@@ -19191,10 +19202,8 @@ function useLighterWithdrawalBalances({
     const result = {};
     for (const asset of account.assets) {
       const symbol = asset.symbol.toUpperCase();
-      if (symbol === "USDC") {
-        continue;
-      }
-      result[symbol] = freeBalance(asset.balance, asset.locked_balance);
+      const key = symbol === "USDC" ? LIGHTER_USDC_SPOT_SYMBOL.toUpperCase() : symbol;
+      result[key] = freeBalance(asset.balance, asset.locked_balance);
     }
     result.USDC = account.total_asset_value;
     logger.info("lighter:withdrawal:balances:resolved", {
@@ -19214,7 +19223,7 @@ function useLighterWithdrawalBalances({
 }
 var LIGHTER_USDC_ASSET_INDEX = 3;
 function resolveLighterAssetIndex(lighterAssets, selectedSourceToken) {
-  const selectedSymbol = selectedSourceToken.toUpperCase();
+  const selectedSymbol = getLighterBaseSymbol(selectedSourceToken).toUpperCase();
   const lookupAssetId = lighterAssets.find(
     (asset) => asset.symbol.toUpperCase() === selectedSymbol
   )?.asset_id;
@@ -19231,17 +19240,26 @@ function buildLighterSourceTokenOptions(config, lighterAssets) {
       }
     ];
   }
-  const usdcOption = {
+  const usdcPerpsOption = {
     symbol: "USDC",
-    label: "USDC",
+    label: "USDC (Perps)",
     iconSrc: getTokenIconUrl("USDC")
   };
-  const nonUsdcOptions = lighterAssets.filter((asset) => asset.symbol.toUpperCase() !== "USDC").map((asset) => ({
-    symbol: asset.symbol,
-    label: asset.symbol,
-    iconSrc: getTokenIconUrl(asset.symbol)
-  }));
-  return [usdcOption, ...nonUsdcOptions];
+  const spotOptions = lighterAssets.map((asset) => {
+    if (asset.symbol.toUpperCase() === "USDC") {
+      return {
+        symbol: LIGHTER_USDC_SPOT_SYMBOL,
+        label: LIGHTER_USDC_SPOT_SYMBOL,
+        iconSrc: getTokenIconUrl("USDC")
+      };
+    }
+    return {
+      symbol: asset.symbol,
+      label: asset.symbol,
+      iconSrc: getTokenIconUrl(asset.symbol)
+    };
+  });
+  return [usdcPerpsOption, ...spotOptions];
 }
 function useLighterWithdrawal(config, setRecipientAddress) {
   const { apiKey } = useFunkitConfig();
@@ -19353,9 +19371,10 @@ function LighterSecureAddressDisplay({ address }) {
   ));
 }
 function LighterSecureReceiveDisplay({
-  sourceTokenSymbol
+  sourceTokenSymbol: rawSourceTokenSymbol
 }) {
   const { t } = useFunkitTranslation();
+  const sourceTokenSymbol = getLighterBaseSymbol(rawSourceTokenSymbol);
   return /* @__PURE__ */ React83.createElement(Box, { width: "full", display: "flex", gap: "12" }, /* @__PURE__ */ React83.createElement(Box, { width: "full", display: "flex", flexDirection: "column", gap: "4" }, /* @__PURE__ */ React83.createElement(Text, { size: "inputLabel", weight: "inputLabel", color: "inputLabel" }, t("withdrawal.receiveToken")), /* @__PURE__ */ React83.createElement(
     LighterSecureLockedField,
     {
@@ -19394,8 +19413,9 @@ function LighterSecureReceiveDisplay({
 }
 function LighterSecureReceiveAmountValue({
   amount,
-  tokenSymbol
+  tokenSymbol: rawTokenSymbol
 }) {
+  const tokenSymbol = getLighterBaseSymbol(rawTokenSymbol);
   return /* @__PURE__ */ React83.createElement(
     Text,
     {
@@ -19415,10 +19435,11 @@ function LighterSecureWithdrawalSuccess({
   onClose,
   onNewWithdrawal,
   amount,
-  tokenSymbol,
+  tokenSymbol: rawTokenSymbol,
   txHash
 }) {
   const { t } = useFunkitTranslation();
+  const tokenSymbol = getLighterBaseSymbol(rawTokenSymbol);
   const bottomSectionRef = useBottomSectionRef("withdrawal");
   const isSyntheticHash = txHash === "0x0000000000000000000000000000000000000001";
   const hasRealTxHash = !!txHash && !isSyntheticHash;
@@ -25067,7 +25088,12 @@ function WithdrawAmountInput({
   const isLighter = isLighterxyzCustomer(apiKey);
   const isLighterFast = isLighter && config.sourceChainId === RELAY_LIGHTER_CHAIN_ID3;
   const activeSymbol = selectedSourceToken ?? config.sourceTokenSymbol;
-  const chipLabel = isLighterFast ? "USDC (Perps)" : activeSymbol;
+  const selectedOption = sourceTokenOptions?.find(
+    (opt) => opt.symbol === activeSymbol
+  );
+  const chipLabel = selectedOption?.label ?? (isLighterFast ? "USDC (Perps)" : activeSymbol);
+  const chipIconSrc = selectedOption?.iconSrc ?? getTokenIconUrl(getLighterBaseSymbol(activeSymbol));
+  const displaySymbol = getLighterBaseSymbol(activeSymbol);
   const chipTooltip = isLighterFast ? t("withdrawal.lighterFastTokenTooltip") : void 0;
   const [amountInputTouched, setAmountInputTouched] = useState38(false);
   const handleAmountChange = (e) => {
@@ -25082,15 +25108,16 @@ function WithdrawAmountInput({
   };
   const isSolelyOverCap = isWithdrawAmountTooHigh && !isWithdrawAmountAboveBalance;
   const showAmountError = amountInputTouched && withdrawalInputAmount !== "" && !isWithdrawAmountValid && !isSolelyOverCap;
-  const minAmountDisplay = isLighter ? `${minWithdrawalDisplayValue} ${activeSymbol}` : formatCurrencyAndStringify5(minWithdrawalDisplayValue);
+  const minAmountDisplay = isLighter ? `${minWithdrawalDisplayValue} ${displaySymbol}` : formatCurrencyAndStringify5(minWithdrawalDisplayValue);
   const errorText = showAmountError ? isWithdrawAmountTooLow ? t("withdrawal.minimumWithdrawAmount", { amount: minAmountDisplay }) : t("withdrawal.insufficientBalance") : void 0;
   return /* @__PURE__ */ React131.createElement(Box, { display: "flex", flexDirection: "column", gap: "4" }, /* @__PURE__ */ React131.createElement(Text, { size: "inputLabel", weight: "inputLabel", color: "inputLabel" }, t("withdrawal.amount")), /* @__PURE__ */ React131.createElement(Box, { display: "flex", flexDirection: "column", gap: "4" }, isLighter ? /* @__PURE__ */ React131.createElement(
     LighterCompoundAmountInput,
     {
       value: withdrawalInputAmount,
       onChange: handleAmountChange,
-      activeSymbol,
+      activeSymbol: displaySymbol,
       chipLabel,
+      chipIconSrc,
       chipTooltip,
       sourceTokenBalance,
       onMax: setMaxAmount,
@@ -25116,7 +25143,7 @@ function WithdrawAmountInput({
       suffix: /* @__PURE__ */ React131.createElement(
         AmountInputSuffix,
         {
-          symbol: activeSymbol,
+          symbol: displaySymbol,
           sourceTokenBalance,
           onMax: setMaxAmount
         }
@@ -25127,7 +25154,7 @@ function WithdrawAmountInput({
     { minBeforeUseScientific: 0 }
   )), Number(sourceTokenBalance) > 0 && /* @__PURE__ */ React131.createElement(Text, { size: "12", color: "secondaryText" }, t("withdrawal.balance", {
     amount: formatCryptoAndStringify2(Number(sourceTokenBalance)),
-    symbol: activeSymbol
+    symbol: displaySymbol
   })))));
 }
 function AmountInputSuffix({
@@ -25151,6 +25178,7 @@ function LighterCompoundAmountInput({
   onChange,
   activeSymbol,
   chipLabel,
+  chipIconSrc,
   chipTooltip,
   sourceTokenBalance,
   onMax,
@@ -25185,8 +25213,8 @@ function LighterCompoundAmountInput({
     /* @__PURE__ */ React131.createElement(
       LighterSourceTokenDropdown,
       {
-        activeSymbol,
         chipLabel,
+        chipIconSrc,
         tooltip: chipTooltip,
         options: sourceTokenOptions,
         onSelect: onSourceTokenChange
@@ -25229,8 +25257,8 @@ function LighterAmountInputField({
   ));
 }
 function LighterSourceTokenDropdown({
-  activeSymbol,
   chipLabel,
+  chipIconSrc,
   tooltip,
   options,
   onSelect
@@ -25260,7 +25288,7 @@ function LighterSourceTokenDropdown({
     /* @__PURE__ */ React131.createElement(
       AsyncImage,
       {
-        src: getTokenIconUrl(activeSymbol),
+        src: chipIconSrc,
         alt: chipLabel,
         width: 20,
         height: 20,
@@ -25295,7 +25323,11 @@ function LighterSourceTokenDropdown({
       className: "funkit-dropdown-content",
       style: {
         zIndex: "calc(var(--rk-modal-z-index, 2147483646) + 1)",
-        width: "var(--radix-dropdown-menu-trigger-width)"
+        // Track the chip width as a floor only — a short selection (e.g.
+        // "LIT") must not squeeze longer labels ("USDC (Perps)") into
+        // wrapping; the menu grows to its widest item instead.
+        minWidth: "var(--radix-dropdown-menu-trigger-width)",
+        width: "max-content"
       },
       onCloseAutoFocus: (e) => e.preventDefault()
     },
@@ -25342,7 +25374,16 @@ function LighterSourceTokenDropdown({
               borderRadius: "full"
             }
           ),
-          /* @__PURE__ */ React131.createElement(Text, { size: "13", weight: "medium", color: "primaryText" }, opt.label)
+          /* @__PURE__ */ React131.createElement(
+            Text,
+            {
+              size: "13",
+              weight: "medium",
+              color: "primaryText",
+              style: { whiteSpace: "nowrap" }
+            },
+            opt.label
+          )
         )
       ))
     )
@@ -25628,7 +25669,7 @@ function useWithdrawal({
             targetAssetAddress: formData.tokenAddress,
             targetChainId: formData.chainId,
             destinationAddress: formData.destinationAddress,
-            lighterAssetIndex: formData.lighterAssetIndex,
+            customerData: formData.customerData,
             userInputAmount: formData.userInputAmount,
             withdrawalUSD: formData.withdrawalUSD
           });
@@ -25664,7 +25705,7 @@ function useWithdrawal({
           targetAssetAddress: formData.tokenAddress,
           targetChainId: formData.chainId,
           destinationAddress: formData.destinationAddress,
-          lighterAssetIndex: formData.lighterAssetIndex,
+          customerData: formData.customerData,
           userInputAmount: formData.userInputAmount,
           withdrawalUSD: formData.withdrawalUSD
         });
@@ -26090,7 +26131,13 @@ var WithdrawContent = ({
       // submit button is gated on `lighterAssetIndex` but not on this asset.
       tokenAddress: lighterSecureMainnetAddress ?? "0x",
       chainId: mainnet7.id,
-      lighterAssetIndex,
+      customerData: {
+        customerName: "lighter",
+        assetIndex: lighterAssetIndex,
+        // Perps vs spot route — disambiguates USDC, which shares asset
+        // index 3 across both routes.
+        routeType: resolveLighterSecureRouteType(selectedSourceToken)
+      },
       userInputAmount: withdrawalInputAmount
     });
   };

package/dist/modals/CheckoutModal/buildRelayChains.d.ts

@@ -0,0 +1,12 @@
+import type { Chain } from 'viem';
+/**
+ * Returns the chain list for the relay client, applying per-chain RPC overrides
+ * (keyed by chain id) onto each chain's `rpcUrls.default.http`.
+ *
+ * The relay-sdk derives the RPC it polls for transaction receipts from each
+ * chain's `rpcUrls.default`, so this points that receipt-wait at a reachable
+ * endpoint for chains whose default RPC isn't (e.g. an early-access chain like
+ * Robinhood). Only chains listed in `rpcOverrides` are changed; everything else
+ * is returned unchanged. See {@link FunkitConfig.relayRpcOverrides}.
+ */
+export declare function buildRelayChains(chains: readonly Chain[], rpcOverrides?: Record<number, string>): Chain[];

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

@@ -6,12 +6,38 @@
 import type { LighterAccountIndex } from '@funkit/api-base';
 import React from 'react';
 import type { Address } from 'viem';
-import type { CustomWithdrawalConfig, WalletWithdrawalConfig } from '../../providers/FunkitCheckoutContext';
+import type { CustomWithdrawalConfig, LighterRouteType, WalletWithdrawalConfig } from '../../providers/FunkitCheckoutContext';
 import type { LighterShare } from '../../utils/customer';
 import type { SourceTokenOption } from './WithdrawAmountInput';
 /** Stable method ids for the Fast / Secure options (used for tracking + switching). */
 export declare const LIGHTER_FAST_METHOD_ID = "lighter-fast";
 export declare const LIGHTER_SECURE_METHOD_ID = "lighter-secure";
+/**
+ * USDC exists twice on a Lighter account: as perps collateral
+ * (`total_asset_value`, withdrawn via route 0) and as a spot asset balance
+ * (asset entry 3, withdrawn via route 1). The Secure dropdown keys selection
+ * by `symbol`, so the spot variant gets a pseudo-symbol to stay selectable
+ * alongside the plain `USDC` (perps) entry.
+ */
+export declare const LIGHTER_USDC_SPOT_SYMBOL = "USDC (Spot)";
+/** Lighter L2 route types (`RouteType` in the withdraw/transfer tx payload). */
+export declare const LIGHTER_ROUTE_TYPE: {
+    readonly PERPS: 0;
+    readonly SPOT: 1;
+};
+/**
+ * Strips the ` (Spot)` / ` (Perps)` variant suffix off a Lighter source-token
+ * selection, returning the real token symbol (e.g. `USDC (Spot)` → `USDC`).
+ * Symbol-keyed lookups (icons, prices, asset indices, min amounts) operate on
+ * the base symbol; only selection identity and route resolution keep the suffix.
+ */
+export declare function getLighterBaseSymbol(symbol: string): string;
+/**
+ * Resolves the Lighter L2 route type for a Secure source-token selection.
+ * Plain `USDC` withdraws perps collateral (route 0); everything else —
+ * including the `USDC (Spot)` pseudo-symbol — is a spot asset (route 1).
+ */
+export declare function resolveLighterSecureRouteType(selectedSourceToken: string): LighterRouteType;
 /**
  * Mainnet ERC-20 address for a Lighter Secure source token symbol, or undefined
  * if the symbol isn't a known Secure asset.
@@ -91,7 +117,8 @@ export declare function resolveLighterAssetIndex(lighterAssets: {
  * Builds the source-token options list for the Lighter compound input dropdown.
  *
  * - Fast path: only USDC (Perps).
- * - Secure path: USDC (from total_asset_value) + every asset on the account.
+ * - Secure path: USDC (Perps) (from total_asset_value) + USDC (Spot) when the
+ *   account carries a spot USDC asset + every non-USDC asset on the account.
  */
 export declare function buildLighterSourceTokenOptions(config: FunkitWithdrawalConfig, lighterAssets: {
     symbol: string;
@@ -130,17 +157,17 @@ export declare function LighterSecureAddressDisplay({ address }: {
  * token always matches the source asset, and the destination chain is always
  * Ethereum mainnet. Each field surfaces a hover tooltip explaining the lock.
  */
-export declare function LighterSecureReceiveDisplay({ sourceTokenSymbol, }: {
+export declare function LighterSecureReceiveDisplay({ sourceTokenSymbol: rawSourceTokenSymbol, }: {
     sourceTokenSymbol: string;
 }): React.JSX.Element;
 /**
  * Lighter Secure: receive amount value (1:1 — same token, no swap).
  */
-export declare function LighterSecureReceiveAmountValue({ amount, tokenSymbol, }: {
+export declare function LighterSecureReceiveAmountValue({ amount, tokenSymbol: rawTokenSymbol, }: {
     amount: string;
     tokenSymbol: string;
 }): React.JSX.Element;
-export declare function LighterSecureWithdrawalSuccess({ onClose, onNewWithdrawal, amount, tokenSymbol, txHash, }: {
+export declare function LighterSecureWithdrawalSuccess({ onClose, onNewWithdrawal, amount, tokenSymbol: rawTokenSymbol, txHash, }: {
     onClose: () => void;
     onNewWithdrawal: () => void;
     amount: string;

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

@@ -1,7 +1,7 @@
 import type { Address, Hex } from 'viem';
 import { type CheckoutConfirmationError } from '../../domains/checkoutErrors';
 import type { FunkitCheckoutQuoteResult } from '../../domains/quote';
-import { type FunkitActiveWithdrawalItem, type FunkitWithdrawalConfig } from '../../providers/FunkitCheckoutContext';
+import { type FunkitActiveWithdrawalItem, type FunkitWithdrawalConfig, type WithdrawalCustomerData } from '../../providers/FunkitCheckoutContext';
 interface UseWithdrawalResult {
     handleWithdrawal: (withdrawal: WithdrawalFormData) => Promise<Hex | null>;
     isWithdrawing: boolean;
@@ -15,8 +15,8 @@ export type WithdrawalFormData = {
     tokenAddress: Address;
     chainId: number;
     quote?: FunkitCheckoutQuoteResult;
-    /** Lighter asset index for quoteless Secure withdrawal. */
-    lighterAssetIndex?: number;
+    /** Customer-specific data for quoteless flows (e.g. Lighter Secure). */
+    customerData?: WithdrawalCustomerData;
     userInputAmount: string;
 };
 export declare function useWithdrawal({ config, withdrawalItem, onSuccess, }: {

package/dist/providers/FunkitCheckoutContext/types.d.ts

@@ -281,14 +281,32 @@ export interface CustomWithdrawalConfig extends WithdrawalConfigBase {
      */
     withdrawCallback: (param: WithdrawalParam) => Promise<undefined | string>;
 }
+/** Lighter L2 route type: 0 = perps (USDC collateral), 1 = spot. */
+export type LighterRouteType = 0 | 1;
+/**
+ * Lighter-specific data for quoteless Secure withdrawal. `assetIndex` selects
+ * the L2 asset (avoids overloading targetChainId); `routeType` disambiguates
+ * USDC, whose perps and spot balances share asset index 3.
+ */
+export interface LighterWithdrawalCustomerData {
+    customerName: 'lighter';
+    assetIndex: number;
+    routeType: LighterRouteType;
+}
+/**
+ * Customer-specific data threaded through withdrawal callbacks, discriminated
+ * by `customerName` so future customers extend the union instead of adding
+ * top-level params.
+ */
+export type WithdrawalCustomerData = LighterWithdrawalCustomerData;
 export interface WithdrawalParam {
     quoteId: string;
     funQuote: unknown;
     targetAssetAddress: Address;
     targetChainId: number;
     destinationAddress: Address;
-    /** Lighter asset index for quoteless Secure withdrawal (avoids overloading targetChainId). */
-    lighterAssetIndex?: number;
+    /** Customer-specific data for quoteless flows (e.g. Lighter Secure). */
+    customerData?: WithdrawalCustomerData;
     /** User-entered amount in token units for quoteless flows (avoids overloading quoteId). */
     userInputAmount?: string;
     /**

package/dist/providers/FunkitFlagsProvider.d.ts

@@ -0,0 +1,26 @@
+import React, { type ReactNode } from 'react';
+import type { FlagKey } from '@funkit/utils';
+import { flagConfig as offlineConfig } from '../utils/flags/config';
+import type { InferFlagType } from '../utils/flags/types';
+export type FlagValue<K extends FlagKey> = InferFlagType<(typeof offlineConfig)[K]>;
+export type FlagValues = {
+    [K in FlagKey]?: FlagValue<K>;
+};
+export type GetFlagFunction = <K extends FlagKey>(flagKey: K, fallback?: FlagValue<K>) => FlagValue<K>;
+export interface FunkitFlagsContextValue {
+    /** Error fetching flag config from server */
+    error: Error | null;
+    /** Loaded flags - each flag may be undefined if configuration from server was missing or invalid */
+    flags: FlagValues;
+    /** Synchronously reads a single flag (derived for current user) - returns fallback while loading */
+    getFlag: GetFlagFunction;
+    /** Whether flags are currently loading */
+    isLoading: boolean;
+}
+export declare const FunkitFlagsContext: React.Context<FunkitFlagsContextValue>;
+export declare function FunkitFlagsProvider({ children }: {
+    children: ReactNode;
+}): React.JSX.Element;
+export declare function useFlags(): FunkitFlagsContextValue;
+export type FlagMiddleware<K extends FlagKey> = (flagValue: FlagValue<K>) => FlagValue<K>;
+export declare function useFlag<K extends FlagKey>(flagKey: K, fallback?: FlagValue<K>, middleware?: FlagMiddleware<K>): FlagValue<K>;