@circle-fin/bridge-kit 1.3.0 → 1.4.0

package/index.mjs

@@ -480,6 +480,12 @@ const InputError = {
         name: 'INPUT_INVALID_CHAIN',
         type: 'INPUT',
     },
+    /** Invalid or unknown token (symbol not found, missing decimals, etc.) */
+    INVALID_TOKEN: {
+        code: 1006,
+        name: 'INPUT_INVALID_TOKEN',
+        type: 'INPUT',
+    },
     /** General validation failure for complex validation rules */
     VALIDATION_FAILED: {
         code: 1098,
@@ -1262,8 +1268,11 @@ const ArcTestnet = defineChain({
     name: 'Arc Testnet',
     title: 'ArcTestnet',
     nativeCurrency: {
-        name: 'Arc',
-        symbol: 'Arc',
+        name: 'USDC',
+        symbol: 'USDC',
+        // Arc uses native USDC with 18 decimals for gas payments (EVM standard).
+        // Note: The ERC-20 USDC contract at usdcAddress uses 6 decimals.
+        // See: https://docs.arc.network/arc/references/contract-addresses
         decimals: 18,
     },
     chainId: 5042002,
@@ -4628,7 +4637,7 @@ const parseAmount = (params) => {
 };
 
 var name = "@circle-fin/bridge-kit";
-var version = "1.3.0";
+var version = "1.4.0";
 var pkg = {
 	name: name,
 	version: version};
@@ -5905,7 +5914,7 @@ class BridgeKit {
         return formatBridgeResult(await provider.estimate(finalResolvedParams), 'to-human-readable');
     }
     /**
-     * Get all chains supported by any provider in the kit.
+     * Get all chains supported by any provider in the kit, with optional filtering.
      *
      * Aggregate and deduplicate the supported chains from all registered providers.
      * This provides a comprehensive list of chains that can be used as either source
@@ -5915,6 +5924,7 @@ class BridgeKit {
      * ensuring each chain appears only once in the result regardless of how many
      * providers support it.
      *
+     * @param options - Optional filtering options to narrow down the returned chains
      * @returns Array of unique chain definitions supported by the registered providers
      *
      * @example
@@ -5922,19 +5932,56 @@ class BridgeKit {
      * import { BridgeKit } from '@circle-fin/bridge-kit'
      *
      * const kit = new BridgeKit()
-     * const chains = kit.getSupportedChains()
+     *
+     * // Get all supported chains (no filtering)
+     * const allChains = kit.getSupportedChains()
+     *
+     * // Get only EVM chains
+     * const evmChains = kit.getSupportedChains({ chainType: 'evm' })
+     *
+     * // Get EVM and Solana chains
+     * const evmAndSolana = kit.getSupportedChains({ chainType: ['evm', 'solana'] })
+     *
+     * // Get only mainnet chains
+     * const mainnets = kit.getSupportedChains({ isTestnet: false })
+     *
+     * // Get only EVM mainnet chains
+     * const evmMainnets = kit.getSupportedChains({ chainType: 'evm', isTestnet: false })
      *
      * console.log('Supported chains:')
-     * chains.forEach(chain => {
+     * allChains.forEach(chain => {
      *   console.log(`- ${chain.name} (${chain.type})`)
      * })
      * ```
      */
-    getSupportedChains() {
+    getSupportedChains(options) {
         const supportedChains = this.providers.flatMap((p) => p.supportedChains);
         // Deduplicate chains by using chain identifiers as object keys
         // Later duplicates will override earlier ones, keeping only the last occurrence
-        return Object.values(Object.fromEntries(supportedChains.map((chain) => [chain.chain, chain])));
+        let chains = Object.values(Object.fromEntries(supportedChains.map((chain) => [chain.chain, chain])));
+        // Apply chain type filter if provided
+        if (options?.chainType !== undefined) {
+            // Validate at runtime since JS consumers can bypass TypeScript's narrow type.
+            const supportedChainTypes = ['evm', 'solana'];
+            const chainTypeInput = options.chainType;
+            const chainTypeValues = Array.isArray(chainTypeInput)
+                ? chainTypeInput
+                : [chainTypeInput];
+            if (!chainTypeValues.every((chainType) => supportedChainTypes.includes(chainType))) {
+                const listFormatter = new Intl.ListFormat('en', {
+                    style: 'long',
+                    type: 'conjunction',
+                });
+                throw createValidationFailedError$1('options.chainType', options.chainType, `Supported chain types include: ${listFormatter.format(supportedChainTypes)}`);
+            }
+            const chainTypes = new Set(chainTypeValues);
+            chains = chains.filter((chain) => chainTypes.has(chain.type));
+        }
+        // Apply testnet filter if provided
+        if (options?.isTestnet !== undefined) {
+            chains = chains.filter((chain) => chain.isTestnet === options.isTestnet);
+        }
+        return chains;
     }
     /**
      * Validate that source and destination chains are on the same network type.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circle-fin/bridge-kit",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "SDK for seamless cross-chain stablecoin bridging",
   "keywords": [
     "circle",
@@ -22,7 +22,7 @@
   "types": "./index.d.ts",
   "dependencies": {
     "zod": "3.25.67",
-    "@circle-fin/provider-cctp-v2": "^1.1.0",
+    "@circle-fin/provider-cctp-v2": "^1.2.0",
     "abitype": "^1.1.0",
     "@solana/web3.js": "^1.98.4",
     "@ethersproject/address": "^5.8.0",