@circle-fin/app-kit 1.9.0 → 1.11.0

package/index.d.mts

@@ -374,6 +374,14 @@ interface CCTPSplitConfig {
     type: 'split';
     tokenMessenger: string;
     messageTransmitter: string;
+    /**
+     * Address of the `TokenMessengerWithFees` wrapper, when deployed on this chain.
+     *
+     * Optional. Present only on chains that support the prepaid FORWARD path
+     * (source-chain fee collection via `depositForBurnWithHookAndFees`). Resolve
+     * it with `resolveCCTPV2ContractAddress(chain, 'tokenMessengerWithFees')`.
+     */
+    tokenMessengerWithFees?: string;
     confirmations: number;
 }
 /**
@@ -394,6 +402,14 @@ interface CCTPSplitConfig {
 interface CCTPMergedConfig {
     type: 'merged';
     contract: string;
+    /**
+     * Address of the `TokenMessengerWithFees` wrapper, when deployed on this chain.
+     *
+     * Optional. Present only on chains that support the prepaid FORWARD path
+     * (source-chain fee collection via `depositForBurnWithHookAndFees`). Resolve
+     * it with `resolveCCTPV2ContractAddress(chain, 'tokenMessengerWithFees')`.
+     */
+    tokenMessengerWithFees?: string;
     confirmations: number;
 }
 /**
@@ -528,6 +544,21 @@ interface GatewayV1Contracts {
      * @example "0xabcdef1234567890abcdef1234567890abcdef12"
      */
     minter: string;
+    /**
+     * The address of the `DepositForHandler` contract.
+     *
+     * @description Optional. The handler the GenericExecutor calls on this chain
+     * to run a fast cross-chain deposit into the {@link GatewayV1Contracts.wallet}.
+     * Present only on chains that are fast-deposit destinations; other Gateway
+     * chains omit it.
+     *
+     * Address format varies by blockchain:
+     * - EVM chains: 40-character hexadecimal with 0x prefix (e.g., "0x1234...")
+     * - Solana: Base58-encoded 32-byte address (e.g., "9WzDX...")
+     *
+     * @example "0xD05E7D2E7d30b92c5F17d7d0fC575fce231F1A48"
+     */
+    depositForHandler?: string;
 }
 /**
  * Versioned map of Gateway contract configurations.
@@ -1362,6 +1393,7 @@ declare const ArcTestnet: {
             readonly v1: {
                 readonly wallet: "0x0077777d7EBA4688BDeF3E311b846F25870A19B9";
                 readonly minter: "0x0022222ABE238Cc2C7Bb1f21003F0a260052475B";
+                readonly depositForHandler: "0xD05E7D2E7d30b92c5F17d7d0fC575fce231F1A48";
             };
         };
         readonly forwarderSupported: {
@@ -5472,6 +5504,110 @@ interface CCTPv2ActionMap {
          */
         hookData: string;
     };
+    /**
+     * Initiate a prepaid cross-chain USDC transfer through the `TokenMessengerWithFees` wrapper.
+     *
+     * Burn USDC on the source chain while collecting all fees up front against a
+     * signed quote. The wrapper collects the fee via `FeeManager`, then delegates
+     * to the unmodified `TokenMessengerV2`. When `hookData` is provided (the
+     * GenericExecutor FORWARD path) the wrapper's `depositForBurnWithHookAndFees`
+     * contract method is used; otherwise `depositForBurnWithFees` is used.
+     *
+     * @remarks
+     * SDK/contract naming: this SDK action is `depositForBurnWithFees` but, when a
+     * `hookData` is present, it dispatches to the `depositForBurnWithHookAndFees`
+     * contract method on `TokenMessengerWithFees` (NOT on `TokenMessengerV2`).
+     *
+     * Fee payment channel (must match the quote's `feeToken`):
+     * - Native fee (`feeToken` is the zero address): exactly `feeTotalAmount` is
+     *   attached as `msg.value`.
+     * - ERC-20 fee (e.g. USDC): no value is attached; the caller must first approve
+     *   the wrapper for `feeTotalAmount` (see the provider's fee approval helper).
+     *
+     * @remarks
+     * Unlike `depositForBurn`, the `TokenMessengerWithFees` contract methods do NOT
+     * take `maxFee` or `minFinalityThreshold` — fee and finality behavior are
+     * derived from the signed quote — so those fields are omitted from this action.
+     *
+     * @example
+     * ```typescript
+     * await adapter.action('cctp.v2.depositForBurnWithFees', {
+     *   amount: BigInt('1000000'),
+     *   mintRecipient: executorAddress,     // GenericExecutor (bytes32)
+     *   destinationCaller: executorAddress, // GenericExecutor (bytes32)
+     *   fromChain: ethereum,
+     *   toChain: arc,
+     *   hookData: geForwardHookData,        // cctp-forward-wrapped GenericExecutor blob
+     *   claim: { signedQuote: '0x...', refundAddress: '0x...' },
+     *   feeToken: '0x0000000000000000000000000000000000000000', // native
+     *   feeTotalAmount: 3500000n,
+     * })
+     * ```
+     */
+    depositForBurnWithFees: Omit<CCTPv2ActionMap['depositForBurn'], 'maxFee' | 'minFinalityThreshold'> & {
+        /**
+         * Optional hex-encoded hook data for the GenericExecutor FORWARD path.
+         *
+         * When present, the `depositForBurnWithHookAndFees` contract method is used
+         * and the blob must be wrapped in the `cctp-forward` envelope (the wrapper
+         * rejects a FORWARD fee quote whose hook lacks it). When omitted, the plain
+         * `depositForBurnWithFees` contract method is used.
+         */
+        hookData?: string;
+        /**
+         * Signed fee quote claim passed to the `TokenMessengerWithFees` wrapper.
+         *
+         * `signedQuote` is the `[uint8 0x01][abi.encode(Quote)]` blob returned by the
+         * Fee Quote service; `refundAddress` receives any fee overpayment refund.
+         */
+        claim: QuoteClaim;
+        /**
+         * Fee token from the signed quote.
+         *
+         * The zero address (`0x000…0`) means the fee is paid in native currency and
+         * is attached as `msg.value`. Any other address (e.g. USDC) means an ERC-20
+         * fee that must be approved to the wrapper beforehand. This is independent of
+         * `burnToken`, which is always USDC.
+         */
+        feeToken: string;
+        /**
+         * Total fee amount from the signed quote, in `feeToken` minor units.
+         *
+         * Firm only until the quote's `expiresAt`. For a native fee this is the exact
+         * `msg.value`; for an ERC-20 fee this is the amount approved to the wrapper.
+         */
+        feeTotalAmount: bigint;
+    };
+}
+/**
+ * Signed fee quote claim consumed by the `TokenMessengerWithFees` wrapper.
+ *
+ * Mirrors the on-chain `IFeeManager.QuoteClaim` struct.
+ *
+ * @example
+ * ```typescript
+ * const claim: QuoteClaim = {
+ *   signedQuote: '0x01...', // [uint8 0x01][abi.encode(Quote)]
+ *   refundAddress: '0xUserWallet...',
+ * }
+ * ```
+ */
+interface QuoteClaim {
+    /**
+     * Opaque signed quote bytes (`0x` hex) from the fee-quote service
+     * (`SignedFeeQuote.signedQuote` returned by `fetchFeeQuote`). Pass verbatim;
+     * do not decode.
+     *
+     * The quote binds the FORWARD fee item to the on-chain call via `argsHash`;
+     * passing a quote that does not match the burn args reverts `QuoteArgsMismatch`.
+     */
+    signedQuote: string;
+    /**
+     * Address that receives any refund of overpaid fees.
+     *
+     * Typically the user wallet that authorized the burn.
+     */
+    refundAddress: string;
 }
 
 /**
@@ -8469,14 +8605,14 @@ declare const ServiceError: {
 };
 
 /**
- * Standardized error definitions for Earn/Zenith operations.
+ * Standardized error definitions for Earn operations.
  *
  * These error codes provide fine-grained categorization of failures
- * from the Zenith earn service, enabling SDK consumers to distinguish
+ * from the Earn service, enabling SDK consumers to distinguish
  * between input errors (fix your request) and service errors (retry later).
  *
  * Error code ranges:
- * - 1100-1105: INPUT errors — invalid inputs, unsupported configurations
+ * - 1100-1106: INPUT errors — invalid, unsupported, or stale request state
  * - 8100-8105: SERVICE errors — retryable backend/provider failures
  *
  * @example
@@ -8536,6 +8672,15 @@ declare const EarnError: {
         readonly name: "EARN_UNSUPPORTED_BRIDGE_ROUTE";
         readonly type: ErrorType;
     };
+    /**
+     * The bridge quote expired. This is an INPUT error because the prepared
+     * request is stale and must be replaced instead of retried.
+     */
+    readonly BRIDGE_QUOTE_EXPIRED: {
+        readonly code: 1106;
+        readonly name: "EARN_BRIDGE_QUOTE_EXPIRED";
+        readonly type: ErrorType;
+    };
     /** The proxy signing call failed — retryable. */
     readonly SIGNING_FAILED: {
         readonly code: 8100;
@@ -12174,6 +12319,70 @@ interface ICCTPV2BridgingProvider extends BridgingProvider<CCTPV2Actions> {
     mint<TFromAdapterCapabilities extends AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities>(source: BridgeParams$1<TFromAdapterCapabilities, TToAdapterCapabilities>['source'], destination: BridgeParams$1<TFromAdapterCapabilities, TToAdapterCapabilities>['destination'], attestation: AttestationMessage): Promise<PreparedChainRequest>;
 }
 
+/**
+ * An ERC-20 approval required before a prepaid-FORWARD burn.
+ *
+ * @example
+ * ```typescript
+ * const approval: FeeApproval = {
+ *   token: '0xUSDC...',
+ *   amount: 1_003_500_000n,
+ * }
+ * ```
+ */
+interface FeeApproval {
+    /**
+     * Token address to approve (the burn token and/or the ERC-20 fee token).
+     */
+    token: string;
+    /**
+     * Amount to approve to the `TokenMessengerWithFees` wrapper, in token minor units.
+     */
+    amount: bigint;
+}
+/**
+ * The resolved fee payment channel for a prepaid-FORWARD burn.
+ *
+ * @example
+ * ```typescript
+ * const plan: FeePaymentPlan = {
+ *   isNativeFee: false,
+ *   isBurnTokenFee: true,
+ *   nativeValue: 0n,
+ *   approvals: [{ token: '0xUSDC...', amount: 1_003_500_000n }],
+ * }
+ * ```
+ */
+interface FeePaymentPlan {
+    /**
+     * True when the fee is paid in native currency (`feeToken` is the zero address).
+     */
+    isNativeFee: boolean;
+    /**
+     * True when the fee token is the same token being burned (both USDC).
+     *
+     * In this case a single, combined approval covers both the burn and the fee,
+     * so the redundant second approval is skipped.
+     */
+    isBurnTokenFee: boolean;
+    /**
+     * Native value to attach as `msg.value`.
+     *
+     * Exactly `feeTotalAmount` for a native fee; `0n` for an ERC-20 fee.
+     */
+    nativeValue: bigint;
+    /**
+     * ERC-20 approvals required before the burn, each to the `TokenMessengerWithFees`
+     * wrapper.
+     *
+     * - Native fee: a single approval of `amount` for the burn token.
+     * - ERC-20 fee equal to the burn token: a single approval of `amount + feeTotalAmount`.
+     * - ERC-20 fee different from the burn token: two approvals — `amount` for the
+     *   burn token and `feeTotalAmount` for the fee token.
+     */
+    approvals: FeeApproval[];
+}
+
 /**
  * Configuration options for the CCTP v2 provider.
  *
@@ -12203,6 +12412,81 @@ interface CCTPV2Config {
      */
     headers?: Record<string, string>;
 }
+/**
+ * Parameters for a prepaid-FORWARD burn via {@link CCTPV2BridgingProvider.burnWithFees}.
+ *
+ * @typeParam TFromAdapterCapabilities - The source adapter's capabilities.
+ */
+interface BurnWithFeesParams<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> {
+    /**
+     * Source wallet context (adapter + CCTP v2 source chain).
+     */
+    source: WalletContext<TFromAdapterCapabilities, ChainDefinitionWithCCTPv2>;
+    /**
+     * Destination chain definition (provides the destination CCTP domain).
+     */
+    destinationChain: ChainDefinitionWithCCTPv2;
+    /**
+     * Amount of USDC to burn, in minor units.
+     */
+    amount: string | bigint;
+    /**
+     * The GenericExecutor address on the destination chain.
+     *
+     * Used for BOTH `mintRecipient` and `destinationCaller` (padded to bytes32 by
+     * the underlying action): the executor mints to itself and is the only account
+     * allowed to complete the transfer.
+     */
+    executor: string;
+    /**
+     * The `cctp-forward`-wrapped GenericExecutor hookData blob.
+     *
+     * Produced with `@core/utils`: wrap the bare blob from
+     * `buildDepositForGenericExecutorPayload(...).hookData` with
+     * `buildForwardingHookDataWithPayload(version, bareBlob)`. It must begin with
+     * the `cctp-forward` frame, or the wrapper reverts `ForwardFeeWithoutHook`.
+     *
+     * Pass the SAME wrapped bytes here that were bound to the FORWARD fee quote
+     * (`fetchFeeQuote` FORWARD `params.hookData`); mismatched bytes revert
+     * `QuoteArgsMismatch`. Do not pass the bare (`circle-generic-executor`) blob.
+     */
+    hookData: string;
+    /**
+     * Signed fee quote claim (`{ signedQuote, refundAddress }`).
+     */
+    claim: QuoteClaim;
+    /**
+     * Fee token from the quote. The zero address denotes a native fee.
+     */
+    feeToken: string;
+    /**
+     * Total fee amount from the quote, in `feeToken` minor units.
+     */
+    feeTotalAmount: string | bigint;
+}
+/**
+ * Result of {@link CCTPV2BridgingProvider.burnWithFees}.
+ *
+ * The prepared requests are returned unexecuted; the caller executes the
+ * approvals first (in order) and then the burn.
+ */
+interface BurnWithFeesResult {
+    /**
+     * ERC-20 approvals to the `TokenMessengerWithFees` wrapper required before the
+     * burn. Always contains at least one entry: the burn-token approval. A
+     * distinct fee-token approval is added only when the fee token differs from
+     * the burn token and is not the native token.
+     */
+    approvals: PreparedChainRequest[];
+    /**
+     * The prepared `depositForBurnWithHookAndFees` burn transaction.
+     */
+    burn: PreparedChainRequest;
+    /**
+     * The resolved fee payment plan (native value, approvals, and flags).
+     */
+    feePayment: FeePaymentPlan;
+}
 /**
  * Concrete implementation of BridgingProvider for Circle's Cross-Chain Transfer Protocol (CCTP) version 2.
  *
@@ -12711,6 +12995,57 @@ declare class CCTPV2BridgingProvider extends BridgingProvider<CCTPV2Actions> imp
      * ```
      */
     burn<TFromAdapterCapabilities extends AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities>(params: BridgeParams$1<TFromAdapterCapabilities, TToAdapterCapabilities>): Promise<PreparedChainRequest>;
+    /**
+     * Prepare a prepaid-FORWARD burn through the `TokenMessengerWithFees` wrapper.
+     *
+     * Builds the source-chain `depositForBurnWithHookAndFees` call for the
+     * GenericExecutor FORWARD path: fees are collected up front on the source chain
+     * against a signed quote, `mintRecipient` and `destinationCaller` are both set to
+     * the GenericExecutor, and the GE `hookData` is passed through unchanged.
+     *
+     * This is the low-level on-chain primitive behind the UBK `fastCrossChainDeposit`
+     * and Bridge Kit `bridge({ deposit })` flows. The `hookData` and signed-quote
+     * `claim` are produced elsewhere and passed in here:
+     * - `hookData`: `buildForwardingHookDataWithPayload(version,
+     *   buildDepositForGenericExecutorPayload(...).hookData)` from `@core/utils`.
+     * - `claim.signedQuote` / `feeToken` / `feeTotalAmount`: from `fetchFeeQuote`
+     *   (`@circle-fin/provider-fee-v1`), whose FORWARD item must be bound to the
+     *   SAME `hookData` and executor `destinationCaller` used here.
+     *
+     * The returned approvals and burn are NOT executed — the caller executes the
+     * approvals first (in order) and then the burn. The fee payment channel matches
+     * the quote's `feeToken`:
+     * - Native fee: exactly `feeTotalAmount` is attached as the burn's `msg.value`;
+     *   only the burn amount is approved.
+     * - USDC fee (same token as the burn): a single combined `amount + feeTotalAmount`
+     *   approval covers both; the redundant second approval is skipped.
+     *
+     * @typeParam TFromAdapterCapabilities - The source adapter's capabilities.
+     * @param params - The burn amount, executor, hookData, signed-quote claim, and fee.
+     * @returns The prepared approvals, the prepared burn, and the resolved fee plan.
+     * @throws {KitError} If the wallet context is invalid, `destinationChain` does not
+     *   support CCTP v2, the executor is missing, `amount` or `feeTotalAmount` is not
+     *   a bigint or a numeric string coercible to bigint, the hookData lacks a
+     *   `cctp-forward` frame (guaranteed `ForwardFeeWithoutHook`), or the operation
+     *   context cannot be resolved.
+     *
+     * @example
+     * ```typescript
+     * const { approvals, burn } = await provider.burnWithFees({
+     *   source,
+     *   destinationChain: Arc,
+     *   amount: 1_000_000n,
+     *   executor: genericExecutorAddress,
+     *   hookData: geForwardHookData,
+     *   claim: { signedQuote: '0x01...', refundAddress: userAddress },
+     *   feeToken: '0x0000000000000000000000000000000000000000', // native
+     *   feeTotalAmount: 3_500_000n,
+     * })
+     * for (const approval of approvals) await approval.execute()
+     * const txHash = await burn.execute()
+     * ```
+     */
+    burnWithFees<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: BurnWithFeesParams<TFromAdapterCapabilities>): Promise<BurnWithFeesResult>;
     /**
      * Waits for a transaction to be mined and confirmed on the blockchain.
      *
@@ -13553,6 +13888,29 @@ interface ServiceSwapConfig {
      * @example 'lifi', 'paraswap'
      */
     provider?: string;
+    /**
+     * Whether to fuse the ERC-20 approval and the swap into a single atomic
+     * batch when the adapter supports it (EIP-5792, or a signing strategy that
+     * declares atomic batching).
+     *
+     * @remarks
+     * Defaults to `true`. When batching is available this collapses the two
+     * sequential transactions of the on-chain approval path into one atomic
+     * submission — a single signing challenge for a smart-contract wallet. Set
+     * to `false` to force the sequential approve-then-swap path. Has no effect on
+     * the gasless permit path (already a single transaction) or on native-token
+     * swaps (no approval needed).
+     *
+     * The batch path relies on the wallet's own gas estimation for the swap call:
+     * the service-provided gas floor and pre-flight simulation that the sequential
+     * path applies are not conveyed through the batch. For a complex/multi-hop
+     * swap whose wallet-side estimate under-shoots, this can out-of-gas-revert the
+     * atomic batch where the sequential path would succeed — set `false` to fall
+     * back to the service-floored sequential path if you hit this.
+     *
+     * @defaultValue true
+     */
+    batchTransactions?: boolean;
 }
 /**
  * Parameters for initiating a swap operation through the Stablecoin Service.
@@ -13880,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.
      *
@@ -14987,9 +15356,10 @@ interface SwapDestinationLeg {
  * Parameters for {@link SwapKit.getSwapStatus}.
  *
  * @remarks
- * Only `txHash`, `chainIn`, and `kitKey` are required. Supply `chainOut`
- * when the original swap was cross-chain (source chain ≠ destination
- * chain).
+ * Only `txHash` and `chainIn` are required; `chainOut` and `kitKey` are
+ * optional. Supply `chainOut` when the original swap was cross-chain
+ * (source chain ≠ destination chain); omit `kitKey` to call in
+ * permissionless mode.
  *
  * The field names mirror {@link SwapResult.chainIn} / {@link
  * SwapResult.chainOut} so consumers can pipe a `SwapResult` straight into
@@ -15004,11 +15374,11 @@ interface SwapDestinationLeg {
  * ```typescript
  * const result = await kit.swap(params)
  *
+ * // Permissionless — no kit key needed. Pass `kitKey` to authenticate.
  * let status = await kit.getSwapStatus({
  *   txHash: result.txHash,
  *   chainIn: result.chainIn,
  *   chainOut: result.chainOut,
- *   kitKey: process.env.KIT_KEY ?? '',
  * })
  * while (status.progress.status === 'PENDING') {
  *   await new Promise((r) => setTimeout(r, 3_000))
@@ -15016,7 +15386,6 @@ interface SwapDestinationLeg {
  *     txHash: result.txHash,
  *     chainIn: result.chainIn,
  *     chainOut: result.chainOut,
- *     kitKey: process.env.KIT_KEY ?? '',
  *   })
  * }
  * ```
@@ -15044,8 +15413,11 @@ interface GetSwapStatusParams {
     /**
      * Stablecoin Service Kit Key used as a bearer credential for the status
      * request. Treat this value as a secret and do not log it.
+     *
+     * Optional — when omitted, the request is made without an `Authorization`
+     * header (permissionless mode).
      */
-    kitKey: string;
+    kitKey?: string;
 }
 /**
  * Result of a swap status lookup — a single snapshot of the swap's state at
@@ -15093,8 +15465,11 @@ interface WaitForSwapCommonParams {
     /**
      * Stablecoin Service Kit Key used as a bearer credential. Treat as a
      * secret and do not log it.
+     *
+     * Optional — when omitted, the request is made without an `Authorization`
+     * header (permissionless mode).
      */
-    readonly kitKey: string;
+    readonly kitKey?: string;
     /**
      * Overall wait budget, in milliseconds. The promise rejects with a
      * RETRYABLE {@link KitError} when this elapses without a terminal
@@ -15255,8 +15630,11 @@ interface GetTokenRatesParams {
     /**
      * Stablecoin Service Kit Key used as a bearer credential for the rates
      * request. Treat this value as a secret and do not log it.
+     *
+     * Optional — when omitted, the request is made without an `Authorization`
+     * header (permissionless mode).
      */
-    kitKey: string;
+    kitKey?: string;
 }
 /**
  * Result of a token rates lookup.
@@ -15420,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.
      *
@@ -15431,6 +15822,30 @@ interface SwapKitConfig<TExtraProviders extends FlexibleSwappingProvider[] = []>
     disableErrorReporting?: boolean;
 }
 
+/** @internal */
+declare const bridgeQuoteExpirySchema: z.ZodCatch<z.ZodOptional<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+    mode: z.ZodLiteral<"TIMESTAMP">;
+    expiresAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    mode: "TIMESTAMP";
+    expiresAt: string;
+}, {
+    mode: "TIMESTAMP";
+    expiresAt: string;
+}>, z.ZodObject<{
+    mode: z.ZodLiteral<"BLOCK_NUMBER">;
+    expiresAtBlock: z.ZodNumber;
+    blockEstimatedAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    mode: "BLOCK_NUMBER";
+    expiresAtBlock: number;
+    blockEstimatedAt?: string | undefined;
+}, {
+    mode: "BLOCK_NUMBER";
+    expiresAtBlock: number;
+    blockEstimatedAt?: string | undefined;
+}>]>>>;
+
 /**
  * Configuration options for the Earn Service provider.
  *
@@ -15504,6 +15919,7 @@ interface VaultRewardInfo {
  *   assetAddress: '0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf',
  *   lltv: 0.86,
  *   supplyUsd: 50000000.25,
+ *   allocationPct: 0.6,
  * }
  * ```
  */
@@ -15516,6 +15932,17 @@ interface CollateralInfo {
     readonly lltv: number;
     /** Approximate supplied value in USD, e.g. 50000000.25 for $50,000,000.25. */
     readonly supplyUsd: number;
+    /**
+     * Share of the vault's supply allocated to this collateral market
+     * (e.g., 0.6 = 60%).
+     *
+     * Populated for Morpho V1 vaults; `null` when the underlying product
+     * exposes no per-market allocation (e.g. Morpho V2). Optional for now — a
+     * backend that predates this field omits it entirely, matching the other
+     * optional facets on {@link EarnOpportunityBase}; a future release makes it
+     * required once every backend emits it.
+     */
+    readonly allocationPct?: number | null | undefined;
 }
 /**
  * Vault warning from the underlying earn protocol.
@@ -15535,65 +15962,253 @@ interface VaultWarning {
     readonly level: 'YELLOW' | 'RED';
 }
 /**
- * Describe a yield-bearing vault available through the earn service.
+ * Manager (e.g., curator) responsible for a yield opportunity.
+ *
+ * Generalizes Morpho's "curator". `null` on the opportunity when the
+ * underlying product has no per-opportunity manager (e.g., a pooled
+ * lending market).
  *
  * @example
  * ```typescript
- * const vault: VaultInfo = {
- *   vaultAddress: '0xAabbeF1D3971c710276ed41eC791BbE14CdB8E88',
- *   chain: 'Arc_Testnet',
- *   name: 'Steakhouse USDC',
- *   protocol: 'MORPHO',
- *   asset: 'USDC',
- *   assetAddress: '0x3600000000000000000000000000000000000000',
- *   currentApy: 0.0425,
- *   nativeApy: 0.035,
- *   vaultFee: 0.05,
- *   rewards: [{ token: 'MORPHO', tokenAddress: '0x...', apy: 0.0075 }],
- *   collateral: [{ asset: 'cbBTC', assetAddress: '0x...', lltv: 0.86, supplyUsd: 50000000.25 }],
- *   totalDeposits: Amount.fromJSON({ raw: '15000000000000', decimals: 6 }),
- *   liquidity: Amount.fromJSON({ raw: '5000000000000', decimals: 6 }),
+ * const manager: ManagerInfo = {
+ *   name: 'Steakhouse',
+ *   address: '0x...',
+ *   type: 'curator',
+ * }
+ * ```
+ */
+interface ManagerInfo {
+    /** Human-readable manager name. */
+    readonly name: string;
+    /** On-chain manager address, when the product exposes one. */
+    readonly address?: string | undefined;
+    /**
+     * Manager role within the product. Only `'curator'` is emitted today
+     * (Morpho V1/V2); additional roles are added as the providers that emit
+     * them land.
+     */
+    readonly type: 'curator';
+}
+/**
+ * Yield profile for an opportunity, including trailing averages.
+ *
+ * `current` is always present; trailing and native values are `null` when
+ * unavailable for this instance (e.g., a vault younger than the lookback
+ * window). `source`/`asOf` carry provenance for derived/staleness-prone
+ * values.
+ *
+ * @example
+ * ```typescript
+ * const apyProfile: ApyProfile = {
+ *   current: 0.085,
+ *   native: 0.071,
+ *   d7: 0.082,
+ *   d30: 0.079,
+ *   d90: 0.081,
+ *   rewardShare: 0.16,
+ *   source: 'morpho:avgNetApy',
+ *   asOf: '2026-06-23T18:00:00Z',
+ * }
+ * ```
+ */
+interface ApyProfile {
+    /** Current total APY including rewards. */
+    readonly current: number;
+    /** Native APY excluding reward incentives; `null` when unavailable. */
+    readonly native: number | null;
+    /** Trailing 7-day average net APY; `null` when unavailable. */
+    readonly d7: number | null;
+    /** Trailing 30-day average net APY; `null` when unavailable. */
+    readonly d30: number | null;
+    /** Trailing 90-day average net APY; `null` when unavailable. */
+    readonly d90: number | null;
+    /** Share of current APY attributable to rewards; `null` when unavailable. */
+    readonly rewardShare: number | null;
+    /** Provenance of the trailing values (`native` or `circle:<source>`). */
+    readonly source?: string | undefined;
+    /** RFC3339 timestamp of the newest input used for the trailing values. */
+    readonly asOf?: string | undefined;
+}
+/**
+ * Fee split for an opportunity.
+ *
+ * Each component is `null` when the product does not levy it (e.g., Morpho
+ * V1 vaults have no management fee).
+ *
+ * @example
+ * ```typescript
+ * const fee: FeeInfo = { performance: 0.1, management: null }
+ * ```
+ */
+interface FeeInfo {
+    /** Performance fee as a decimal (e.g., 0.1 = 10%); `null` when unavailable. */
+    readonly performance: number | null;
+    /** Management fee as a decimal; `null` when unavailable. */
+    readonly management: number | null;
+}
+/**
+ * Liquidity profile for an opportunity.
+ *
+ * @example
+ * ```typescript
+ * const liquidityProfile: LiquidityProfile = {
+ *   totalDeposits: Amount.fromJSON({ raw: '45000000000000', decimals: 6 }),
+ *   available: Amount.fromJSON({ raw: '5200000000000', decimals: 6 }),
+ *   totalSupply: Amount.fromJSON({ raw: '44900000000000000000', decimals: 18 }),
  *   status: 'active',
- *   circleGuarded: false,
  * }
  * ```
  */
-interface VaultInfo {
-    /** On-chain vault contract address. */
-    readonly vaultAddress: string;
-    /** Blockchain where the vault is deployed. */
+interface LiquidityProfile {
+    /** Total value deposited in base-unit amount form. */
+    readonly totalDeposits: Amount;
+    /** Available liquidity in base-unit amount form. */
+    readonly available: Amount;
+    /** Outstanding vault share tokens (ERC4626 totalSupply) in base-unit form. */
+    readonly totalSupply: Amount;
+    /** Current liquidity status. */
+    readonly status: 'active' | 'low_liquidity';
+}
+/**
+ * Risk signals for an opportunity.
+ *
+ * @example
+ * ```typescript
+ * const riskSignals: RiskSignals = {
+ *   circleSentinel: true,
+ *   warnings: [],
+ *   earnKitWarnings: [],
+ * }
+ * ```
+ */
+interface RiskSignals {
+    /** Whether the opportunity is covered by Circle Sentinel. */
+    readonly circleSentinel: boolean;
+    /** Protocol warnings for this opportunity. */
+    readonly warnings?: readonly VaultWarning[] | undefined;
+    /** Circle-specific warnings (e.g., unsupported reward protocol). */
+    readonly earnKitWarnings?: readonly string[] | undefined;
+}
+/**
+ * Facets common to every earn opportunity, plus the deprecated flat
+ * fields retained for backward compatibility.
+ *
+ * The flat aliases are emitted by the backend alongside the nested facets
+ * and mapped straight through, so existing consumers keep reading them until
+ * they are removed in a future major release. Narrow on
+ * {@link EarnOpportunity.productType} to access product-specific fields.
+ */
+interface EarnOpportunityBase {
+    /** Blockchain where the opportunity is deployed. */
     readonly chain: `${EarnChain}`;
-    /** Human-readable vault name. */
+    /** Human-readable opportunity name. */
     readonly name: string;
-    /** Vault protocol identifier. */
+    /** Protocol identifier. */
     readonly protocol: string;
     /** Underlying deposit asset symbol (e.g., 'USDC'). */
     readonly asset: string;
     /** Underlying deposit asset contract address. */
     readonly assetAddress: string;
-    /** Total annualized percentage yield including rewards. */
+    /** Reward tokens distributed by this opportunity. */
+    readonly rewards: readonly VaultRewardInfo[];
+    /** Primary on-chain address (protocol-neutral; replaces vaultAddress). */
+    readonly address?: string | undefined;
+    /** RFC3339 freshness timestamp: provider state ts, else cache sync time. */
+    readonly asOf?: string | undefined;
+    /** Manager/curator identity; `null` when the product has no manager. */
+    readonly manager?: ManagerInfo | null | undefined;
+    /** Yield profile including trailing averages. */
+    readonly apyProfile?: ApyProfile | undefined;
+    /** Fee split. */
+    readonly fee?: FeeInfo | undefined;
+    /** Liquidity profile. */
+    readonly liquidityProfile?: LiquidityProfile | undefined;
+    /** Risk signals. */
+    readonly riskSignals?: RiskSignals | undefined;
+    /** @deprecated use {@link EarnOpportunityBase.address} */
+    readonly vaultAddress: string;
+    /** @deprecated use {@link ApyProfile.current} via apyProfile */
     readonly currentApy: number;
-    /** Native APY excluding reward incentives. */
+    /** @deprecated use {@link ApyProfile.native} via apyProfile */
     readonly nativeApy: number;
-    /** Vault fee as a decimal (e.g., 0.05 = 5%). */
+    /** @deprecated use {@link FeeInfo.performance} via fee */
     readonly vaultFee: number;
-    /** Reward tokens distributed by this vault. */
-    readonly rewards: readonly VaultRewardInfo[];
-    /** Collateral markets backing this vault. */
-    readonly collateral: readonly CollateralInfo[];
-    /** Total value deposited in base-unit amount form. */
+    /** @deprecated use {@link LiquidityProfile.totalDeposits} via liquidityProfile */
     readonly totalDeposits: Amount;
-    /** Available liquidity in the vault. */
+    /** @deprecated use {@link LiquidityProfile.available} via liquidityProfile */
     readonly liquidity: Amount;
-    /** Current vault status. */
+    /** @deprecated use {@link LiquidityProfile.status} via liquidityProfile */
     readonly status: 'active' | 'low_liquidity';
-    /** Whether the vault is on Circle's curated Circle-guarded list. */
+    /** @deprecated use {@link RiskSignals.circleSentinel} via riskSignals */
     readonly circleGuarded: boolean;
-    /** Morpho protocol warnings for this vault. */
+    /** @deprecated use {@link RiskSignals.warnings} via riskSignals */
     readonly warnings?: readonly VaultWarning[] | undefined;
-    /** Circle-specific warnings (e.g., unsupported reward protocol). */
+    /** @deprecated use {@link RiskSignals.earnKitWarnings} via riskSignals */
     readonly earnKitWarnings?: readonly string[] | undefined;
 }
+/**
+ * A yield-bearing vault opportunity (`productType: 'vault'`).
+ *
+ * Carries the universal {@link EarnOpportunityBase} facets plus the
+ * vault-specific `collateral` markets.
+ *
+ * @example
+ * ```typescript
+ * const vault: VaultOpportunity = {
+ *   productType: 'vault',
+ *   address: '0x8eB67A509616cd6A7c1B3c8C21D48FF57df3d458',
+ *   chain: 'Arc_Testnet',
+ *   name: 'Steakhouse USDC',
+ *   protocol: 'MORPHO',
+ *   asset: 'USDC',
+ *   assetAddress: '0x3600000000000000000000000000000000000000',
+ *   asOf: '2026-06-23T18:00:00Z',
+ *   manager: { name: 'Steakhouse', address: '0x...', type: 'curator' },
+ *   apyProfile: { current: 0.085, native: 0.071, d7: 0.082, d30: 0.079, d90: 0.081, rewardShare: 0.16 },
+ *   fee: { performance: 0.1, management: null },
+ *   liquidityProfile: {
+ *     totalDeposits: Amount.fromJSON({ raw: '15000000000000', decimals: 6 }),
+ *     available: Amount.fromJSON({ raw: '5000000000000', decimals: 6 }),
+ *     totalSupply: Amount.fromJSON({ raw: '14950000000000000000', decimals: 18 }),
+ *     status: 'active',
+ *   },
+ *   riskSignals: { circleSentinel: true, warnings: [], earnKitWarnings: [] },
+ *   rewards: [{ token: 'MORPHO', tokenAddress: '0x...', apy: 0.0075 }],
+ *   collateral: [{ asset: 'cbBTC', assetAddress: '0x...', lltv: 0.86, supplyUsd: 50000000.25, allocationPct: 0.6 }],
+ *   // deprecated flat aliases (dual-emitted during migration)
+ *   vaultAddress: '0x8eB67A509616cd6A7c1B3c8C21D48FF57df3d458',
+ *   currentApy: 0.085,
+ *   nativeApy: 0.071,
+ *   vaultFee: 0.1,
+ *   totalDeposits: Amount.fromJSON({ raw: '15000000000000', decimals: 6 }),
+ *   liquidity: Amount.fromJSON({ raw: '5000000000000', decimals: 6 }),
+ *   status: 'active',
+ *   circleGuarded: true,
+ * }
+ * ```
+ */
+interface VaultOpportunity extends EarnOpportunityBase {
+    /**
+     * Universal discriminator identifying the opportunity shape.
+     *
+     * Optional for now — a backend that predates the field omits it, matching
+     * the other optional facets — so this release stays source-compatible for
+     * code that constructs the type. A future release makes it required once
+     * every backend emits it. Always present on responses from an emitting
+     * backend; narrow on it before reading product-specific fields.
+     */
+    readonly productType?: 'vault';
+    /** Collateral markets backing this vault. */
+    readonly collateral: readonly CollateralInfo[];
+}
+/**
+ * A yield opportunity available through the earn service.
+ *
+ * Modeled as a discriminated union on `productType` over a shared base.
+ * Only the `vault` variant ships today; additional product types (e.g.
+ * `lending_market`, `rwa_token`) are added as additive union members.
+ */
+type EarnOpportunity = VaultOpportunity;
 /**
  * Per-vault error from a batch vault lookup.
  *
@@ -15773,6 +16388,14 @@ interface AssetAmount {
      */
     readonly status?: string | undefined;
 }
+/**
+ * Source-fee quote expiry metadata returned by bridge prepare.
+ *
+ * `TIMESTAMP` expiries use an ISO-8601 UTC `expiresAt`; `BLOCK_NUMBER`
+ * expiries use a source-chain `expiresAtBlock`, with an optional ISO-8601 UTC
+ * `blockEstimatedAt` for when that block estimate was produced.
+ */
+type EarnBridgeQuoteExpiry = Readonly<Exclude<z.infer<typeof bridgeQuoteExpirySchema>, undefined>>;
 /**
  * Result of a deposit operation returned by
  * {@link EarningProvider.deposit}.
@@ -15873,6 +16496,13 @@ interface EarnCrossChainDepositResult {
      * @example '2026-05-19T00:00:00Z'
      */
     readonly expiresAt: string;
+    /** ISO-8601 UTC timestamp at which the source-fee quote was issued. */
+    readonly quoteIssuedAt?: string | undefined;
+    /**
+     * Optional source-fee quote expiry metadata for display and refresh UX.
+     * This deadline is independent of the prepared-bundle `expiresAt` above.
+     */
+    readonly quoteExpiry?: EarnBridgeQuoteExpiry | undefined;
 }
 /**
  * Status of one hop (source relay or destination mint) of a cross-chain
@@ -16349,27 +16979,21 @@ interface DepositQuoteInfo {
      */
     readonly fees: readonly AssetAmount[];
     /**
-     * Estimated native gas fees for the transactions needed to deposit
-     * (e.g. token approval and the deposit itself).
+     * Estimated native gas fees for the transactions needed to deposit (e.g.
+     * token approval and the deposit itself).
      *
      * Optional so that custom {@link EarningProvider} implementations are not
      * required to produce gas estimates. The bundled Earn Service provider
-     * always populates this with one entry per transaction in the flow. When an
-     * individual estimate cannot be produced, that entry is still present with
-     * `fees` set to `null` and `error` describing why — so a non-empty array
-     * does not imply every estimate succeeded; inspect each entry's `fees`.
-     *
-     * The number of entries depends on where estimation stopped: when the flow
-     * fails before the approval step is examined, a single entry named after
-     * the main action is returned. Look entries up by `name`, not by index.
-     *
-     * Each estimate simulates the transaction against current chain state.
-     * When a token approval is still pending (typically a first-time deposit),
-     * the deposit simulation reverts because the allowance is not yet in
-     * place, so the deposit entry resolves with `fees: null` while the
-     * approval entry still carries a real estimate. Render a fallback (e.g.
-     * "available after approval") for that case rather than treating it as an
-     * error.
+     * populates this from the server-side estimate returned on the quote, with
+     * one entry per action. Empty for cross-chain quotes, which resolve no
+     * single source chain.
+     *
+     * Each entry is the Earn Service's estimate for that action, so a pending
+     * token approval no longer causes the deposit entry to fail. An entry may
+     * still carry `fees: null` with an `error` when the service could not
+     * estimate it, so a non-empty array does not imply every estimate
+     * succeeded — inspect each entry's `fees` and look entries up by `name`,
+     * not by index.
      */
     readonly gasFees?: readonly EarnGasFeeEstimate$1[] | undefined;
 }
@@ -16410,26 +17034,21 @@ interface WithdrawalQuoteInfo {
      */
     readonly fees: readonly AssetAmount[];
     /**
-     * Estimated native gas fees for the transactions needed to withdraw.
+     * Estimated native gas fees for the transactions needed to withdraw (e.g.
+     * vault-share approval and the withdrawal itself).
      *
      * Optional so that custom {@link EarningProvider} implementations are not
      * required to produce gas estimates. The bundled Earn Service provider
-     * always populates this with one entry per transaction in the flow. When an
-     * individual estimate cannot be produced, that entry is still present with
-     * `fees` set to `null` and `error` describing why — so a non-empty array
-     * does not imply every estimate succeeded; inspect each entry's `fees`.
-     *
-     * The number of entries depends on where estimation stopped: when the flow
-     * fails before the approval step is examined, a single entry named after
-     * the main action is returned. Look entries up by `name`, not by index.
-     *
-     * Each estimate simulates the transaction against current chain state.
-     * When a vault-share approval is still pending (typically the first
-     * withdrawal from a vault), the withdrawal simulation reverts because the
-     * allowance is not yet in place, so the withdrawal entry resolves with
-     * `fees: null` while the approval entry still carries a real estimate.
-     * Render a fallback (e.g. "available after approval") for that case
-     * rather than treating it as an error.
+     * populates this from the server-side estimate returned on the quote, with
+     * one entry per action. Empty for cross-chain quotes, which resolve no
+     * single source chain.
+     *
+     * Each entry is the Earn Service's estimate for that action, so a pending
+     * vault-share approval no longer causes the withdrawal entry to fail. An
+     * entry may still carry `fees: null` with an `error` when the service could
+     * not estimate it, so a non-empty array does not imply every estimate
+     * succeeded — inspect each entry's `fees` and look entries up by `name`,
+     * not by index.
      */
     readonly gasFees?: readonly EarnGasFeeEstimate$1[] | undefined;
     /**
@@ -16462,16 +17081,13 @@ interface ClaimRewardsQuoteInfo {
     /** Reward tokens available for claiming. */
     readonly rewards: readonly AssetAmount[];
     /**
-     * Estimated native gas fees for claiming rewards. Empty when there are no
-     * rewards to claim.
+     * Estimated native gas fees for claiming rewards.
      *
      * Optional so that custom {@link EarningProvider} implementations are not
-     * required to produce gas estimates. Otherwise the bundled Earn Service
-     * provider populates this with one entry per claim transaction; when an
-     * estimate cannot be produced, that entry is still present with `fees` set
-     * to `null` and `error` describing why — so a non-empty array does not imply
-     * every estimate succeeded; inspect each entry's `fees`. Look entries up by
-     * `name`, not by index.
+     * required to produce gas estimates. The bundled Earn Service provider does
+     * not return a gas estimate for claim-rewards quotes, so this is always
+     * empty (`[]`); it is retained for API symmetry with the deposit and
+     * withdrawal quotes.
      */
     readonly gasFees?: readonly EarnGasFeeEstimate$1[] | undefined;
 }
@@ -16482,8 +17098,8 @@ interface ClaimRewardsQuoteInfo {
  * `vaults` while per-vault failures are in `errors`.
  */
 interface GetVaultsResult {
-    /** Successfully resolved vault information. */
-    readonly vaults: readonly VaultInfo[];
+    /** Successfully resolved opportunities. */
+    readonly vaults: readonly EarnOpportunity[];
     /** Per-vault errors for failed lookups. */
     readonly errors: readonly VaultError[];
 }
@@ -16536,7 +17152,7 @@ interface ExploreVaultsPagination {
  */
 interface ExploreVaultsResult {
     /** Vaults matching the query, in the requested sort order. */
-    readonly vaults: readonly VaultInfo[];
+    readonly vaults: readonly EarnOpportunity[];
     /** Pagination metadata for the query. */
     readonly pagination: ExploreVaultsPagination;
 }
@@ -17192,10 +17808,6 @@ declare class EarnServiceProvider implements EarningProvider {
     supportsRetry(error: unknown): boolean;
     /** {@inheritdoc} */
     retry(error: unknown): Promise<EarnDepositOutcome | EarnWithdrawResult | ClaimRewardsResult>;
-    private gasEstimateFailure;
-    private estimateDepositQuoteGasFees;
-    private estimateWithdrawalQuoteGasFees;
-    private estimateClaimRewardsQuoteGasFees;
     /** {@inheritdoc} */
     getDepositQuote<T extends AdapterCapabilities>(params: GetDepositQuoteServiceParams<T>): Promise<DepositQuoteInfo>;
     /** {@inheritdoc} */
@@ -17786,12 +18398,42 @@ type EarnAssetAmount = Omit<AssetAmount, 'amount'> & {
     /** Token amount in human-readable decimal format. */
     readonly amount: string;
 };
-/** Vault information returned by the SDK. */
-type EarnVaultInfo = Omit<VaultInfo, 'totalDeposits' | 'liquidity'> & {
+/**
+ * Distributive `Omit` over a union.
+ *
+ * A plain `Omit<Union, K>` is not distributive: `keyof (A | B)` collapses to
+ * the shared keys, dropping every variant-specific field and the discriminant
+ * narrowing. Distributing over each member preserves the union.
+ */
+type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
+/** Liquidity profile returned by the SDK with amounts as decimal strings. */
+type EarnLiquidityProfile = Omit<LiquidityProfile, 'totalDeposits' | 'available' | 'totalSupply'> & {
+    /** Total value deposited in human-readable decimal format. */
+    readonly totalDeposits: string;
+    /** Available liquidity in human-readable decimal format. */
+    readonly available: string;
+    /** Outstanding vault share tokens (ERC4626 totalSupply) in decimal format. */
+    readonly totalSupply: string;
+};
+/**
+ * Vault information returned by the SDK.
+ *
+ * Derived with a distributive `Omit` so each opportunity variant keeps its
+ * product-specific fields and the `productType` discriminant.
+ */
+type EarnVaultInfo = DistributiveOmit<EarnOpportunity, 'totalDeposits' | 'liquidity' | 'liquidityProfile'> & {
     /** Total value deposited in human-readable decimal format. */
     readonly totalDeposits: string;
     /** Available liquidity in the vault in human-readable decimal format. */
     readonly liquidity: string;
+    /**
+     * Liquidity profile with amounts as human-readable decimal strings.
+     *
+     * Optional during the expand/contract migration window: a backend that
+     * predates the nested facets omits it, so it is absent until the response
+     * carries it.
+     */
+    readonly liquidityProfile?: EarnLiquidityProfile;
 };
 /** Result of a batch vault lookup. */
 type EarnGetVaultsResult = Omit<GetVaultsResult, 'vaults'> & {
@@ -17921,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;
 }
 
 /**
@@ -17982,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
@@ -18994,22 +19661,27 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1: z.ZodOptional<z.ZodObject<{
                         wallet: z.ZodString;
                         minter: z.ZodString;
+                        depositForHandler: z.ZodOptional<z.ZodString>;
                     }, "strict", z.ZodTypeAny, {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     }, {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     }>>;
                 }, "strict", z.ZodTypeAny, {
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 }, {
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 }>;
                 forwarderSupported: z.ZodObject<{
@@ -19028,6 +19700,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19040,6 +19713,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19078,6 +19752,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19113,6 +19788,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19160,22 +19836,27 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1: z.ZodOptional<z.ZodObject<{
                         wallet: z.ZodString;
                         minter: z.ZodString;
+                        depositForHandler: z.ZodOptional<z.ZodString>;
                     }, "strict", z.ZodTypeAny, {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     }, {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     }>>;
                 }, "strict", z.ZodTypeAny, {
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 }, {
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 }>;
                 forwarderSupported: z.ZodObject<{
@@ -19194,6 +19875,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19206,6 +19888,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19242,6 +19925,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19276,6 +19960,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19311,6 +19996,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19345,6 +20031,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19380,6 +20067,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19414,6 +20102,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19452,6 +20141,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19486,6 +20176,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19524,6 +20215,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19558,6 +20250,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19605,6 +20298,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19639,6 +20333,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19682,6 +20377,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19716,6 +20412,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -19785,22 +20482,27 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1: z.ZodOptional<z.ZodObject<{
                     wallet: z.ZodString;
                     minter: z.ZodString;
+                    depositForHandler: z.ZodOptional<z.ZodString>;
                 }, "strict", z.ZodTypeAny, {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 }, {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 }>>;
             }, "strict", z.ZodTypeAny, {
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             }, {
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             }>;
             forwarderSupported: z.ZodObject<{
@@ -19819,6 +20521,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -19831,6 +20534,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -19869,6 +20573,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -19904,6 +20609,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -19951,22 +20657,27 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1: z.ZodOptional<z.ZodObject<{
                     wallet: z.ZodString;
                     minter: z.ZodString;
+                    depositForHandler: z.ZodOptional<z.ZodString>;
                 }, "strict", z.ZodTypeAny, {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 }, {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 }>>;
             }, "strict", z.ZodTypeAny, {
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             }, {
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             }>;
             forwarderSupported: z.ZodObject<{
@@ -19985,6 +20696,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -19997,6 +20709,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20033,6 +20746,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20067,6 +20781,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20102,6 +20817,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20136,6 +20852,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20171,6 +20888,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20205,6 +20923,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20256,6 +20975,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20290,6 +21010,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20337,6 +21058,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20371,6 +21093,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20447,22 +21170,27 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1: z.ZodOptional<z.ZodObject<{
                     wallet: z.ZodString;
                     minter: z.ZodString;
+                    depositForHandler: z.ZodOptional<z.ZodString>;
                 }, "strict", z.ZodTypeAny, {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 }, {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 }>>;
             }, "strict", z.ZodTypeAny, {
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             }, {
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             }>;
             forwarderSupported: z.ZodObject<{
@@ -20481,6 +21209,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20493,6 +21222,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20531,6 +21261,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20566,6 +21297,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20613,22 +21345,27 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1: z.ZodOptional<z.ZodObject<{
                     wallet: z.ZodString;
                     minter: z.ZodString;
+                    depositForHandler: z.ZodOptional<z.ZodString>;
                 }, "strict", z.ZodTypeAny, {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 }, {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 }>>;
             }, "strict", z.ZodTypeAny, {
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             }, {
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             }>;
             forwarderSupported: z.ZodObject<{
@@ -20647,6 +21384,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20659,6 +21397,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20695,6 +21434,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20729,6 +21469,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20764,6 +21505,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20798,6 +21540,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20833,6 +21576,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20867,6 +21611,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20918,6 +21663,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20952,6 +21698,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -20998,6 +21745,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -21032,6 +21780,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
                 v1?: {
                     wallet: string;
                     minter: string;
+                    depositForHandler?: string | undefined;
                 } | undefined;
             };
             forwarderSupported: {
@@ -21153,22 +21902,27 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1: z.ZodOptional<z.ZodObject<{
                         wallet: z.ZodString;
                         minter: z.ZodString;
+                        depositForHandler: z.ZodOptional<z.ZodString>;
                     }, "strict", z.ZodTypeAny, {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     }, {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     }>>;
                 }, "strict", z.ZodTypeAny, {
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 }, {
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 }>;
                 forwarderSupported: z.ZodObject<{
@@ -21187,6 +21941,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21199,6 +21954,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21237,6 +21993,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21272,6 +22029,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21319,22 +22077,27 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1: z.ZodOptional<z.ZodObject<{
                         wallet: z.ZodString;
                         minter: z.ZodString;
+                        depositForHandler: z.ZodOptional<z.ZodString>;
                     }, "strict", z.ZodTypeAny, {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     }, {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     }>>;
                 }, "strict", z.ZodTypeAny, {
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 }, {
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 }>;
                 forwarderSupported: z.ZodObject<{
@@ -21353,6 +22116,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21365,6 +22129,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21401,6 +22166,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21435,6 +22201,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21470,6 +22237,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21504,6 +22272,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21539,6 +22308,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21573,6 +22343,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21611,6 +22382,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21645,6 +22417,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21683,6 +22456,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21717,6 +22491,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21769,6 +22544,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21803,6 +22579,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21851,6 +22628,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -21885,6 +22663,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
                     v1?: {
                         wallet: string;
                         minter: string;
+                        depositForHandler?: string | undefined;
                     } | undefined;
                 };
                 forwarderSupported: {
@@ -23987,30 +24766,43 @@ interface AppKitContext {
      * Event handlers registered for AppKit operations.
      *
      * This property stores event handlers that are registered via the AppKit's
-     * `on()` method. Handlers are grouped by operation type. The current runtime
-     * bucket is `bridge`, and the context can add more operation buckets as AppKit
-     * wires action handlers for additional kits.
+     * `on()` method. Handlers are grouped by operation type. The runtime buckets
+     * are `bridge` and `earn`; the context can add more operation buckets as
+     * AppKit wires action handlers for additional kits.
      *
-     * Within each operation bucket, handlers are keyed by action name (for example,
-     * `bridge.approve`) or `*` for wildcard handlers. Each action can have multiple
-     * handlers registered, allowing multiple subscribers to listen to the same event.
+     * Within each operation bucket, handlers are keyed by action name (for
+     * example, `bridge.approve` or `earn.deposit`) or `*` for wildcard handlers.
+     * Each action can have multiple handlers registered, allowing multiple
+     * subscribers to listen to the same event.
      *
      * The handlers are stored in the context to allow deferred registration with
-     * underlying operation kits, enabling a clean separation between event registration
-     * and operation execution.
+     * underlying operation kits, enabling a clean separation between event
+     * registration and operation execution.
      *
      * @example
      * ```typescript
      * const context = createContext()
      * // Handlers registered via kit.on() are stored by operation type
-     * // Bridge handlers are registered with BridgeKit when bridge() is executed
+     * // Bridge handlers are registered with BridgeKit when bridge() runs
+     * // Earn handlers are registered with EarnKit when earn operations run
      * ```
      */
-    actions: Record<'bridge', Record<string, ((payload: unknown) => void)[]>>;
+    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).
      *
@@ -24032,6 +24824,7 @@ interface AppKitContext {
  * Earn operation namespace exposed as `kit.earn`.
  *
  * Mirrors the operations currently available from `@circle-fin/earn-kit`.
+ * Step events use the AppKit event API (`kit.on('earn.*')` / `kit.on('*')`).
  *
  * @example
  * ```typescript
@@ -24279,6 +25072,40 @@ interface AppKitEarnOperations {
      * @internal
      */
     getClaimRewardsQuote<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: GetClaimRewardsQuoteParams<TFromAdapterCapabilities>): Promise<EarnClaimRewardsQuoteInfo>;
+    /**
+     * Resume a multi-phase earn operation that previously failed.
+     *
+     * Pass the {@link KitError} caught from `deposit`, `withdraw`, or
+     * `claimRewards`. The error carries the original inputs and step
+     * progress, so completed phases (for example a successful token
+     * approval) can be skipped. Call `isRetryableError(error)` first.
+     *
+     * @remarks
+     * Retry re-fetches execution params and may re-submit the execute
+     * transaction. Treat this as best-effort recovery: if a prior attempt
+     * broadcast execute but failed before observing the receipt, that
+     * transaction may still be in flight.
+     *
+     * @param error - The error caught from a previous multi-phase earn operation
+     * @returns Promise resolving to the result of the resumed operation
+     * @throws If the error is not retryable or lacks earn retry context
+     *
+     * @example
+     * ```typescript
+     * import { AppKit, isRetryableError } from '@circle-fin/app-kit'
+     *
+     * const kit = new AppKit()
+     *
+     * try {
+     *   await kit.earn.deposit(params)
+     * } catch (error) {
+     *   if (isRetryableError(error)) {
+     *     const result = await kit.earn.retry(error)
+     *   }
+     * }
+     * ```
+     */
+    retry(error: unknown): Promise<EarnDepositOutcome | EarnWithdrawResult | EarnClaimRewardsResult>;
 }
 /**
  * Type for event handler functions that can be registered with the AppKit.
@@ -24426,21 +25253,31 @@ type AppKitBridgeActions = PrefixActions<'bridge', DefaultBridgeKitActions>;
  * to namespace them within the AppKit event system.
  */
 type AppKitUnifiedBalanceActions = PrefixActions<'unifiedBalance', GatewayV1Actions>;
+/**
+ * Prefixed earn actions for AppKit.
+ *
+ * Earn step events are exposed under the `earn.` namespace (for example
+ * `earn.deposit`, `earn.approve`, `earn.withdraw`) so they can be
+ * subscribed to via `kit.on()` alongside bridge and unified balance
+ * events.
+ */
+type AppKitEarnActions = PrefixActions<'earn', EarnActions>;
 /**
  * Union of all AppKit action names.
  */
-type AppKitActionName = keyof AppKitBridgeActions | keyof AppKitUnifiedBalanceActions;
+type AppKitActionName = keyof AppKitBridgeActions | keyof AppKitUnifiedBalanceActions | keyof AppKitEarnActions;
 /**
  * All actions available in AppKit.
  */
-type AppKitActions = AppKitBridgeActions & AppKitUnifiedBalanceActions;
+type AppKitActions = AppKitBridgeActions & AppKitUnifiedBalanceActions & AppKitEarnActions;
 
 /**
  * Parameters for creating a AppKit context.
  *
  * This type allows partial customization of the context while ensuring
  * that all required properties have sensible defaults. Users can override
- * specific methods while keeping the rest intact.
+ * specific methods while keeping the rest intact. Action handler buckets
+ * may also be supplied partially; missing buckets default to empty maps.
  *
  * @example
  * ```typescript
@@ -24452,7 +25289,9 @@ type AppKitActions = AppKitBridgeActions & AppKitUnifiedBalanceActions;
  * })
  * ```
  */
-type CreateContextParams = Partial<AppKitContext>;
+type CreateContextParams = Omit<Partial<AppKitContext>, 'actions'> & {
+    actions?: Partial<AppKitContext['actions']>;
+};
 
 /**
  * Destination for a Gateway spend (mint) operation.
@@ -24830,10 +25669,13 @@ interface ResolvedSpendParams<TFromAdapterCapabilities extends AdapterCapabiliti
  */
 type SpendFeeFunction = (params: ResolvedSpendParams) => Promise<string> | string;
 /**
- * Function that resolves the fee recipient address for a given source chain.
- * Called once per source chain in a multi-chain spend.
+ * Function that resolves the fee recipient address for a spend.
+ * Called once per spend, against the resolved **destination** chain —
+ * every fee burn intent in a spend mints to that single chain
+ * regardless of which source chain(s) funded it, so only one
+ * recipient address (valid on the destination chain) is ever needed.
  */
-type SpendFeeRecipientFunction = (feePayoutChain: ChainDefinition, params: ResolvedSpendParams) => Promise<string> | string;
+type SpendFeeRecipientFunction = (destinationChain: ChainDefinition, params: ResolvedSpendParams) => Promise<string> | string;
 /**
  * Policy for computing and routing custom developer fees.
  *
@@ -24843,11 +25685,54 @@ type SpendFeeRecipientFunction = (feePayoutChain: ChainDefinition, params: Resol
  * Fields that only exist after resolution (e.g. per-source allocations)
  * may be `undefined`.  Implementations should only rely on top-level
  * fields such as `to`, `token`, and `amount`.
+ *
+ * @remarks
+ * `resolveFeeRecipientAddress` is optional when you configure
+ * {@link UnifiedBalanceKit.setFeeRecipients} instead — the declarative
+ * map takes priority over this callback when both are present. Provide
+ * exactly one of the two; a policy with neither throws at spend time.
  */
 interface CustomFeePolicy {
     computeFee: SpendFeeFunction;
-    resolveFeeRecipientAddress: SpendFeeRecipientFunction;
+    resolveFeeRecipientAddress?: SpendFeeRecipientFunction;
 }
+/**
+ * Chain type group used to key {@link FeeRecipientsConfig}.
+ *
+ * @remarks
+ * Only `'evm'` and `'solana'` are live today (the only chain types the
+ * kit's provider currently supports). This is deliberately a narrow
+ * subset of `@core/chains`' broader `ChainType` union rather than a
+ * hardcoded two-field struct, so that support for additional non-EVM
+ * chain types (e.g. Stellar, Starknet) can be added later by adding
+ * new union members here — no restructuring of `FeeRecipientsConfig`
+ * or its consumers required.
+ */
+type FeeRecipientChainType = 'evm' | 'solana';
+/**
+ * Declarative map of fee recipient addresses, keyed by chain type.
+ *
+ * @remarks
+ * Set via {@link UnifiedBalanceKit.setFeeRecipients}. At spend time the
+ * kit resolves the spend's destination chain to its
+ * {@link FeeRecipientChainType} and looks up the matching entry —
+ * exactly one recipient is used per spend (see
+ * {@link SpendFeeRecipientFunction}). Provide entries for every chain
+ * type you expect to spend to; a spend to a destination chain type
+ * with no matching entry throws before any fee collection is
+ * attempted.
+ *
+ * @example
+ * ```typescript
+ * import type { FeeRecipientsConfig } from '@circle-fin/unified-balance-kit'
+ *
+ * const feeRecipients: FeeRecipientsConfig = {
+ *   evm: '0x1234567890123456789012345678901234567890',
+ *   solana: '9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM',
+ * }
+ * ```
+ */
+type FeeRecipientsConfig = Partial<Record<FeeRecipientChainType, string>>;
 /**
  * Fee category describing the origin of a fee line item.
  *
@@ -25684,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
@@ -25770,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.
@@ -25867,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'
@@ -26068,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.
@@ -26086,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
@@ -26161,6 +27069,43 @@ declare class AppKitUnifiedBalance {
      * ```
      */
     removeCustomFeePolicy(): void;
+    /**
+     * Set a declarative fee recipient map, keyed by chain type.
+     *
+     * Once set, `spend()`/`estimateSpend()` resolve the fee recipient by
+     * looking up the spend's destination chain type in this map — taking
+     * priority over `customFeePolicy`'s `resolveFeeRecipientAddress`
+     * callback.
+     *
+     * @remarks
+     * This only controls which address a fee is sent to — it does not by
+     * itself cause any fee to be charged. You still need
+     * `setCustomFeePolicy`'s `computeFee` to determine the fee amount;
+     * calling `setFeeRecipients` without ever calling `setCustomFeePolicy`
+     * throws at spend time (there is no `computeFee` to determine an
+     * amount).
+     *
+     * @param config - Fee recipient addresses keyed by chain type (e.g.
+     *   `{ evm: '0x...', solana: 'Sol...' }`).
+     *
+     * @example
+     * ```typescript
+     * kit.unifiedBalance.setFeeRecipients({
+     *   evm: '0x1234567890123456789012345678901234567890',
+     *   solana: '9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM',
+     * })
+     * ```
+     */
+    setFeeRecipients(config: FeeRecipientsConfig): void;
+    /**
+     * Remove the declarative fee recipient map.
+     *
+     * @example
+     * ```typescript
+     * kit.unifiedBalance.removeFeeRecipients()
+     * ```
+     */
+    removeFeeRecipients(): void;
 }
 
 interface DeveloperFeeHooks {
@@ -26174,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
@@ -26559,7 +27515,8 @@ declare class AppKit {
      * or `'NOT_FOUND'`). Use {@link AppKit.waitForSwap} if you'd rather
      * not write the polling loop yourself.
      *
-     * @param params - `txHash`, `chainIn`, optional `chainOut`, and `kitKey`.
+     * @param params - `txHash` and `chainIn`, plus optional `chainOut` and
+     *   `kitKey`.
      * @returns A snapshot of the swap's status at the time of the call.
      * @throws \{KitError\} If `chainIn` or `chainOut` is malformed.
      *
@@ -26671,7 +27628,7 @@ declare class AppKit {
      * translates to the chain's native sentinel address — `0xEee…` for EVM,
      * `1111…` for Solana — before querying the service.
      *
-     * @param params - `chain`, optional `tokens`, and `kitKey`.
+     * @param params - `chain`, plus optional `tokens` and `kitKey`.
      * @returns A nested map of `[chain][address] → { priceUSD, fetchedAt }`.
      * @throws \{KitError\} If `chain` is malformed, `tokens` exceeds 100
      *         entries, or any entry is neither a registered symbol nor a
@@ -26725,17 +27682,16 @@ declare class AppKit {
     /**
      * Register an event handler for a specific AppKit action.
      *
-     * Subscribe to events emitted during bridge or unified balance operations.
-     * Bridge events are prefixed with 'bridge.' and unified balance events
-     * with 'unifiedBalance.' to namespace them within the AppKit event system.
+     * Subscribe to step events from bridge, earn, or unified balance
+     * operations. Action names are namespaced: `bridge.*`, `earn.*`, and
+     * `unifiedBalance.*`. Use `'*'` to receive every action.
      *
-     * Handlers receive strongly-typed payloads based on the action name. Multiple
-     * handlers can be registered for the same action, and all will be invoked when
-     * the action occurs. Use the wildcard '*' to listen to all actions.
+     * Handlers receive strongly-typed payloads for the chosen action.
+     * Multiple handlers may be registered for the same action.
      *
      * @typeParam K - The action name to listen for
      * @param action - The namespaced action name or '*' for all actions
-     * @param handler - Callback function to invoke when the action occurs
+     * @param handler - Callback invoked when the action occurs
      *
      * @example
      * ```typescript
@@ -26748,6 +27704,11 @@ declare class AppKit {
      *   console.log('Approval transaction:', payload.values.txHash)
      * })
      *
+     * // Listen to earn deposit steps
+     * kit.on('earn.deposit', (payload) => {
+     *   console.log('Earn deposit step:', payload.values.state)
+     * })
+     *
      * // Listen to unified balance action
      * kit.on('unifiedBalance.gateway.spend.succeeded', (payload) => {
      *   console.log('Spend succeeded:', payload.data)
@@ -26792,6 +27753,16 @@ declare class AppKit {
      */
     off<K extends AppKitActionName>(action: K, handler: (payload: AppKitActions[K]) => void): void;
     off(action: '*', handler: (payload: AppKitActions[keyof AppKitActions]) => void): void;
+    /**
+     * Remove one handler from a deferred AppKit action bucket.
+     *
+     * Deletes the action key when its handler list becomes empty.
+     *
+     * @param handlers - Action bucket to update (`bridge` or `earn`)
+     * @param action - Stored action key, including namespace or `*`
+     * @param handler - Handler reference previously passed to {@link on}
+     */
+    private removeStoredActionHandler;
 }
 
 /**
@@ -26911,4 +27882,4 @@ declare function isTokenAddress(token: string, chain: ChainDefinition): token is
 declare function validateToken(token: string, chain: ChainDefinition): TokenValidationResult;
 
 export { AppKit, AppKitUnifiedBalance, BalanceError, Blockchain, BridgeChain, EarnChain, EarnError, EarnKit, InputError, KitError, NetworkError, OnchainError, RateLimitError, RpcError, ServiceError, SwapChain, TOKEN_ALIASES, TransferSpeed, UnifiedBalanceChain, anyDepositParamsSchema, claimRewardsParamsSchema, createEarnKitContext, depositParamsSchema, claimRewards as earnClaimRewards, deposit as earnDeposit, exploreVaults as earnExploreVaults, exploreVaultsIterator as earnExploreVaultsIterator, getClaimRewardsQuote as earnGetClaimRewardsQuote, getCrossChainDepositStatus as earnGetCrossChainDepositStatus, getCrossChainDepositStatusOutcome as earnGetCrossChainDepositStatusOutcome, getDepositQuote as earnGetDepositQuote, getPosition as earnGetPosition, getSupportedChains as earnGetSupportedChains, getVaults as earnGetVaults, getWithdrawalQuote as earnGetWithdrawalQuote, waitForCrossChainDeposit as earnWaitForCrossChainDeposit, withdraw as earnWithdraw, exploreVaultsIteratorParamsSchema, exploreVaultsParamsSchema, getClaimRewardsQuoteParamsSchema, getCrossChainDepositStatusParamsSchema, getDepositQuoteParamsSchema, getErrorCode, getErrorMessage, getPositionParamsSchema, getTokenDecimals, getVaultsParamsSchema, getWithdrawalQuoteParamsSchema, isBalanceError, isFatalError, isInputError, isKitError, isNetworkError, isOnchainError, isRateLimitError, isRetryableError, isRpcError, isServiceError, isTerminalCrossChainDepositStatus as isTerminalEarnCrossChainDepositStatus, isTokenAddress, isTokenAlias, isUserCancellationError, setExternalPrefix, validateToken, waitForCrossChainDepositParamsSchema, withdrawParamsSchema };
-export type { ActionHandler, AdapterContext, AllowanceStrategy$2 as AllowanceStrategy, AppKitActionName, AppKitActions, AppKitBridgeActions, AppKitConfig, AppKitContext, AppKitEarnOperations, AppKitUnifiedBalanceActions, BaseChainDefinition, BridgeConfig, CustomFeePolicy$2 as BridgeCustomFeePolicy, BridgeParams, BridgeResult, BridgeStep, CCTPConfig, CCTPMergedConfig, CCTPSplitConfig, ChainDefinition, Currency, DelegateStatus, DepositForParams, DepositParams, DepositResult, DeveloperFeeHooks, EVMChainDefinition, EarnAccruedRewardInfo, EarnAdapterContext, AnyDepositParams as EarnAnyDepositParams, EarnAssetAmount, EarnBridgeCctpStatus, EarnBridgeHopStatus, ClaimRewardsParams as EarnClaimRewardsParams, EarnClaimRewardsQuoteInfo, EarnClaimRewardsResult, EarnClaimedAmount, EarnClaimedRewardsResult, EarnConfig, EarnCrossChainDepositDestination, CrossChainDepositParams as EarnCrossChainDepositParams, EarnCrossChainDepositResult, EarnCrossChainDepositStatus, EarnCrossChainDepositWaitOutcome, EarnCrossChainDepositWaitResult, CrossChainGetDepositQuoteParams as EarnCrossChainGetDepositQuoteParams, EarnDepositOutcome, DepositParams$2 as EarnDepositParams, EarnDepositQuoteInfo, EarnDepositResult, ExploreVaultsIteratorParams as EarnExploreVaultsIteratorParams, ExploreVaultsPagination as EarnExploreVaultsPagination, ExploreVaultsParams as EarnExploreVaultsParams, EarnExploreVaultsResult, ExploreVaultsSortBy as EarnExploreVaultsSortBy, EarnGasFeeEstimate, EarnGasFeeEstimateBase, GetClaimRewardsQuoteParams as EarnGetClaimRewardsQuoteParams, GetCrossChainDepositStatusParams as EarnGetCrossChainDepositStatusParams, GetDepositQuoteParams as EarnGetDepositQuoteParams, GetPositionParams as EarnGetPositionParams, GetVaultsParams as EarnGetVaultsParams, EarnGetVaultsResult, GetWithdrawalQuoteParams as EarnGetWithdrawalQuoteParams, EarnKitConfig, EarnKitContext, EarnOperationParams, EarnPositionInfo, EarnPositionPnLInfo, EarningProvider as EarnProvider, SameChainDepositParams as EarnSameChainDepositParams, EarnSameChainDepositResult, SameChainGetDepositQuoteParams as EarnSameChainGetDepositQuoteParams, EarnServiceConfig, EarnVaultInfo, VaultQuery as EarnVaultQuery, WaitForCrossChainDepositParams as EarnWaitForCrossChainDepositParams, WithdrawParams as EarnWithdrawParams, EarnWithdrawResult, EarnWithdrawalQuoteInfo, ErrorDetails, EstimateResult$1 as EstimateResult, EstimateSpendResult, EstimatedGas, FeeOperationType, GetBalancesParams, GetBalancesResult, GetDelegateStatusParams, GetSupportedChainsOptions, GetSwapStatusParams, GetTokenRatesParams, GetTokenRatesResult, InitiateRemoveFundParams, InitiateRemoveFundResult, KitContractType, NonEVMChainDefinition, OperationParamsMap, OperationType, Recoverability, RemoveFundParams, RemoveFundResult, RetryContext, SendParams, SpendDestination, SpendParams, SpendResult, SwapConfig, CustomFeePolicy$1 as SwapCustomFeePolicy, SwapDestinationLeg, SwapEstimate, SwapFeeContext, SwapKitConfig, SwapKitContext, SwapParams, SwapProgress, SwapResult, SwapSourceLeg, SwapStatus, SwapStatusResult, SwapTerminalStatus, TokenInfo, TokenRate, UnifiedBalanceChainIdentifier, CustomFeePolicy as UnifiedBalanceCustomFeePolicy, UnifiedBalanceKitConfig, SupportedToken as UnifiedBalanceSupportedToken, UpdateDelegateParams, UpdateDelegateResult, VersionConfig, WaitForSwapDiscreteParams, WaitForSwapParams, WaitForSwapResultParams };
+export type { ActionHandler, AdapterContext, AllowanceStrategy$2 as AllowanceStrategy, AppKitActionName, AppKitActions, AppKitBridgeActions, AppKitConfig, AppKitContext, AppKitEarnActions, AppKitEarnOperations, AppKitUnifiedBalanceActions, BaseChainDefinition, BridgeConfig, CustomFeePolicy$2 as BridgeCustomFeePolicy, BridgeParams, BridgeResult, BridgeStep, CCTPConfig, CCTPMergedConfig, CCTPSplitConfig, ChainDefinition, Currency, DelegateStatus, DepositForParams, DepositParams, DepositResult, DeveloperFeeHooks, EVMChainDefinition, EarnAccruedRewardInfo, EarnAdapterContext, AnyDepositParams as EarnAnyDepositParams, EarnAssetAmount, EarnBridgeCctpStatus, EarnBridgeHopStatus, EarnBridgeQuoteExpiry, ClaimRewardsParams as EarnClaimRewardsParams, EarnClaimRewardsQuoteInfo, EarnClaimRewardsResult, EarnClaimedAmount, EarnClaimedRewardsResult, EarnConfig, EarnCrossChainDepositDestination, CrossChainDepositParams as EarnCrossChainDepositParams, EarnCrossChainDepositResult, EarnCrossChainDepositStatus, EarnCrossChainDepositWaitOutcome, EarnCrossChainDepositWaitResult, CrossChainGetDepositQuoteParams as EarnCrossChainGetDepositQuoteParams, EarnDepositOutcome, DepositParams$2 as EarnDepositParams, EarnDepositQuoteInfo, EarnDepositResult, ExploreVaultsIteratorParams as EarnExploreVaultsIteratorParams, ExploreVaultsPagination as EarnExploreVaultsPagination, ExploreVaultsParams as EarnExploreVaultsParams, EarnExploreVaultsResult, ExploreVaultsSortBy as EarnExploreVaultsSortBy, EarnGasFeeEstimate, EarnGasFeeEstimateBase, GetClaimRewardsQuoteParams as EarnGetClaimRewardsQuoteParams, GetCrossChainDepositStatusParams as EarnGetCrossChainDepositStatusParams, GetDepositQuoteParams as EarnGetDepositQuoteParams, GetPositionParams as EarnGetPositionParams, GetVaultsParams as EarnGetVaultsParams, EarnGetVaultsResult, GetWithdrawalQuoteParams as EarnGetWithdrawalQuoteParams, EarnKitConfig, EarnKitContext, EarnOperationParams, EarnPositionInfo, EarnPositionPnLInfo, EarningProvider as EarnProvider, SameChainDepositParams as EarnSameChainDepositParams, EarnSameChainDepositResult, SameChainGetDepositQuoteParams as EarnSameChainGetDepositQuoteParams, EarnServiceConfig, EarnVaultInfo, VaultQuery as EarnVaultQuery, WaitForCrossChainDepositParams as EarnWaitForCrossChainDepositParams, WithdrawParams as EarnWithdrawParams, EarnWithdrawResult, EarnWithdrawalQuoteInfo, ErrorDetails, EstimateResult$1 as EstimateResult, EstimateSpendResult, EstimatedGas, FeeOperationType, GetBalancesParams, GetBalancesResult, GetDelegateStatusParams, GetSupportedChainsOptions, GetSwapStatusParams, GetTokenRatesParams, GetTokenRatesResult, InitiateRemoveFundParams, InitiateRemoveFundResult, KitContractType, NonEVMChainDefinition, OperationParamsMap, OperationType, Recoverability, RemoveFundParams, RemoveFundResult, RetryContext, SendParams, SpendDestination, SpendParams, SpendResult, SwapConfig, CustomFeePolicy$1 as SwapCustomFeePolicy, SwapDestinationLeg, SwapEstimate, SwapFeeContext, SwapKitConfig, SwapKitContext, SwapParams, SwapProgress, SwapResult, SwapSourceLeg, SwapStatus, SwapStatusResult, SwapTerminalStatus, TokenInfo, TokenRate, UnifiedBalanceChainIdentifier, CustomFeePolicy as UnifiedBalanceCustomFeePolicy, FeeRecipientsConfig as UnifiedBalanceFeeRecipientsConfig, UnifiedBalanceKitConfig, SupportedToken as UnifiedBalanceSupportedToken, UpdateDelegateParams, UpdateDelegateResult, VersionConfig, WaitForSwapDiscreteParams, WaitForSwapParams, WaitForSwapResultParams };