@circle-fin/app-kit 1.8.0 → 1.9.0

package/earn.d.cts

@@ -659,6 +659,8 @@ declare enum Blockchain {
     Celo_Alfajores_Testnet = "Celo_Alfajores_Testnet",
     Codex = "Codex",
     Codex_Testnet = "Codex_Testnet",
+    Cronos = "Cronos",
+    Cronos_Testnet = "Cronos_Testnet",
     Edge = "Edge",
     Edge_Testnet = "Edge_Testnet",
     Ethereum = "Ethereum",
@@ -900,6 +902,7 @@ declare enum BridgeChain {
     Avalanche = "Avalanche",
     Base = "Base",
     Codex = "Codex",
+    Cronos = "Cronos",
     Edge = "Edge",
     Ethereum = "Ethereum",
     HyperEVM = "HyperEVM",
@@ -923,6 +926,7 @@ declare enum BridgeChain {
     Avalanche_Fuji = "Avalanche_Fuji",
     Base_Sepolia = "Base_Sepolia",
     Codex_Testnet = "Codex_Testnet",
+    Cronos_Testnet = "Cronos_Testnet",
     Edge_Testnet = "Edge_Testnet",
     Ethereum_Sepolia = "Ethereum_Sepolia",
     HyperEVM_Testnet = "HyperEVM_Testnet",
@@ -6380,10 +6384,11 @@ interface AssetAmount {
     /**
      * Optional category tag for the amount.
      *
-     * Present on fee entries to identify the kind of fee — for cross-chain
-     * deposit quotes this is the source-fee item type (e.g. `'FORWARD'`,
-     * `'PRE_FINALITY'`). Omitted when the amount has no meaningful category
-     * (plain deposit/withdrawal/share/reward amounts).
+     * Present on fee entries to identify the kind of fee. For cross-chain deposit
+     * quotes this is the source-fee item type (e.g. `'FORWARD'`,
+     * `'PRE_FINALITY'`), and for withdrawal quotes this can identify Circle fees
+     * (e.g. `'circle'`). Omitted when the amount has no meaningful
+     * category (plain deposit/withdrawal/share/reward amounts).
      */
     readonly type?: string | undefined;
     /**
@@ -6744,12 +6749,12 @@ interface DepositQuoteInfo {
     /** Current annualized percentage yield. */
     readonly currentApy: number;
     /**
-     * Deposit fees charged in the deposit asset. For cross-chain quotes this
-     * carries one entry per source-fee item (e.g. `'FORWARD'`, `'PRE_FINALITY'`),
-     * each tagged with its own {@link AssetAmount.type} and
-     * {@link AssetAmount.status} (e.g. `'estimated'`). Empty when no such fee
-     * applies. Distinct from native gas estimates, which are reported separately
-     * as gas-fee fields.
+     * Deposit fees charged by the quote. For cross-chain quotes this carries one
+     * entry per source-fee item (e.g. `'FORWARD'`, `'PRE_FINALITY'`) in the
+     * returned fee token and decimal precision, each tagged with its own
+     * {@link AssetAmount.type} and {@link AssetAmount.status} (e.g.
+     * `'estimated'`). Empty when no such fee applies. Distinct from native gas
+     * estimates, which are reported separately as gas-fee fields.
      */
     readonly fees: readonly AssetAmount[];
     /**
@@ -6806,7 +6811,12 @@ interface WithdrawalQuoteInfo {
      * available balance and quoted withdrawal in a single round-trip.
      */
     readonly maxWithdrawable: AssetAmount;
-    /** Fees applied to the withdrawal. */
+    /**
+     * Fees applied to the withdrawal.
+     *
+     * Circle fees are returned with `type: 'circle'` so callers can distinguish
+     * them from untyped plain fees and native gas estimates.
+     */
     readonly fees: readonly AssetAmount[];
     /**
      * Estimated native gas fees for the transactions needed to withdraw.
@@ -7264,8 +7274,8 @@ interface CrossChainDepositParams<TFromAdapterCapabilities extends AdapterCapabi
      */
     readonly amount: string;
     /**
-     * Maximum source-collected bridge fee the caller is willing to sign for, in
-     * human-readable source token units.
+     * Maximum source-collected bridge fee the caller is willing to accept, in
+     * human-readable fee token units from the quote.
      *
      * Derive this from a recent cross-chain deposit quote by summing
      * `quote.fees[].amount`. The prepared bridge bundle must not exceed this cap
@@ -8064,6 +8074,16 @@ interface AppKitContext {
      * @defaultValue false
      */
     disableErrorReporting?: boolean;
+    /**
+     * Custom HTTP headers forwarded with the underlying CCTP provider's
+     * attestation (Iris) API requests made by bridge operations.
+     *
+     * @remarks
+     * Headers are merged on top of the SDK defaults (such as `Content-Type`)
+     * rather than replacing them. The header is forwarded as-is to Circle's API;
+     * the SDK does not interpret it.
+     */
+    headers?: Record<string, string>;
 }
 
 /**

package/earn.d.mts

@@ -659,6 +659,8 @@ declare enum Blockchain {
     Celo_Alfajores_Testnet = "Celo_Alfajores_Testnet",
     Codex = "Codex",
     Codex_Testnet = "Codex_Testnet",
+    Cronos = "Cronos",
+    Cronos_Testnet = "Cronos_Testnet",
     Edge = "Edge",
     Edge_Testnet = "Edge_Testnet",
     Ethereum = "Ethereum",
@@ -900,6 +902,7 @@ declare enum BridgeChain {
     Avalanche = "Avalanche",
     Base = "Base",
     Codex = "Codex",
+    Cronos = "Cronos",
     Edge = "Edge",
     Ethereum = "Ethereum",
     HyperEVM = "HyperEVM",
@@ -923,6 +926,7 @@ declare enum BridgeChain {
     Avalanche_Fuji = "Avalanche_Fuji",
     Base_Sepolia = "Base_Sepolia",
     Codex_Testnet = "Codex_Testnet",
+    Cronos_Testnet = "Cronos_Testnet",
     Edge_Testnet = "Edge_Testnet",
     Ethereum_Sepolia = "Ethereum_Sepolia",
     HyperEVM_Testnet = "HyperEVM_Testnet",
@@ -6380,10 +6384,11 @@ interface AssetAmount {
     /**
      * Optional category tag for the amount.
      *
-     * Present on fee entries to identify the kind of fee — for cross-chain
-     * deposit quotes this is the source-fee item type (e.g. `'FORWARD'`,
-     * `'PRE_FINALITY'`). Omitted when the amount has no meaningful category
-     * (plain deposit/withdrawal/share/reward amounts).
+     * Present on fee entries to identify the kind of fee. For cross-chain deposit
+     * quotes this is the source-fee item type (e.g. `'FORWARD'`,
+     * `'PRE_FINALITY'`), and for withdrawal quotes this can identify Circle fees
+     * (e.g. `'circle'`). Omitted when the amount has no meaningful
+     * category (plain deposit/withdrawal/share/reward amounts).
      */
     readonly type?: string | undefined;
     /**
@@ -6744,12 +6749,12 @@ interface DepositQuoteInfo {
     /** Current annualized percentage yield. */
     readonly currentApy: number;
     /**
-     * Deposit fees charged in the deposit asset. For cross-chain quotes this
-     * carries one entry per source-fee item (e.g. `'FORWARD'`, `'PRE_FINALITY'`),
-     * each tagged with its own {@link AssetAmount.type} and
-     * {@link AssetAmount.status} (e.g. `'estimated'`). Empty when no such fee
-     * applies. Distinct from native gas estimates, which are reported separately
-     * as gas-fee fields.
+     * Deposit fees charged by the quote. For cross-chain quotes this carries one
+     * entry per source-fee item (e.g. `'FORWARD'`, `'PRE_FINALITY'`) in the
+     * returned fee token and decimal precision, each tagged with its own
+     * {@link AssetAmount.type} and {@link AssetAmount.status} (e.g.
+     * `'estimated'`). Empty when no such fee applies. Distinct from native gas
+     * estimates, which are reported separately as gas-fee fields.
      */
     readonly fees: readonly AssetAmount[];
     /**
@@ -6806,7 +6811,12 @@ interface WithdrawalQuoteInfo {
      * available balance and quoted withdrawal in a single round-trip.
      */
     readonly maxWithdrawable: AssetAmount;
-    /** Fees applied to the withdrawal. */
+    /**
+     * Fees applied to the withdrawal.
+     *
+     * Circle fees are returned with `type: 'circle'` so callers can distinguish
+     * them from untyped plain fees and native gas estimates.
+     */
     readonly fees: readonly AssetAmount[];
     /**
      * Estimated native gas fees for the transactions needed to withdraw.
@@ -7264,8 +7274,8 @@ interface CrossChainDepositParams<TFromAdapterCapabilities extends AdapterCapabi
      */
     readonly amount: string;
     /**
-     * Maximum source-collected bridge fee the caller is willing to sign for, in
-     * human-readable source token units.
+     * Maximum source-collected bridge fee the caller is willing to accept, in
+     * human-readable fee token units from the quote.
      *
      * Derive this from a recent cross-chain deposit quote by summing
      * `quote.fees[].amount`. The prepared bridge bundle must not exceed this cap
@@ -8064,6 +8074,16 @@ interface AppKitContext {
      * @defaultValue false
      */
     disableErrorReporting?: boolean;
+    /**
+     * Custom HTTP headers forwarded with the underlying CCTP provider's
+     * attestation (Iris) API requests made by bridge operations.
+     *
+     * @remarks
+     * Headers are merged on top of the SDK defaults (such as `Content-Type`)
+     * rather than replacing them. The header is forwarded as-is to Circle's API;
+     * the SDK does not interpret it.
+     */
+    headers?: Record<string, string>;
 }
 
 /**

package/earn.d.ts

@@ -659,6 +659,8 @@ declare enum Blockchain {
     Celo_Alfajores_Testnet = "Celo_Alfajores_Testnet",
     Codex = "Codex",
     Codex_Testnet = "Codex_Testnet",
+    Cronos = "Cronos",
+    Cronos_Testnet = "Cronos_Testnet",
     Edge = "Edge",
     Edge_Testnet = "Edge_Testnet",
     Ethereum = "Ethereum",
@@ -900,6 +902,7 @@ declare enum BridgeChain {
     Avalanche = "Avalanche",
     Base = "Base",
     Codex = "Codex",
+    Cronos = "Cronos",
     Edge = "Edge",
     Ethereum = "Ethereum",
     HyperEVM = "HyperEVM",
@@ -923,6 +926,7 @@ declare enum BridgeChain {
     Avalanche_Fuji = "Avalanche_Fuji",
     Base_Sepolia = "Base_Sepolia",
     Codex_Testnet = "Codex_Testnet",
+    Cronos_Testnet = "Cronos_Testnet",
     Edge_Testnet = "Edge_Testnet",
     Ethereum_Sepolia = "Ethereum_Sepolia",
     HyperEVM_Testnet = "HyperEVM_Testnet",
@@ -6380,10 +6384,11 @@ interface AssetAmount {
     /**
      * Optional category tag for the amount.
      *
-     * Present on fee entries to identify the kind of fee — for cross-chain
-     * deposit quotes this is the source-fee item type (e.g. `'FORWARD'`,
-     * `'PRE_FINALITY'`). Omitted when the amount has no meaningful category
-     * (plain deposit/withdrawal/share/reward amounts).
+     * Present on fee entries to identify the kind of fee. For cross-chain deposit
+     * quotes this is the source-fee item type (e.g. `'FORWARD'`,
+     * `'PRE_FINALITY'`), and for withdrawal quotes this can identify Circle fees
+     * (e.g. `'circle'`). Omitted when the amount has no meaningful
+     * category (plain deposit/withdrawal/share/reward amounts).
      */
     readonly type?: string | undefined;
     /**
@@ -6744,12 +6749,12 @@ interface DepositQuoteInfo {
     /** Current annualized percentage yield. */
     readonly currentApy: number;
     /**
-     * Deposit fees charged in the deposit asset. For cross-chain quotes this
-     * carries one entry per source-fee item (e.g. `'FORWARD'`, `'PRE_FINALITY'`),
-     * each tagged with its own {@link AssetAmount.type} and
-     * {@link AssetAmount.status} (e.g. `'estimated'`). Empty when no such fee
-     * applies. Distinct from native gas estimates, which are reported separately
-     * as gas-fee fields.
+     * Deposit fees charged by the quote. For cross-chain quotes this carries one
+     * entry per source-fee item (e.g. `'FORWARD'`, `'PRE_FINALITY'`) in the
+     * returned fee token and decimal precision, each tagged with its own
+     * {@link AssetAmount.type} and {@link AssetAmount.status} (e.g.
+     * `'estimated'`). Empty when no such fee applies. Distinct from native gas
+     * estimates, which are reported separately as gas-fee fields.
      */
     readonly fees: readonly AssetAmount[];
     /**
@@ -6806,7 +6811,12 @@ interface WithdrawalQuoteInfo {
      * available balance and quoted withdrawal in a single round-trip.
      */
     readonly maxWithdrawable: AssetAmount;
-    /** Fees applied to the withdrawal. */
+    /**
+     * Fees applied to the withdrawal.
+     *
+     * Circle fees are returned with `type: 'circle'` so callers can distinguish
+     * them from untyped plain fees and native gas estimates.
+     */
     readonly fees: readonly AssetAmount[];
     /**
      * Estimated native gas fees for the transactions needed to withdraw.
@@ -7264,8 +7274,8 @@ interface CrossChainDepositParams<TFromAdapterCapabilities extends AdapterCapabi
      */
     readonly amount: string;
     /**
-     * Maximum source-collected bridge fee the caller is willing to sign for, in
-     * human-readable source token units.
+     * Maximum source-collected bridge fee the caller is willing to accept, in
+     * human-readable fee token units from the quote.
      *
      * Derive this from a recent cross-chain deposit quote by summing
      * `quote.fees[].amount`. The prepared bridge bundle must not exceed this cap
@@ -8064,6 +8074,16 @@ interface AppKitContext {
      * @defaultValue false
      */
     disableErrorReporting?: boolean;
+    /**
+     * Custom HTTP headers forwarded with the underlying CCTP provider's
+     * attestation (Iris) API requests made by bridge operations.
+     *
+     * @remarks
+     * Headers are merged on top of the SDK defaults (such as `Content-Type`)
+     * rather than replacing them. The header is forwarded as-is to Circle's API;
+     * the SDK does not interpret it.
+     */
+    headers?: Record<string, string>;
 }
 
 /**