@circle-fin/app-kit 1.15.1 → 1.15.3

package/server.d.mts

@@ -1785,17 +1785,17 @@ interface KitEventSubscription<M extends EventMap = KitEventMap> {
  *   embeds. Never sent back by the client; it is redeemed inside the
  *   widget origin only.
  * - `widgetUrl` — fully composed launch URL (origin + path + token +
- *   `destinationWallet`). The server kit prefers to compose this itself
+ *   asset-scoping params). The server kit prefers to compose this itself
  *   so the client kit has no exposure to the widget origin. The client
  *   still accepts a bare `sessionToken` and composes a URL locally as a
  *   fallback. `getOnrampUrl` is the single place that enforces the
  *   https-scheme / origin-pin safety checks before the URL reaches the
  *   DOM — that is a security boundary, not response validation.
  * - `destinationWallet` — the wallet that receives funds. The widget
- *   requires it as a launch query param, so the server kit echoes the
- *   `destinationAddress` it was minted with here (and bakes it into
- *   `widgetUrl`). Used by the client fallback path when it has to
- *   compose the URL from a bare `sessionToken`.
+ *   reads it from the signed session token, not the launch URL, so the
+ *   kit never adds it there. The server kit still echoes the
+ *   `destinationAddress` it was minted with here for the host's
+ *   convenience.
  * - `expiresAt` — RFC 3339 timestamp. The client refuses to launch an
  *   expired session and throws an `INPUT` `KitError` so the host can
  *   re-mint.
@@ -1819,8 +1819,8 @@ interface OnrampSession {
      */
     readonly sessionToken: string;
     /**
-     * Fully composed launch URL (origin + path + token +
-     * `destinationWallet`).
+     * Fully composed launch URL (origin + path + token + optional
+     * asset-scoping params).
      *
      * @remarks
      * The server kit prefers to compose this itself; the client falls
@@ -1833,8 +1833,9 @@ interface OnrampSession {
      *
      * @remarks
      * Echoed verbatim from the `destinationAddress` the server kit
-     * minted with. Used by the client kit's URL-composition fallback
-     * when `widgetUrl` is absent.
+     * minted with, for the host's convenience (e.g. to display it). Never
+     * added to the launch URL: the widget reads the destination wallet
+     * from the signed session token.
      */
     readonly destinationWallet?: string;
     /**

package/server.d.ts

@@ -1785,17 +1785,17 @@ interface KitEventSubscription<M extends EventMap = KitEventMap> {
  *   embeds. Never sent back by the client; it is redeemed inside the
  *   widget origin only.
  * - `widgetUrl` — fully composed launch URL (origin + path + token +
- *   `destinationWallet`). The server kit prefers to compose this itself
+ *   asset-scoping params). The server kit prefers to compose this itself
  *   so the client kit has no exposure to the widget origin. The client
  *   still accepts a bare `sessionToken` and composes a URL locally as a
  *   fallback. `getOnrampUrl` is the single place that enforces the
  *   https-scheme / origin-pin safety checks before the URL reaches the
  *   DOM — that is a security boundary, not response validation.
  * - `destinationWallet` — the wallet that receives funds. The widget
- *   requires it as a launch query param, so the server kit echoes the
- *   `destinationAddress` it was minted with here (and bakes it into
- *   `widgetUrl`). Used by the client fallback path when it has to
- *   compose the URL from a bare `sessionToken`.
+ *   reads it from the signed session token, not the launch URL, so the
+ *   kit never adds it there. The server kit still echoes the
+ *   `destinationAddress` it was minted with here for the host's
+ *   convenience.
  * - `expiresAt` — RFC 3339 timestamp. The client refuses to launch an
  *   expired session and throws an `INPUT` `KitError` so the host can
  *   re-mint.
@@ -1819,8 +1819,8 @@ interface OnrampSession {
      */
     readonly sessionToken: string;
     /**
-     * Fully composed launch URL (origin + path + token +
-     * `destinationWallet`).
+     * Fully composed launch URL (origin + path + token + optional
+     * asset-scoping params).
      *
      * @remarks
      * The server kit prefers to compose this itself; the client falls
@@ -1833,8 +1833,9 @@ interface OnrampSession {
      *
      * @remarks
      * Echoed verbatim from the `destinationAddress` the server kit
-     * minted with. Used by the client kit's URL-composition fallback
-     * when `widgetUrl` is absent.
+     * minted with, for the host's convenience (e.g. to display it). Never
+     * added to the launch URL: the widget reads the destination wallet
+     * from the signed session token.
      */
     readonly destinationWallet?: string;
     /**

package/server.mjs

@@ -8644,7 +8644,7 @@ const swapTokenEnumSchema = z.enum([
     return kit;
 }
 
-var version = "1.0.1";
+var version = "1.0.2";
 var pkg = {
 	version: version};
 
@@ -9160,10 +9160,10 @@ function isAbortLikeError(err) {
  * @param widgetPath - Path appended to `widgetBaseUrl`. Leading `/`
  *   is required by the URL semantics below — see remarks.
  * @param params - Additional query parameters to set on the launch URL
- *   (e.g. `destinationWallet`, `hostApp`). Entries whose value is
- *   `undefined` or empty are skipped. The widget reads these from the
- *   query string — `destinationWallet` in particular is **required** by
- *   the widget, so callers that have it must pass it here.
+ *   (e.g. the asset-scoping `chains` / `tokens` / `pairs`). Entries whose
+ *   value is `undefined` or empty are skipped. Launch URLs end up in
+ *   browser history and access logs, so never pass user identifiers
+ *   such as wallet addresses here.
  * @returns A fully-qualified launch URL.
  *
  * @remarks
@@ -9187,9 +9187,9 @@ function isAbortLikeError(err) {
  * @example
  * ```ts
  * composeWidgetUrl('https://onramp.arc.io', 'tok-1', '', {
- *   destinationWallet: '0xabc',
+ *   tokens: 'USDC',
  * })
- * // → 'https://onramp.arc.io/?sessionToken=tok-1&destinationWallet=0xabc'
+ * // → 'https://onramp.arc.io/?sessionToken=tok-1&tokens=USDC'
  * ```
  *
  * @internal Implementation detail shared by the server kit
@@ -9428,17 +9428,13 @@ function isAbortLikeError(err) {
             const session = unwrapped !== null && typeof unwrapped === 'object' ? unwrapped : {};
             const sessionToken = typeof session['sessionToken'] === 'string' ? session['sessionToken'] : undefined;
             const existingWidgetUrl = typeof session['widgetUrl'] === 'string' && session['widgetUrl'].length > 0 ? session['widgetUrl'] : undefined;
-            // The widget reads the destination wallet from the launch URL
-            // (`destinationWallet` query param), NOT from the session token —
-            // the `/v1/stablecoinKits/sessions` body is anonymous. We must
-            // therefore bake it into the composed URL or the widget reports
-            // "Destination wallet is required." mid-flow. Host-app asset scoping
-            // (`assets`) rides the same launch URL as `chains`/`tokens`/`pairs`.
+            // The launch URL carries only the session token and host-app asset
+            // scoping (`chains`/`tokens`/`pairs`). The destination wallet must
+            // stay out of it: the widget reads the wallet from the signed session
+            // token's `walletAddress` claim, and a query param would only leak
+            // the address into browser history and access logs.
             const assetParams = serializeAssetSelection(params.assets);
-            const composedWidgetUrl = sessionToken === undefined ? undefined : composeWidgetUrl(widgetBaseUrl, sessionToken, ONRAMP_WIDGET_PATH, {
-                destinationWallet: params.destinationAddress,
-                ...assetParams
-            });
+            const composedWidgetUrl = sessionToken === undefined ? undefined : composeWidgetUrl(widgetBaseUrl, sessionToken, ONRAMP_WIDGET_PATH, assetParams);
             // When wallets-api returns a `widgetUrl`, asset scoping must still be
             // applied — `assets` is a display-only widget concern and is never
             // forwarded upstream, so we merge the params directly into the returned

package/swap.cjs

@@ -10564,7 +10564,7 @@ const swapTokenEnumSchema = zod.z.enum([
 }
 
 var name$2 = "@circle-fin/bridge-kit";
-var version$2 = "1.15.0";
+var version$2 = "1.15.1";
 var pkg$2 = {
 	name: name$2,
 	version: version$2};
@@ -22576,7 +22576,7 @@ registerKit(`${pkg$1.name}/${pkg$1.version}`);
 };
 
 var name = "@circle-fin/earn-kit";
-var version = "1.7.0";
+var version = "1.8.0";
 var pkg = {
 	name: name,
 	version: version};
@@ -22718,10 +22718,8 @@ const bridgeFeeTokenSchema = hexAddressSchema;
     assetAddress: zod.z.string(),
     lltv: zod.z.number(),
     supplyUsd: zod.z.number(),
-    // Optional during the expand/contract window (a backend that predates the
-    // field omits the key), mirroring the `.optional()` facets on the base
-    // schema; `null` when the product exposes no per-market allocation (V2).
-    allocationPct: zod.z.number().nullable().optional()
+    // `null` when the product exposes no per-market allocation (V2).
+    allocationPct: zod.z.number().nullable()
 });
 /**
  * Zod schema for a Morpho vault warning in the API response.
@@ -22828,19 +22826,20 @@ const bridgeFeeTokenSchema = hexAddressSchema;
     earnKitWarnings: zod.z.array(zod.z.string()).optional()
 });
 /**
- * Shared base schema: existing flat fields (kept) plus the new nested
- * facets and neutral identity. Facets are `.optional()` during the
- * transition; flip to required once the backend is confirmed emitting.
+ * Shared base schema: existing flat fields (kept as deprecated aliases) plus
+ * the nested facets. Zenith emits all facets on every response; required here
+ * so a partial emission is caught at parse time rather than surfacing as a
+ * runtime `undefined` access.
  *
  * @internal
  */ const earnBaseSchema = vaultInfoResponseSchema.extend({
-    address: zod.z.string().optional(),
-    asOf: zod.z.string().optional(),
-    manager: managerSchema.nullable().optional(),
-    apyProfile: apyProfileSchema.optional(),
-    fee: feeInfoSchema.optional(),
-    liquidityProfile: liquidityProfileSchema.optional(),
-    riskSignals: riskSignalsSchema.optional()
+    address: zod.z.string(),
+    asOf: zod.z.string(),
+    manager: managerSchema.nullable(),
+    apyProfile: apyProfileSchema,
+    fee: feeInfoSchema,
+    liquidityProfile: liquidityProfileSchema,
+    riskSignals: riskSignalsSchema
 });
 /**
  * Zod schema for the `vault` opportunity variant.
@@ -23810,6 +23809,49 @@ const sourceAdapterContextSchema = zod.z.object({
     vaultAddress: vaultAddressSchema,
     config: earnConfigSchema.optional()
 });
+/**
+ * Schema for a successful gas fee entry (fees is non-null).
+ *
+ * Validates the kit shape — {@link EarnEstimatedGas} uses decimal strings for
+ * `gas`, `gasPrice`, and `fee`. Only digits are accepted so that the deposit
+ * operation can safely convert them to `bigint` before passing them to the
+ * provider's `computeGasReserve`.
+ *
+ * @internal
+ */ const earnGasFeeEstimateSuccessSchema = zod.z.object({
+    name: zod.z.string(),
+    token: zod.z.string(),
+    blockchain: zod.z.string(),
+    fees: zod.z.object({
+        gas: zod.z.string().regex(/^\d+$/, 'gas must be a non-negative integer string'),
+        gasPrice: zod.z.string().regex(/^\d+$/, 'gasPrice must be a non-negative integer string'),
+        fee: zod.z.string().regex(/^\d+$/, 'fee must be a non-negative integer string')
+    }),
+    error: zod.z.undefined().optional()
+}).strict();
+/**
+ * Schema for a failed gas fee entry (fees is null, error is a string).
+ *
+ * @internal
+ */ const earnGasFeeEstimateFailureSchema = zod.z.object({
+    name: zod.z.string(),
+    token: zod.z.string(),
+    blockchain: zod.z.string(),
+    fees: zod.z.null(),
+    error: zod.z.string()
+}).strict();
+/**
+ * Schema for a single kit-level gas fee estimate entry.
+ *
+ * Rejects arbitrary inputs (null, numbers, empty objects, non-numeric fee
+ * strings) so callers receive a descriptive validation error instead of a
+ * raw `BigInt` conversion error inside `computeGasReserve`.
+ *
+ * @internal
+ */ const earnGasFeeEstimateSchema = zod.z.union([
+    earnGasFeeEstimateSuccessSchema,
+    earnGasFeeEstimateFailureSchema
+]);
 /**
  * Validation schema for the same-chain variant of DepositParams.
  *
@@ -23822,6 +23864,7 @@ const sourceAdapterContextSchema = zod.z.object({
     to: zod.z.undefined().optional(),
     vaultAddress: vaultAddressSchema,
     amount: amountSchema,
+    gasFees: zod.z.array(earnGasFeeEstimateSchema).optional(),
     config: earnConfigSchema.optional()
 }).strict();
 const crossChainDepositDestinationSchema = zod.z.object({

package/swap.d.cts

@@ -7533,6 +7533,26 @@ interface VaultQuery {
     /** On-chain vault contract address. */
     readonly vaultAddress: string;
 }
+/**
+ * Fields shared by both {@link EarnGasFeeEstimate} variants.
+ *
+ * @example
+ * ```typescript
+ * const base: EarnGasFeeEstimateBase = {
+ *   name: 'Deposit',
+ *   token: 'ETH',
+ *   blockchain: 'Arc_Testnet',
+ * }
+ * ```
+ */
+interface EarnGasFeeEstimateBase {
+    /** The earn step being estimated, e.g. "Approve", "Deposit", "Withdraw". */
+    readonly name: string;
+    /** Native token used to pay gas fees, e.g. "ETH". */
+    readonly token: string;
+    /** Blockchain where this gas fee applies. */
+    readonly blockchain: ChainDefinition['chain'];
+}
 /**
  * Sort order for a vault discovery query.
  *
@@ -7547,6 +7567,51 @@ interface VaultQuery {
  */
 type ExploreVaultsSortBy = 'apy' | 'tvl' | 'name';
 
+/**
+ * Estimated gas details for one transaction in a kit-level Earn quote, with
+ * every amount as a decimal string so quote results stay JSON-serializable.
+ *
+ * @example
+ * ```typescript
+ * const gas: EarnEstimatedGas = { gas: '73567', gasPrice: '20003763738', fee: '1471616886913446' }
+ * ```
+ */
+interface EarnEstimatedGas {
+    /** Estimated gas units as a decimal string, e.g. '73567'. */
+    readonly gas: string;
+    /** Estimated price per gas unit as a decimal string in wei. */
+    readonly gasPrice: string;
+    /** Total estimated fee as a decimal string in wei. */
+    readonly fee: string;
+}
+/**
+ * Estimated native gas fee for one transaction in an Earn quote.
+ *
+ * A discriminated union on `fees`: a successful estimate carries
+ * {@link EarnEstimatedGas} details and no `error`; a failed estimate carries
+ * `fees: null` and a sanitized `error` message.
+ *
+ * @example
+ * ```typescript
+ * function describe(entry: EarnGasFeeEstimate): string {
+ *   if (entry.fees === null) {
+ *     return `${entry.name}: estimation failed (${entry.error})`
+ *   }
+ *   return `${entry.name}: ${entry.fees.fee} wei`
+ * }
+ * ```
+ */
+type EarnGasFeeEstimate = (EarnGasFeeEstimateBase & {
+    /** Estimated gas details with amounts formatted as decimal strings. */
+    readonly fees: EarnEstimatedGas;
+    /** Never present on a successful estimate. */
+    readonly error?: never;
+}) | (EarnGasFeeEstimateBase & {
+    /** Null because estimation failed. */
+    readonly fees: null;
+    /** Sanitized estimation error message. */
+    readonly error: string;
+});
 /**
  * Adapter context for earn operations, constrained to earn-supported chains.
  *
@@ -7730,6 +7795,12 @@ interface SameChainDepositParams<TFromAdapterCapabilities extends AdapterCapabil
      * @example '100.50' for 100.50 USDC
      */
     readonly amount: string;
+    /**
+     * Gas fee estimates from a prior {@link getDepositQuote} call. When provided,
+     * the pre-broadcast gas reserve check uses the actual estimated cost instead
+     * of the conservative fallback reserve.
+     */
+    readonly gasFees?: readonly EarnGasFeeEstimate[] | undefined;
     /** Optional earn configuration. */
     readonly config?: EarnConfig | undefined;
 }

package/swap.d.mts

@@ -7533,6 +7533,26 @@ interface VaultQuery {
     /** On-chain vault contract address. */
     readonly vaultAddress: string;
 }
+/**
+ * Fields shared by both {@link EarnGasFeeEstimate} variants.
+ *
+ * @example
+ * ```typescript
+ * const base: EarnGasFeeEstimateBase = {
+ *   name: 'Deposit',
+ *   token: 'ETH',
+ *   blockchain: 'Arc_Testnet',
+ * }
+ * ```
+ */
+interface EarnGasFeeEstimateBase {
+    /** The earn step being estimated, e.g. "Approve", "Deposit", "Withdraw". */
+    readonly name: string;
+    /** Native token used to pay gas fees, e.g. "ETH". */
+    readonly token: string;
+    /** Blockchain where this gas fee applies. */
+    readonly blockchain: ChainDefinition['chain'];
+}
 /**
  * Sort order for a vault discovery query.
  *
@@ -7547,6 +7567,51 @@ interface VaultQuery {
  */
 type ExploreVaultsSortBy = 'apy' | 'tvl' | 'name';
 
+/**
+ * Estimated gas details for one transaction in a kit-level Earn quote, with
+ * every amount as a decimal string so quote results stay JSON-serializable.
+ *
+ * @example
+ * ```typescript
+ * const gas: EarnEstimatedGas = { gas: '73567', gasPrice: '20003763738', fee: '1471616886913446' }
+ * ```
+ */
+interface EarnEstimatedGas {
+    /** Estimated gas units as a decimal string, e.g. '73567'. */
+    readonly gas: string;
+    /** Estimated price per gas unit as a decimal string in wei. */
+    readonly gasPrice: string;
+    /** Total estimated fee as a decimal string in wei. */
+    readonly fee: string;
+}
+/**
+ * Estimated native gas fee for one transaction in an Earn quote.
+ *
+ * A discriminated union on `fees`: a successful estimate carries
+ * {@link EarnEstimatedGas} details and no `error`; a failed estimate carries
+ * `fees: null` and a sanitized `error` message.
+ *
+ * @example
+ * ```typescript
+ * function describe(entry: EarnGasFeeEstimate): string {
+ *   if (entry.fees === null) {
+ *     return `${entry.name}: estimation failed (${entry.error})`
+ *   }
+ *   return `${entry.name}: ${entry.fees.fee} wei`
+ * }
+ * ```
+ */
+type EarnGasFeeEstimate = (EarnGasFeeEstimateBase & {
+    /** Estimated gas details with amounts formatted as decimal strings. */
+    readonly fees: EarnEstimatedGas;
+    /** Never present on a successful estimate. */
+    readonly error?: never;
+}) | (EarnGasFeeEstimateBase & {
+    /** Null because estimation failed. */
+    readonly fees: null;
+    /** Sanitized estimation error message. */
+    readonly error: string;
+});
 /**
  * Adapter context for earn operations, constrained to earn-supported chains.
  *
@@ -7730,6 +7795,12 @@ interface SameChainDepositParams<TFromAdapterCapabilities extends AdapterCapabil
      * @example '100.50' for 100.50 USDC
      */
     readonly amount: string;
+    /**
+     * Gas fee estimates from a prior {@link getDepositQuote} call. When provided,
+     * the pre-broadcast gas reserve check uses the actual estimated cost instead
+     * of the conservative fallback reserve.
+     */
+    readonly gasFees?: readonly EarnGasFeeEstimate[] | undefined;
     /** Optional earn configuration. */
     readonly config?: EarnConfig | undefined;
 }

package/swap.d.ts

@@ -7533,6 +7533,26 @@ interface VaultQuery {
     /** On-chain vault contract address. */
     readonly vaultAddress: string;
 }
+/**
+ * Fields shared by both {@link EarnGasFeeEstimate} variants.
+ *
+ * @example
+ * ```typescript
+ * const base: EarnGasFeeEstimateBase = {
+ *   name: 'Deposit',
+ *   token: 'ETH',
+ *   blockchain: 'Arc_Testnet',
+ * }
+ * ```
+ */
+interface EarnGasFeeEstimateBase {
+    /** The earn step being estimated, e.g. "Approve", "Deposit", "Withdraw". */
+    readonly name: string;
+    /** Native token used to pay gas fees, e.g. "ETH". */
+    readonly token: string;
+    /** Blockchain where this gas fee applies. */
+    readonly blockchain: ChainDefinition['chain'];
+}
 /**
  * Sort order for a vault discovery query.
  *
@@ -7547,6 +7567,51 @@ interface VaultQuery {
  */
 type ExploreVaultsSortBy = 'apy' | 'tvl' | 'name';
 
+/**
+ * Estimated gas details for one transaction in a kit-level Earn quote, with
+ * every amount as a decimal string so quote results stay JSON-serializable.
+ *
+ * @example
+ * ```typescript
+ * const gas: EarnEstimatedGas = { gas: '73567', gasPrice: '20003763738', fee: '1471616886913446' }
+ * ```
+ */
+interface EarnEstimatedGas {
+    /** Estimated gas units as a decimal string, e.g. '73567'. */
+    readonly gas: string;
+    /** Estimated price per gas unit as a decimal string in wei. */
+    readonly gasPrice: string;
+    /** Total estimated fee as a decimal string in wei. */
+    readonly fee: string;
+}
+/**
+ * Estimated native gas fee for one transaction in an Earn quote.
+ *
+ * A discriminated union on `fees`: a successful estimate carries
+ * {@link EarnEstimatedGas} details and no `error`; a failed estimate carries
+ * `fees: null` and a sanitized `error` message.
+ *
+ * @example
+ * ```typescript
+ * function describe(entry: EarnGasFeeEstimate): string {
+ *   if (entry.fees === null) {
+ *     return `${entry.name}: estimation failed (${entry.error})`
+ *   }
+ *   return `${entry.name}: ${entry.fees.fee} wei`
+ * }
+ * ```
+ */
+type EarnGasFeeEstimate = (EarnGasFeeEstimateBase & {
+    /** Estimated gas details with amounts formatted as decimal strings. */
+    readonly fees: EarnEstimatedGas;
+    /** Never present on a successful estimate. */
+    readonly error?: never;
+}) | (EarnGasFeeEstimateBase & {
+    /** Null because estimation failed. */
+    readonly fees: null;
+    /** Sanitized estimation error message. */
+    readonly error: string;
+});
 /**
  * Adapter context for earn operations, constrained to earn-supported chains.
  *
@@ -7730,6 +7795,12 @@ interface SameChainDepositParams<TFromAdapterCapabilities extends AdapterCapabil
      * @example '100.50' for 100.50 USDC
      */
     readonly amount: string;
+    /**
+     * Gas fee estimates from a prior {@link getDepositQuote} call. When provided,
+     * the pre-broadcast gas reserve check uses the actual estimated cost instead
+     * of the conservative fallback reserve.
+     */
+    readonly gasFees?: readonly EarnGasFeeEstimate[] | undefined;
     /** Optional earn configuration. */
     readonly config?: EarnConfig | undefined;
 }

package/swap.mjs

@@ -10557,7 +10557,7 @@ const swapTokenEnumSchema = z.enum([
 }
 
 var name$2 = "@circle-fin/bridge-kit";
-var version$2 = "1.15.0";
+var version$2 = "1.15.1";
 var pkg$2 = {
 	name: name$2,
 	version: version$2};
@@ -22569,7 +22569,7 @@ registerKit(`${pkg$1.name}/${pkg$1.version}`);
 };
 
 var name = "@circle-fin/earn-kit";
-var version = "1.7.0";
+var version = "1.8.0";
 var pkg = {
 	name: name,
 	version: version};
@@ -22711,10 +22711,8 @@ const bridgeFeeTokenSchema = hexAddressSchema;
     assetAddress: z.string(),
     lltv: z.number(),
     supplyUsd: z.number(),
-    // Optional during the expand/contract window (a backend that predates the
-    // field omits the key), mirroring the `.optional()` facets on the base
-    // schema; `null` when the product exposes no per-market allocation (V2).
-    allocationPct: z.number().nullable().optional()
+    // `null` when the product exposes no per-market allocation (V2).
+    allocationPct: z.number().nullable()
 });
 /**
  * Zod schema for a Morpho vault warning in the API response.
@@ -22821,19 +22819,20 @@ const bridgeFeeTokenSchema = hexAddressSchema;
     earnKitWarnings: z.array(z.string()).optional()
 });
 /**
- * Shared base schema: existing flat fields (kept) plus the new nested
- * facets and neutral identity. Facets are `.optional()` during the
- * transition; flip to required once the backend is confirmed emitting.
+ * Shared base schema: existing flat fields (kept as deprecated aliases) plus
+ * the nested facets. Zenith emits all facets on every response; required here
+ * so a partial emission is caught at parse time rather than surfacing as a
+ * runtime `undefined` access.
  *
  * @internal
  */ const earnBaseSchema = vaultInfoResponseSchema.extend({
-    address: z.string().optional(),
-    asOf: z.string().optional(),
-    manager: managerSchema.nullable().optional(),
-    apyProfile: apyProfileSchema.optional(),
-    fee: feeInfoSchema.optional(),
-    liquidityProfile: liquidityProfileSchema.optional(),
-    riskSignals: riskSignalsSchema.optional()
+    address: z.string(),
+    asOf: z.string(),
+    manager: managerSchema.nullable(),
+    apyProfile: apyProfileSchema,
+    fee: feeInfoSchema,
+    liquidityProfile: liquidityProfileSchema,
+    riskSignals: riskSignalsSchema
 });
 /**
  * Zod schema for the `vault` opportunity variant.
@@ -23803,6 +23802,49 @@ const sourceAdapterContextSchema = z.object({
     vaultAddress: vaultAddressSchema,
     config: earnConfigSchema.optional()
 });
+/**
+ * Schema for a successful gas fee entry (fees is non-null).
+ *
+ * Validates the kit shape — {@link EarnEstimatedGas} uses decimal strings for
+ * `gas`, `gasPrice`, and `fee`. Only digits are accepted so that the deposit
+ * operation can safely convert them to `bigint` before passing them to the
+ * provider's `computeGasReserve`.
+ *
+ * @internal
+ */ const earnGasFeeEstimateSuccessSchema = z.object({
+    name: z.string(),
+    token: z.string(),
+    blockchain: z.string(),
+    fees: z.object({
+        gas: z.string().regex(/^\d+$/, 'gas must be a non-negative integer string'),
+        gasPrice: z.string().regex(/^\d+$/, 'gasPrice must be a non-negative integer string'),
+        fee: z.string().regex(/^\d+$/, 'fee must be a non-negative integer string')
+    }),
+    error: z.undefined().optional()
+}).strict();
+/**
+ * Schema for a failed gas fee entry (fees is null, error is a string).
+ *
+ * @internal
+ */ const earnGasFeeEstimateFailureSchema = z.object({
+    name: z.string(),
+    token: z.string(),
+    blockchain: z.string(),
+    fees: z.null(),
+    error: z.string()
+}).strict();
+/**
+ * Schema for a single kit-level gas fee estimate entry.
+ *
+ * Rejects arbitrary inputs (null, numbers, empty objects, non-numeric fee
+ * strings) so callers receive a descriptive validation error instead of a
+ * raw `BigInt` conversion error inside `computeGasReserve`.
+ *
+ * @internal
+ */ const earnGasFeeEstimateSchema = z.union([
+    earnGasFeeEstimateSuccessSchema,
+    earnGasFeeEstimateFailureSchema
+]);
 /**
  * Validation schema for the same-chain variant of DepositParams.
  *
@@ -23815,6 +23857,7 @@ const sourceAdapterContextSchema = z.object({
     to: z.undefined().optional(),
     vaultAddress: vaultAddressSchema,
     amount: amountSchema,
+    gasFees: z.array(earnGasFeeEstimateSchema).optional(),
     config: earnConfigSchema.optional()
 }).strict();
 const crossChainDepositDestinationSchema = z.object({