@circle-fin/app-kit 1.10.0 → 1.11.0

package/index.d.cts

@@ -14238,6 +14238,17 @@ interface SwapResult$1 {
      * The transaction hash for the executed swap.
      */
     readonly txHash: string;
+    /**
+     * Per-swap correlation id echoed back by the service (a UUID).
+     *
+     * @remarks
+     * Attached to success telemetry so a swap can be correlated across records.
+     * Present when the service response exposes it — currently every chain
+     * (EVM + Solana); undefined only against an older service that omits it.
+     * Internal telemetry detail — not part of the developer-facing result.
+     * @internal
+     */
+    readonly correlationId?: string;
     /**
      * Array of all transactions executed during the swap operation.
      *
@@ -15787,6 +15798,19 @@ interface SwapKitConfig<TExtraProviders extends FlexibleSwappingProvider[] = []>
      * for all swaps executed through the created context.
      */
     customFeePolicy?: CustomFeePolicy$1;
+    /**
+     * Disable success/analytics telemetry.
+     *
+     * When `true`, the SDK will not POST success telemetry (the `swap_swap`
+     * volume-attribution event emitted after a successful swap). Independent of
+     * {@link SwapKitConfig.disableErrorReporting}, so analytics can be opted out
+     * without silencing error reports. The events carry SDK metadata and
+     * allowlisted operation context (chains, token symbols, txHash, correlation
+     * id); they do not include wallet addresses or amounts. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
     /**
      * Disable error telemetry.
      *
@@ -18539,6 +18563,27 @@ interface EarnKitContext<TProviders extends readonly FlexibleEarningProvider[] =
 interface EarnKitConfig<TExtraProviders extends FlexibleEarningProvider[] = []> {
     /** Optional array of custom earn providers. */
     providers?: TExtraProviders;
+    /**
+     * Disable success telemetry for completed EarnKit operations.
+     *
+     * When `true`, direct {@link EarnKit} instances do not send success events
+     * to Circle's telemetry endpoint for vault lookups, vault discovery,
+     * deposits, withdrawals, or reward claims. The events include SDK metadata
+     * and allowlisted operation context; they do not include wallet addresses or
+     * amounts. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
+    /**
+     * Disable error telemetry for failed public operations.
+     *
+     * When `true`, direct {@link EarnKit} instances do not send structured
+     * error details to Circle's telemetry endpoint. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableErrorReporting?: boolean;
 }
 
 /**
@@ -18600,6 +18645,10 @@ interface EarnKitConfig<TExtraProviders extends FlexibleEarningProvider[] = []>
  */
 declare class EarnKit {
     private readonly context;
+    /** Per-kit identity and opt-out state for error telemetry. */
+    private readonly telemetryConfig;
+    /** Per-kit identity and opt-out state for success telemetry. */
+    private readonly analyticsTelemetryConfig;
     /**
      * Event dispatcher for step-level events emitted during multi-phase earn
      * operations. Prefer {@link EarnKit.on} / {@link EarnKit.off} over using
@@ -24739,10 +24788,21 @@ interface AppKitContext {
      * ```
      */
     actions: Record<'bridge' | 'earn', Record<string, ((payload: unknown) => void)[]>>;
+    /**
+     * Disable success analytics for the underlying EarnKit, SwapKit, and
+     * UnifiedBalanceKit.
+     *
+     * When `true`, completed earn, swap, and unified balance operations will not
+     * POST analytics events. This does not disable error reporting; use
+     * {@link AppKitContext.disableErrorReporting} for that. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
     /**
      * Disable error telemetry for all sub-kits.
      *
-     * When `true`, none of the underlying kits (BridgeKit, SwapKit,
+     * When `true`, none of the underlying kits (BridgeKit, SwapKit, EarnKit,
      * UnifiedBalanceKit) will POST error details to the telemetry
      * endpoint when operations throw. Defaults to `false` (enabled).
      *
@@ -26509,10 +26569,13 @@ interface GetDelegateStatusParams<TAdapterCapabilities extends AdapterCapabiliti
 }
 
 /**
- * Parameters for initiating a delayed fund removal from a Gateway
+ * Parameters for initiating a delayed recovery fund removal from a Gateway
  * account.
  *
  * @remarks
+ * Use fund removal only as a trustless fallback when the normal spend flow is
+ * unavailable. For day-to-day movement out of a Unified Balance, use `spend`.
+ *
  * Fund removals have a mandatory 7-day delay before they can be
  * completed.  Only one removal may be pending per chain at a
  * time.  Initiating a second removal on the same chain adds the
@@ -26595,7 +26658,12 @@ interface InitiateRemoveFundResult {
     explorerUrl?: string;
 }
 /**
- * Parameters for completing a fund removal after the activation period.
+ * Parameters for completing a recovery fund removal after the withdrawal
+ * delay.
+ *
+ * @remarks
+ * Use fund removal only as a trustless fallback when the normal spend flow is
+ * unavailable. For day-to-day movement out of a Unified Balance, use `spend`.
  *
  * @typeParam TAdapterCapabilities - Adapter capability constraints.
  * @typeParam TChainIdentifier - Accepted chain identifier type.
@@ -26692,6 +26760,11 @@ interface GetSupportedChainsOptions {
  * Internally holds a persistent {@link UnifiedBalanceKit} instance so that
  * event dispatchers and custom fee policies are preserved across calls.
  *
+ * Use {@link AppKitUnifiedBalance.spend} for normal movement out of a Unified
+ * Balance. {@link AppKitUnifiedBalance.removeFund} is a trustless recovery path
+ * for situations where the normal spend flow is unavailable, and it requires a
+ * 7-day withdrawal delay after {@link AppKitUnifiedBalance.initiateRemoveFund}.
+ *
  * @example
  * ```typescript
  * import { AppKit } from '@circle-fin/app-kit'
@@ -26893,7 +26966,12 @@ declare class AppKitUnifiedBalance {
      */
     removeDelegate(params: UpdateDelegateParams): Promise<UpdateDelegateResult>;
     /**
-     * Kick off a delayed fund removal from an account.
+     * Initiate a trustless recovery removal from an account.
+     *
+     * Use `spend` for normal movement out of a Unified Balance. `removeFund` is a
+     * recovery path for situations where the normal spend flow is unavailable.
+     * Calling this method starts the 7-day withdrawal delay before the removal can
+     * be completed.
      *
      * @param params - The account owner's adapter context, amount, and token.
      * @returns Promise resolving to the initiation details.
@@ -26911,11 +26989,16 @@ declare class AppKitUnifiedBalance {
      */
     initiateRemoveFund(params: InitiateRemoveFundParams): Promise<InitiateRemoveFundResult>;
     /**
-     * Complete a fund removal once the activation period has passed.
+     * Complete a trustless recovery removal after the withdrawal delay.
+     *
+     * Use `spend` for normal movement out of a Unified Balance. `removeFund` is a
+     * recovery path for situations where the normal spend flow is unavailable.
+     * Both EVM and Solana removals require a 7-day withdrawal delay after
+     * `initiateRemoveFund` before funds can be removed.
      *
      * @param params - The account owner context matching the original initiation.
      * @returns Promise resolving to the fund removal details.
-     * @throws {KitError} If the activation period has not elapsed or the
+     * @throws {KitError} If the withdrawal delay has not elapsed or the
      *   on-chain transaction fails.
      *
      * @example
@@ -27036,10 +27119,21 @@ type AppKitConfig = CreateContextParams & {
     developerFee?: Partial<DeveloperFeeHooks>;
     /** Optional config forwarded to the underlying {@link UnifiedBalanceKit}. */
     unifiedBalance?: UnifiedBalanceKitConfig;
+    /**
+     * Disable success analytics for the underlying EarnKit, SwapKit, and
+     * UnifiedBalanceKit.
+     *
+     * When `true`, completed earn, swap, and unified balance operations will not
+     * POST analytics events. This does not disable error reporting; use
+     * {@link AppKitConfig.disableErrorReporting} for that. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
     /**
      * Disable error telemetry for all underlying kits.
      *
-     * When `true`, BridgeKit, SwapKit, and UnifiedBalanceKit will not
+     * When `true`, BridgeKit, SwapKit, EarnKit, and UnifiedBalanceKit will not
      * POST error details to the telemetry endpoint. Defaults to `false`.
      *
      * @defaultValue false

package/index.d.mts

@@ -14238,6 +14238,17 @@ interface SwapResult$1 {
      * The transaction hash for the executed swap.
      */
     readonly txHash: string;
+    /**
+     * Per-swap correlation id echoed back by the service (a UUID).
+     *
+     * @remarks
+     * Attached to success telemetry so a swap can be correlated across records.
+     * Present when the service response exposes it — currently every chain
+     * (EVM + Solana); undefined only against an older service that omits it.
+     * Internal telemetry detail — not part of the developer-facing result.
+     * @internal
+     */
+    readonly correlationId?: string;
     /**
      * Array of all transactions executed during the swap operation.
      *
@@ -15787,6 +15798,19 @@ interface SwapKitConfig<TExtraProviders extends FlexibleSwappingProvider[] = []>
      * for all swaps executed through the created context.
      */
     customFeePolicy?: CustomFeePolicy$1;
+    /**
+     * Disable success/analytics telemetry.
+     *
+     * When `true`, the SDK will not POST success telemetry (the `swap_swap`
+     * volume-attribution event emitted after a successful swap). Independent of
+     * {@link SwapKitConfig.disableErrorReporting}, so analytics can be opted out
+     * without silencing error reports. The events carry SDK metadata and
+     * allowlisted operation context (chains, token symbols, txHash, correlation
+     * id); they do not include wallet addresses or amounts. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
     /**
      * Disable error telemetry.
      *
@@ -18539,6 +18563,27 @@ interface EarnKitContext<TProviders extends readonly FlexibleEarningProvider[] =
 interface EarnKitConfig<TExtraProviders extends FlexibleEarningProvider[] = []> {
     /** Optional array of custom earn providers. */
     providers?: TExtraProviders;
+    /**
+     * Disable success telemetry for completed EarnKit operations.
+     *
+     * When `true`, direct {@link EarnKit} instances do not send success events
+     * to Circle's telemetry endpoint for vault lookups, vault discovery,
+     * deposits, withdrawals, or reward claims. The events include SDK metadata
+     * and allowlisted operation context; they do not include wallet addresses or
+     * amounts. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
+    /**
+     * Disable error telemetry for failed public operations.
+     *
+     * When `true`, direct {@link EarnKit} instances do not send structured
+     * error details to Circle's telemetry endpoint. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableErrorReporting?: boolean;
 }
 
 /**
@@ -18600,6 +18645,10 @@ interface EarnKitConfig<TExtraProviders extends FlexibleEarningProvider[] = []>
  */
 declare class EarnKit {
     private readonly context;
+    /** Per-kit identity and opt-out state for error telemetry. */
+    private readonly telemetryConfig;
+    /** Per-kit identity and opt-out state for success telemetry. */
+    private readonly analyticsTelemetryConfig;
     /**
      * Event dispatcher for step-level events emitted during multi-phase earn
      * operations. Prefer {@link EarnKit.on} / {@link EarnKit.off} over using
@@ -24739,10 +24788,21 @@ interface AppKitContext {
      * ```
      */
     actions: Record<'bridge' | 'earn', Record<string, ((payload: unknown) => void)[]>>;
+    /**
+     * Disable success analytics for the underlying EarnKit, SwapKit, and
+     * UnifiedBalanceKit.
+     *
+     * When `true`, completed earn, swap, and unified balance operations will not
+     * POST analytics events. This does not disable error reporting; use
+     * {@link AppKitContext.disableErrorReporting} for that. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
     /**
      * Disable error telemetry for all sub-kits.
      *
-     * When `true`, none of the underlying kits (BridgeKit, SwapKit,
+     * When `true`, none of the underlying kits (BridgeKit, SwapKit, EarnKit,
      * UnifiedBalanceKit) will POST error details to the telemetry
      * endpoint when operations throw. Defaults to `false` (enabled).
      *
@@ -26509,10 +26569,13 @@ interface GetDelegateStatusParams<TAdapterCapabilities extends AdapterCapabiliti
 }
 
 /**
- * Parameters for initiating a delayed fund removal from a Gateway
+ * Parameters for initiating a delayed recovery fund removal from a Gateway
  * account.
  *
  * @remarks
+ * Use fund removal only as a trustless fallback when the normal spend flow is
+ * unavailable. For day-to-day movement out of a Unified Balance, use `spend`.
+ *
  * Fund removals have a mandatory 7-day delay before they can be
  * completed.  Only one removal may be pending per chain at a
  * time.  Initiating a second removal on the same chain adds the
@@ -26595,7 +26658,12 @@ interface InitiateRemoveFundResult {
     explorerUrl?: string;
 }
 /**
- * Parameters for completing a fund removal after the activation period.
+ * Parameters for completing a recovery fund removal after the withdrawal
+ * delay.
+ *
+ * @remarks
+ * Use fund removal only as a trustless fallback when the normal spend flow is
+ * unavailable. For day-to-day movement out of a Unified Balance, use `spend`.
  *
  * @typeParam TAdapterCapabilities - Adapter capability constraints.
  * @typeParam TChainIdentifier - Accepted chain identifier type.
@@ -26692,6 +26760,11 @@ interface GetSupportedChainsOptions {
  * Internally holds a persistent {@link UnifiedBalanceKit} instance so that
  * event dispatchers and custom fee policies are preserved across calls.
  *
+ * Use {@link AppKitUnifiedBalance.spend} for normal movement out of a Unified
+ * Balance. {@link AppKitUnifiedBalance.removeFund} is a trustless recovery path
+ * for situations where the normal spend flow is unavailable, and it requires a
+ * 7-day withdrawal delay after {@link AppKitUnifiedBalance.initiateRemoveFund}.
+ *
  * @example
  * ```typescript
  * import { AppKit } from '@circle-fin/app-kit'
@@ -26893,7 +26966,12 @@ declare class AppKitUnifiedBalance {
      */
     removeDelegate(params: UpdateDelegateParams): Promise<UpdateDelegateResult>;
     /**
-     * Kick off a delayed fund removal from an account.
+     * Initiate a trustless recovery removal from an account.
+     *
+     * Use `spend` for normal movement out of a Unified Balance. `removeFund` is a
+     * recovery path for situations where the normal spend flow is unavailable.
+     * Calling this method starts the 7-day withdrawal delay before the removal can
+     * be completed.
      *
      * @param params - The account owner's adapter context, amount, and token.
      * @returns Promise resolving to the initiation details.
@@ -26911,11 +26989,16 @@ declare class AppKitUnifiedBalance {
      */
     initiateRemoveFund(params: InitiateRemoveFundParams): Promise<InitiateRemoveFundResult>;
     /**
-     * Complete a fund removal once the activation period has passed.
+     * Complete a trustless recovery removal after the withdrawal delay.
+     *
+     * Use `spend` for normal movement out of a Unified Balance. `removeFund` is a
+     * recovery path for situations where the normal spend flow is unavailable.
+     * Both EVM and Solana removals require a 7-day withdrawal delay after
+     * `initiateRemoveFund` before funds can be removed.
      *
      * @param params - The account owner context matching the original initiation.
      * @returns Promise resolving to the fund removal details.
-     * @throws {KitError} If the activation period has not elapsed or the
+     * @throws {KitError} If the withdrawal delay has not elapsed or the
      *   on-chain transaction fails.
      *
      * @example
@@ -27036,10 +27119,21 @@ type AppKitConfig = CreateContextParams & {
     developerFee?: Partial<DeveloperFeeHooks>;
     /** Optional config forwarded to the underlying {@link UnifiedBalanceKit}. */
     unifiedBalance?: UnifiedBalanceKitConfig;
+    /**
+     * Disable success analytics for the underlying EarnKit, SwapKit, and
+     * UnifiedBalanceKit.
+     *
+     * When `true`, completed earn, swap, and unified balance operations will not
+     * POST analytics events. This does not disable error reporting; use
+     * {@link AppKitConfig.disableErrorReporting} for that. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
     /**
      * Disable error telemetry for all underlying kits.
      *
-     * When `true`, BridgeKit, SwapKit, and UnifiedBalanceKit will not
+     * When `true`, BridgeKit, SwapKit, EarnKit, and UnifiedBalanceKit will not
      * POST error details to the telemetry endpoint. Defaults to `false`.
      *
      * @defaultValue false

package/index.d.ts

@@ -14238,6 +14238,17 @@ interface SwapResult$1 {
      * The transaction hash for the executed swap.
      */
     readonly txHash: string;
+    /**
+     * Per-swap correlation id echoed back by the service (a UUID).
+     *
+     * @remarks
+     * Attached to success telemetry so a swap can be correlated across records.
+     * Present when the service response exposes it — currently every chain
+     * (EVM + Solana); undefined only against an older service that omits it.
+     * Internal telemetry detail — not part of the developer-facing result.
+     * @internal
+     */
+    readonly correlationId?: string;
     /**
      * Array of all transactions executed during the swap operation.
      *
@@ -15787,6 +15798,19 @@ interface SwapKitConfig<TExtraProviders extends FlexibleSwappingProvider[] = []>
      * for all swaps executed through the created context.
      */
     customFeePolicy?: CustomFeePolicy$1;
+    /**
+     * Disable success/analytics telemetry.
+     *
+     * When `true`, the SDK will not POST success telemetry (the `swap_swap`
+     * volume-attribution event emitted after a successful swap). Independent of
+     * {@link SwapKitConfig.disableErrorReporting}, so analytics can be opted out
+     * without silencing error reports. The events carry SDK metadata and
+     * allowlisted operation context (chains, token symbols, txHash, correlation
+     * id); they do not include wallet addresses or amounts. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
     /**
      * Disable error telemetry.
      *
@@ -18539,6 +18563,27 @@ interface EarnKitContext<TProviders extends readonly FlexibleEarningProvider[] =
 interface EarnKitConfig<TExtraProviders extends FlexibleEarningProvider[] = []> {
     /** Optional array of custom earn providers. */
     providers?: TExtraProviders;
+    /**
+     * Disable success telemetry for completed EarnKit operations.
+     *
+     * When `true`, direct {@link EarnKit} instances do not send success events
+     * to Circle's telemetry endpoint for vault lookups, vault discovery,
+     * deposits, withdrawals, or reward claims. The events include SDK metadata
+     * and allowlisted operation context; they do not include wallet addresses or
+     * amounts. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
+    /**
+     * Disable error telemetry for failed public operations.
+     *
+     * When `true`, direct {@link EarnKit} instances do not send structured
+     * error details to Circle's telemetry endpoint. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableErrorReporting?: boolean;
 }
 
 /**
@@ -18600,6 +18645,10 @@ interface EarnKitConfig<TExtraProviders extends FlexibleEarningProvider[] = []>
  */
 declare class EarnKit {
     private readonly context;
+    /** Per-kit identity and opt-out state for error telemetry. */
+    private readonly telemetryConfig;
+    /** Per-kit identity and opt-out state for success telemetry. */
+    private readonly analyticsTelemetryConfig;
     /**
      * Event dispatcher for step-level events emitted during multi-phase earn
      * operations. Prefer {@link EarnKit.on} / {@link EarnKit.off} over using
@@ -24739,10 +24788,21 @@ interface AppKitContext {
      * ```
      */
     actions: Record<'bridge' | 'earn', Record<string, ((payload: unknown) => void)[]>>;
+    /**
+     * Disable success analytics for the underlying EarnKit, SwapKit, and
+     * UnifiedBalanceKit.
+     *
+     * When `true`, completed earn, swap, and unified balance operations will not
+     * POST analytics events. This does not disable error reporting; use
+     * {@link AppKitContext.disableErrorReporting} for that. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
     /**
      * Disable error telemetry for all sub-kits.
      *
-     * When `true`, none of the underlying kits (BridgeKit, SwapKit,
+     * When `true`, none of the underlying kits (BridgeKit, SwapKit, EarnKit,
      * UnifiedBalanceKit) will POST error details to the telemetry
      * endpoint when operations throw. Defaults to `false` (enabled).
      *
@@ -26509,10 +26569,13 @@ interface GetDelegateStatusParams<TAdapterCapabilities extends AdapterCapabiliti
 }
 
 /**
- * Parameters for initiating a delayed fund removal from a Gateway
+ * Parameters for initiating a delayed recovery fund removal from a Gateway
  * account.
  *
  * @remarks
+ * Use fund removal only as a trustless fallback when the normal spend flow is
+ * unavailable. For day-to-day movement out of a Unified Balance, use `spend`.
+ *
  * Fund removals have a mandatory 7-day delay before they can be
  * completed.  Only one removal may be pending per chain at a
  * time.  Initiating a second removal on the same chain adds the
@@ -26595,7 +26658,12 @@ interface InitiateRemoveFundResult {
     explorerUrl?: string;
 }
 /**
- * Parameters for completing a fund removal after the activation period.
+ * Parameters for completing a recovery fund removal after the withdrawal
+ * delay.
+ *
+ * @remarks
+ * Use fund removal only as a trustless fallback when the normal spend flow is
+ * unavailable. For day-to-day movement out of a Unified Balance, use `spend`.
  *
  * @typeParam TAdapterCapabilities - Adapter capability constraints.
  * @typeParam TChainIdentifier - Accepted chain identifier type.
@@ -26692,6 +26760,11 @@ interface GetSupportedChainsOptions {
  * Internally holds a persistent {@link UnifiedBalanceKit} instance so that
  * event dispatchers and custom fee policies are preserved across calls.
  *
+ * Use {@link AppKitUnifiedBalance.spend} for normal movement out of a Unified
+ * Balance. {@link AppKitUnifiedBalance.removeFund} is a trustless recovery path
+ * for situations where the normal spend flow is unavailable, and it requires a
+ * 7-day withdrawal delay after {@link AppKitUnifiedBalance.initiateRemoveFund}.
+ *
  * @example
  * ```typescript
  * import { AppKit } from '@circle-fin/app-kit'
@@ -26893,7 +26966,12 @@ declare class AppKitUnifiedBalance {
      */
     removeDelegate(params: UpdateDelegateParams): Promise<UpdateDelegateResult>;
     /**
-     * Kick off a delayed fund removal from an account.
+     * Initiate a trustless recovery removal from an account.
+     *
+     * Use `spend` for normal movement out of a Unified Balance. `removeFund` is a
+     * recovery path for situations where the normal spend flow is unavailable.
+     * Calling this method starts the 7-day withdrawal delay before the removal can
+     * be completed.
      *
      * @param params - The account owner's adapter context, amount, and token.
      * @returns Promise resolving to the initiation details.
@@ -26911,11 +26989,16 @@ declare class AppKitUnifiedBalance {
      */
     initiateRemoveFund(params: InitiateRemoveFundParams): Promise<InitiateRemoveFundResult>;
     /**
-     * Complete a fund removal once the activation period has passed.
+     * Complete a trustless recovery removal after the withdrawal delay.
+     *
+     * Use `spend` for normal movement out of a Unified Balance. `removeFund` is a
+     * recovery path for situations where the normal spend flow is unavailable.
+     * Both EVM and Solana removals require a 7-day withdrawal delay after
+     * `initiateRemoveFund` before funds can be removed.
      *
      * @param params - The account owner context matching the original initiation.
      * @returns Promise resolving to the fund removal details.
-     * @throws {KitError} If the activation period has not elapsed or the
+     * @throws {KitError} If the withdrawal delay has not elapsed or the
      *   on-chain transaction fails.
      *
      * @example
@@ -27036,10 +27119,21 @@ type AppKitConfig = CreateContextParams & {
     developerFee?: Partial<DeveloperFeeHooks>;
     /** Optional config forwarded to the underlying {@link UnifiedBalanceKit}. */
     unifiedBalance?: UnifiedBalanceKitConfig;
+    /**
+     * Disable success analytics for the underlying EarnKit, SwapKit, and
+     * UnifiedBalanceKit.
+     *
+     * When `true`, completed earn, swap, and unified balance operations will not
+     * POST analytics events. This does not disable error reporting; use
+     * {@link AppKitConfig.disableErrorReporting} for that. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
     /**
      * Disable error telemetry for all underlying kits.
      *
-     * When `true`, BridgeKit, SwapKit, and UnifiedBalanceKit will not
+     * When `true`, BridgeKit, SwapKit, EarnKit, and UnifiedBalanceKit will not
      * POST error details to the telemetry endpoint. Defaults to `false`.
      *
      * @defaultValue false