@circle-fin/app-kit 1.13.0 → 1.15.0

package/CHANGELOG.md

@@ -1,5 +1,127 @@
 # @circle-fin/app-kit
 
+## 1.15.0
+
+### Minor Changes
+
+- Add an `onramp` namespace and a `@circle-fin/app-kit/server` entry point. `kit.onramp` can fetch a session and mount the Arc Onramp widget (`mountIframe` / `openWindow`). `createAppServerKit` validates onramp credentials and mints sessions on the server.
+- Add Arc mainnet (`Blockchain.Arc`, chainId 5042) as a supported chain. Arc is wired for CCTP v2 bridging (`BridgeChain.Arc`, domain 26) with Circle's Forwarding Service enabled for Arc as a destination, and for Gateway v1 (`UnifiedBalanceChain.Arc`).
+- Add Arc mainnet (`Blockchain.Arc`, chainId 5042) as an EarnKit-selectable chain alongside Arc Testnet. `EarnChain.Arc` is now exposed for earn operations, and the Earn Service provider maps `Blockchain.Arc` to the `ARC` Earn API chain and reports it in `supportedChains`. App Kit re-exports this through its `earn` namespace, so `EarnChain.Arc` is selectable via App Kit as well.
+- Add Arc mainnet as a destination for FAST cross-chain deposits. You can now call `depositFor` with a cross-chain source and Arc mainnet (`UnifiedBalanceChain.Arc`) as the destination; previously that destination was rejected as unsupported.
+- Enable Arc mainnet swaps for USDC and EURC. `SwapChain.Arc` is accepted by swap operations, the Arc mainnet EURC token locator is registered, and Arc mainnet USDC EIP-2612 permit metadata (name "USDC", version "2") is included for gasless approvals.
+- Bridge EURC between Base and Ethereum mainnet
+
+  App Kit now supports EURC transfers between Base and Ethereum mainnet through Circle's CCTPx protocol. Pass `EURC` as `token` on `bridge` and `estimateBridge`:
+
+  ```ts
+  import { AppKit } from "@circle-fin/app-kit";
+
+  const kit = new AppKit();
+
+  const result = await kit.bridge({
+    token: "EURC",
+    from: { adapter, chain: "Base" },
+    to: { adapter, chain: "Ethereum" },
+    amount: "100",
+  });
+  ```
+
+  CCTPx also supports `cirBTC`, `wETH`, `EURC`, and raw `bytes32` token ids on eligible testnet routes.
+
+  - Routed results support provider-defined token identifiers while bare `BridgeResult` and `EstimateResult` types remain USDC-specific for source compatibility.
+  - `bridge` and `estimateBridge` reject custom fees on non-USDC routes. CCTPx routes accept `feePayment` only when omitted or set to `'source'`, and `useForwarder` only when omitted or set to `true`.
+  - Route discovery continues to other providers when one provider's route check fails. If no provider supports the route, App Kit preserves retryable failures on the resulting error.
+
+- Make Arc mainnet a CCTPx endpoint
+
+  Arc mainnet's chain definition gains `cctpx.serviceAddress`, pointing at the mainnet
+  CrossChainTokenService. `isCCTPXSupported(Chains.Arc)` becomes `true`, so Arc joins the
+  chains reported by `CCTPXBridgingProvider.getSupportedChains()`, and by Bridge Kit and App
+  Kit through it.
+
+  A chain being eligible does not by itself make a route usable: the token registry must list
+  the token with a deployment on both endpoints' CCTP domains.
+
+- Enable CCTPx on Arbitrum, Avalanche, Optimism and Polygon mainnet
+
+  These four chain definitions gain `cctpx.serviceAddress`, pointing at the mainnet
+  CrossChainTokenService. They join Ethereum and Base in the chains reported by
+  `CCTPXBridgingProvider.getSupportedChains()`, and by Bridge Kit and App Kit through it.
+
+  A chain being eligible does not by itself make a route usable: the token registry must list
+  the token with a deployment on both endpoints' CCTP domains.
+
+- Reuse an `estimate` quote when bridging (CCTPx)
+
+  Pass the `quote` returned by `estimateBridge` into `bridge` so the fee
+  you were quoted is the fee you pay. Treat the value as opaque and pass
+  it back unmodified.
+
+  Do not pass a quote into `estimateBridge`. If the supplied quote is
+  stale or does not match the requested fee token and speed, CCTPx
+  fetches a fresh quote and adds `QUOTE_NOT_REUSED` to `result.warnings`,
+  which means the fee paid may differ from the one quoted. A CCTPx quote
+  passed to a plain USDC bridge is ignored. Re-estimate whenever the
+  transfer changes.
+
+- Enable Circle's Forwarding Service as a destination for Arc mainnet. The Forwarding Service now supports Gateway transaction types on Arc, so a Gateway `spend` with `useForwarder: true` to an Arc mainnet destination is now accepted instead of being rejected up front.
+
+## 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

package/README.md

@@ -65,8 +65,8 @@ The App Kit provides a **unified interface** for cross-chain transfers, same-cha
 - **🔧 Bring your own infrastructure**: Seamlessly integrate with your existing setup when needed
 - **🔒 Production-ready security**: Leverages Circle's CCTPv2 for bridging and trusted swap providers
 - **🚀 Developer experience**: Complete TypeScript support, comprehensive validation, and instant connectivity
-- **🌍 Multi-chain support**: Bridge across **51 chains** with **1250 total bridge routes** through Circle's CCTPv2
-  - **Mainnet (25 chains)**: Arbitrum, Avalanche, Base, Codex, Cronos, Edge, Ethereum, HyperEVM, Injective, Ink, Linea, Monad, Morph, OP Mainnet, Pharos, Plasma, Plume, Polygon PoS, Sei, Solana, Sonic, Unichain, World Chain, XDC, X Layer
+- **🌍 Multi-chain support**: Bridge across **52 chains** with **1300 total bridge routes** through Circle's CCTPv2
+  - **Mainnet (26 chains)**: Arbitrum, Arc, Avalanche, Base, Codex, Cronos, Edge, Ethereum, HyperEVM, Injective, Ink, Linea, Monad, Morph, OP Mainnet, Pharos, Plasma, Plume, Polygon PoS, Sei, Solana, Sonic, Unichain, World Chain, XDC, X Layer
   - **Testnet (26 chains)**: Arc Testnet, Arbitrum Sepolia, Avalanche Fuji, Base Sepolia, Codex Testnet, Cronos Testnet, Edge Testnet, Ethereum Sepolia, HyperEVM Testnet, Injective Testnet, Ink Testnet, Linea Sepolia, Monad Testnet, Morph Testnet, OP Sepolia, Pharos Atlantic, Plasma Testnet, Plume Testnet, Polygon PoS Amoy, Sei Testnet, Solana Devnet, Sonic Testnet, Unichain Sepolia, World Chain Sepolia, XDC Apothem, X Layer Testnet
 - **🔄 Swap support**: Same-chain token swaps powered by Circle's Stablecoin Service
 - **🏦 Earn support**: DeFi lending vault deposits, withdrawals, and reward claims via `kit.earn`
@@ -163,7 +163,7 @@ const result = await kit.bridge({
 })
 ```
 
-A curated subset of 37 CCTPv2-supported chains is available for import from App Kit.
+A curated subset of 40 CCTPv2-supported chains is available for import from App Kit.
 
 ## Quick Start