@circle-fin/bridge-kit 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -0,0 +1,124 @@
+# @circle-fin/bridge-kit
+
+## 1.1.2
+
+### Patch Changes
+
+- Fixed bug where tokens could be burned when bridging to unsupported chains, and improved error messages to clearly show which chains are supported.
+
+  **What's Fixed:**
+  - **Prevents fund loss**: Bridge operations now fail immediately if your adapter doesn't support the source or destination chain, **before** any tokens are approved or burned. Previously, tokens could be burned on the source chain before discovering the destination chain was unsupported, requiring manual recovery.
+  - **Better error messages**: When you attempt to use an unsupported chain, the error now clearly lists all chains your adapter supports, making it easy to pick an alternative:
+    ```
+    Invalid chain 'Linea Sepolia': Not supported by this adapter.
+    It supports 17 chains: Arbitrum, Base, Ethereum, Polygon, Solana, ...
+    ```
+  - **Correct error codes**: Chain validation errors now use the correct `INVALID_CHAIN` error code instead of `UNSUPPORTED_ROUTE`, making it easier to handle errors programmatically.
+
+## 1.1.1
+
+### Patch Changes
+
+- Fix CommonJS compatibility by correcting file extensions and package exports. This resolves a "ReferenceError: require is not defined" error that occurred when using packages in CommonJS projects with ts-node.
+
+- Fixes a bug where the `recipientAddress` field in the `to` parameter was not being properly propagated to the underlying CCTP v2 provider. This caused custom recipient addresses to be ignored during cross-chain USDC transfers, resulting in funds being minted to the signer's address instead of the intended recipient.
+
+  With this fix, when you specify a `recipientAddress` in the `to` parameter, the Bridge Kit now correctly passes it through to the provider, ensuring funds are minted to the correct address.
+
+  **Example usage** (no changes needed if already using this pattern):
+
+  ```typescript
+  await kit.bridge({
+    from: { adapter: sourceAdapter, chain: 'Ethereum' },
+    to: {
+      adapter: destAdapter,
+      chain: 'Base',
+      recipientAddress: '0x...', // Now properly respected
+    },
+    amount: '10',
+    token: 'USDC',
+  })
+  ```
+
+  **No breaking changes** - existing code without `recipientAddress` continues to work unchanged. This fix only affects transfers where you explicitly provide a custom recipient address.
+
+## 1.1.0
+
+### Minor Changes
+
+- Add automatic HTTP request tracking for analytics and debugging. The kit now automatically registers itself when the module loads, enabling Circle to track kit usage and identify issues. Applications can optionally set an external prefix using the new `setExternalPrefix` function to identify themselves in request analytics. All HTTP requests from the kit will include user agent information in the format: `[app/version] bridge-kit/version (runtime)`. This feature requires no code changes for existing users.
+
+### Patch Changes
+
+- Standardize `maxFee` parameter to accept human-readable values. The `maxFee` parameter in `BridgeConfig` now correctly accepts human-readable token amounts (e.g., `"1"` for 1 USDC, `"0.5"` for 0.5 USDC), matching the behavior of `customFee.value`. This resolves an undocumented inconsistency in the API. If you were previously passing values in smallest units, update to human-readable format: use `"1"` instead of `"1000000"` for 1 USDC.
+- Complete CCTP v2 chain support exports
+
+  Ensures all 35 chains with CCTP v2 support are properly exported from the `chains` entry point. This fix adds previously missing chain definitions including Codex, HyperEVM, Ink, Plume, Sei, Sonic, Unichain, WorldChain, and XDC networks (both mainnet and testnet variants where applicable).
+
+- Add support for Arc Testnet chain definition. Arc is Circle's EVM-compatible Layer-1 blockchain designed for stablecoin finance and asset
+  tokenization, featuring USDC as the native gas token and sub-second finality via the Malachite BFT consensus engine.
+- Fix support for developer-controlled address context. Bridge operations now correctly accept an explicit `address` field in the context, allowing developer-controlled adapters to specify which address to use for operations. Previously, this field was incorrectly rejected at runtime.
+- Update Sonic Testnet chain definition to canonical network. The `SonicTestnet` chain definition now points to the official Sonic Testnet (chainId: 14601) instead of the deprecated Sonic Blaze Testnet (chainId: 57054). The RPC endpoint has been updated to `https://rpc.testnet.soniclabs.com`, the display name simplified to "Sonic Testnet", and the USDC contract address updated to the new deployment.
+
+  **Breaking Changes:**
+  - **Chain ID:** 57054 → 14601
+  - **RPC Endpoint:** `https://rpc.blaze.soniclabs.com` → `https://rpc.testnet.soniclabs.com`
+  - **USDC Address:** `0xA4879Fed32Ecbef99399e5cbC247E533421C4eC6` → `0x0BA304580ee7c9a980CF72e55f5Ed2E9fd30Bc51`
+
+  **Migration:** If you were using `SonicTestnet`, your application will automatically connect to the new network upon upgrading. Any accounts, contracts, or transactions on the old Blaze testnet (chainId: 57054) will need to be recreated on the new testnet.
+
+## 1.0.0
+
+### Major Changes
+
+- # Bridge Kit 1.0.0 Release 🎉
+
+  The core orchestration library for cross-chain USDC transfers - providing a unified, type-safe interface for bridging USDC between heterogeneous blockchain networks.
+
+  ## 🚀 Core Features
+  - **Complete Cross-chain Orchestration**: High-level API for USDC transfers between any supported chains
+  - **Type-safe APIs**: Exhaustive runtime validation with strict TypeScript support
+  - **Deterministic Operations**: Pre-flight simulations and predictable quote generation
+  - **Comprehensive Finality Tracking**: Monitor transfer progress across all bridge steps
+
+  ## 🔄 Intelligent Retry System
+
+  Sophisticated retry mechanism that automatically handles failed or incomplete transfers:
+  - **Automatic Recovery**: Resume transfers from the exact point of failure
+  - **Step Analysis**: Intelligent detection of which operations completed successfully
+  - **Network Resilience**: Handle temporary connectivity issues and gas estimation failures
+  - **Multi-step Flow Support**: Retry complex bridge operations involving multiple blockchain transactions
+
+  ```typescript
+  // Retry a failed transfer with fresh adapter instances
+  const retryResult = await kit.retry(failedResult, {
+    from: sourceAdapter,
+    to: destAdapter,
+  })
+  ```
+
+  ## 💰 Flexible Fee Management
+
+  Comprehensive fee system supporting both protocol fees and custom integrator fees:
+  - **Transfer Speed Options**: Choose between FAST (with fees) and SLOW (fee-free) transfers
+  - **Dynamic Fee Calculation**: Automatic fee estimation based on transfer amount and network conditions
+  - **Custom Fee Policies**: Implement your own fee structures with absolute amounts
+  - **Multi-chain Fee Support**: Different fee configurations per source chain
+  - **Fee Recipient Control**: Specify where fees are sent on the source chain
+
+  ```typescript
+  // Set custom fee policy
+  kit.setCustomFeePolicy({
+    calculateFee: (params) =>
+      params.from.chain.type === 'solana' ? '0.1' : '0.2',
+    resolveFeeRecipientAddress: (chain) => getFeeRecipientForChain(chain),
+  })
+  ```
+
+  ## 🎯 Use Cases
+  - **Multi-chain dApp Integration**: Single SDK for all cross-chain USDC needs
+  - **Wallet Integration**: Seamless cross-chain transfers for end users
+  - **Exchange Integration**: Institutional-grade cross-chain USDC movement
+  - **DeFi Protocol Integration**: Bridge USDC liquidity across ecosystems
+
+  This release provides the foundational orchestration layer for cross-chain USDC applications with production-ready reliability and comprehensive developer tooling.

package/{chains.cjs.js → chains.cjs}

@@ -2301,4 +2301,4 @@ exports.WorldChain = WorldChain;
 exports.WorldChainSepolia = WorldChainSepolia;
 exports.XDC = XDC;
 exports.XDCApothem = XDCApothem;
-//# sourceMappingURL=chains.cjs.js.map
+//# sourceMappingURL=chains.cjs.map

package/chains.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}