@funkit/connect 9.15.1 → 9.16.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @funkit/connect
 
+## 9.16.0
+
+### Minor Changes
+
+- 33bdcdc: Add `uiCustomizations.checkoutHistory.successScreenBackground` for custom CSS gradients on the post-checkout success screen.
+- 85a68f3: Show supply APY and collateralization status on the checkout confirmation screen for yield destinations like Aave.
+- 18bd8a2: feat(connect): gated "Add to wallet" button on the post-checkout success screen (EIP-747 `wallet_watchAsset`), driven by a new optional `addToWalletToken` checkout config field for vault-receipt flows (e.g. Aave aUSDT).
+- 1d38bb4: feat: add btc lightning quoting and invoice
+- 4753c9b: Add `confirmationScreen.showSelectedRoute` to surface the Relay/Across route row independently of passthrough branding (`selectedRouteConfig`).
+
+### Patch Changes
+
+- 1623974: test(connect): test useCheckoutDirectExecution
+- bd5d863: Internal refactor: move the pure checkout-notification logic (multi-step direct-execution merging, deposit filtering, snapshot-diff derivation) into a new `domains/checkoutNotifications.ts` module. No public API or behavior change.
+- 6cc9477: test: add snapshot coverage
+- 33bdcdc: Skip the destination redirect on the post-checkout success screen when `destinationConfig` is set without a `url` (avoids misleading link to the user's own wallet).
+- 7dfaeb7: Restore the post-checkout destination explorer link for customers whose `destinationConfig` sets no `url` (e.g. Polymarket). The link again falls back to the block explorer of `recipientAddr` as documented; customers whose destination is a concept rather than the recipient address should set `destinationConfig.url`.
+- ce7dd34: Fix Lighter deposit/withdrawal recipient selecting a sub-account instead of the main account by selecting the `account_type === 0` entry from `accountsByL1Address` rather than `sub_accounts[0]`.
+- 657a284: Internal refactor: add a platform-agnostic `IdentityProvider`/`FunkitIdentity` interface and a web `useIdentity()` implementation backed by `GeneralWalletProvider`, and route `useFops`/`useSwappedExchanges` through it. No public API or user-visible behavior change.
+- 3f6ceb8: Internal refactor: introduce a platform-agnostic `LogTransport` interface and move the `@datadog/browser-logs` calls out of `FunLogger` into a `DatadogBrowserLogsTransport` that the global logger is wired with. `FunLogger` now emits through an injected transport instead of importing Datadog directly. No public API or behavior change.
+- 96f9b0a: chore(security): upgrade uuid to 11.1.1
+- 12b4059: Move approval method toggle from confirmation screen to input amount screen and add explanatory tooltip
+- 4970a3b: Internal refactor: route `QuoteModeProvider`'s feature-gate reads through the `~/hooks/statsig` `useFeatureGate` wrapper instead of `@statsig/react-bindings` directly. No public API or behavior change.
+- 2e869ee: Remove unused useUpdateCardSourceAsset hook tied to deprecated Moonpay card flow
+- 2e869ee: Remove unused getMockedTargetChainId helper and DepositTokenSymbol enum from Moonpay flow
+- 64caa75: chore(connect): remove the stale `new-token-transfer-config` feature gate
+- 2e869ee: Remove Polymarket-specific Moonpay estimate from Meld quotes now that Polymarket uses swapped quotes
+- d8a374e: feat: create shared component for error statem, replace instances, and remove unused tagline path
+- 9391b6f: Internal refactor: make the Swapped theme builders (`buildSwappedTheme`, `buildSwappedThemeQueryParams`) pure by moving DOM-bound CSS-variable resolution out to the web call sites. No public API or user-visible behavior change — prep for sharing the Swapped theme path with React Native via `@funkit/connect-core`.
+- 2265429: Internal refactor: introduce a typed `SwappedTransport` contract (the inbound/outbound postMessage event union) and route `SwappedProvider` + `SwappedIframeController` through a web `IframeSwappedTransport` instead of touching `window.postMessage`/`addEventListener` directly. No public API or user-visible behavior change — prep for sharing the Swapped state machine with React Native (which will provide a WebView-backed transport) via `@funkit/connect-core`.
+- Updated dependencies [1d38bb4]
+  - @funkit/api-base@4.4.0
+
 ## 9.15.1
 
 ### Patch Changes

package/dist/__generated__/default_feature_gates.d.ts

@@ -2,6 +2,7 @@ declare const _default: {
     readonly 'compliance-review-blocker': false;
     readonly 'enable-across-wallet-flow': false;
     readonly 'enable-add-token-to-wallet': false;
+    readonly 'enable-checkout-success-screen-background': false;
     readonly 'enable-empty-withdrawal-selection': false;
     readonly 'enable-free-usdc-banner': false;
     readonly 'enable-permit-toggle': false;

package/dist/{chunk-76E6MOLR.js → chunk-C2DLTEP2.js}

@@ -207,6 +207,7 @@ var lightTheme = ({
     // primaryText
     txSummaryBoxBackground: customColors?.txSummaryBoxBackground ?? customColors?.modalBackground ?? "#FFF",
     txSummaryBoxBorder: customColors?.txSummaryBoxBorder ?? customColors?.lightStroke ?? "#F7F7F7",
+    modalBackgroundCheckoutComplete: customColors?.modalBackgroundCheckoutComplete ?? customColors?.modalBackground ?? "#FFF",
     counterRingColor: customColors?.counterRingColor ?? accentColor,
     cryptoCashToggleContainerBorderColor: customColors?.cryptoCashToggleContainerBorderColor ?? "transparent",
     cryptoCashToggleBackground: customColors?.cryptoCashToggleBackground ?? "transparent"

package/dist/{chunk-AVVB5AIE.js → chunk-PPNE44RL.js}

@@ -207,6 +207,7 @@ var darkTheme = ({
     // primaryText
     txSummaryBoxBackground: customColors?.txSummaryBoxBackground ?? customColors?.modalBackground ?? "#000",
     txSummaryBoxBorder: customColors?.txSummaryBoxBorder ?? customColors?.lightStroke ?? "#333333",
+    modalBackgroundCheckoutComplete: customColors?.modalBackgroundCheckoutComplete ?? customColors?.modalBackground ?? "#000",
     counterRingColor: customColors?.counterRingColor ?? accentColor,
     cryptoCashToggleContainerBorderColor: customColors?.cryptoCashToggleContainerBorderColor ?? "transparent",
     cryptoCashToggleBackground: customColors?.cryptoCashToggleBackground ?? "transparent"

package/dist/clients/aave.d.ts

@@ -75,6 +75,21 @@ export interface AaveSupplyCheckoutInput {
     };
     /** Aave referral code; defaults to 0. */
     referralCode?: number;
+    /**
+     * The aToken receipt the supply mints (Aave's `Reserve.aToken`). When
+     * provided, the post-checkout success screen offers adding it to the user's
+     * wallet via EIP-747 — necessary because the checkout's destination token is
+     * the intermediate underlying (USDT), not the aToken (aUSDT) the user holds
+     * after the supply. Resolve it from Aave reserve data (`@aave/client`'s
+     * `reserve()` → `aToken`, or `@aave-dao/aave-address-book`). Omit if
+     * unavailable — the button is simply not shown.
+     */
+    receiptToken?: {
+        address: Address;
+        symbol: string;
+        decimals: number;
+        iconSrc?: string;
+    };
 }
 /**
  * High-level builder for an Aave V3 supply checkout. Returns a

package/dist/clients/aave.js

@@ -125,28 +125,53 @@ function createAaveSupplyCheckoutConfig(input) {
     chainId,
     walletAddress,
     display,
-    referralCode
+    referralCode,
+    receiptToken
   } = input;
   if (!isAaveSupplySupported(chainId)) {
     return void 0;
   }
   const symbol = display?.symbol ?? "asset";
-  const receiptTicker = `a${symbol}`;
+  const receiptTicker = receiptToken?.symbol ?? `a${symbol}`;
   return {
     modalTitle: `Supply ${symbol}`,
     modalTitleMeta: buildSupplyModalTitleMeta(display),
+    // Same integrator-provided signals as the subtitle, but structured so the
+    // confirmation screen renders them as rows (DestinationYieldRows). No extra
+    // fetch — one resolved snapshot, two surfaces. Left undefined when neither
+    // signal is present so the field stays falsy (no empty-but-truthy object).
+    destinationYieldInfo: display?.supplyAPY !== void 0 || display?.collateralizationEnabled !== void 0 ? {
+      supplyApy: display?.supplyAPY,
+      collateralizationEnabled: display?.collateralizationEnabled
+    } : void 0,
     targetChain: chainId.toString(),
     targetAsset: underlyingAsset,
     targetAssetTicker: receiptTicker,
     checkoutItemTitle: receiptTicker,
-    iconSrc: display?.iconSrc,
+    // Prefer the aToken's icon (e.g. Aave's aEthUSDC artwork) when known so
+    // the You-receive row / modal title show the receipt token's branding,
+    // not the underlying's. Falls back to the integrator-supplied underlying
+    // icon when reserve metadata isn't available.
+    iconSrc: receiptToken?.iconSrc ?? display?.iconSrc,
     generateActionsParams: createAaveSupplyActions({
       onBehalfOf: walletAddress,
       underlyingAsset,
       poolAddress,
       chainId,
       referralCode
-    })
+    }),
+    // The checkout delivers the underlying (USDT); the supply mints the aToken
+    // (aEthUSDT) to the wallet. Offer adding the aToken — not `targetAsset` —
+    // so the wallet tracks what the user actually holds. All fields come
+    // straight from Aave reserve data so the wallet label / icon / decimals
+    // match what users see on-chain and in explorers.
+    addToWalletToken: receiptToken ? {
+      tokenAddress: receiptToken.address,
+      tokenChainId: chainId.toString(),
+      tokenSymbol: receiptToken.symbol,
+      decimals: receiptToken.decimals,
+      iconSrc: receiptToken.iconSrc
+    } : void 0
   };
 }
 export {

package/dist/clients/{chunk-H6F75ULR.js → chunk-3QHYYLVM.js}

@@ -1,24 +1,59 @@
 "use client";
 
 // src/utils/funLogger.ts
-import { datadogLogs } from "@datadog/browser-logs";
 import { DEV_API_KEY } from "@funkit/api-base";
+
+// src/utils/datadogBrowserLogsTransport.ts
+import { datadogLogs } from "@datadog/browser-logs";
 var DDOG_CLIENT_TOKEN = "pub4f86c6be8c792cb48dc156a8c17d9a47";
+var DatadogBrowserLogsTransport = class {
+  constructor() {
+    datadogLogs.init({
+      clientToken: DDOG_CLIENT_TOKEN,
+      site: "datadoghq.com",
+      forwardErrorsToLogs: false,
+      sessionSampleRate: 100,
+      service: "connect-sdk"
+    });
+  }
+  setEnv(environment) {
+    datadogLogs.setGlobalContextProperty("env", environment);
+  }
+  setTrackingConsent(consent) {
+    datadogLogs.setTrackingConsent(consent);
+  }
+  log({ level, title, context, error }) {
+    if (typeof window === "undefined") {
+      return;
+    }
+    switch (level) {
+      case "info":
+        datadogLogs.logger.info(title, context);
+        break;
+      case "debug":
+        datadogLogs.logger.debug(title, context);
+        break;
+      case "warn":
+        datadogLogs.logger.warn(title, context);
+        break;
+      case "error":
+        datadogLogs.logger.error(title, context, error);
+        break;
+    }
+  }
+};
+
+// src/utils/funLogger.ts
 var FUN_DEV_API_KEYS = [
   "hnHevQR0y394nBprGrvNx4HgoZHUwMet5mXTOBhf",
   "MYny3w7xJh6PRlRgkJ9604sHouY2MTke6lCPpSHq",
   DEV_API_KEY
 ];
-function setDdogEnv(environment) {
-  datadogLogs.setGlobalContextProperty("env", environment);
-}
-function setDdogTrackingConsent(consent) {
-  datadogLogs.setTrackingConsent(consent);
-}
 var FunLogger = class {
-  constructor() {
-    setDdogEnv("development" /* DEVELOPMENT */);
-    setDdogTrackingConsent("granted");
+  constructor(transport) {
+    this.transport = transport;
+    this.transport.setEnv?.("development" /* DEVELOPMENT */);
+    this.transport.setTrackingConsent?.("granted");
     this.apiKey = null;
     this.isDebugMode = false;
     this.userId = null;
@@ -38,11 +73,9 @@ var FunLogger = class {
     }
     return "production" /* PRODUCTION */;
   }
-  logDataDog(level, title, data, error) {
-    if (typeof window === "undefined") {
-      return;
-    }
-    const datadogData = {
+  /** Merge caller data with the logger's resolved context for the transport. */
+  buildLogContext(data) {
+    return {
       data,
       apiKey: this.apiKey,
       userId: this.userId,
@@ -52,19 +85,6 @@ var FunLogger = class {
       typeLabel: this.typeLabel,
       sdkVersion: this.sdkVersion
     };
-    switch (level) {
-      case "info":
-        datadogLogs.logger.info(title, datadogData);
-        break;
-      case "debug":
-        datadogLogs.logger.debug(title, datadogData);
-        break;
-      case "warn":
-        datadogLogs.logger.warn(title, datadogData);
-        break;
-      case "error":
-        datadogLogs.logger.error(title, datadogData, error);
-    }
   }
   processLog(level, title, data, error) {
     if (!this.isConfigured) {
@@ -79,7 +99,12 @@ var FunLogger = class {
     }
     const isProd = this.getFunLogEnv() === "production" /* PRODUCTION */;
     if (isProd) {
-      this.logDataDog(level, title, data, error);
+      this.transport.log({
+        level,
+        title,
+        context: this.buildLogContext(data),
+        error
+      });
     }
     if (!isProd || this.isDebugMode) {
       const formattedData = data || "";
@@ -175,8 +200,10 @@ var FunLogger = class {
     this.sdkVersion = sdkVersion;
     this.disableLogging = disableLogging;
     this.isConfigured = true;
-    setDdogEnv(this.getFunLogEnv());
-    setDdogTrackingConsent(this.disableLogging ? "not-granted" : "granted");
+    this.transport.setEnv?.(this.getFunLogEnv());
+    this.transport.setTrackingConsent?.(
+      this.disableLogging ? "not-granted" : "granted"
+    );
     this.flushLogQueue();
   }
   getUserId() {
@@ -206,14 +233,7 @@ var FunLogger = class {
     this.l2Address = l2Address ?? null;
   }
 };
-datadogLogs.init({
-  clientToken: DDOG_CLIENT_TOKEN,
-  site: "datadoghq.com",
-  forwardErrorsToLogs: false,
-  sessionSampleRate: 100,
-  service: "connect-sdk"
-});
-var logger = new FunLogger();
+var logger = new FunLogger(new DatadogBrowserLogsTransport());
 
 export {
   logger