@circle-fin/app-kit 1.13.0 → 1.14.0

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # @circle-fin/app-kit
 
+## 1.14.0
+
+### Minor Changes
+
+- Add fast cross-chain deposits and fee estimation to Unified Balance Kit.
+
+  ## Fast cross-chain deposits
+
+  `deposit` and `depositFor` now accept a `to` field and a `config.transferSpeed`
+  of `'FAST'` to burn USDC on the source chain and credit a Gateway balance on a
+  different destination chain in a single relayed flow:
+
+  ```typescript
+  const result = await kit.deposit({
+    from,
+    amount: "10",
+    token: "USDC",
+    to: { chain: "Arc_Testnet" },
+    config: { transferSpeed: "FAST" },
+  });
+  ```
+
+  `DepositResult` now includes `fees`, `progress`, `sourceChain`, and
+  `destinationChain` on the fast path.
+
+  ## Fee estimation
+
+  New `estimateDeposit` method returns an itemized fee breakdown and a signed
+  quote that can be passed directly into a subsequent `deposit` / `depositFor` to
+  lock the price:
+
+  ```typescript
+  const estimate = await kit.estimateDeposit({
+    from,
+    amount: "10",
+    token: "USDC",
+    to: { chain: "Arc_Testnet" },
+    config: { transferSpeed: "FAST" },
+  });
+
+  // Spread the estimate at the top level; re-attach `from` (which holds the signer).
+  // The signed `quote` inside the estimate locks the quoted fee for this call.
+  const result = await kit.deposit({ ...estimate, from });
+  ```
+
+  `estimateDeposit` is also available on `AppKit` via
+  `kit.unifiedBalance.estimateDeposit(...)`.
+
+### Patch Changes
+
+- Fix `getSupportedChains({ sourceFeeSupported: true })` over-reporting source-fee
+  bridging support. Previously, source-fee eligibility was inferred from a contract
+  address shared with the fast-deposit forwarding path, causing fast-deposit-only chains
+  to appear supported and fail at the Quote API instead of being rejected client-side.
+  Source-fee support is now gated on an explicit allowlist of eligible source chains.
+
 ## 1.13.0
 
 ### Minor Changes