@funkit/connect 9.12.0 → 9.14.0

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

@@ -0,0 +1,31 @@
+import React, { type ReactNode } from 'react';
+import type { SourceGroup } from './buildSourceGroups';
+interface FlatListProps {
+    groups: SourceGroup[];
+    /**
+     * Class name applied to the outer Box that holds the groups.
+     * Caller decides between standard / compact styling so the renderer
+     * doesn't reach into FunkitConfig.
+     */
+    boxClassName: string;
+    /**
+     * Label rendered on the `FunDivider` between adjacent groups.
+     * Omit to render the divider without a label.
+     */
+    dividerLabel?: string;
+    /**
+     * Trailing content rendered after the groups, inside the outer Box.
+     * Used by the source-list flat layout to place PayPal at the
+     * bottom of the box.
+     */
+    footer?: ReactNode;
+    /** Applied as `data-testid` on the outer Box for snapshot scoping. */
+    testId?: string;
+}
+/**
+ * Pure presentational primitive: a single column of group bodies with
+ * a divider between adjacent groups and an optional footer. No
+ * provider/context dependencies — composition lives in the caller.
+ */
+export declare function FlatList({ groups, boxClassName, dividerLabel, footer, testId, }: FlatListProps): React.JSX.Element;
+export {};

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

@@ -0,0 +1,25 @@
+import React from 'react';
+import type { SourceGroup } from './buildSourceGroups';
+interface GroupedListProps {
+    groups: SourceGroup[];
+    /**
+     * Render each group's `label` as a section header when true. False
+     * skips the headers but keeps the grouped container styling.
+     */
+    showLabels: boolean;
+    /**
+     * Class name applied to the inner box that holds each group's
+     * children. Caller decides between standard / compact styling so the
+     * renderer doesn't reach into FunkitConfig.
+     */
+    boxClassName: string;
+    /** Applied as `data-testid` on the outer Box for snapshot scoping. */
+    testId?: string;
+}
+/**
+ * Pure presentational primitive: groups rendered as separate boxes
+ * inside a grouped container, with optional section labels. No
+ * provider/context dependencies — composition lives in the caller.
+ */
+export declare function GroupedList({ groups, showLabels, boxClassName, testId, }: GroupedListProps): React.JSX.Element;
+export {};

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

@@ -35,6 +35,14 @@ export type SourceChangeNext = {
     selectedPaymentOption: SwappedFormOfPayment;
     /** Payment method type filter to restore when returning */
     paymentMethodTypeFilter: PaymentMethodType;
+} | {
+    /**
+     * Skip the asset-select screen; land on InputAmount with the
+     * source asset pre-set on the checkout context. Used by the
+     * Native fast-path row.
+     */
+    skipAssetSelect: true;
+    paymentMethodInfo: ConnectablePaymentMethodInfo;
 };
 export declare const SourceChangeInfo: ModalStepInfo<FunCheckoutStep.SOURCE_CHANGE>;
 export declare function SourceChange({ modalState, onClose, onNext, setModalState, }: ModalStepComponentProps<FunCheckoutStep.SOURCE_CHANGE>): React.JSX.Element;

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

@@ -1,13 +1,27 @@
-import React from 'react';
-import type { ConnectablePaymentMethodInfo, PaymentMethod } from '../../../domains/paymentMethods';
-import { type UnavailablePaymentSource } from '../../../hooks/usePaymentSources';
+import React, { type ReactNode } from 'react';
 interface SourceListProps {
-    preferred: (ConnectablePaymentMethodInfo | PaymentMethod)[];
-    moreSources: (ConnectablePaymentMethodInfo | PaymentMethod)[];
-    unavailable: UnavailablePaymentSource[];
+    preferred: ReactNode[];
+    moreSources: ReactNode[];
+    unavailable: ReactNode[];
     isFallback: boolean;
-    renderSource: (source: ConnectablePaymentMethodInfo | PaymentMethod) => React.ReactNode;
-    renderUnavailable: (source: UnavailablePaymentSource) => React.ReactNode;
+    /**
+     * Pre-rendered Native fast-path row, threaded through to
+     * `buildSourceGroups`. Caller (SourceChange) owns the row's click
+     * handler since it depends on the modal's `onNext` callback.
+     */
+    nativeRow?: ReactNode;
+    testId?: string;
 }
-export declare function SourceList({ preferred, moreSources, unavailable, isFallback, renderSource, renderUnavailable, }: SourceListProps): React.JSX.Element;
+/**
+ * Contextual composer for the source-change payment-method list.
+ * Reads translation, funkit config, and the source-list-relevant
+ * Statsig flags directly; runs `buildSourceGroups`; dispatches to the
+ * matching layout primitive — `FlatList` for the non-Swapped path
+ * (with a PayPal footer + "more" divider label) or `GroupedList` for
+ * the Swapped path (with optional section labels).
+ *
+ * `SourceList` has no DOM of its own; the primitive it returns owns
+ * the outer `data-testid` element.
+ */
+export declare function SourceList({ preferred, moreSources, unavailable, isFallback, nativeRow, testId, }: SourceListProps): React.JSX.Element;
 export {};

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

@@ -0,0 +1,70 @@
+import type { TFunction } from 'i18next';
+import { type ReactNode } from 'react';
+export interface SourceGroup {
+    /** Section header. Omit to render the group's body without a header. */
+    label?: string;
+    /**
+     * Optional tooltip surfaced via an info icon next to the label.
+     * Only renders when `showLabels` and `label` are both set.
+     */
+    labelTooltip?: string;
+    children: ReactNode;
+}
+interface BuildSourceGroupsArgs {
+    /** Customer identity — used to dispatch to per-customer section composition. */
+    apiKey: string;
+    preferred: ReactNode[];
+    moreSources: ReactNode[];
+    unavailable: ReactNode[];
+    isFallback: boolean;
+    isSwappedEnabled: boolean;
+    enableSourceGroupLabels: boolean;
+    t: TFunction;
+    /**
+     * Pre-rendered Native fast-path row. Caller resolves the customer's
+     * native asset, looks up the wallet holding, and constructs the row
+     * component; this function decides where in the Aave section
+     * structure it belongs. Only the Aave branch consumes it; the
+     * default branch ignores it.
+     */
+    nativeRow?: ReactNode;
+}
+export type BuildSourceGroupsResult = {
+    layout: 'flat';
+    groups: SourceGroup[];
+} | {
+    layout: 'grouped';
+    groups: SourceGroup[];
+    showLabels: boolean;
+};
+/**
+ * Composes source-list sections from `usePaymentSources` buckets +
+ * the relevant Statsig flags + the customer identity. Returns a
+ * discriminated layout shape; the composer (`SourceList`) dispatches
+ * to the matching layout primitive.
+ *
+ * **Default branch** (most customers) mirrors SourceList's prior
+ * output:
+ * - `isSwappedEnabled=false` → flat layout. One group for `preferred`
+ *   (if any), one combined group for `moreSources + unavailable` (if
+ *   any), with a single divider between them. (`SourceList` places
+ *   `<PayPal />` as the flat footer.)
+ * - `isSwappedEnabled=true` → grouped layout. Same two groups, but
+ *   rendered in separate boxes with `showLabels` toggling the section
+ *   headers ("Connected" / "Most popular" / "Other options"). The
+ *   "Other options" header is suppressed when no preferred group
+ *   precedes it.
+ *
+ * **Aave branch** (per Figma, [ENG-3743](https://linear.app/funxyz/issue/ENG-3743)
+ * + [ENG-3747](https://linear.app/funxyz/issue/ENG-3747)
+ * + [ENG-3755](https://linear.app/funxyz/issue/ENG-3755)):
+ * - "Native" section with the user's underlying-asset row when
+ *   `nativeRow` is provided.
+ * - Second section flattens preferred + moreSources + unavailable
+ *   into "Use other assets" (with native present) or "Use any asset"
+ *   (without). Header carries a tooltip via `labelTooltip`.
+ * - Layout is always `grouped` with `showLabels=true` for Aave so the
+ *   section headers render.
+ */
+export declare function buildSourceGroups(args: BuildSourceGroupsArgs): BuildSourceGroupsResult;
+export {};

package/dist/modals/CheckoutModal/TransferToken/types.d.ts

@@ -6,11 +6,10 @@ export type NotificationItem = (MergedMultiStepDirectExecution & {
 }) | (CheckoutHistoryItem & {
     isDirectExecution: false;
 });
-type NotificationVariant = 'withdrawal' | 'token_transfer';
+export type NotificationVariant = 'deposit' | 'withdrawal' | 'token_transfer';
 export interface CheckoutNotificationsProps {
     onHelp: (depositAddress: Address) => void;
     /** To control notifications visibility on specific pages, without changing internal dismissal state */
     isVisible: boolean;
     variant: NotificationVariant | undefined;
 }
-export {};

package/dist/modals/ProfileDetails/FunProfileViews/Home/HomeCheckoutDisplayRow.css.d.ts

@@ -1,2 +1,2 @@
 export declare const baseStyles: string;
-export declare const homeCheckoutDisplayRowStyle: Record<"hoverBackground" | "defaultBorder" | "defaultBackground", string>;
+export declare const homeCheckoutDisplayRowStyle: Record<"defaultBorder" | "defaultBackground" | "hoverBackground", string>;

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

@@ -0,0 +1,4 @@
+import type { TFunction } from 'i18next';
+import type { ErrorNotification } from '../../components/FunNotification/FunNotification';
+import type { CheckoutConfirmationError } from '../CheckoutModal/ConfirmationStep/useCheckoutConfirmation';
+export declare function getErrorNotification(quoteErrorObject: Error | null, withdrawalError: CheckoutConfirmationError | null, targetAssetFetchError: Error | null, t: TFunction): ErrorNotification | null;

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

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { FunkitWithdrawalConfig } from '../../providers/FunkitCheckoutContext';
+export declare function WithdrawRecipientAddress({ config, recipientAddress, setRecipientAddress, selectedChainId, selectedToken, isValidAddress, isRiskyAddress, }: {
+    config: FunkitWithdrawalConfig;
+    recipientAddress: string;
+    setRecipientAddress: (s: string) => void;
+    selectedChainId: number | undefined;
+    selectedToken: string | undefined;
+    isValidAddress: boolean;
+    isRiskyAddress: boolean;
+}): React.JSX.Element;

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

@@ -6,14 +6,20 @@ export interface SourceTokenOption {
     label: string;
     iconSrc?: string;
 }
-export declare function WithdrawAmountInput({ withdrawalUSD, setWithdrawalUSD, sourceTokenBalance, isWithdrawAmountTooLow, isWithdrawAmountValid, minWithdrawalUsd, config, sourceTokenOptions, onSourceTokenChange, selectedSourceToken, sourceTokenUsdPrice, }: {
+export declare function WithdrawAmountInput({ withdrawalInputAmount, setWithdrawalInputAmount, sourceTokenBalance, isWithdrawAmountTooLow, isWithdrawAmountValid, minWithdrawalDisplayValue, config, sourceTokenOptions, onSourceTokenChange, selectedSourceToken, sourceTokenUsdPrice, }: {
     config: Exclude<FunkitWithdrawalConfig, MultiMethodWithdrawalConfig>;
     sourceTokenBalance: string;
-    withdrawalUSD: string;
-    setWithdrawalUSD: (s: string) => void;
+    /** User-entered amount in source-token units (e.g. "0.5" for 0.5 ETH). */
+    withdrawalInputAmount: string;
+    setWithdrawalInputAmount: (s: string) => void;
     isWithdrawAmountTooLow: boolean;
     isWithdrawAmountValid: boolean;
-    minWithdrawalUsd: number;
+    /**
+     * Minimum-withdrawal value formatted for display. Token units when the
+     * config provides `getMinWithdrawalAmount` (Lighter Secure); USD otherwise.
+     * The component picks the rendering style from `isLighter`.
+     */
+    minWithdrawalDisplayValue: number;
     sourceTokenOptions?: SourceTokenOption[];
     onSourceTokenChange?: (opt: SourceTokenOption) => void;
     /** Currently selected source token symbol (drives chip label + icon). */

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

@@ -1,6 +1,6 @@
 import React from 'react';
 import type { Hex } from 'viem';
-import type { CustomWithdrawalConfig, FunkitActiveWithdrawalItem, WalletWithdrawalConfig } from '../../providers/FunkitCheckoutContext';
+import type { CustomWithdrawalConfig, FunkitActiveWithdrawalItem, FunkitCheckoutConfig, WalletWithdrawalConfig } from '../../providers/FunkitCheckoutContext';
 import { type WithdrawalFormData } from './useWithdrawal';
 /**
  * WithdrawalContent only operates on concrete single-method withdrawal configs.
@@ -12,6 +12,37 @@ interface WithdrawContentProps {
     config: FunkitWithdrawalConfig;
     withdrawalItem: FunkitActiveWithdrawalItem | null;
 }
+/**
+ * Converts a source-token amount string to its USD value using the given unit
+ * price. Returns `undefined` when the price is not yet loaded so callers can
+ * differentiate "still loading" from "actually $0".
+ *
+ * Exported for testing.
+ */
+export declare function toUsdValue(sourceAmount: string, sourceTokenUsdPrice: number | undefined): number | undefined;
+export declare function isValidWithdrawal({ config, checkoutConfig, withdrawalInputAmount, sourceTokenUsdPrice, recipientAddress, selectedChainId, sourceTokenBalance, selectedSourceToken, }: {
+    config: FunkitWithdrawalConfig;
+    checkoutConfig: FunkitCheckoutConfig | undefined;
+    /** User-entered amount in source-token units (e.g. "0.5" for 0.5 ETH). */
+    withdrawalInputAmount: string;
+    /**
+     * USD price per unit of the source token. Hardcoded to 1 for stablecoin
+     * sources; only Lighter Secure resolves a live spot price, and that path
+     * uses `getMinWithdrawalAmount` (per-token) which takes priority over the
+     * USD-min branch — so this field is only meaningfully consumed when it's 1.
+     */
+    sourceTokenUsdPrice: number;
+    sourceTokenBalance: string;
+    recipientAddress: string;
+    selectedChainId: number | undefined;
+    selectedSourceToken: string | undefined;
+}): {
+    isValidAddress: boolean;
+    isValidAddressAndChain: boolean;
+    isWithdrawAmountTooLow: boolean;
+    isWithdrawAmountValid: boolean;
+    minWithdrawalDisplayValue: number;
+};
 /**
  * Builds the source-token options list for the Lighter compound input dropdown.
  * Currently returns a single option per config; expands when Lighter exposes

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

@@ -196,6 +196,7 @@ export interface MultiMethodWithdrawalConfig {
     sectionTitle?: string;
     /** The methods the user can choose between. Order is preserved in the UI. */
     methods: WithdrawalMethodOption[];
+    disableConnectedWallet?: boolean;
 }
 export type FunkitWithdrawalConfig = WalletWithdrawalConfig | CustomWithdrawalConfig | MultiMethodWithdrawalConfig;
 export interface FunkitCheckoutValidationResult {

package/dist/providers/FunkitConfigContext.d.ts

@@ -11,6 +11,7 @@ export interface FunkitTextCustomizationsConfig {
     sourceMethodTitle: string;
     tokensListTitle: string;
     transferTokens: string;
+    bitcoinLightning: string;
     receiveDropdownTitle: string;
     receiveDropdownLabel: string;
     txStatus?: {
@@ -58,6 +59,7 @@ export interface FunkitTextCustomizationsConfig {
         debitOrCredit?: string;
         paypal?: string;
         transferTokens?: string;
+        bitcoinLightning?: string;
         virtualFiat?: string;
     };
 }
@@ -184,6 +186,8 @@ export interface FunkitUiCustomizationsConfig {
         showTargetAssetSelection?: boolean;
         /** Whether to show wallet option when balance is insufficient - defaults to false (hides wallet) */
         showWalletOnInsufficientBalance?: boolean;
+        /** Whether to show the wallet connect payment option - defaults to true */
+        showWalletConnect?: boolean;
         /** Function that returns a custom React component to render before other UIs in the source change screen */
         customTopComponent?: () => ReactNode;
         paymentMethodIcons?: {

package/dist/providers/GeneralWalletProvider.d.ts

@@ -3,15 +3,13 @@ import React, { type ReactNode } from 'react';
 import type { Address } from 'viem';
 import { type UseDisconnectReturnType, type UseReconnectReturnType } from '../wagmi/hooks';
 import { type FunkitUserInfo } from '../consts/funkit';
+import { LoginType } from '../utils/userInfo';
 /** AssetBalanceInfo with known price and totalUsdValue */
 export interface KnownAssetBalanceInfo extends AssetBalanceInfo {
     price: number;
     totalUsdValue: number;
 }
-export declare enum LoginType {
-    Web3 = "web3",
-    Guest = "guest"
-}
+export { LoginType } from '../utils/userInfo';
 export interface GeneralWalletContextProps {
     walletAddress: Address | '';
     isUserLoggedIn: boolean;

package/dist/utils/userInfo.d.ts

@@ -0,0 +1,36 @@
+import type { Address } from 'viem';
+import { type FunkitUserInfo } from '../consts/funkit';
+export declare enum LoginType {
+    Web3 = "web3",
+    Guest = "guest"
+}
+/**
+ * Whether externalUserId should be treated as a trusted wallet address.
+ * Currently only Lighter mobile QR flow passes externalUserId as an L1 address.
+ */
+export declare function getIsExternalUserIdAddress(apiKey: string, externalUserId: string | undefined): boolean;
+/**
+ * Resolve the wallet address, preferring wagmi's connected address.
+ * When `isExternalUserIdAddress` is true, externalUserId is treated as a trusted
+ * wallet address and used as fallback when wagmi is not connected.
+ * Currently used by Lighter mobile QR flow where the L1 address is passed via externalUserId.
+ */
+export declare function resolveWalletAddress(address: Address | undefined, externalUserId: string | undefined, isExternalUserIdAddress: boolean): Address | undefined;
+/**
+ * Resolve the userId for the current session.
+ */
+export declare function resolveUserId(address: Address | undefined, externalUserId: string | undefined, apiKey: string, isExternalUserIdAddress: boolean): string;
+/**
+ * Build the FunkitUserInfo for the current session.
+ */
+export declare function buildUserInfo({ address, effectiveAddress, externalUserId, apiKey, isExternalUserIdAddress, loginType, connectorName, ensName, ensAvatar, }: {
+    address: Address | undefined;
+    effectiveAddress: Address | undefined;
+    externalUserId: string | undefined;
+    apiKey: string;
+    isExternalUserIdAddress: boolean;
+    loginType: LoginType;
+    connectorName: string | undefined;
+    ensName: string | null | undefined;
+    ensAvatar: string | null | undefined;
+}): FunkitUserInfo;

package/dist/wallets/walletConnectors/bifrostWallet/bifrostWallet.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   bifrostWallet
-} from "../chunk-6DRCY52E.js";
-import "../chunk-YYYRPQHB.js";
+} from "../chunk-OD6B2ISG.js";
 import "../chunk-FMVNQKZL.js";
+import "../chunk-YYYRPQHB.js";
 import "../chunk-3K2MFXCO.js";
 export {
   bifrostWallet

package/dist/wallets/walletConnectors/bitgetWallet/bitgetWallet.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   bitgetWallet
-} from "../chunk-YIEASHLS.js";
-import "../chunk-YYYRPQHB.js";
+} from "../chunk-IMNI4AGV.js";
 import "../chunk-FMVNQKZL.js";
+import "../chunk-YYYRPQHB.js";
 import "../chunk-3K2MFXCO.js";
 export {
   bitgetWallet

package/dist/wallets/walletConnectors/bybitWallet/bybitWallet.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   bybitWallet
-} from "../chunk-DEFRRPXB.js";
-import "../chunk-YYYRPQHB.js";
+} from "../chunk-7IEUTLHY.js";
 import "../chunk-FMVNQKZL.js";
+import "../chunk-YYYRPQHB.js";
 import "../chunk-3K2MFXCO.js";
 export {
   bybitWallet

package/dist/wallets/walletConnectors/clvWallet/clvWallet.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   clvWallet
-} from "../chunk-5TN5Z2WY.js";
-import "../chunk-YYYRPQHB.js";
+} from "../chunk-3ZJN3PXP.js";
 import "../chunk-FMVNQKZL.js";
+import "../chunk-YYYRPQHB.js";
 import "../chunk-3K2MFXCO.js";
 export {
   clvWallet

package/dist/wallets/walletConnectors/coin98Wallet/coin98Wallet.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   coin98Wallet
-} from "../chunk-XVBSJCW5.js";
-import "../chunk-YYYRPQHB.js";
+} from "../chunk-RZQ4B4Z7.js";
 import "../chunk-FMVNQKZL.js";
+import "../chunk-YYYRPQHB.js";
 import "../chunk-3K2MFXCO.js";
 export {
   coin98Wallet

package/dist/wallets/walletConnectors/coreWallet/coreWallet.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   coreWallet
-} from "../chunk-V6UOWTEZ.js";
-import "../chunk-YYYRPQHB.js";
+} from "../chunk-55VS2NKG.js";
 import "../chunk-FMVNQKZL.js";
+import "../chunk-YYYRPQHB.js";
 import "../chunk-3K2MFXCO.js";
 export {
   coreWallet

package/dist/wallets/walletConnectors/foxWallet/foxWallet.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   foxWallet
-} from "../chunk-ZPSPK6LH.js";
-import "../chunk-YYYRPQHB.js";
+} from "../chunk-YGMU5VWD.js";
 import "../chunk-FMVNQKZL.js";
+import "../chunk-YYYRPQHB.js";
 import "../chunk-3K2MFXCO.js";
 export {
   foxWallet

package/dist/wallets/walletConnectors/frontierWallet/frontierWallet.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   frontierWallet
-} from "../chunk-UDTBQV4Q.js";
-import "../chunk-YYYRPQHB.js";
+} from "../chunk-J3PJOMO7.js";
 import "../chunk-FMVNQKZL.js";
+import "../chunk-YYYRPQHB.js";
 import "../chunk-3K2MFXCO.js";
 export {
   frontierWallet

package/dist/wallets/walletConnectors/gateWallet/gateWallet.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   gateWallet
-} from "../chunk-VJZWNQOF.js";
-import "../chunk-YYYRPQHB.js";
+} from "../chunk-LEAZMT5Y.js";
 import "../chunk-FMVNQKZL.js";
+import "../chunk-YYYRPQHB.js";
 import "../chunk-3K2MFXCO.js";
 export {
   gateWallet