@circle-fin/app-kit 1.15.3 → 1.16.0

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # @circle-fin/app-kit
 
+## 1.16.0
+
+### Minor Changes
+
+- Add Borrow Kit to App Kit under `kit.borrow`:
+
+  ```ts
+  import { AppKit, BorrowChain } from "@circle-fin/app-kit";
+
+  const kit = new AppKit();
+
+  const result = await kit.borrow.borrow({
+    from: { adapter, chain: BorrowChain.Arc },
+    marketId: "0x...",
+    borrowAmount: "100",
+  });
+  ```
+
+  - Every Borrow Kit operation except `getSupportedChains` is available on
+    `kit.borrow`, including `retry`, and forwards App Kit's `disableAnalytics`
+    and `disableErrorReporting`.
+  - List borrow chains with `kit.getSupportedChains('borrow')`. Calling
+    `kit.getSupportedChains()` with no operation type now includes them, and
+    the standalone operation is exported as `borrowGetSupportedChains`.
+  - Borrow step events are namespaced: `kit.on('borrow.execute', handler)` and
+    `kit.on('*', handler)` both receive borrow progress.
+  - `@circle-fin/app-kit/borrow` exports the same operations as standalone
+    functions for tree-shaking.
+  - Borrow Kit's types, schemas and standalone operations are re-exported from
+    the package root, prefixed with `Borrow` wherever the name does not already
+    contain it (for example `BorrowLoanInfo`, `borrowRepay`).
+
+- Default the destination of FAST cross-chain deposits to Arc. When `config.transferSpeed` is `'FAST'` and `to` is omitted, `deposit`, `depositFor`, and `estimateDeposit` now credit the Gateway balance on `Arc` for mainnet sources and `Arc_Testnet` for testnet sources instead of throwing. Passing `to` explicitly still selects any other supported fast-finality destination, and `estimateDeposit` echoes the resolved `to` so `deposit({ ...estimate, from })` targets the same chain.
+
+  Setting `allowanceStrategy` on a FAST deposit now fails with "cannot be set for FAST cross-chain deposits". A STANDARD deposit that sets both `to` and `allowanceStrategy` now reports the invalid `to` instead.
+
+### Patch Changes
+
+- Stop replacing a validation error with a `TypeError` when the rejected value
+  holds a `bigint`.
+
+  Building a validation error serializes the offending value into the message.
+  `JSON.stringify` refuses `bigint` and circular structures, so a value that
+  carried either — an on-chain read, or a transaction receipt log, both of which
+  routinely hold `bigint` fields — threw
+  `TypeError: Do not know how to serialize a BigInt` from inside the error
+  constructor. The real error never surfaced, and callers saw an unrelated crash
+  in its place.
+
+  Such values now render with their `bigint` fields as strings, and a value that
+  still cannot be serialized renders as `[unserializable object]`. The error's
+  `cause.trace.value` is unchanged and still carries the raw value.
+
 ## 1.15.3
 
 ### Patch Changes

package/README.md

@@ -266,7 +266,7 @@ console.log(
 Check which chains support specific operations:
 
 ```typescript
-// Get all chains (bridge, swap, earn, and unified balance)
+// Get all chains (bridge, swap, earn, borrow, and unified balance)
 const allChains = kit.getSupportedChains()
 
 // Get all chains that support bridging
@@ -278,6 +278,9 @@ const swapChains = kit.getSupportedChains('swap')
 // Get chains that support earn vault operations
 const earnChains = kit.getSupportedChains('earn')
 
+// Get chains that support borrow operations
+const borrowChains = kit.getSupportedChains('borrow')
+
 // Get chains that support unified balance operations
 const ubChains = kit.getSupportedChains('unifiedBalance')
 ```
@@ -793,7 +796,7 @@ await kit.bridge({
 - `kit.getSwapStatus(params)` - Fetch the current status of a swap
 - `kit.waitForSwap(params)` - Poll until a swap reaches a terminal status
 - `kit.getTokenRates(params)` - Fetch cached token USD rates
-- `kit.getSupportedChains(operationType?)` - Query supported chains by operation type (`'bridge'`, `'swap'`, `'earn'`, `'unifiedBalance'`)
+- `kit.getSupportedChains(operationType?)` - Query supported chains by operation type (`'bridge'`, `'swap'`, `'earn'`, `'borrow'`, `'unifiedBalance'`)
 - `kit.setCustomFeePolicy(policy)` - Set operation-scoped custom fee policies
 - `kit.removeCustomFeePolicy(operation)` - Remove an operation-scoped custom fee policy
 - `kit.on(event, handler)` - Listen to operation events