@funkit/connect 9.11.0 → 9.12.0

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

@@ -3,9 +3,25 @@
  *
  * Extracted from WithdrawalContent.tsx to keep Lighter-specific logic isolated.
  */
+import type { LighterAccountIndex } from '@funkit/api-base';
 import React from 'react';
 import type { CustomWithdrawalConfig, WalletWithdrawalConfig } from '../../providers/FunkitCheckoutContext';
 import type { SourceTokenOption } from './WithdrawAmountInput';
+/** Free (withdrawable) balance for a single Lighter asset: balance - locked. */
+export declare function freeBalance(balance: string, lockedBalance: string): string;
+/**
+ * Fetches all asset balances for a Lighter account. Returns:
+ *
+ * - `balances` — `Record<SYMBOL, freeBalance>` (uppercased symbol keys)
+ * - `assets` — raw asset list from the API (for building source-token options)
+ */
+export declare function useLighterWithdrawalBalances({ accountIndex, }: {
+    accountIndex: LighterAccountIndex | undefined;
+}): {
+    balances: Record<string, string>;
+    assets: import("../../utils/customer").LighterAsset[];
+    isLoading: boolean;
+};
 type FunkitWithdrawalConfig = WalletWithdrawalConfig | CustomWithdrawalConfig;
 /**
  * Resolves the Lighter `asset_id` for a selected source token symbol. Returns

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

@@ -3,7 +3,7 @@ import React, { type ReactNode } from 'react';
 import type { Address } from 'viem';
 import { type PaymentMethodInfo } from '../../domains/paymentMethods';
 import type { AssetHoldingsItem } from '../../utils/assets';
-import type { WithdrawalClient } from '../../wallets/Wallet';
+import type { WithdrawalClient, WithdrawalTransaction } from '../../wallets/Wallet';
 import { type FunkitCheckoutQuoteResult } from '../FunkitHistoryContext';
 import type { FunkitActiveCheckoutItem, FunkitActiveWithdrawalItem, FunkitCheckoutConfig, FunkitWithdrawalConfig, UseFunkitCheckoutProps, UseFunkitCheckoutPropsWithFullConfig } from './types';
 export * from './types';
@@ -25,7 +25,7 @@ interface FunkitCheckoutContextInterface {
     }): void;
     updateSelectedPaymentMethodInfo(newPaymentMethodInfo: PaymentMethodInfo): void;
     updateCustomRecipient: (recipient: Address) => void;
-    confirmCheckout(quote: FunkitCheckoutQuoteResult, stepMessageSetter: (m: string) => void, withdrawalClient?: WithdrawalClient): Promise<Address>;
+    confirmCheckout(quote: FunkitCheckoutQuoteResult, stepMessageSetter: (m: string) => void, withdrawalClient?: WithdrawalClient, preWithdrawalTxs?: WithdrawalTransaction[]): Promise<Address>;
     cancelCheckout(depositAddress: Address): Promise<boolean>;
     /** @deprecated to be removed after quote migration is finished (historically named setCheckoutQuote) */
     setCheckout: (checkout: FunkitActiveCheckoutItem) => void;

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

@@ -4,7 +4,7 @@ import type { ReactNode } from 'react';
 import type { Address } from 'viem';
 import type { PaymentMethodInfo } from '../../domains/paymentMethods';
 import type { CheckoutBlockedReason } from '../../modals/CheckoutModal/CheckoutBlockedReason';
-import type { WithdrawalClient } from '../../wallets/Wallet';
+import type { WithdrawalClient, WithdrawalTransaction } from '../../wallets/Wallet';
 import type { FunkitCheckoutQuoteResult } from '../FunkitHistoryContext';
 export type FunkitCheckoutActionParams = ApiFunkitCheckoutActionParams;
 export interface TokenInfo {
@@ -120,6 +120,26 @@ export interface WithdrawalConfigBase {
 export interface WalletWithdrawalConfig extends WithdrawalConfigBase {
     /** Wallet instance used to execute the quote */
     wallet: WithdrawalClient;
+    /**
+     * Optional async hook that runs **before** the SDK executes the wallet-based
+     * withdrawal quote. Return any transactions that must execute as part of the
+     * withdrawal flow *prior* to the SDK's withdrawal transaction (e.g. an
+     * `approve` and a custom-collateral `unwrap` that produces the source token).
+     *
+     * The SDK atomically prepends the returned array to the withdrawal txn(s)
+     * via the integrator's `wallet.sendTransactions` primitive, so the
+     * approve/unwrap and the withdrawal land in a single user signature.
+     *
+     * Return `[]` if no extra transactions are required — the hook is then
+     * purely a side-effect / preflight step.
+     *
+     * Throw to abort the withdrawal — the thrown error message is surfaced to
+     * the user in the standard error UI.
+     *
+     * Mutually exclusive with {@link CustomWithdrawalConfig['withdrawCallback']}
+     * by virtue of living on a different config variant.
+     */
+    preWithdrawalAction?: (param: WithdrawalParam) => Promise<WithdrawalTransaction[]>;
 }
 export interface CustomWithdrawalConfig extends WithdrawalConfigBase {
     /**

package/dist/providers/FunkitStatsigProvider.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { ReactNode } from 'react';
+export declare const STATSIG_CLIENT_KEY: "client-UmFd8WIJljA7cLmZuDqs3X25M8sKd5WIQP4BSC2bRbM";
 interface FunkitStatsigProviderProps {
     children: ReactNode;
     isDevelopment?: boolean;

package/dist/utils/statsig/checkFeatureGate.d.ts

@@ -0,0 +1,19 @@
+import fallbackFeatureGates from '../../__generated__/default_feature_gates';
+type FeatureGateName = keyof typeof fallbackFeatureGates;
+/**
+ * Synchronous, non-hook variant of {@link useFeatureGate}. Reads the gate
+ * value directly from the connect package's Statsig client singleton.
+ *
+ * Use this from non-React contexts (event handlers, async callbacks created
+ * outside render) where calling a hook is not possible. Behavior:
+ * - Returns the live gate value once `FunkitStatsigProvider`'s async init
+ *   has resolved (typical case for event-driven calls — by the time a user
+ *   clicks a button, init has long since completed).
+ * - Returns the bundled default if called before init completes or if the
+ *   provider has not been mounted (graceful fallback rather than throw).
+ *
+ * For render-time consumers, prefer {@link useFeatureGate} so the consumer
+ * re-renders when values update mid-session.
+ */
+export declare function checkFeatureGate(name: FeatureGateName): boolean;
+export {};

package/dist/wallets/Wallet.d.ts

@@ -108,6 +108,17 @@ export interface WithdrawalClient {
     getChainId: () => Promise<number>;
     switchChain: (chainId: number) => Promise<void>;
     sendTransaction: (chainId: number, transaction: WithdrawalTransaction) => Promise<string>;
+    /**
+     * Optional batched submitter. When provided, the SDK collapses approve +
+     * swap/deposit steps into a single user signature via this method (e.g.
+     * EIP-5792 `wallet_sendCalls` with `forceAtomic`).
+     *
+     * Must return a tx hash that {@link confirmTransaction} can wait on.
+     * Implementations using `wallet_sendCalls` should map the calls-id back to
+     * the underlying tx hash via `waitForCallsStatus` →
+     * `receipts[0].transactionHash`.
+     */
+    sendTransactions?: (chainId: number, transactions: WithdrawalTransaction[]) => Promise<string>;
     confirmTransaction: (txHash: string, chainId: number) => Promise<TransactionReceipt>;
     address: () => string;
 }

package/dist/wallets/walletConnectors/index.js

@@ -14,9 +14,6 @@ import {
 import {
   tokenPocketWallet
 } from "./chunk-HXWUH73P.js";
-import {
-  tokenaryWallet
-} from "./chunk-R7X5RIO7.js";
 import {
   trustWallet
 } from "./chunk-T4ROGPMF.js";
@@ -30,8 +27,11 @@ import {
   xdefiWallet
 } from "./chunk-KSNA53EX.js";
 import {
-  rabbyWallet
-} from "./chunk-7PVUEV4M.js";
+  tokenaryWallet
+} from "./chunk-R7X5RIO7.js";
+import {
+  frameWallet
+} from "./chunk-MTJIPVYB.js";
 import {
   rainbowWallet
 } from "./chunk-LCIPVVH5.js";
@@ -53,9 +53,6 @@ import {
 import {
   subWallet
 } from "./chunk-APHCF4DT.js";
-import {
-  metaMaskWallet
-} from "./chunk-7V33VJAL.js";
 import {
   mewWallet
 } from "./chunk-DP5ICBEB.js";
@@ -77,12 +74,12 @@ import {
 import {
   phantomWallet
 } from "./chunk-57GN4W23.js";
+import {
+  rabbyWallet
+} from "./chunk-7PVUEV4M.js";
 import {
   foxWallet
 } from "./chunk-ZPSPK6LH.js";
-import {
-  frameWallet
-} from "./chunk-MTJIPVYB.js";
 import {
   frontierWallet
 } from "./chunk-UDTBQV4Q.js";
@@ -102,11 +99,14 @@ import {
   ledgerWallet
 } from "./chunk-V4EXM3KB.js";
 import {
-  braveWallet
-} from "./chunk-XVH4JIXB.js";
+  metaMaskWallet
+} from "./chunk-7V33VJAL.js";
 import {
   clvWallet
 } from "./chunk-5TN5Z2WY.js";
+import {
+  braveWallet
+} from "./chunk-XVH4JIXB.js";
 import {
   coin98Wallet
 } from "./chunk-XVBSJCW5.js";
@@ -116,24 +116,24 @@ import {
 import {
   coreWallet
 } from "./chunk-V6UOWTEZ.js";
-import {
-  dawnWallet
-} from "./chunk-PARFRRNI.js";
 import {
   desigWallet
 } from "./chunk-TNVLCMJD.js";
+import {
+  dawnWallet
+} from "./chunk-PARFRRNI.js";
 import {
   enkryptWallet
 } from "./chunk-2DKNXOPL.js";
+import {
+  bitgetWallet
+} from "./chunk-YIEASHLS.js";
 import {
   argentWallet
 } from "./chunk-XTD6OMZP.js";
 import {
   bifrostWallet
 } from "./chunk-6DRCY52E.js";
-import {
-  bitgetWallet
-} from "./chunk-YIEASHLS.js";
 import {
   bitskiWallet
 } from "./chunk-Y36HPFB3.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funkit/connect",
-  "version": "9.11.0",
+  "version": "9.12.0",
   "description": "Funkit Connect SDK elevates DeFi apps via web2 sign-ins and one-click checkouts.",
   "files": [
     "dist",
@@ -47,11 +47,11 @@
   "devDependencies": {
     "@aws-sdk/client-cloudfront": "3.1033.0",
     "@aws-sdk/client-s3": "3.1001.0",
-    "@chromatic-com/storybook": "^4.1.3",
+    "@chromatic-com/storybook": "^5.1.2",
     "@statsig/statsig-node-core": "^0.11.1",
-    "@storybook/addon-docs": "^9.1.19",
-    "@storybook/addon-links": "^10.1.3",
-    "@storybook/react-vite": "^9.1.19",
+    "@storybook/addon-docs": "^10.3.6",
+    "@storybook/addon-links": "^10.3.6",
+    "@storybook/react-vite": "^10.3.6",
     "@testing-library/jest-dom": "^6.2.0",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.5.2",
@@ -60,8 +60,8 @@
     "@vanilla-extract/css-utils": "^0.1.4",
     "@vanilla-extract/esbuild-plugin": "^2.3.16",
     "@vanilla-extract/private": "^1.0.7",
-    "@vanilla-extract/vite-plugin": "^5.0.3",
-    "@vitejs/plugin-react": "^5.1.2",
+    "@vanilla-extract/vite-plugin": "^5.2.2",
+    "@vitejs/plugin-react": "^5.2.0",
     "autoprefixer": "^10.4.27",
     "buffer": "^6.0.3",
     "dotenv": "^17.2.3",
@@ -71,13 +71,13 @@
     "postcss-prefix-selector": "^1.16.0",
     "process": "^0.11.10",
     "react": "^19.0.0",
-    "storybook": "^9.1.19",
+    "storybook": "^10.3.6",
     "stream-browserify": "^3.0.0",
     "tsc-alias": "1.8.16",
     "tsx": "^4.19.2",
     "util": "^0.12.5",
-    "vite-plugin-node-polyfills": "^0.24.0",
-    "vitest": "^4.0.18",
+    "vite-plugin-node-polyfills": "^0.26.0",
+    "vitest": "^4.1.6",
     "wagmi": "2.17.2"
   },
   "dependencies": {
@@ -89,7 +89,7 @@
     "@radix-ui/react-dropdown-menu": "^2.1.7",
     "@radix-ui/react-tooltip": "^1.2.0",
     "@solana/addresses": "^2.1.0",
-    "@statsig/react-bindings": "^3.25.4",
+    "@statsig/react-bindings": "3.25.4",
     "@types/uuid": "^9.0.8",
     "@vanilla-extract/css": "1.15.3",
     "@vanilla-extract/dynamic": "2.1.0",
@@ -105,10 +105,10 @@
     "ua-parser-js": "^1.0.37",
     "use-debounce": "^10.0.5",
     "uuid": "^9.0.1",
-    "@funkit/api-base": "4.2.1",
-    "@funkit/chains": "1.1.2",
-    "@funkit/utils": "3.0.0",
-    "@funkit/fun-relay": "2.7.0"
+    "@funkit/api-base": "4.2.2",
+    "@funkit/chains": "1.1.3",
+    "@funkit/fun-relay": "2.7.1",
+    "@funkit/utils": "3.0.1"
   },
   "repository": {
     "type": "git",