@circle-fin/app-kit 1.16.0 → 1.17.0

package/index.d.cts

@@ -899,10 +899,10 @@ declare enum Blockchain {
  *
  * Unlike the full {@link Blockchain} enum, SwapChain includes mainnet
  * networks and explicitly whitelisted testnets (e.g., {@link Arc_Testnet})
- * where adapter contracts are deployed (CCTPv2 support).
+ * where Adapter contracts are deployed.
  *
  * Dynamic validation via {@link isSwapSupportedChain} ensures chains
- * automatically work when adapter contracts and supported tokens are deployed.
+ * automatically work when Adapter contracts and supported tokens are deployed.
  *
  * @example
  * ```typescript
@@ -942,20 +942,22 @@ declare enum SwapChain {
     HyperEVM = "HyperEVM",
     Monad = "Monad",
     Arc = "Arc",
+    Cronos = "Cronos",
+    Morph = "Morph",
     Arc_Testnet = "Arc_Testnet"
 }
 /**
  * Chain definition that supports swap operations.
  *
  * @remarks
- * Expanded from 4 to ~18 supported chains based on:
- * - CCTPv2 support (adapter contract deployed)
+ * Expanded from 4 to supported mainnets and whitelisted testnets based on:
+ * - A deployed Adapter contract, configured directly or through CCTP v2
  * - Mainnet chains plus whitelisted testnets (e.g., Arc Testnet)
  *
  * Use `isSwapSupportedChain()` for runtime validation.
  */
 type SwapChainDefinition = ChainDefinition & {
-    chain: Blockchain.Ethereum | Blockchain.Base | Blockchain.Polygon | Blockchain.Solana | Blockchain.Arbitrum | Blockchain.Optimism | Blockchain.Avalanche | Blockchain.Linea | Blockchain.Ink | Blockchain.World_Chain | Blockchain.Unichain | Blockchain.Plume | Blockchain.Sei | Blockchain.Sonic | Blockchain.XDC | Blockchain.HyperEVM | Blockchain.Monad | Blockchain.Arc | Blockchain.Arc_Testnet;
+    chain: Blockchain.Ethereum | Blockchain.Base | Blockchain.Polygon | Blockchain.Solana | Blockchain.Arbitrum | Blockchain.Optimism | Blockchain.Avalanche | Blockchain.Linea | Blockchain.Ink | Blockchain.World_Chain | Blockchain.Unichain | Blockchain.Plume | Blockchain.Sei | Blockchain.Sonic | Blockchain.XDC | Blockchain.HyperEVM | Blockchain.Monad | Blockchain.Arc | Blockchain.Cronos | Blockchain.Morph | Blockchain.Arc_Testnet;
 };
 /**
  * Chain identifier accepted by swap operations.
@@ -2195,6 +2197,7 @@ declare const Cronos: {
     };
     readonly kitContracts: {
         readonly bridge: "0xB3FA262d0fB521cc93bE83d87b322b8A23DAf3F0";
+        readonly adapter: "0x7FB8c7260b63934d8da38aF902f87ae6e284a845";
     };
 };
 
@@ -3043,6 +3046,7 @@ declare const Morph: {
     };
     readonly kitContracts: {
         readonly bridge: "0xB3FA262d0fB521cc93bE83d87b322b8A23DAf3F0";
+        readonly adapter: "0x7FB8c7260b63934d8da38aF902f87ae6e284a845";
     };
 };
 
@@ -8834,7 +8838,7 @@ declare const ServiceError: {
  * between input errors (fix your request) and service errors (retry later).
  *
  * Error code ranges:
- * - 1100-1106: INPUT errors — invalid, unsupported, or stale request state
+ * - 1100-1107: INPUT errors — invalid, unsupported, or stale request state
  * - 8100-8105: SERVICE errors — retryable backend/provider failures
  *
  * @example
@@ -8903,6 +8907,16 @@ declare const EarnError: {
         readonly name: "EARN_BRIDGE_QUOTE_EXPIRED";
         readonly type: ErrorType;
     };
+    /**
+     * The wallet's vault shares are inside the vault's share lock period, which
+     * starts at deposit. Surfaced as FATAL rather than RETRYABLE because the
+     * lock can last hours, so an immediate retry fails the same way.
+     */
+    readonly SHARES_LOCKED: {
+        readonly code: 1107;
+        readonly name: "EARN_SHARES_LOCKED";
+        readonly type: ErrorType;
+    };
     /** The proxy signing call failed — retryable. */
     readonly SIGNING_FAILED: {
         readonly code: 8100;
@@ -13226,6 +13240,25 @@ interface CCTPXTokenDeployment {
      * the same reason as {@link CCTPXTokenDeployment.tokenAddress}.
      */
     tokenManagerAddress: string;
+    /**
+     * Operator-controlled per-chain kill switch, surfaced by IRIS as of CCTPE-3979.
+     *
+     * - `true` or absent → the deployment is routable (back-compat with older IRIS
+     *   versions that do not return the field).
+     * - `false` → an operator has disabled this `(tokenId, domainId)` for CCTPx
+     *   transfer quotes. {@link findCCTPXDeployment} skips the row, so bridging
+     *   providers treat the chain as un-deployed for route-selection purposes.
+     *
+     * This field is purely informational for SDK consumers — route gating is
+     * applied internally. Expect it to flip without warning in response to
+     * incidents or operator policy; cache it with the same lifetime as the
+     * registry response, not longer.
+     *
+     * The `| undefined` in the type is required by `exactOptionalPropertyTypes`
+     * so Zod's `z.boolean().optional()` inferred shape assigns through this
+     * interface without a cast.
+     */
+    enabled?: boolean | undefined;
 }
 /** One CCTPx token from the IRIS registry, including all its per-chain deployments. */
 interface CCTPXToken {
@@ -17249,6 +17282,229 @@ declare class BridgeKit<TExtraProviders extends FlexibleBridgingProvider[] = []>
     removeCustomFeePolicy(): void;
 }
 
+/** Token metadata for one side of a swap route step. */
+interface SwapRouteToken {
+    readonly symbol: string;
+    readonly address: string;
+    readonly decimals: number;
+}
+/** Amount estimates for a swap route step, expressed in base units. */
+interface SwapRouteStepEstimate {
+    readonly fromAmount: string;
+    readonly toAmount: string;
+    readonly gasCostUSD?: string;
+}
+/** A single swap or bridge hop selected by the route provider. */
+interface SwapRouteStep {
+    /** Hop kind, for example `swap` or `bridge`. */
+    readonly type: string;
+    /** Protocol identifier, for example `cctp-v2`. */
+    readonly tool: string;
+    /** Display name for {@link SwapRouteStep.tool}. */
+    readonly toolName: string;
+    readonly fromToken: SwapRouteToken;
+    readonly toToken: SwapRouteToken;
+    readonly estimate: SwapRouteStepEstimate;
+    /** Provider-specific details that are not part of the stable step shape. */
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Provider and executable hops selected for a swap. */
+interface SwapRoute {
+    /**
+     * Provider that routed the swap, for example `lifi` or `circle`. Treat as
+     * an opaque identifier; new providers can appear without an SDK release.
+     */
+    readonly provider: string;
+    readonly steps: readonly SwapRouteStep[];
+    /** Provider-specific details that are not part of the stable route shape. */
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Latest cached USD rate for a single (chain, token) pair, as written by the
+ * Stablecoin Service's `token-rate-update` cron.
+ *
+ * @remarks
+ * The cron refreshes entries once per minute and they expire after 15 minutes
+ * of staleness. Inspect {@link TokenRate.fetchedAt} when freshness matters —
+ * a value older than a few minutes likely means the upstream provider was
+ * unreachable on the most recent run.
+ *
+ * @example
+ * ```typescript
+ * const rate: TokenRate = { priceUSD: '1.0001', fetchedAt: 1716240000000 }
+ * const ageMs = Date.now() - rate.fetchedAt
+ * ```
+ */
+interface TokenRate {
+    /**
+     * USD price as reported by the upstream provider.
+     *
+     * Returned as a string to preserve precision — parse with `Number` or a
+     * decimal library depending on how much precision callers need.
+     */
+    readonly priceUSD: string;
+    /**
+     * Unix timestamp in milliseconds at which the price was fetched from the
+     * upstream provider.
+     */
+    readonly fetchedAt: number;
+    /**
+     * On-chain decimal precision of the token, when the upstream provider
+     * reports it. Absent for tokens the provider has not catalogued.
+     *
+     * Use it to convert a raw base-unit balance into a human amount before
+     * multiplying by `priceUSD`: `balance / 10 ** decimals * Number(priceUSD)`.
+     */
+    readonly decimals?: number;
+}
+/**
+ * Response payload from `GET /v1/stablecoinKits/rates`.
+ *
+ * Nested map keyed first by chain name (matching the `Blockchain` enum), then
+ * by token address. Address keys preserve the service's canonical casing:
+ * EVM hex addresses are lowercased, Solana base58 mints are case-preserved.
+ *
+ * @remarks
+ * - A successful call always returns a `rates` object, but it may be empty
+ *   when no cached entries are found.
+ * - When `addresses` was supplied, missing addresses are simply absent —
+ *   there is no 404 for partial lookups.
+ *
+ * @example
+ * ```typescript
+ * const response: GetTokenRatesResponse = {
+ *   rates: {
+ *     Ethereum: {
+ *       '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48': {
+ *         priceUSD: '1.0001',
+ *         fetchedAt: 1716240000000,
+ *       },
+ *     },
+ *   },
+ * }
+ * ```
+ */
+interface GetTokenRatesResponse {
+    /**
+     * Nested map of token rates keyed by `[chain][address]`.
+     *
+     * Always present; may be an empty object when no rates are found.
+     */
+    readonly rates: Readonly<Record<string, Readonly<Record<string, TokenRate>>>>;
+}
+
+/**
+ * MOVED, not new. Lifted from providers/earn-service/src/validations/, where the
+ * same mapper existed; borrow-service uses it instead of adding a second copy.
+ */
+
+/**
+ * A single claimed (or claimable) reward token amount.
+ *
+ * @example
+ * ```typescript
+ * import type { ClaimedAmount } from '@core/service-client'
+ *
+ * const reward: ClaimedAmount = {
+ *   address: '0x9994E35Db50125E0DF82e4c2dde62496CE330999',
+ *   symbol: 'MORPHO',
+ *   amount: Amount.fromJSON({ raw: '12500000000000000000', decimals: 18 }),
+ * }
+ * ```
+ */
+interface ClaimedAmount$1 {
+    /** Reward token contract address. */
+    readonly address: string;
+    /** Reward token symbol. */
+    readonly symbol: string;
+    /** Claimed (or claimable) amount. */
+    readonly amount: Amount;
+}
+
+/**
+ * MOVED, not new. The claim-rewards result types previously declared
+ * identically in providers/earn-service/src/types.ts and
+ * providers/borrow-service/src/types.ts. Both now re-export from here.
+ */
+/**
+ * Provider-level result types for the claim-rewards contract.
+ *
+ * The claim-rewards contract returns the same shapes to every kit that
+ * consumes it, so these are declared once here rather than per service.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Result returned when no rewards were claimable.
+ *
+ * No transaction is submitted in this case, so there is no hash to report.
+ */
+interface NoClaimableRewardsResult {
+    /** Discriminant: nothing was claimable. */
+    readonly status: 'no_rewards';
+    /** Always empty. */
+    readonly rewards: readonly [];
+}
+/**
+ * Result returned after claimable rewards were submitted on-chain.
+ *
+ * The reward element type is parameterized so a service whose own claimed
+ * amount carries more than the contract-defined fields (e.g.
+ * `@circle-fin/provider-earn-service`, whose `ClaimedAmount` also has
+ * `type`/`status`) can reuse this shape without narrowing `rewards`.
+ *
+ * @typeParam TClaimedAmount - Element type of `rewards`. Defaults to the
+ * contract-defined {@link ClaimedAmount}.
+ *
+ * @example
+ * ```typescript
+ * // Contract-defined rewards.
+ * const claimed: ClaimedRewardsResult = {
+ *   status: 'claimed',
+ *   rewards: [],
+ *   txHash: '0xabc',
+ *   explorerUrl: 'https://example.com/tx/0xabc',
+ * }
+ * ```
+ */
+interface ClaimedRewardsResult$1<TClaimedAmount = ClaimedAmount$1> {
+    /** Discriminant: rewards were claimed. */
+    readonly status: 'claimed';
+    /** Reward token amounts that were claimed. */
+    readonly rewards: readonly TClaimedAmount[];
+    /** Hash of the confirmed claim transaction. */
+    readonly txHash: string;
+    /** Block-explorer URL for {@link ClaimedRewardsResult.txHash}. */
+    readonly explorerUrl: string;
+}
+/**
+ * Result of a claim-rewards operation, discriminated on `status`.
+ *
+ * @typeParam TClaimedAmount - Element type of the claimed `rewards`. Defaults
+ * to the contract-defined {@link ClaimedAmount}.
+ *
+ * @example
+ * ```typescript
+ * declare const result: ClaimRewardsResult
+ * if (result.status === 'claimed') {
+ *   console.log(result.txHash)
+ * }
+ * ```
+ */
+type ClaimRewardsResult$1<TClaimedAmount = ClaimedAmount$1> = NoClaimableRewardsResult | ClaimedRewardsResult$1<TClaimedAmount>;
+/**
+ * Read-only claimable-rewards quote.
+ *
+ * Services may extend this with their own optional fields (e.g. EarnKit
+ * carries an always-empty `gasFees` for symmetry with its other quotes); the
+ * `rewards` list itself is contract-defined and identical everywhere.
+ */
+interface ClaimRewardsQuoteInfo$1 {
+    /** Reward tokens currently available for claiming. */
+    readonly rewards: readonly ClaimedAmount$1[];
+}
+
 /**
  * Represents a token amount with its symbol and value.
  *
@@ -17447,7 +17703,7 @@ interface ServiceSwapConfig {
      *
      * @defaultValue true
      */
-    batchTransactions?: boolean;
+    batchTransactions?: boolean | undefined;
 }
 /**
  * Parameters for initiating a swap operation through the Stablecoin Service.
@@ -17600,6 +17856,14 @@ interface ServiceSwapFee {
      * addresses are not available from the proxy response.
      */
     readonly recipientAddress?: string;
+    /** Provider-defined fee component (for example `FORWARD`). */
+    readonly component?: string;
+    /**
+     * Chain on which the fee is charged, as reported by the service
+     * (a `Blockchain` value such as `'Ethereum'`). Not validated
+     * against the `Blockchain` enum.
+     */
+    readonly chain?: string;
 }
 /**
  * Result from estimating a swap operation through the Stablecoin Service.
@@ -17662,6 +17926,8 @@ interface EstimateResult {
      * and kit fees (if configured). Amounts are in decimal format for display.
      */
     readonly fees?: readonly ServiceSwapFee[];
+    /** Provider and executable hops selected for the swap. */
+    readonly route?: SwapRoute;
 }
 /**
  * Individual executed transaction in a swap operation.
@@ -17799,6 +18065,8 @@ interface SwapResult$1 {
      * fees (charged by the DEX aggregator/protocol) and kit fees.
      */
     readonly fees?: readonly ServiceSwapFee[];
+    /** Provider and executable hops selected for the swap. */
+    readonly route?: SwapRoute;
     /**
      * Lifecycle snapshot: `status`, `substatus`, and `substatusMessage`.
      *
@@ -17985,192 +18253,6 @@ interface SwappingProvider {
     swap<TFromAdapterCapabilities extends AdapterCapabilities>(params: ServiceSwapParams<TFromAdapterCapabilities>): Promise<SwapResult$1>;
 }
 
-/**
- * Latest cached USD rate for a single (chain, token) pair, as written by the
- * Stablecoin Service's `token-rate-update` cron.
- *
- * @remarks
- * The cron refreshes entries once per minute and they expire after 15 minutes
- * of staleness. Inspect {@link TokenRate.fetchedAt} when freshness matters —
- * a value older than a few minutes likely means the upstream provider was
- * unreachable on the most recent run.
- *
- * @example
- * ```typescript
- * const rate: TokenRate = { priceUSD: '1.0001', fetchedAt: 1716240000000 }
- * const ageMs = Date.now() - rate.fetchedAt
- * ```
- */
-interface TokenRate {
-    /**
-     * USD price as reported by the upstream provider.
-     *
-     * Returned as a string to preserve precision — parse with `Number` or a
-     * decimal library depending on how much precision callers need.
-     */
-    readonly priceUSD: string;
-    /**
-     * Unix timestamp in milliseconds at which the price was fetched from the
-     * upstream provider.
-     */
-    readonly fetchedAt: number;
-    /**
-     * On-chain decimal precision of the token, when the upstream provider
-     * reports it. Absent for tokens the provider has not catalogued.
-     *
-     * Use it to convert a raw base-unit balance into a human amount before
-     * multiplying by `priceUSD`: `balance / 10 ** decimals * Number(priceUSD)`.
-     */
-    readonly decimals?: number;
-}
-/**
- * Response payload from `GET /v1/stablecoinKits/rates`.
- *
- * Nested map keyed first by chain name (matching the `Blockchain` enum), then
- * by token address. Address keys preserve the service's canonical casing:
- * EVM hex addresses are lowercased, Solana base58 mints are case-preserved.
- *
- * @remarks
- * - A successful call always returns a `rates` object, but it may be empty
- *   when no cached entries are found.
- * - When `addresses` was supplied, missing addresses are simply absent —
- *   there is no 404 for partial lookups.
- *
- * @example
- * ```typescript
- * const response: GetTokenRatesResponse = {
- *   rates: {
- *     Ethereum: {
- *       '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48': {
- *         priceUSD: '1.0001',
- *         fetchedAt: 1716240000000,
- *       },
- *     },
- *   },
- * }
- * ```
- */
-interface GetTokenRatesResponse {
-    /**
-     * Nested map of token rates keyed by `[chain][address]`.
-     *
-     * Always present; may be an empty object when no rates are found.
-     */
-    readonly rates: Readonly<Record<string, Readonly<Record<string, TokenRate>>>>;
-}
-
-/**
- * MOVED, not new. Lifted from providers/earn-service/src/validations/, where the
- * same mapper existed; borrow-service uses it instead of adding a second copy.
- */
-
-/**
- * A single claimed (or claimable) reward token amount.
- *
- * @example
- * ```typescript
- * import type { ClaimedAmount } from '@core/service-client'
- *
- * const reward: ClaimedAmount = {
- *   address: '0x9994E35Db50125E0DF82e4c2dde62496CE330999',
- *   symbol: 'MORPHO',
- *   amount: Amount.fromJSON({ raw: '12500000000000000000', decimals: 18 }),
- * }
- * ```
- */
-interface ClaimedAmount$1 {
-    /** Reward token contract address. */
-    readonly address: string;
-    /** Reward token symbol. */
-    readonly symbol: string;
-    /** Claimed (or claimable) amount. */
-    readonly amount: Amount;
-}
-
-/**
- * MOVED, not new. The claim-rewards result types previously declared
- * identically in providers/earn-service/src/types.ts and
- * providers/borrow-service/src/types.ts. Both now re-export from here.
- */
-/**
- * Provider-level result types for the claim-rewards contract.
- *
- * The claim-rewards contract returns the same shapes to every kit that
- * consumes it, so these are declared once here rather than per service.
- *
- * @packageDocumentation
- */
-
-/**
- * Result returned when no rewards were claimable.
- *
- * No transaction is submitted in this case, so there is no hash to report.
- */
-interface NoClaimableRewardsResult {
-    /** Discriminant: nothing was claimable. */
-    readonly status: 'no_rewards';
-    /** Always empty. */
-    readonly rewards: readonly [];
-}
-/**
- * Result returned after claimable rewards were submitted on-chain.
- *
- * The reward element type is parameterized so a service whose own claimed
- * amount carries more than the contract-defined fields (e.g.
- * `@circle-fin/provider-earn-service`, whose `ClaimedAmount` also has
- * `type`/`status`) can reuse this shape without narrowing `rewards`.
- *
- * @typeParam TClaimedAmount - Element type of `rewards`. Defaults to the
- * contract-defined {@link ClaimedAmount}.
- *
- * @example
- * ```typescript
- * // Contract-defined rewards.
- * const claimed: ClaimedRewardsResult = {
- *   status: 'claimed',
- *   rewards: [],
- *   txHash: '0xabc',
- *   explorerUrl: 'https://example.com/tx/0xabc',
- * }
- * ```
- */
-interface ClaimedRewardsResult$1<TClaimedAmount = ClaimedAmount$1> {
-    /** Discriminant: rewards were claimed. */
-    readonly status: 'claimed';
-    /** Reward token amounts that were claimed. */
-    readonly rewards: readonly TClaimedAmount[];
-    /** Hash of the confirmed claim transaction. */
-    readonly txHash: string;
-    /** Block-explorer URL for {@link ClaimedRewardsResult.txHash}. */
-    readonly explorerUrl: string;
-}
-/**
- * Result of a claim-rewards operation, discriminated on `status`.
- *
- * @typeParam TClaimedAmount - Element type of the claimed `rewards`. Defaults
- * to the contract-defined {@link ClaimedAmount}.
- *
- * @example
- * ```typescript
- * declare const result: ClaimRewardsResult
- * if (result.status === 'claimed') {
- *   console.log(result.txHash)
- * }
- * ```
- */
-type ClaimRewardsResult$1<TClaimedAmount = ClaimedAmount$1> = NoClaimableRewardsResult | ClaimedRewardsResult$1<TClaimedAmount>;
-/**
- * Read-only claimable-rewards quote.
- *
- * Services may extend this with their own optional fields (e.g. EarnKit
- * carries an always-empty `gasFees` for symmetry with its other quotes); the
- * `rewards` list itself is contract-defined and identical everywhere.
- */
-interface ClaimRewardsQuoteInfo$1 {
-    /** Reward tokens currently available for claiming. */
-    readonly rewards: readonly ClaimedAmount$1[];
-}
-
 /**
  * A type alias that enables flexible provider type handling.
  *
@@ -18543,6 +18625,33 @@ interface SwapConfig {
      * `apiKey` is omitted, and `apiKey` takes precedence when both are set.
      */
     kitKey?: string;
+    /**
+     * Enable or disable atomic batched execution of the approval and swap.
+     *
+     * When `true` (or omitted), an EVM swap that needs an on-chain ERC-20
+     * approval submits the approval and the swap as one atomic batch if the
+     * connected wallet supports it (EIP-5792, or a signing strategy that
+     * declares atomic batching). Set to `false` to force the sequential
+     * approve-then-swap flow.
+     *
+     * @remarks
+     * Has no effect on the gasless permit path, native-token swaps, or Solana,
+     * which already execute as a single transaction. USDT input always uses the
+     * sequential path because its allowance must be reset to zero first. The
+     * batched path relies on the wallet's own gas estimation for the swap call;
+     * set `false` if your wallet under-estimates gas for complex routes or
+     * rejects batched calls.
+     *
+     * @defaultValue `undefined` (batching attempted when the wallet supports it)
+     *
+     * @example
+     * ```typescript
+     * const config: SwapConfig = {
+     *   batchTransactions: false, // force sequential approve → swap
+     * }
+     * ```
+     */
+    batchTransactions?: boolean | undefined;
 }
 /**
  * Estimation result for a swap operation.
@@ -18655,6 +18764,8 @@ interface SwapEstimate {
      * and kit fees (if configured). Amounts are in decimal format for display.
      */
     readonly fees?: readonly ServiceSwapFee[];
+    /** Provider and executable hops selected for the swap. */
+    readonly route?: SwapRoute;
 }
 /**
  * Configuration for swap results.
@@ -18795,6 +18906,8 @@ interface SwapResult {
      * fees (charged by the DEX aggregator/protocol) and kit fees.
      */
     fees?: readonly ServiceSwapFee[];
+    /** Provider and executable hops selected for the swap. */
+    readonly route?: SwapRoute;
     /**
      * Lifecycle snapshot: `status`, `substatus`, and `substatusMessage`.
      *
@@ -47287,6 +47400,8 @@ type OnrampEventEnvelope = OnrampInitializationErrorEnvelope | OnrampInitializat
  *   re-mint.
  * - `traceId` — the trace id the server stamped when minting. Echoed
  *   back so the client can tag widget events with the same id.
+ * - `metadata`: string map echoed on the create response, when the API
+ *   sends one. Forwarded to the browser with the rest of the session.
  */
 interface OnrampSession {
     /**
@@ -47340,6 +47455,18 @@ interface OnrampSession {
      * id.
      */
     readonly traceId?: string;
+    /**
+     * Request `metadata` as the Onramp API echoed it on the create response.
+     *
+     * @remarks
+     * Present only for a well-formed echo, never copied from the request
+     * params, so absence means the API did not echo it. Returned once: not
+     * sealed into the session token or delivered on later events. A host
+     * that forwards the session to the browser (including via
+     * `createSessionRouteHandler`) also forwards this field, so do not put
+     * server-only values in it.
+     */
+    readonly metadata?: Readonly<Record<string, string>>;
     /**
      * Index signature keeping the type tolerant of additive fields.
      *
@@ -47712,9 +47839,8 @@ type OnrampWindowResult = {
  * contract.
  *
  * Validation is intentionally conservative: only the fields the kit
- * actually consumes (or rejects on shape grounds) are checked. Free-
- * form fields like `metadata` pass through so wallets-api can layer
- * its own validation on top without the SDK lagging behind.
+ * actually consumes (or rejects on shape grounds) are checked.
+ * `metadata` is a string map. The Onramp API owns its limits.
  *
  * @packageDocumentation
  */
@@ -47806,7 +47932,7 @@ declare const onrampSessionRequestSchema: z.ZodObject<{
             chain: string;
         }[] | undefined;
     }>>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     appUserId: string;
     destinationAddress: string;
@@ -47822,7 +47948,7 @@ declare const onrampSessionRequestSchema: z.ZodObject<{
             chain: string;
         }[] | undefined;
     } | undefined;
-    metadata?: Record<string, unknown> | undefined;
+    metadata?: Record<string, string> | undefined;
 }, {
     appUserId: string;
     destinationAddress: string;
@@ -47838,7 +47964,7 @@ declare const onrampSessionRequestSchema: z.ZodObject<{
             chain: string;
         }[] | undefined;
     } | undefined;
-    metadata?: Record<string, unknown> | undefined;
+    metadata?: Record<string, string> | undefined;
 }>;
 /**
  * A single token↔chain pair a host app wants to offer.
@@ -47893,8 +48019,11 @@ type OnrampAssetSelection = z.infer<typeof onrampAssetSelectionSchema>;
  * - `assets`: optional host-app scoping for the asset selector (which
  *   token/chain pairs the widget offers). See {@link OnrampAssetSelection}.
  *   Baked into the launch URL at mint time; never forwarded to wallets-api.
- * - `metadata`: free-form passthrough — useful for re-stitching the
- *   session back to the host's order ledger.
+ * - `metadata`: optional string map. The Onramp API rejects more than 20
+ *   keys, keys over 64 characters, values over 1024 characters, and
+ *   control characters. It is echoed once on the create response (see
+ *   {@link OnrampSession.metadata}) and is not delivered on later widget
+ *   events, so use `appUserId` to correlate the user.
  *
  * Note: the embedding-domain allowlist entry (`referrerDomain`) is **not**
  * part of this request. It is a server-only concern configured on
@@ -53737,4 +53866,4 @@ declare function isTokenAddress(token: string, chain: ChainDefinition): token is
 declare function validateToken(token: string, chain: ChainDefinition): TokenValidationResult;
 
 export { AppKit, AppKitUnifiedBalance, BalanceError, Blockchain, BorrowChain, BorrowError, BorrowKit, BorrowServiceProvider, BridgeChain, EARN_EXECUTE_REVIEW_KIND, EarnChain, EarnError, EarnKit, InputError, KitError, NetworkError, OnchainError, QUOTE_NOT_REUSED_WARNING_CODE, RateLimitError, RpcError, SPEED_DOWNGRADED_WARNING_CODE, ServiceError, SwapChain, TOKEN_ALIASES, TransferSpeed, UnifiedBalanceChain, anyDepositParamsSchema, assertBorrowParams, addCollateral as borrowAddCollateral, addCollateralParamsSchema as borrowAddCollateralParamsSchema, addCollateralQuoteParamsSchema as borrowAddCollateralQuoteParamsSchema, borrow as borrowBorrow, claimRewards as borrowClaimRewards, claimRewardsParamsSchema as borrowClaimRewardsParamsSchema, closeLoan as borrowCloseLoan, closeLoanParamsSchema as borrowCloseLoanParamsSchema, closeLoanQuoteParamsSchema as borrowCloseLoanQuoteParamsSchema, exploreMarkets as borrowExploreMarkets, exploreMarketsIterator as borrowExploreMarketsIterator, exploreMarketsIteratorParamsSchema as borrowExploreMarketsIteratorParamsSchema, exploreMarketsParamsSchema as borrowExploreMarketsParamsSchema, getAddCollateralQuote as borrowGetAddCollateralQuote, getBorrowQuote as borrowGetBorrowQuote, getClaimRewardsQuote as borrowGetClaimRewardsQuote, getClaimRewardsQuoteParamsSchema as borrowGetClaimRewardsQuoteParamsSchema, getCloseLoanQuote as borrowGetCloseLoanQuote, getIntegratorConfig as borrowGetIntegratorConfig, getIntegratorConfigParamsSchema as borrowGetIntegratorConfigParamsSchema, getLoans as borrowGetLoans, getLoansParamsSchema as borrowGetLoansParamsSchema, getMarket as borrowGetMarket, getMarketParamsSchema as borrowGetMarketParamsSchema, getMaxBorrow as borrowGetMaxBorrow, getPosition as borrowGetPosition, getPositionParamsSchema as borrowGetPositionParamsSchema, getRepayQuote as borrowGetRepayQuote, getRequiredCollateral as borrowGetRequiredCollateral, getSupportedChains as borrowGetSupportedChains, getWithdrawCollateralRepayIfNeededQuote as borrowGetWithdrawCollateralRepayIfNeededQuote, borrowParamsSchema, borrowQuoteParamsSchema, registerWebhook as borrowRegisterWebhook, registerWebhookParamsSchema as borrowRegisterWebhookParamsSchema, repay as borrowRepay, repayParamsSchema as borrowRepayParamsSchema, repayQuoteParamsSchema as borrowRepayQuoteParamsSchema, requiredCollateralParamsSchema as borrowRequiredCollateralParamsSchema, setIntegratorConfig as borrowSetIntegratorConfig, setIntegratorConfigParamsSchema as borrowSetIntegratorConfigParamsSchema, withdrawCollateralParamsSchema as borrowWithdrawCollateralParamsSchema, withdrawCollateralQuoteParamsSchema as borrowWithdrawCollateralQuoteParamsSchema, withdrawCollateralRepayIfNeeded as borrowWithdrawCollateralRepayIfNeeded, claimRewardsParamsSchema$1 as claimRewardsParamsSchema, createBorrowKitContext, createEarnKitContext, depositParamsSchema, claimRewards$1 as earnClaimRewards, deposit as earnDeposit, exploreVaults as earnExploreVaults, exploreVaultsIterator as earnExploreVaultsIterator, getClaimRewardsQuote$1 as earnGetClaimRewardsQuote, getCrossChainDepositStatus as earnGetCrossChainDepositStatus, getCrossChainDepositStatusOutcome as earnGetCrossChainDepositStatusOutcome, getDepositQuote as earnGetDepositQuote, getPosition$1 as earnGetPosition, getSupportedChains$1 as earnGetSupportedChains, getVaults as earnGetVaults, getWithdrawalQuote as earnGetWithdrawalQuote, waitForCrossChainDeposit as earnWaitForCrossChainDeposit, withdraw as earnWithdraw, exploreVaultsIteratorParamsSchema, exploreVaultsParamsSchema, getClaimRewardsQuoteParamsSchema$1 as getClaimRewardsQuoteParamsSchema, getCrossChainDepositStatusParamsSchema, getDepositQuoteParamsSchema, getErrorCode, getErrorMessage, getPositionParamsSchema$1 as getPositionParamsSchema, getTokenDecimals, getVaultsParamsSchema, getWithdrawalQuoteParamsSchema, isBalanceError, isBorrowErrorTrace, isEarnExecuteReview, isFatalError, isInputError, isKitError, isNetworkError, isOnchainError, isRateLimitError, isResumableError, isRetryableError, isRpcError, isServiceError, isTerminalCrossChainDepositStatus as isTerminalEarnCrossChainDepositStatus, isTokenAddress, isTokenAlias, isUserCancellationError, maxBorrowParamsSchema, retryBorrow, setExternalPrefix, validateToken, waitForCrossChainDepositParamsSchema, withdrawParamsSchema };
-export type { ActionHandler, AdapterContext, AllowanceStrategy$2 as AllowanceStrategy, AppKitActionName, AppKitActions, AppKitBorrowActions, AppKitBorrowOperations, AppKitBridgeActions, AppKitConfig, AppKitContext, AppKitCustomFeePolicy, AppKitCustomFeePolicyScope, AppKitEarnActions, AppKitEarnOperations, AppKitOnrampClientConfig, AppKitOnrampOperations, AppKitUnifiedBalanceActions, BaseChainDefinition, BorrowActionBase, BorrowActions, BorrowAdapterContext, AddCollateralParams as BorrowAddCollateralParams, AddCollateralQuote as BorrowAddCollateralQuote, AddCollateralQuoteParams as BorrowAddCollateralQuoteParams, AddCollateralResult as BorrowAddCollateralResult, BorrowAssetAmount, BorrowChainDefinition, BorrowChainIdentifier, ClaimRewardsParams as BorrowClaimRewardsParams, BorrowClaimRewardsQuoteInfo, BorrowClaimRewardsResult, BorrowClaimedAmount, BorrowClaimedRewardsResult, CloseLoanParams as BorrowCloseLoanParams, CloseLoanQuote as BorrowCloseLoanQuote, CloseLoanQuoteParams as BorrowCloseLoanQuoteParams, CloseLoanResult as BorrowCloseLoanResult, ConfirmedAddCollateralDetailsUnavailableResult as BorrowConfirmedAddCollateralDetailsUnavailableResult, ConfirmedAddCollateralResult as BorrowConfirmedAddCollateralResult, ConfirmedCloseLoanDetailsUnavailableResult as BorrowConfirmedCloseLoanDetailsUnavailableResult, ConfirmedCloseLoanResult as BorrowConfirmedCloseLoanResult, ConfirmedRepayDetailsUnavailableResult as BorrowConfirmedRepayDetailsUnavailableResult, ConfirmedRepayResult as BorrowConfirmedRepayResult, ConfirmedWithdrawCollateralDetailsUnavailableResult as BorrowConfirmedWithdrawCollateralDetailsUnavailableResult, ConfirmedWithdrawCollateralResult as BorrowConfirmedWithdrawCollateralResult, BorrowErrorTrace, BorrowExecutionParams, ExploreMarketsIteratorParams as BorrowExploreMarketsIteratorParams, ExploreMarketsParams as BorrowExploreMarketsParams, ExploreMarketsResult as BorrowExploreMarketsResult, BorrowFee, GetClaimRewardsQuoteParams as BorrowGetClaimRewardsQuoteParams, GetIntegratorConfigParams as BorrowGetIntegratorConfigParams, GetLoansParams as BorrowGetLoansParams, GetMarketParams as BorrowGetMarketParams, GetPositionParams as BorrowGetPositionParams, HealthFactorBand as BorrowHealthFactorBand, BorrowInstruction, IntegratorConfig as BorrowIntegratorConfig, BorrowKitConfig, BorrowKitContext, ListLoansResult as BorrowListLoansResult, Loan as BorrowLoan, LoanDataStatus as BorrowLoanDataStatus, LoanExecution as BorrowLoanExecution, BorrowLoanInfo, LoanStatus as BorrowLoanStatus, BorrowMarketAsset, MarketInfo as BorrowMarketInfo, MarketSortBy as BorrowMarketSortBy, BorrowMoreParams, BorrowMoreQuoteParams, NoClaimableRewardsResult as BorrowNoClaimableRewardsResult, OpenLoanParams as BorrowOpenLoanParams, OpenLoanQuoteParams as BorrowOpenLoanQuoteParams, BorrowOperationName, BorrowOperationResultBase, BorrowPagination, BorrowParams, BorrowPosition, BorrowProtocol, BorrowingProvider as BorrowProvider, BorrowQuote, BorrowQuoteGas, BorrowQuoteGasFee, BorrowQuoteParams, RegisterWebhookParams as BorrowRegisterWebhookParams, RegisterWebhookResult as BorrowRegisterWebhookResult, RepayParams as BorrowRepayParams, RepayQuote as BorrowRepayQuote, RepayQuoteParams as BorrowRepayQuoteParams, RepayResult as BorrowRepayResult, RequiredCollateralParams as BorrowRequiredCollateralParams, RequiredCollateralQuote as BorrowRequiredCollateralQuote, BorrowResult, BorrowRetryResult, BorrowServiceConfig, SetIntegratorConfigParams as BorrowSetIntegratorConfigParams, BorrowStep, BorrowStepBase, BorrowStepName, SubmittedAddCollateralResult as BorrowSubmittedAddCollateralResult, SubmittedCloseLoanResult as BorrowSubmittedCloseLoanResult, SubmittedRepayResult as BorrowSubmittedRepayResult, SubmittedWithdrawCollateralResult as BorrowSubmittedWithdrawCollateralResult, BorrowTokenRecipient, WithdrawCollateralExecution as BorrowWithdrawCollateralExecution, WithdrawCollateralParams as BorrowWithdrawCollateralParams, WithdrawCollateralQuote as BorrowWithdrawCollateralQuote, WithdrawCollateralQuoteParams as BorrowWithdrawCollateralQuoteParams, WithdrawCollateralResult as BorrowWithdrawCollateralResult, BridgeConfig, CustomFeePolicy$2 as BridgeCustomFeePolicy, BridgeEstimateResult, BridgeExecutionConfig, BridgeParams, BridgeResult, BridgeStep, BridgeSupportedChainsOptions, BridgeWarning, CCTPConfig, CCTPMergedConfig, CCTPSplitConfig, ChainDefinition, ConfirmedBorrowDetailsUnavailableResult, ConfirmedBorrowOperationResultBase, ConfirmedBorrowResult, ConfirmedDetailsUnavailableBorrowOperationResultBase, Currency, DecodedEarnTx, DelegateStatus, DepositForParams, DepositParams, DepositResult, DeveloperFeeHooks, EVMChainDefinition, EarnAccruedRewardInfo, EarnAdapterContext, AnyDepositParams as EarnAnyDepositParams, EarnAssetAmount, EarnBridgeCctpStatus, EarnBridgeHopStatus, EarnBridgeQuoteExpiry, ClaimRewardsParams$1 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, EarnEncodedTransaction, EarnExecuteAuthorizationReview, EarnExecuteReview, ExploreVaultsIteratorParams as EarnExploreVaultsIteratorParams, ExploreVaultsPagination as EarnExploreVaultsPagination, ExploreVaultsParams as EarnExploreVaultsParams, EarnExploreVaultsResult, ExploreVaultsSortBy as EarnExploreVaultsSortBy, EarnGasFeeEstimate, EarnGasFeeEstimateBase, GetClaimRewardsQuoteParams$1 as EarnGetClaimRewardsQuoteParams, GetCrossChainDepositStatusParams as EarnGetCrossChainDepositStatusParams, GetDepositQuoteParams as EarnGetDepositQuoteParams, GetPositionParams$1 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, FetchOnrampSessionOptions, GetBalancesParams, GetBalancesResult, GetDelegateStatusParams, GetSupportedChainsOptions, GetSwapStatusParams, GetTokenRatesParams, GetTokenRatesResult, InitiateRemoveFundParams, InitiateRemoveFundResult, KitContractType, MaxBorrowParams, MaxBorrowQuote, MintedOnrampSession, NonEVMChainDefinition, OnrampAssetSelection, OnrampDepositInfo, OnrampDepositNotCompletedCode, OnrampDepositNotCompletedEnvelope, OnrampDepositSettledEnvelope, OnrampDepositSubmittedEnvelope, OnrampEventCode, OnrampEventEnvelope, OnrampEventType, OnrampIframeOptions, OnrampInitializationErrorCode, OnrampInitializationErrorEnvelope, OnrampInitializationSuccessEnvelope, OnrampLifecycleOptions, OnrampPaymentMethod, OnrampSession, OnrampSessionRequest, OnrampWidget, OnrampWidgetAnyHandler, OnrampWidgetEventHandler, OnrampWidgetLifecycle, OnrampWindowBlockedReason, OnrampWindowOptions, OnrampWindowResult, OperationParamsMap, OperationType, ReceiveExactEstimateResult, ReceiveExactFeeItem, Recoverability, RemoveFundParams, RemoveFundResult, RetryContext, SendParams, SpendDestination, SpendParams, SpendResult, SubmittedBorrowOperationResultBase, SubmittedBorrowResult, SwapConfig, CustomFeePolicy$1 as SwapCustomFeePolicy, SwapDestinationLeg, SwapEstimate, SwapFeeContext, SwapKitConfig, SwapKitContext, SwapParams, SwapProgress, SwapResult, SwapSourceLeg, SwapStatus, SwapStatusResult, SwapTerminalStatus, TokenChainPair, TokenInfo, TokenRate, UnifiedBalanceChainIdentifier, CustomFeePolicy as UnifiedBalanceCustomFeePolicy, FeeRecipientsConfig as UnifiedBalanceFeeRecipientsConfig, UnifiedBalanceKitConfig, SupportedToken as UnifiedBalanceSupportedToken, UpdateDelegateParams, UpdateDelegateResult, VersionConfig, WaitForSwapDiscreteParams, WaitForSwapParams, WaitForSwapResultParams };
+export type { ActionHandler, AdapterContext, AllowanceStrategy$2 as AllowanceStrategy, AppKitActionName, AppKitActions, AppKitBorrowActions, AppKitBorrowOperations, AppKitBridgeActions, AppKitConfig, AppKitContext, AppKitCustomFeePolicy, AppKitCustomFeePolicyScope, AppKitEarnActions, AppKitEarnOperations, AppKitOnrampClientConfig, AppKitOnrampOperations, AppKitUnifiedBalanceActions, BaseChainDefinition, BorrowActionBase, BorrowActions, BorrowAdapterContext, AddCollateralParams as BorrowAddCollateralParams, AddCollateralQuote as BorrowAddCollateralQuote, AddCollateralQuoteParams as BorrowAddCollateralQuoteParams, AddCollateralResult as BorrowAddCollateralResult, BorrowAssetAmount, BorrowChainDefinition, BorrowChainIdentifier, ClaimRewardsParams as BorrowClaimRewardsParams, BorrowClaimRewardsQuoteInfo, BorrowClaimRewardsResult, BorrowClaimedAmount, BorrowClaimedRewardsResult, CloseLoanParams as BorrowCloseLoanParams, CloseLoanQuote as BorrowCloseLoanQuote, CloseLoanQuoteParams as BorrowCloseLoanQuoteParams, CloseLoanResult as BorrowCloseLoanResult, ConfirmedAddCollateralDetailsUnavailableResult as BorrowConfirmedAddCollateralDetailsUnavailableResult, ConfirmedAddCollateralResult as BorrowConfirmedAddCollateralResult, ConfirmedCloseLoanDetailsUnavailableResult as BorrowConfirmedCloseLoanDetailsUnavailableResult, ConfirmedCloseLoanResult as BorrowConfirmedCloseLoanResult, ConfirmedRepayDetailsUnavailableResult as BorrowConfirmedRepayDetailsUnavailableResult, ConfirmedRepayResult as BorrowConfirmedRepayResult, ConfirmedWithdrawCollateralDetailsUnavailableResult as BorrowConfirmedWithdrawCollateralDetailsUnavailableResult, ConfirmedWithdrawCollateralResult as BorrowConfirmedWithdrawCollateralResult, BorrowErrorTrace, BorrowExecutionParams, ExploreMarketsIteratorParams as BorrowExploreMarketsIteratorParams, ExploreMarketsParams as BorrowExploreMarketsParams, ExploreMarketsResult as BorrowExploreMarketsResult, BorrowFee, GetClaimRewardsQuoteParams as BorrowGetClaimRewardsQuoteParams, GetIntegratorConfigParams as BorrowGetIntegratorConfigParams, GetLoansParams as BorrowGetLoansParams, GetMarketParams as BorrowGetMarketParams, GetPositionParams as BorrowGetPositionParams, HealthFactorBand as BorrowHealthFactorBand, BorrowInstruction, IntegratorConfig as BorrowIntegratorConfig, BorrowKitConfig, BorrowKitContext, ListLoansResult as BorrowListLoansResult, Loan as BorrowLoan, LoanDataStatus as BorrowLoanDataStatus, LoanExecution as BorrowLoanExecution, BorrowLoanInfo, LoanStatus as BorrowLoanStatus, BorrowMarketAsset, MarketInfo as BorrowMarketInfo, MarketSortBy as BorrowMarketSortBy, BorrowMoreParams, BorrowMoreQuoteParams, NoClaimableRewardsResult as BorrowNoClaimableRewardsResult, OpenLoanParams as BorrowOpenLoanParams, OpenLoanQuoteParams as BorrowOpenLoanQuoteParams, BorrowOperationName, BorrowOperationResultBase, BorrowPagination, BorrowParams, BorrowPosition, BorrowProtocol, BorrowingProvider as BorrowProvider, BorrowQuote, BorrowQuoteGas, BorrowQuoteGasFee, BorrowQuoteParams, RegisterWebhookParams as BorrowRegisterWebhookParams, RegisterWebhookResult as BorrowRegisterWebhookResult, RepayParams as BorrowRepayParams, RepayQuote as BorrowRepayQuote, RepayQuoteParams as BorrowRepayQuoteParams, RepayResult as BorrowRepayResult, RequiredCollateralParams as BorrowRequiredCollateralParams, RequiredCollateralQuote as BorrowRequiredCollateralQuote, BorrowResult, BorrowRetryResult, BorrowServiceConfig, SetIntegratorConfigParams as BorrowSetIntegratorConfigParams, BorrowStep, BorrowStepBase, BorrowStepName, SubmittedAddCollateralResult as BorrowSubmittedAddCollateralResult, SubmittedCloseLoanResult as BorrowSubmittedCloseLoanResult, SubmittedRepayResult as BorrowSubmittedRepayResult, SubmittedWithdrawCollateralResult as BorrowSubmittedWithdrawCollateralResult, BorrowTokenRecipient, WithdrawCollateralExecution as BorrowWithdrawCollateralExecution, WithdrawCollateralParams as BorrowWithdrawCollateralParams, WithdrawCollateralQuote as BorrowWithdrawCollateralQuote, WithdrawCollateralQuoteParams as BorrowWithdrawCollateralQuoteParams, WithdrawCollateralResult as BorrowWithdrawCollateralResult, BridgeConfig, CustomFeePolicy$2 as BridgeCustomFeePolicy, BridgeEstimateResult, BridgeExecutionConfig, BridgeParams, BridgeResult, BridgeStep, BridgeSupportedChainsOptions, BridgeWarning, CCTPConfig, CCTPMergedConfig, CCTPSplitConfig, ChainDefinition, ConfirmedBorrowDetailsUnavailableResult, ConfirmedBorrowOperationResultBase, ConfirmedBorrowResult, ConfirmedDetailsUnavailableBorrowOperationResultBase, Currency, DecodedEarnTx, DelegateStatus, DepositForParams, DepositParams, DepositResult, DeveloperFeeHooks, EVMChainDefinition, EarnAccruedRewardInfo, EarnAdapterContext, AnyDepositParams as EarnAnyDepositParams, EarnAssetAmount, EarnBridgeCctpStatus, EarnBridgeHopStatus, EarnBridgeQuoteExpiry, ClaimRewardsParams$1 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, EarnEncodedTransaction, EarnExecuteAuthorizationReview, EarnExecuteReview, ExploreVaultsIteratorParams as EarnExploreVaultsIteratorParams, ExploreVaultsPagination as EarnExploreVaultsPagination, ExploreVaultsParams as EarnExploreVaultsParams, EarnExploreVaultsResult, ExploreVaultsSortBy as EarnExploreVaultsSortBy, EarnGasFeeEstimate, EarnGasFeeEstimateBase, GetClaimRewardsQuoteParams$1 as EarnGetClaimRewardsQuoteParams, GetCrossChainDepositStatusParams as EarnGetCrossChainDepositStatusParams, GetDepositQuoteParams as EarnGetDepositQuoteParams, GetPositionParams$1 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, FetchOnrampSessionOptions, GetBalancesParams, GetBalancesResult, GetDelegateStatusParams, GetSupportedChainsOptions, GetSwapStatusParams, GetTokenRatesParams, GetTokenRatesResult, InitiateRemoveFundParams, InitiateRemoveFundResult, KitContractType, MaxBorrowParams, MaxBorrowQuote, MintedOnrampSession, NonEVMChainDefinition, OnrampAssetSelection, OnrampDepositInfo, OnrampDepositNotCompletedCode, OnrampDepositNotCompletedEnvelope, OnrampDepositSettledEnvelope, OnrampDepositSubmittedEnvelope, OnrampEventCode, OnrampEventEnvelope, OnrampEventType, OnrampIframeOptions, OnrampInitializationErrorCode, OnrampInitializationErrorEnvelope, OnrampInitializationSuccessEnvelope, OnrampLifecycleOptions, OnrampPaymentMethod, OnrampSession, OnrampSessionRequest, OnrampWidget, OnrampWidgetAnyHandler, OnrampWidgetEventHandler, OnrampWidgetLifecycle, OnrampWindowBlockedReason, OnrampWindowOptions, OnrampWindowResult, OperationParamsMap, OperationType, ReceiveExactEstimateResult, ReceiveExactFeeItem, Recoverability, RemoveFundParams, RemoveFundResult, RetryContext, SendParams, SpendDestination, SpendParams, SpendResult, SubmittedBorrowOperationResultBase, SubmittedBorrowResult, SwapConfig, CustomFeePolicy$1 as SwapCustomFeePolicy, SwapDestinationLeg, SwapEstimate, SwapFeeContext, SwapKitConfig, SwapKitContext, SwapParams, SwapProgress, SwapResult, SwapRoute, SwapRouteStep, SwapRouteStepEstimate, SwapRouteToken, SwapSourceLeg, SwapStatus, SwapStatusResult, SwapTerminalStatus, TokenChainPair, TokenInfo, TokenRate, UnifiedBalanceChainIdentifier, CustomFeePolicy as UnifiedBalanceCustomFeePolicy, FeeRecipientsConfig as UnifiedBalanceFeeRecipientsConfig, UnifiedBalanceKitConfig, SupportedToken as UnifiedBalanceSupportedToken, UpdateDelegateParams, UpdateDelegateResult, VersionConfig, WaitForSwapDiscreteParams, WaitForSwapParams, WaitForSwapResultParams };