@funkit/connect 9.28.1 → 10.0.0

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # @funkit/connect
 
+## 10.0.0
+
+### Major Changes
+
+- 6eb4e0d: fix(connect): isolate i18next in a private instance so the SDK no longer initializes or mutates the host app's global i18next singleton
+
+  Previously `@funkit/connect` called `i18n.use(initReactI18next).init()` on the shared i18next **default singleton** at import time (and `changeLanguage()` on it at runtime via `FunkitI18nProvider`). Because bundlers dedupe i18next to a single instance, this let the SDK "take over" a host app's own i18next — surfacing as an intermittent, build-order-dependent i18next takeover under webpack.
+
+  The SDK now creates its own instance via `i18next.createInstance()` and no longer registers `initReactI18next`, so importing or rendering funkit never touches your app's i18next or react-i18next's module-global defaults.
+
+  Migration: if you imported the `i18n` export from `@funkit/connect` expecting it to be your app's shared i18next singleton, it is now a private, funkit-scoped instance — configure your own i18next for your app. Set the SDK's language via the `locale` prop on `FunkitProvider` as documented.
+
+### Patch Changes
+
+- a806298: Show a subtle note under the Cash header instead of a large error state when no cash-out methods are available for withdrawal.
+- cac2d42: feat(connect): add cash app payment method
+- e81d5c2: chore: migrate connect consumers off the legacy CDN feature-flag runtime (Statsig is now the flag source)
+
+  - remove the unused `useIsTokenWhitelisted` hook (no remaining consumers)
+  - drop the `useFlags()` loading gate from `LoadingAccount` — checkout no longer blocks on legacy flag fetch
+  - inline `AssetSelectionBannerConfig` into `useNewTokenBanner` (already Statsig-backed) so it no longer depends on `~/utils/flags/types`
+
+  Internal-only — none of these symbols are public exports.
+
+- 9e0e045: chore: remove the legacy CDN feature-flag runtime now that Statsig is the flag source
+
+  The `FunkitFlagsProvider` (CDN-fetched flags with an offline fallback config) is no longer read by any consumer after the [3/n] migration. This removes it entirely:
+
+  - unmount `FunkitFlagsProvider` from `FunkitProvider`
+  - delete `FunkitFlagsProvider.tsx` and the `~/utils/flags/` module (`config`, `endpoint`, `impl`, `hash`, `types`)
+
+  Internal-only — none of these symbols were public exports. The old SDK flag config remains hosted on S3 for existing (pre-migration) consumers.
+
+- 4b8c04b: refactor(connect): consolidate Cash App into synthetic FOP, and warn on unexpected withdrawal synthetic FOP
+- 109a92c: fix(connect): use correct per-token decimals for Solana SPL tokens (USDC/USDT are 6, not 9)
+- 92fad39: refactor(connect): cleanup sourcechange handler logic
+- a78a301: feat(connect): finish Cash App flow
+- 4c446f9: Surface specific error messages for checkout quote failures
+- 5c1dd2b: feat(connect): add Cash App payment method flow
+- d6e6900: refactor: narrow ts types and clean up ternary checks on lightning invoice qrcode
+- c20374e: Broaden WithdrawAmountInput snapshot coverage (insufficient-balance error, USD equivalent). Test-only; no runtime change.
+- 42461ff: Broaden WithdrawContent snapshot coverage (quote loading/error, risk, blacklist, Lighter Fast). Test-only; no runtime change.
+- d1223b9: Add unit test coverage for getErrorNotification mapping and error-source precedence. Test-only; no runtime change.
+- Updated dependencies [cac2d42]
+- Updated dependencies [4b8c04b]
+- Updated dependencies [79c92ec]
+- Updated dependencies [16cc96f]
+- Updated dependencies [4c446f9]
+- Updated dependencies [d27111c]
+  - @funkit/connect-core@1.6.1
+  - @funkit/chains@2.1.3
+  - @funkit/api-base@6.0.0
+
 ## 9.28.1
 
 ### Patch Changes

package/dist/clients/{chunk-7LKK5QMZ.js → chunk-6PIIYPQK.js}

@@ -299,6 +299,12 @@ function createPaymentMethodInfo(params) {
         title: "Bitcoin Lightning",
         description: ""
       };
+    case PaymentMethod.CASH_APP_LIGHTNING:
+      return {
+        paymentMethod: PaymentMethod.CASH_APP_LIGHTNING,
+        title: "Cash App",
+        description: ""
+      };
     case PaymentMethod.VIRTUAL_BANK:
       return {
         paymentMethod: PaymentMethod.VIRTUAL_BANK,

package/dist/clients/{chunk-CGHPNWIF.js → chunk-E3USJY7A.js}

@@ -25,6 +25,7 @@ var DEFAULT_TEXT_CUSTOMIZATIONS = {
   tokensListTitle: "Your tokens",
   transferTokens: "Transfer Crypto",
   bitcoinLightning: "Bitcoin Lightning",
+  cashAppLightning: "Cash App",
   receiveDropdownTitle: "",
   // Default to empty
   receiveDropdownLabel: "Asset to Receive",
@@ -112,6 +113,7 @@ function useFunkitConfig() {
       tokensListTitle: t("textCustomizations.tokensListTitle"),
       transferTokens: t("textCustomizations.transferTokens"),
       bitcoinLightning: t("textCustomizations.bitcoinLightning"),
+      cashAppLightning: t("textCustomizations.cashAppLightning"),
       receiveDropdownTitle: t("textCustomizations.receiveDropdownTitle"),
       receiveDropdownLabel: t("textCustomizations.receiveDropdownLabel"),
       confirmationScreen: {

package/dist/clients/{chunk-TQVRP3Z2.js → chunk-YFHTV7DT.js}

@@ -8,7 +8,7 @@ import {
   VAULT_DEPOSITOR_ABI,
   VAULT_DEPOSITOR_POLYGON,
   createPerpsGenerateActionParams
-} from "./chunk-7LKK5QMZ.js";
+} from "./chunk-6PIIYPQK.js";
 
 // src/clients/polymarket/createPolymarketDepositConfig.ts
 import { encodeFunctionData, erc20Abi, getAddress, maxUint256 } from "viem";

package/dist/clients/{chunk-4O4YAFYK.js → chunk-ZAXSDMDU.js}

@@ -3,7 +3,7 @@ import {
   FunInput,
   FunSkeletonBlock,
   TooltipAnchorRefContext
-} from "./chunk-CGHPNWIF.js";
+} from "./chunk-E3USJY7A.js";
 import {
   Box,
   Text,
@@ -15,11 +15,11 @@ import {
 import {
   POLYMARKET_PERPS_ROUTING_ID,
   POLYMARKET_PREDICTIONS_ROUTING_ID
-} from "./chunk-TQVRP3Z2.js";
+} from "./chunk-YFHTV7DT.js";
 import {
   POLYGON_USDCE,
   PUSD_TOKEN
-} from "./chunk-7LKK5QMZ.js";
+} from "./chunk-6PIIYPQK.js";
 import {
   logger
 } from "./chunk-AHYOV7AV.js";

package/dist/clients/lighter.js

@@ -4,7 +4,7 @@ import {
 } from "./chunk-2NBYHUIW.js";
 import {
   useFunkitConfig
-} from "./chunk-CGHPNWIF.js";
+} from "./chunk-E3USJY7A.js";
 import {
   Box
 } from "./chunk-LUHEVXPD.js";

package/dist/clients/polymarket/PolymarketDepositAccountDropdown.js

@@ -1,13 +1,13 @@
 "use client";
 import {
   PolymarketDepositAccountDropdown
-} from "../chunk-4O4YAFYK.js";
-import "../chunk-CGHPNWIF.js";
+} from "../chunk-ZAXSDMDU.js";
+import "../chunk-E3USJY7A.js";
 import "../chunk-LUHEVXPD.js";
 import "../chunk-UPZNKPYU.js";
 import "../chunk-STLOQEN7.js";
-import "../chunk-TQVRP3Z2.js";
-import "../chunk-7LKK5QMZ.js";
+import "../chunk-YFHTV7DT.js";
+import "../chunk-6PIIYPQK.js";
 import "../chunk-AHYOV7AV.js";
 export {
   PolymarketDepositAccountDropdown

package/dist/clients/polymarket/createPolymarketDepositConfig.js

@@ -4,8 +4,8 @@ import {
   POLYMARKET_PREDICTIONS_ROUTING_ID,
   createPolymarketDepositConfig,
   createPredictionsGenerateActionParams
-} from "../chunk-TQVRP3Z2.js";
-import "../chunk-7LKK5QMZ.js";
+} from "../chunk-YFHTV7DT.js";
+import "../chunk-6PIIYPQK.js";
 import "../chunk-AHYOV7AV.js";
 export {
   POLYMARKET_PERPS_ROUTING_ID,

package/dist/clients/polymarket/index.js

@@ -1,8 +1,8 @@
 "use client";
 import {
   PolymarketDepositAccountDropdown
-} from "../chunk-4O4YAFYK.js";
-import "../chunk-CGHPNWIF.js";
+} from "../chunk-ZAXSDMDU.js";
+import "../chunk-E3USJY7A.js";
 import "../chunk-LUHEVXPD.js";
 import "../chunk-UPZNKPYU.js";
 import "../chunk-STLOQEN7.js";
@@ -11,7 +11,7 @@ import {
   POLYMARKET_PREDICTIONS_ROUTING_ID,
   createPolymarketDepositConfig,
   createPredictionsGenerateActionParams
-} from "../chunk-TQVRP3Z2.js";
+} from "../chunk-YFHTV7DT.js";
 import {
   AMOUNT_PLACEHOLDER,
   COLLATERAL_ONRAMP_ABI,
@@ -22,7 +22,7 @@ import {
   VAULT_DEPOSITOR_POLYGON,
   createPerpsGenerateActionParams,
   createPolymarketWithdrawalConfig
-} from "../chunk-7LKK5QMZ.js";
+} from "../chunk-6PIIYPQK.js";
 import "../chunk-AHYOV7AV.js";
 export {
   AMOUNT_PLACEHOLDER,

package/dist/clients/polymarket/polymarket.js

@@ -9,7 +9,7 @@ import {
   VAULT_DEPOSITOR_POLYGON,
   createPerpsGenerateActionParams,
   createPolymarketWithdrawalConfig
-} from "../chunk-7LKK5QMZ.js";
+} from "../chunk-6PIIYPQK.js";
 import "../chunk-AHYOV7AV.js";
 export {
   AMOUNT_PLACEHOLDER,

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

@@ -39,7 +39,9 @@ interface ConnectedPaymentMethodItemProps {
     disabled?: boolean;
 }
 export declare const AccountBalancePaymentMethodItem: ({ isSelected, showSelectedCheckmark, onSelect, targetChainId, testId, disabled, }: ConnectedPaymentMethodItemProps) => React.JSX.Element;
-export declare const BitcoinLightningPaymentMethodItem: ({ isActive, onClick, isClickable, customValueIcon, paymentIcon, }: PaymentMethodItemProps) => React.JSX.Element;
+export declare const BitcoinLightningPaymentMethodItem: ({ isActive, onClick, isClickable, customValueIcon, paymentIcon, isCashApp, }: PaymentMethodItemProps & {
+    isCashApp?: boolean;
+}) => React.JSX.Element;
 export declare const ActiveFiatAccountPaymentMethodItem: ({ isActive, onClick, paymentMethodInfo, customValueIcon, testId, disabled, }: BasePaymentMethodItemProps & {
     paymentMethodInfo: PaymentMethodVirtualBankInfo;
     testId?: string;

package/dist/domains/paymentMethods.d.ts

@@ -25,6 +25,9 @@ export interface PaymentMethodTokenTransferInfo extends PaymentMethodInfoBase {
 export interface PaymentMethodBitcoinLightningInfo extends PaymentMethodInfoBase {
     paymentMethod: PaymentMethod.BITCOIN_LIGHTNING;
 }
+export interface PaymentMethodCashAppLightningInfo extends PaymentMethodInfoBase {
+    paymentMethod: PaymentMethod.CASH_APP_LIGHTNING;
+}
 export interface PaymentMethodVirtualBankIncompleteInfo extends PaymentMethodInfoBase {
     paymentMethod: PaymentMethod.VIRTUAL_BANK;
     matchingFiatAccount: BridgeVirtualBankAccount | undefined;
@@ -43,7 +46,7 @@ export declare function isConnectablePaymentMethodInfo(value: unknown): value is
  * PaymentMethod enum (which also carries Swapped's iframe-only rails).
  */
 export declare function isBalanceLessPaymentMethod(paymentMethod: PaymentMethodInfo['paymentMethod']): boolean;
-export type PaymentMethodInfo = PaymentMethodCardInfo | PaymentMethodBrokerageInfo | PaymentMethodAccountInfo | PaymentMethodTokenTransferInfo | PaymentMethodBitcoinLightningInfo | PaymentMethodVirtualBankIncompleteInfo;
+export type PaymentMethodInfo = PaymentMethodCardInfo | PaymentMethodBrokerageInfo | PaymentMethodAccountInfo | PaymentMethodTokenTransferInfo | PaymentMethodBitcoinLightningInfo | PaymentMethodCashAppLightningInfo | PaymentMethodVirtualBankIncompleteInfo;
 interface CardPaymentMethodParams {
     paymentMethod: PaymentMethod.CARD;
     /** We also store client's customization in our database :( */
@@ -64,6 +67,9 @@ interface TokenTransferPaymentMethodParams {
 interface BitcoinLightningPaymentMethodParams {
     paymentMethod: PaymentMethod.BITCOIN_LIGHTNING;
 }
+interface CashAppLightningPaymentMethodParams {
+    paymentMethod: PaymentMethod.CASH_APP_LIGHTNING;
+}
 interface VirtualBankPaymentMethodIncompleteParams {
     paymentMethod: PaymentMethod.VIRTUAL_BANK;
     matchingFiatAccount: undefined;
@@ -78,6 +84,7 @@ export declare function createPaymentMethodInfo(params: CardPaymentMethodParams)
 export declare function createPaymentMethodInfo(params: AccountPaymentMethodParams): PaymentMethodAccountInfo;
 export declare function createPaymentMethodInfo(params: TokenTransferPaymentMethodParams): PaymentMethodTokenTransferInfo;
 export declare function createPaymentMethodInfo(params: BitcoinLightningPaymentMethodParams): PaymentMethodBitcoinLightningInfo;
+export declare function createPaymentMethodInfo(params: CashAppLightningPaymentMethodParams): PaymentMethodCashAppLightningInfo;
 export declare function createPaymentMethodInfo(params: VirtualBankPaymentMethodIncompleteParams): PaymentMethodVirtualBankIncompleteInfo;
 export declare function createPaymentMethodInfo(params: VirtualBankPaymentMethodParams): PaymentMethodVirtualBankInfo;
 export declare function createPaymentMethodInfo(params: BrokeragePaymentMethodParams): PaymentMethodBrokerageInfo;

package/dist/domains/relay.d.ts

@@ -1,5 +1,8 @@
 import type { FeeBreakdownV2 } from '@funkit/api-base';
+import { RelayQuoteError } from '@funkit/api-base';
 import type { RelayExecute, RelayQuote } from '@funkit/fun-relay';
+import type { TFunction } from 'i18next';
+import type { ReactNode } from 'react';
 export type RelayQuoteMetadata = {
     relayQuote: RelayQuote['metadata']['relayQuote'];
     feeBreakdown?: FeeBreakdownV2;
@@ -20,4 +23,41 @@ export declare function hasRelayQuoteUnitRate(details: RelayQuoteDetails): boole
  * transfer or a native token wrap operation.
  */
 export declare function isRelayPassthrough(details: RelayQuoteDetails): boolean;
+export declare enum RelayExpectedErrorCodes {
+    AMOUNT_TOO_LOW = "AMOUNT_TOO_LOW",
+    CHAIN_DISABLED = "CHAIN_DISABLED",
+    EXTRA_TXS_NOT_SUPPORTED = "EXTRA_TXS_NOT_SUPPORTED",
+    FORBIDDEN = "FORBIDDEN",
+    INSUFFICIENT_FUNDS = "INSUFFICIENT_FUNDS",
+    INSUFFICIENT_LIQUIDITY = "INSUFFICIENT_LIQUIDITY",
+    INVALID_ADDRESS = "INVALID_ADDRESS",
+    INVALID_EXTRA_TXS = "INVALID_EXTRA_TXS",
+    INVALID_GAS_LIMIT_FOR_DEPOSIT_SPECIFIED_TXS = "INVALID_GAS_LIMIT_FOR_DEPOSIT_SPECIFIED_TXS",
+    INVALID_INPUT_CURRENCY = "INVALID_INPUT_CURRENCY",
+    INVALID_OUTPUT_CURRENCY = "INVALID_OUTPUT_CURRENCY",
+    INVALID_SLIPPAGE_TOLERANCE = "INVALID_SLIPPAGE_TOLERANCE",
+    NO_INTERNAL_SWAP_ROUTES_FOUND = "NO_INTERNAL_SWAP_ROUTES_FOUND",
+    NO_QUOTES = "NO_QUOTES",
+    NO_SWAP_ROUTES_FOUND = "NO_SWAP_ROUTES_FOUND",
+    ROUTE_TEMPORARILY_RESTRICTED = "ROUTE_TEMPORARILY_RESTRICTED",
+    SANCTIONED_CURRENCY = "SANCTIONED_CURRENCY",
+    SANCTIONED_WALLET_ADDRESS = "SANCTIONED_WALLET_ADDRESS",
+    SWAP_IMPACT_TOO_HIGH = "SWAP_IMPACT_TOO_HIGH",
+    UNAUTHORIZED = "UNAUTHORIZED",
+    UNSUPPORTED_CHAIN = "UNSUPPORTED_CHAIN",
+    UNSUPPORTED_CURRENCY = "UNSUPPORTED_CURRENCY",
+    UNSUPPORTED_EXECUTION_TYPE = "UNSUPPORTED_EXECUTION_TYPE",
+    UNSUPPORTED_ROUTE = "UNSUPPORTED_ROUTE",
+    USER_RECIPIENT_MISMATCH = "USER_RECIPIENT_MISMATCH"
+}
+export declare enum RelayUnexpectedErrorCodes {
+    DESTINATION_TX_FAILED = "DESTINATION_TX_FAILED",
+    ERC20_ROUTER_ADDRESS_NOT_FOUND = "ERC20_ROUTER_ADDRESS_NOT_FOUND",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    SWAP_QUOTE_FAILED = "SWAP_QUOTE_FAILED",
+    PERMIT_FAILED = "PERMIT_FAILED"
+}
+export type RelayErrorCodes = RelayExpectedErrorCodes | RelayUnexpectedErrorCodes;
+export declare function getRelayErrorMessages(t: TFunction): Partial<Record<RelayErrorCodes, ReactNode>>;
+export declare function getRelayQuoteErrorDisplayMessage(error: RelayQuoteError, t: TFunction, fallback: ReactNode): ReactNode;
 export {};

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

@@ -17,4 +17,5 @@ export declare const useWithdrawFops: (params: {
 }) => {
     data: GetFopsResponse | undefined;
     isLoading: boolean;
+    isError: boolean;
 };

package/dist/hooks/useNewTokenBanner.d.ts

@@ -1,2 +1,7 @@
-import type { AssetSelectionBannerConfig } from '../utils/flags/types';
+export type AssetSelectionBannerConfig = {
+    chainId: number;
+    symbol: string;
+    name: string;
+    isChainNew?: boolean;
+};
 export declare function useNewTokenBanner(): AssetSelectionBannerConfig | undefined;

package/dist/hooks/usePaymentSources.d.ts

@@ -6,6 +6,7 @@ export declare function usePaymentMethodEnablement(): {
     isMeldEnabled: boolean;
     isBrokerageEnabled: boolean;
     isLightningEnabled: boolean;
+    isCashAppLightningEnabled: boolean;
 };
 export type PaymentMethodType = 'crypto' | 'fiat' | 'withdraw';
 export type UnavailablePaymentSource = {