@funkit/connect 9.11.0 → 9.13.0

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # @funkit/connect
 
+## 9.13.0
+
+### Minor Changes
+
+- ac8b104: Add `showWalletConnect` option to `uiCustomizations.sourceChangeScreen` to allow hiding the wallet connect payment method
+
+### Patch Changes
+
+- 01826fb: chore(connect): bump postcss
+- ab86ca3: refactor(connect): split `SourceList` into a thin composer + `FlatList`/`GroupedList` layout primitives. Internal-only; no public API change; rendered DOM unchanged.
+- 6039a1b: When `externalUserId` is set for Lighter customers, use it directly as `userId` and `walletAddress` instead of wrapping via `generateSyntheticUserId`
+- 3719658: Split useRecentDeposits into a raw API hook and a pure testable transform function
+- ce7e633: Internal: add `testId` prop to `SourceList` for testability.
+- 7743d5b: Extract withdrawal error notification helpers into ErrorMessage module
+- 7743d5b: Extract WithdrawRecipientAddress into its own module and allow multi-method config to disable connected wallet
+- 7743d5b: Use config source chain for withdrawal source token price lookup
+- Updated dependencies [ec97ba2]
+  - @funkit/fun-relay@2.7.2
+
+## 9.12.0
+
+### Minor Changes
+
+- ad8ebdf: Add gated combined-input overload to `createPolymarketWithdrawalConfig`. Pass both UDA and wallet-unwrap params; dispatch is decided at call time by the `enable-polymarket-wallet-withdrawal` Statsig gate. Single-flow overloads are now `@deprecated`.
+- d9973bf: Add wallet-unwrap variant to `createPolymarketWithdrawalConfig` that encapsulates the pUSD → USDCe approve+unwrap and atomically batches it with the SDK's withdrawal transaction
+- 1c4b50a: feat(connect): add `preWithdrawalAction` hook to `WalletWithdrawalConfig`
+- 5a03929: feat(connect): add optional `sendTransactions` to `WithdrawalClient` for EIP-5792 atomic batching of approve + swap/deposit steps
+
+### Patch Changes
+
+- 99062ff: chore(deps): bump vite to v8, vitest to 4.1.6, and storybook to v10
+- 37cb800: feat(connect): improve swapped iframe skeleton loader
+- ba2c3fa: Improved analytics for `createPolymarketWithdrawalConfig`.
+- d9973bf: Lower wallet-unwrap variant of `createPolymarketWithdrawalConfig` minimum withdrawal to 0 USD
+- 868ad27: Move useLighterWithdrawalBalances hook out of client entry into withdrawal modal
+- 57f89a9: fix(connect): fix swapped iframe height
+- fb64077: feat(connect): add notification banner text animations
+- b592df7: Use config source chain for Lighter Secure withdrawal source token price lookup
+- Updated dependencies [99062ff]
+  - @funkit/api-base@4.2.2
+  - @funkit/utils@3.0.1
+  - @funkit/chains@1.1.3
+  - @funkit/fun-relay@2.7.1
+
 ## 9.11.0
 
 ### Minor Changes
@@ -22,6 +66,17 @@
 - Updated dependencies [81e367b]
   - @funkit/api-base@4.2.1
 
+## 9.11.0-next.0
+
+### Minor Changes
+
+- 2bf3417: feat(connect): add Rolly deposit actions factory via VaultDepositor
+
+### Patch Changes
+
+- Updated dependencies [2bf3417]
+  - @funkit/api-base@4.2.1-next.0
+
 ## 9.10.0
 
 ### Minor Changes

package/README.md

@@ -10,3 +10,24 @@ The `@funkit/connect` package elevates decentralize applications via web2 & web3
 ### 📝 Note
 
 This package is currently in closed beta. To learn more, reach out to [developers@fun.xyz](mailto:developers@fun.xyz).
+
+## Development
+
+### Running tests
+
+From the monorepo root:
+
+```bash
+# Run all connect tests once
+pnpm --filter=@funkit/connect test
+
+# Run with coverage (terminal summary + lcov + HTML report)
+pnpm --filter=@funkit/connect test:coverage
+
+# Open the Vitest UI (interactive dashboard with live coverage heatmap)
+pnpm --filter=@funkit/connect test:ui
+```
+
+After `test:coverage`, open `packages/connect/coverage/index.html` to browse the HTML report. The `coverage/` directory is gitignored.
+
+Coverage is collected by [`@vitest/coverage-v8`](https://vitest.dev/guide/coverage) and excludes generated files, Storybook stories, vanilla-extract style files (`*.css.ts`), and translation JSON. Update the `coverage` block in `vitest.config.ts` to tweak include/exclude patterns.

package/dist/__generated__/default_feature_gates.d.ts

@@ -3,6 +3,7 @@ declare const _default: {
     readonly 'enable-across-wallet-flow': false;
     readonly 'enable-empty-withdrawal-selection': false;
     readonly 'enable-permit-toggle': false;
+    readonly 'enable-polymarket-wallet-withdrawal': false;
     readonly 'enable-swapped-exchanges': false;
     readonly 'exact-in': false;
     readonly 'faster-notifications': false;

package/dist/clients/lighter.d.ts

@@ -13,7 +13,6 @@
  * Both callbacks conform to CustomWithdrawalConfig.withdrawCallback; the
  * caller provides the actual on-chain implementation.
  */
-import type { LighterAccountIndex } from '@funkit/api-base';
 import type { Address } from 'viem';
 import type { CustomWithdrawalConfig, MultiMethodWithdrawalConfig } from '../providers/FunkitCheckoutContext/types';
 export type LighterTransferParams = {
@@ -94,21 +93,6 @@ export interface LighterSecureWithdrawalConfig {
      */
     getMinWithdrawalAmount?: (symbol: string) => number;
 }
-/** 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;
-};
 /** Single-method config for Lighter's Secure withdrawal (bridge to Ethereum). */
 export declare function createLighterSecureWithdrawalConfig(config: LighterSecureWithdrawalConfig): CustomWithdrawalConfig;
 /**
@@ -118,8 +102,6 @@ export declare function createLighterSecureWithdrawalConfig(config: LighterSecur
  *
  * The hook owns every Lighter-specific concern that requires React context:
  *   - the user's Lighter account index (resolved from `config.l1Address`)
- *   - all Lighter asset balances (so the form validates against the real
- *     account)
  *   - the live Secure-withdrawal delay (`/api/v1/withdrawalDelay`)
  *   - the active locale (so the disclaimer renders correctly)
  *

package/dist/clients/lighter.js

@@ -14,7 +14,7 @@ import { RELAY_LIGHTER_CHAIN_ID } from "@funkit/fun-relay";
 import { retry } from "@lifeomic/attempt";
 import { useQuery as useQuery2 } from "@tanstack/react-query";
 import i18next from "i18next";
-import React2, { useEffect, useMemo as useMemo2 } from "react";
+import React2, { useMemo as useMemo2 } from "react";
 import { arbitrum, base, bsc, mainnet as mainnet2, optimism } from "viem/chains";
 
 // src/components/Icons/EvmWallet.tsx
@@ -120,6 +120,7 @@ var DEFAULT_UI_CUSTOMIZATIONS = {
     },
     showTargetAssetSelection: false,
     showWalletOnInsufficientBalance: false,
+    showWalletConnect: true,
     paymentMethodIcons: {}
   },
   inputAmountScreen: {
@@ -249,42 +250,6 @@ async function getLighterAccountsByL1Address(address) {
   const data = await response.json();
   return data;
 }
-async function getLighterAccount(lookup, activeOnly) {
-  const params = new URLSearchParams({
-    by: lookup.by,
-    value: String(lookup.value),
-    ...activeOnly !== void 0 && { active_only: String(activeOnly) }
-  });
-  const response = await fetch(
-    `https://mainnet.zklighter.elliot.ai/api/v1/account?${params}`
-  );
-  if (!response.ok) {
-    throw new Error(`Failed to fetch lighter account: ${response.statusText}`);
-  }
-  return response.json();
-}
-function useLighterAccount(lookup, options) {
-  const { apiKey } = useFunkitConfig();
-  const isLighter = isLighterxyzCustomer(apiKey);
-  const enabled = isLighter && lookup !== null && (lookup.by === "index" ? true : !!lookup.value && lookup.value !== "0x");
-  const query = useQuery({
-    queryKey: [
-      "lighterAccount",
-      lookup?.by,
-      lookup?.value,
-      options?.activeOnly
-    ],
-    // biome-ignore lint/style/noNonNullAssertion: already checked for null
-    queryFn: () => getLighterAccount(lookup, options?.activeOnly),
-    enabled,
-    staleTime: 3e4,
-    retry: false
-  });
-  return {
-    ...query,
-    account: query.data?.accounts?.[0]
-  };
-}
 function useLighterAccounts({
   address
 }) {
@@ -488,48 +453,6 @@ var LIGHTER_DEFAULT_SECURE_MIN_WITHDRAWAL_AMOUNTS = {
   LDO: 2,
   AZTEC: 100
 };
-function freeBalance(balance, lockedBalance) {
-  return String(Math.max(0, Number(balance) - Number(lockedBalance)));
-}
-function useLighterWithdrawalBalances({
-  accountIndex
-}) {
-  const { account, isLoading, error } = useLighterAccount(
-    accountIndex ? { by: "index", value: accountIndex } : null
-  );
-  useEffect(() => {
-    logger.debug("lighter:withdrawal:balances:query", {
-      accountIndex,
-      isLoading,
-      hasAccount: !!account,
-      error: error instanceof Error ? error.message : error
-    });
-  }, [accountIndex, isLoading, account, error]);
-  const balances = useMemo2(() => {
-    if (!account) {
-      return {};
-    }
-    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);
-    }
-    result.USDC = account.total_asset_value;
-    logger.info("lighter:withdrawal:balances:resolved", {
-      accountIndex,
-      balances: result
-    });
-    return result;
-  }, [account, accountIndex]);
-  return {
-    balances,
-    assets: account?.assets ?? [],
-    isLoading
-  };
-}
 function buildSecureWithdrawalCallback({
   exec
 }) {
@@ -660,7 +583,6 @@ function buildLighterMultiMethodConfig({
   config,
   accountIndex,
   t,
-  withBalance,
   secureDelayText
 }) {
   const fastConfig = buildLighterFastWalletWithdrawalConfig({
@@ -690,12 +612,7 @@ function buildLighterMultiMethodConfig({
     subtitleText: t("withdrawal.fastDisclaimer"),
     icon: /* @__PURE__ */ React2.createElement(EvmWallet, { size: 20 }),
     valueIcon: /* @__PURE__ */ React2.createElement(ChainIconStack, { chainIds: LIGHTER_FAST_PREVIEW_CHAIN_IDS }),
-    config: withBalance ? {
-      ...fastConfig,
-      withdrawalSourceTokenBalance: withBalance(
-        fastConfig.sourceTokenSymbol
-      )
-    } : fastConfig
+    config: fastConfig
   };
   const secure = {
     id: "lighter-secure",
@@ -708,12 +625,7 @@ function buildLighterMultiMethodConfig({
     }),
     icon: /* @__PURE__ */ React2.createElement(EvmWallet, { size: 20 }),
     valueIcon: /* @__PURE__ */ React2.createElement(ChainIconStack, { chainIds: LIGHTER_SECURE_PREVIEW_CHAIN_IDS }),
-    config: withBalance ? {
-      ...secureConfig,
-      withdrawalSourceTokenBalance: withBalance(
-        secureConfig.sourceTokenSymbol
-      )
-    } : secureConfig
+    config: secureConfig
   };
   return {
     modalTitle: config.modalTitle ?? t("withdrawal.withdraw"),
@@ -727,9 +639,6 @@ function useLighterWithdrawalConfig(config) {
     address: config?.l1Address
   });
   const accountIndex = mainAccountIndex && /^\d+$/.test(mainAccountIndex) ? mainAccountIndex : void 0;
-  const { balances } = useLighterWithdrawalBalances({
-    accountIndex
-  });
   const secureDelayText = useLighterSecureDelayText();
   return useMemo2(() => {
     if (!config || !accountIndex) {
@@ -739,15 +648,12 @@ function useLighterWithdrawalConfig(config) {
       config,
       accountIndex,
       t,
-      withBalance: (symbol) => () => balances[symbol.toUpperCase()] ?? "0",
       secureDelayText
     });
-  }, [config, accountIndex, balances, t, secureDelayText]);
+  }, [config, accountIndex, t, secureDelayText]);
 }
 export {
   LIGHTER_DEFAULT_SECURE_MIN_WITHDRAWAL_AMOUNTS,
   createLighterSecureWithdrawalConfig,
-  freeBalance,
-  useLighterWithdrawalBalances,
   useLighterWithdrawalConfig
 };

package/dist/clients/polymarket.d.ts

@@ -1,15 +1,23 @@
 /**
  * Polymarket V2 PMCT withdrawal.
  *
- * Withdrawal flow:
- * 1. Generate a UDA (User Deposit Address) for the withdrawal via api-base
- * 2. Transfer PMCT from user's Polymarket proxy to the UDA
- * 3. Backend handles: unwrap PMCT → USDC via PermissionedRamp + route to user
+ * Two flows are supported, dispatched on input shape:
  *
- * The callback conforms to CustomWithdrawalConfig.withdrawCallback.
+ *   1. **UDA / PMCT transfer** (legacy) — caller supplies `userId` +
+ *      `sendPmctTransfer`. The backend handles the unwrap/route via
+ *      PermissionedRamp. Returns a {@link CustomWithdrawalConfig}.
+ *
+ *   2. **Wallet unwrap** — caller supplies `proxyAddress`, a `publicClient`,
+ *      and a batched `sendTransactions` primitive. `preWithdrawalAction`
+ *      reads the pUSD allowance and returns the approve (when needed) +
+ *      `unwrap()` to USDCe as an array of {@link WithdrawalTransaction}s.
+ *      The SDK prepends those to the withdrawal txn and atomically broadcasts
+ *      the batch via the integrator's `sendTransactions`. Returns a
+ *      {@link WalletWithdrawalConfig}.
  */
-import type { Address } from 'viem';
-import type { CustomWithdrawalConfig } from '../providers/FunkitCheckoutContext/types';
+import { type Address, type PublicClient, type TransactionReceipt } from 'viem';
+import type { CustomWithdrawalConfig, FunkitWithdrawalConfig, WalletWithdrawalConfig } from '../providers/FunkitCheckoutContext/types';
+import type { WithdrawalTransaction } from '../wallets/Wallet';
 export interface PolymarketWithdrawalCallbackConfig {
     userId: string;
     modalTitle?: string;
@@ -31,9 +39,69 @@ export interface PolymarketWithdrawalCallbackConfig {
     }) => Promise<void>;
 }
 /**
- * Creates a full CustomWithdrawalConfig for Polymarket V2 PMCT withdrawals.
+ * Caller-supplied batched submitter. Receives the full ordered list of txs
+ * (helper-injected approve+unwrap, then the SDK's withdrawal txn). Must
+ * broadcast them atomically in a single user signature and return a tx hash
+ * that {@link WithdrawalClient.confirmTransaction} can wait on.
+ */
+export type PolymarketSendTransactions = (txs: WithdrawalTransaction[]) => Promise<string>;
+export interface PolymarketWalletUnwrapWithdrawalConfig {
+    /** Polymarket proxy that holds pUSD and signs the batched tx. */
+    proxyAddress: Address;
+    /** Polygon public client used for the pre-flight allowance read. */
+    publicClient: PublicClient;
+    /**
+     * Batched send primitive. The SDK passes the full ordered list of txs —
+     * helper-emitted `approve(pUSD → offramp)` (only when allowance is
+     * insufficient) and `offramp.unwrap(USDCe, proxy, amount)` from
+     * `preWithdrawalAction`, followed by the withdrawal txn — and the
+     * integrator broadcasts them atomically in a single user signature.
+     */
+    sendTransactions: PolymarketSendTransactions;
+    /**
+     * Optional override for waiting on a tx receipt. Defaults to
+     * `publicClient.waitForTransactionReceipt`.
+     */
+    confirmTransaction?: (txHash: string, chainId: number) => Promise<TransactionReceipt>;
+    modalTitle?: string;
+    disableConnectedWallet?: boolean;
+    sourceTokenSymbol?: string;
+    sourceTokenAddress?: Address;
+    defaultReceiveToken?: string;
+    iconSrc?: string;
+}
+/**
+ * Combined input — supplies params for both flows. The runtime path is
+ * chosen at call time via the `enable-polymarket-wallet-withdrawal`
+ * Statsig gate (read synchronously through {@link checkFeatureGate}, so
+ * this stays a regular function callable from event handlers).
+ */
+export interface PolymarketWithdrawalConfig extends PolymarketWithdrawalCallbackConfig, PolymarketWalletUnwrapWithdrawalConfig {
+}
+/**
+ * Combined / gated entry point. Returns a {@link CustomWithdrawalConfig}
+ * (UDA path) or {@link WalletWithdrawalConfig} (wallet-unwrap path)
+ * depending on the gate value at call time.
+ *
+ * ```ts
+ * const withdrawalConfig = createPolymarketWithdrawalConfig({
+ *   userId: walletAddress,
+ *   sendPmctTransfer: async ({ udaAddress, amountBaseUnit }) => { ... },
+ *   proxyAddress,
+ *   publicClient,
+ *   sendTransactions: async (txs) => myBatchedSend(txs),
+ * })
+ * ```
+ */
+export declare function createPolymarketWithdrawalConfig(config: PolymarketWithdrawalConfig): FunkitWithdrawalConfig;
+/**
+ * Legacy UDA / PMCT transfer flow. Returns a {@link CustomWithdrawalConfig}.
+ *
+ * @deprecated Pass the combined {@link PolymarketWithdrawalConfig} instead so
+ * the wallet-unwrap rollout can be staged via the
+ * `enable-polymarket-wallet-withdrawal` Statsig gate. Direct callers of this
+ * single-flow overload bypass the gate.
  *
- * Usage:
  * ```ts
  * const withdrawalConfig = createPolymarketWithdrawalConfig({
  *   userId: walletAddress,
@@ -42,3 +110,23 @@ export interface PolymarketWithdrawalCallbackConfig {
  * ```
  */
 export declare function createPolymarketWithdrawalConfig(config: PolymarketWithdrawalCallbackConfig): CustomWithdrawalConfig;
+/**
+ * Wallet-flow with embedded pUSD → USDCe unwrap. Returns a
+ * {@link WalletWithdrawalConfig} whose `preWithdrawalAction` and `wallet`
+ * coordinate via a closure-scoped queue, so the integrator only sees the
+ * batched `sendTransactions` primitive.
+ *
+ * @deprecated Pass the combined {@link PolymarketWithdrawalConfig} instead so
+ * the wallet-unwrap rollout can be staged via the
+ * `enable-polymarket-wallet-withdrawal` Statsig gate. Direct callers of this
+ * single-flow overload bypass the gate.
+ *
+ * ```ts
+ * const withdrawalConfig = createPolymarketWithdrawalConfig({
+ *   proxyAddress,
+ *   publicClient,
+ *   sendTransactions: async (txs) => myBatchedSend(txs),
+ * })
+ * ```
+ */
+export declare function createPolymarketWithdrawalConfig(config: PolymarketWalletUnwrapWithdrawalConfig): WalletWithdrawalConfig;

package/dist/clients/polymarket.js

@@ -8,6 +8,11 @@ import {
   POLYMARKET_API_KEY,
   initializeCheckoutTokenTransferAddress
 } from "@funkit/api-base";
+import {
+  encodeFunctionData,
+  erc20Abi,
+  getAddress
+} from "viem";
 import { polygon } from "viem/chains";
 
 // src/domains/paymentMethods.ts
@@ -323,9 +328,71 @@ function generateClientMetadataForTokenTransfer() {
   };
 }
 
+// src/utils/statsig/checkFeatureGate.ts
+import { StatsigClient } from "@statsig/react-bindings";
+
+// src/providers/FunkitStatsigProvider.tsx
+import { datadogLogs } from "@datadog/browser-logs";
+import {
+  LogEventCompressionMode,
+  LogLevel,
+  StatsigProvider,
+  useClientAsyncInit
+} from "@statsig/react-bindings";
+import React8, { useEffect } from "react";
+var STATSIG_CLIENT_KEY = "client-UmFd8WIJljA7cLmZuDqs3X25M8sKd5WIQP4BSC2bRbM";
+
+// src/__generated__/default_feature_gates.ts
+var default_feature_gates_default = {
+  "compliance-review-blocker": false,
+  "enable-across-wallet-flow": false,
+  "enable-empty-withdrawal-selection": false,
+  "enable-permit-toggle": false,
+  "enable-polymarket-wallet-withdrawal": false,
+  "enable-swapped-exchanges": false,
+  "exact-in": false,
+  "faster-notifications": false,
+  "new-token-transfer-config": false,
+  "new-withdrawal-config": false,
+  "polymarket-pusd-migration": false,
+  "saved-card-defaults-to-fiat-tab": false,
+  "test-testing-gate": false,
+  "wallet-flow-enable-exact-input-with-actions": false,
+  "you-receive-remove-swap-impact": false
+};
+
+// src/utils/statsig/checkFeatureGate.ts
+function checkFeatureGate(name) {
+  try {
+    return StatsigClient.instance(STATSIG_CLIENT_KEY).checkGate(name);
+  } catch (err) {
+    logger.warn("checkFeatureGate:error", { name, err });
+    return default_feature_gates_default[name];
+  }
+}
+
 // src/clients/polymarket.tsx
 var PMCT_WITHDRAW_ACTION_TYPE = "PMCT_WITHDRAW";
 var POLYGON_USDCE = "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174";
+var PUSD_TOKEN = {
+  address: getAddress("0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB"),
+  symbol: "pUSD",
+  iconSrc: "https://sdk-cdn.fun.xyz/images/pusd.svg"
+};
+var PUSD_OFFRAMP_ADDRESS = "0x2957922Eb93258b93368531d39fAcCA3B4dC5854";
+var PUSD_OFFRAMP_ABI = [
+  {
+    name: "unwrap",
+    type: "function",
+    inputs: [
+      { name: "_asset", type: "address" },
+      { name: "_to", type: "address" },
+      { name: "_amount", type: "uint256" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  }
+];
 function createPolymarketWithdrawalCallback(config) {
   const { userId, sendPmctTransfer } = config;
   return async (param) => {
@@ -351,24 +418,20 @@ function createPolymarketWithdrawalCallback(config) {
     });
     const udaAddress = transferInit.depositAddr;
     logger.info("polymarket:withdrawal:udaGenerated", { udaAddress });
-    const quote = funQuote;
-    const amountStr = quote?.baseQuote?.estTotalFromAmountBaseUnit;
-    if (!amountStr) {
-      logger.error("polymarket:withdrawal:missingAmountInQuote", { quote });
-      throw new Error("Missing withdrawal amount in quote");
-    }
-    const amount = BigInt(amountStr);
+    const amountBaseUnit = extractWithdrawalAmount(funQuote);
     await sendPmctTransfer({
       udaAddress,
-      amountBaseUnit: amount
+      amountBaseUnit
     });
     logger.info("polymarket:withdrawal:transferSubmitted", {
       udaAddress,
-      amountBaseUnit: amountStr
+      amountBaseUnit: amountBaseUnit.toString()
     });
+    return void 0;
   };
 }
-function createPolymarketWithdrawalConfig(config) {
+function buildUdaWithdrawalConfig(config) {
+  logger.info("polymarket:withdrawal:flow", { flow: "uda" });
   return {
     modalTitle: config.modalTitle ?? "Withdraw",
     disableConnectedWallet: config.disableConnectedWallet,
@@ -381,6 +444,114 @@ function createPolymarketWithdrawalConfig(config) {
     getMinWithdrawalUSD: () => 3
   };
 }
+function buildWalletUnwrapWithdrawalConfig(config) {
+  logger.info("polymarket:withdrawal:flow", { flow: "wallet-unwrap" });
+  const {
+    proxyAddress,
+    publicClient,
+    sendTransactions: callerSendTransactions,
+    confirmTransaction
+  } = config;
+  const wallet = {
+    address: () => proxyAddress,
+    getChainId: async () => polygon.id,
+    switchChain: async (chainId) => {
+      if (chainId !== polygon.id) {
+        throw new Error(
+          `Cannot switch chain: Polymarket withdrawal is fixed to ${polygon.id}, requested ${chainId}`
+        );
+      }
+    },
+    sendTransaction: async (_chainId, transaction) => callerSendTransactions([transaction]),
+    sendTransactions: async (_chainId, txs) => callerSendTransactions(txs),
+    confirmTransaction: confirmTransaction ?? (async (txHash) => publicClient.waitForTransactionReceipt({ hash: txHash }))
+  };
+  const preWithdrawalAction = async ({
+    funQuote
+  }) => {
+    logger.info("polymarket:withdrawal:wallet:start", { proxyAddress });
+    try {
+      const amountBaseUnit = extractWithdrawalAmount(funQuote);
+      const currentAllowance = await publicClient.readContract({
+        address: PUSD_TOKEN.address,
+        abi: erc20Abi,
+        functionName: "allowance",
+        args: [proxyAddress, PUSD_OFFRAMP_ADDRESS]
+      });
+      const needsApprovalTx = currentAllowance < amountBaseUnit;
+      logger.info("polymarket:withdrawal:wallet:allowanceChecked", {
+        proxyAddress,
+        amountBaseUnit: amountBaseUnit.toString(),
+        currentAllowance: currentAllowance.toString(),
+        needsApprovalTx
+      });
+      const txs = [];
+      if (needsApprovalTx) {
+        txs.push({
+          to: PUSD_TOKEN.address,
+          data: encodeFunctionData({
+            abi: erc20Abi,
+            functionName: "approve",
+            args: [PUSD_OFFRAMP_ADDRESS, amountBaseUnit]
+          }),
+          value: "0"
+        });
+      }
+      txs.push({
+        to: PUSD_OFFRAMP_ADDRESS,
+        data: encodeFunctionData({
+          abi: PUSD_OFFRAMP_ABI,
+          functionName: "unwrap",
+          args: [POLYGON_USDCE, proxyAddress, amountBaseUnit]
+        }),
+        value: "0"
+      });
+      logger.info("polymarket:withdrawal:wallet:txsStaged", {
+        proxyAddress,
+        txCount: txs.length,
+        needsApprovalTx
+      });
+      return txs;
+    } catch (err) {
+      logger.error("polymarket:withdrawal:wallet:error", err, {
+        phase: "preWithdrawal",
+        proxyAddress
+      });
+      throw err;
+    }
+  };
+  return {
+    modalTitle: config.modalTitle ?? "Withdraw",
+    disableConnectedWallet: config.disableConnectedWallet,
+    sourceChainId: polygon.id.toString(),
+    sourceTokenSymbol: config.sourceTokenSymbol ?? PUSD_TOKEN.symbol,
+    sourceTokenAddress: config.sourceTokenAddress ?? POLYGON_USDCE,
+    defaultReceiveToken: config.defaultReceiveToken ?? "USDC",
+    iconSrc: config.iconSrc ?? PUSD_TOKEN.iconSrc,
+    getMinWithdrawalUSD: () => 0,
+    wallet,
+    preWithdrawalAction
+  };
+}
+function extractWithdrawalAmount(funQuote) {
+  const quote = funQuote;
+  const amountStr = quote?.baseQuote?.estTotalFromAmountBaseUnit;
+  if (!amountStr) {
+    logger.error("polymarket:withdrawal:missingAmountInQuote", { quote });
+    throw new Error("Missing withdrawal amount in quote");
+  }
+  return BigInt(amountStr);
+}
+function createPolymarketWithdrawalConfig(config) {
+  if ("sendPmctTransfer" in config && "sendTransactions" in config) {
+    const walletUnwrapEnabled = checkFeatureGate(
+      "enable-polymarket-wallet-withdrawal"
+    );
+    logger.info("polymarket:withdrawal:gate", { walletUnwrapEnabled });
+    return walletUnwrapEnabled ? buildWalletUnwrapWithdrawalConfig(config) : buildUdaWithdrawalConfig(config);
+  }
+  return "sendPmctTransfer" in config ? buildUdaWithdrawalConfig(config) : buildWalletUnwrapWithdrawalConfig(config);
+}
 export {
   createPolymarketWithdrawalConfig
 };

package/dist/components/Dialog/DialogContent.css.d.ts

@@ -1,6 +1,6 @@
 export declare const DIALOG_WIDTH_WIDE = "450px";
 export declare const DIALOG_HEIGHT = 525;
-export declare const DIALOG_HEIGHT_SWAPPED_IFRAME = 580;
+export declare const DIALOG_HEIGHT_SWAPPED_IFRAME = 525;
 export declare const DIALOG_INNER_PADDING_X = 12;
 export declare const SCROLL_BAR_WIDTH = 6;
 export declare const DIALOG_BOTTOM_PADDING = "15";

package/dist/components/FunNotificationBanner/FunNotificationBanner.d.ts

@@ -1,7 +1,7 @@
 import React, { type ReactNode } from 'react';
 import { type FunNotificationBannerIconProps } from './FunNotificationBannerIcon';
 interface FunNotificationBannerProps extends FunNotificationBannerIconProps {
-    title: ReactNode;
+    title: string;
     description: ReactNode;
     /** Additional text-like content clarifying the description */
     disclaimer?: ReactNode;

package/dist/components/FunOptionBox/FunOptionBox.css.d.ts

@@ -1 +1 @@
-export declare const funOptionBoxStyle: Record<"activeBackground" | "baseStyle" | "compactListStyle" | "defaultBorder" | "defaultModeNotActiveBorder" | "activeBorder" | "disabledOptionBorder" | "defaultBackground" | "uninteractiveBackground", string>;
+export declare const funOptionBoxStyle: Record<"baseStyle" | "compactListStyle" | "defaultBorder" | "defaultModeNotActiveBorder" | "activeBorder" | "disabledOptionBorder" | "defaultBackground" | "activeBackground" | "uninteractiveBackground", string>;