@circle-fin/app-kit 1.14.0 → 1.15.1

package/chains.mjs

@@ -61,9 +61,10 @@ import { z } from 'zod';
     Blockchain["Algorand_Testnet"] = "Algorand_Testnet";
     Blockchain["Aptos"] = "Aptos";
     Blockchain["Aptos_Testnet"] = "Aptos_Testnet";
-    Blockchain["Arc_Testnet"] = "Arc_Testnet";
     Blockchain["Arbitrum"] = "Arbitrum";
     Blockchain["Arbitrum_Sepolia"] = "Arbitrum_Sepolia";
+    Blockchain["Arc"] = "Arc";
+    Blockchain["Arc_Testnet"] = "Arc_Testnet";
     Blockchain["Avalanche"] = "Avalanche";
     Blockchain["Avalanche_Fuji"] = "Avalanche_Fuji";
     Blockchain["Base"] = "Base";
@@ -150,6 +151,7 @@ var SwapChain;
     SwapChain["XDC"] = "XDC";
     SwapChain["HyperEVM"] = "HyperEVM";
     SwapChain["Monad"] = "Monad";
+    SwapChain["Arc"] = "Arc";
     // Testnet chains with swap support
     SwapChain["Arc_Testnet"] = "Arc_Testnet";
 })(SwapChain || (SwapChain = {}));
@@ -157,6 +159,7 @@ var BridgeChain;
 (function(BridgeChain) {
     // Mainnet chains with CCTPv2 support
     BridgeChain["Arbitrum"] = "Arbitrum";
+    BridgeChain["Arc"] = "Arc";
     BridgeChain["Avalanche"] = "Avalanche";
     BridgeChain["Base"] = "Base";
     BridgeChain["Codex"] = "Codex";
@@ -212,6 +215,7 @@ var BridgeChain;
 var UnifiedBalanceChain;
 (function(UnifiedBalanceChain) {
     // Mainnet chains with Gateway V1 support
+    UnifiedBalanceChain["Arc"] = "Arc";
     UnifiedBalanceChain["Arbitrum"] = "Arbitrum";
     UnifiedBalanceChain["Avalanche"] = "Avalanche";
     UnifiedBalanceChain["Base"] = "Base";
@@ -241,6 +245,7 @@ var UnifiedBalanceChain;
 })(UnifiedBalanceChain || (UnifiedBalanceChain = {}));
 var EarnChain;
 (function(EarnChain) {
+    EarnChain["Arc"] = "Arc";
     EarnChain["Arc_Testnet"] = "Arc_Testnet";
 })(EarnChain || (EarnChain = {}));
 /**
@@ -257,8 +262,11 @@ var EarnChain;
  * console.log(EARN_BRIDGE_SOURCE_BLOCKCHAINS.join(', '))
  * ```
  */ const EARN_BRIDGE_SOURCE_BLOCKCHAINS = [
+    "Arbitrum",
     "Arbitrum_Sepolia",
+    "Base",
     "Base_Sepolia",
+    "Ethereum",
     "Ethereum_Sepolia"
 ];
 /**
@@ -272,6 +280,7 @@ var EarnChain;
  * console.log(EARN_BRIDGE_DESTINATION_BLOCKCHAINS.join(', '))
  * ```
  */ const EARN_BRIDGE_DESTINATION_BLOCKCHAINS = [
+    "Arc",
     "Arc_Testnet"
 ];
 
@@ -577,6 +586,25 @@ var EarnChain;
  * EVM-compatible chains. Use this address when deploying or testing
  * cross-chain USDC transfers on test networks.
  */ const BRIDGE_CONTRACT_EVM_TESTNET = '0xC5567a5E3370d4DBfB0540025078e283e36A363d';
+/**
+ * The CrossChainTokenService (CCTPx) service address for EVM testnet networks.
+ *
+ * This service coordinates CCTPx cross-chain token operations on testnet
+ * environments and is shared by every EVM test network CCTPx supports. Read the
+ * chain definitions via `isCCTPXSupported` rather than trusting a list here,
+ * which goes stale as deployments land.
+ */ const CCTPX_SERVICE_ADDRESS_EVM_TESTNET = '0x63753E722bd2C2A5DF6EE19C5106662208B81077';
+/**
+ * CrossChainTokenService (CCTS) proxy address for CCTPx on EVM **mainnet**.
+ *
+ * @remarks
+ * A distinct deployment from {@link CCTPX_SERVICE_ADDRESS_EVM_TESTNET}, shared
+ * by every EVM mainnet chain that CCTPx supports. A chain becomes
+ * CCTPx-eligible only once its definition carries this as
+ * `cctpx.serviceAddress`, and a route additionally needs both of its endpoints
+ * eligible — so adding a chain here is the deliberate, reviewable step that
+ * opens mainnet CCTPx for it.
+ */ const CCTPX_SERVICE_ADDRESS_EVM_MAINNET = '0x431871229103b780868f8C6BB820cd16ECf942BC';
 /**
  * The bridge contract address for EVM mainnet networks.
  *
@@ -685,6 +713,76 @@ var EarnChain;
  * Identical across all testnet EVM destination chains.
  */ const GENERIC_EXECUTOR_EVM_TESTNET = '0xEdC81040756AcCfF070c21D37b265b9D0b5Ba45e';
 
+/**
+ * Arc Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Arc blockchain,
+ * Circle's EVM-compatible Layer-1 designed for stablecoin finance
+ * and asset tokenization. Arc uses USDC as the native gas token and
+ * features the Malachite Byzantine Fault Tolerant (BFT) consensus
+ * engine for sub-second finality.
+ */ const Arc = defineChain({
+    type: 'evm',
+    chain: Blockchain.Arc,
+    name: 'Arc',
+    title: 'Arc Mainnet',
+    nativeCurrency: {
+        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: 5042,
+    isTestnet: false,
+    explorerUrl: 'https://explorer.arc.io/tx/{hash}',
+    rpcEndpoints: [
+        'https://rpc.mainnet.arc.io/'
+    ],
+    eurcAddress: '0xbEf5f6d51CB62b58e6A8f77868681825C6fe21c1',
+    usdcAddress: '0x3600000000000000000000000000000000000000',
+    usdtAddress: null,
+    cctp: {
+        domain: 26,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+                confirmations: 1,
+                fastConfirmations: 1
+            }
+        },
+        forwarderSupported: {
+            source: false,
+            destination: true
+        }
+    },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET
+    },
+    gateway: {
+        domain: 26,
+        contracts: {
+            v1: {
+                wallet: GATEWAY_WALLET_EVM_MAINNET,
+                minter: GATEWAY_MINTER_EVM_MAINNET,
+                depositForHandler: DEPOSIT_FOR_HANDLER_EVM_MAINNET,
+                genericExecutor: GENERIC_EXECUTOR_EVM_MAINNET
+            }
+        },
+        forwarderSupported: {
+            source: true,
+            destination: true
+        }
+    }
+});
+
 /**
  * Arc Testnet chain definition
  * @remarks
@@ -732,6 +830,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
         adapter: ADAPTER_CONTRACT_EVM_TESTNET
@@ -799,6 +900,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -864,6 +968,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
         adapter: ADAPTER_CONTRACT_EVM_TESTNET
@@ -929,6 +1036,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -996,6 +1106,9 @@ var EarnChain;
     rpcEndpoints: [
         'https://api.avax-test.network/ext/bc/C/rpc'
     ],
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET
     },
@@ -1063,6 +1176,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -1128,6 +1244,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
         adapter: ADAPTER_CONTRACT_EVM_TESTNET
@@ -1520,6 +1639,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -1585,6 +1707,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
         adapter: ADAPTER_CONTRACT_EVM_TESTNET
@@ -2416,6 +2541,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -2481,6 +2609,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET
     },
@@ -2876,6 +3007,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -2944,6 +3078,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET
     },
@@ -4113,6 +4250,7 @@ var EarnChain;
     usdcAddress: z.string().nullable(),
     usdtAddress: z.string().nullable(),
     cctp: z.any().nullable(),
+    cctpx: z.any().optional(),
     kitContracts: z.object({
         bridge: z.string().optional(),
         adapter: z.string().optional()
@@ -4318,14 +4456,15 @@ const EARN_BRIDGE_DESTINATION_CHAIN_VALUES = EARN_BRIDGE_DESTINATION_BLOCKCHAINS
  * Zod schema for validating the source chain of a cross-chain Earn deposit.
  *
  * Accept a supported source Blockchain value, a matching string literal, or a
- * ChainDefinition for a supported source chain. Source chains are Ethereum
- * Sepolia, Arbitrum Sepolia, and Base Sepolia.
+ * ChainDefinition for a supported source chain. Source chains are Ethereum,
+ * Arbitrum, and Base (mainnet and testnet).
  *
  * @example
  * ```typescript
  * import { earnBridgeSourceChainIdentifierSchema } from '@core/chains'
  *
  * // Valid
+ * earnBridgeSourceChainIdentifierSchema.parse('Ethereum')
  * earnBridgeSourceChainIdentifierSchema.parse('Ethereum_Sepolia')
  *
  * // Invalid (throws ZodError)
@@ -4344,14 +4483,15 @@ const EARN_BRIDGE_DESTINATION_CHAIN_VALUES = EARN_BRIDGE_DESTINATION_BLOCKCHAINS
  * deposit.
  *
  * Accept a supported destination Blockchain value, a matching string literal,
- * or a ChainDefinition for a supported destination chain. Currently only Arc
- * Testnet is supported.
+ * or a ChainDefinition for a supported destination chain. Arc (mainnet) and
+ * Arc Testnet are supported.
  *
  * @example
  * ```typescript
  * import { earnBridgeDestinationChainIdentifierSchema } from '@core/chains'
  *
  * // Valid
+ * earnBridgeDestinationChainIdentifierSchema.parse('Arc')
  * earnBridgeDestinationChainIdentifierSchema.parse('Arc_Testnet')
  *
  * // Invalid (throws ZodError)
@@ -4423,5 +4563,5 @@ const swapTokenEnumSchema = z.enum([
  * ```
  */ z.string().transform((value)=>value.toUpperCase()).pipe(swapTokenEnumSchema);
 
-export { Arbitrum, ArbitrumSepolia, ArcTestnet, Avalanche, AvalancheFuji, Base, BaseSepolia, Codex, CodexTestnet, Ethereum, EthereumSepolia, HyperEVM, HyperEVMTestnet, Ink, InkTestnet, Linea, LineaSepolia, Optimism, OptimismSepolia, Plasma, PlasmaTestnet, Plume, PlumeTestnet, Polygon, PolygonAmoy, Sei, SeiTestnet, Solana, SolanaDevnet, Sonic, SonicTestnet, Unichain, UnichainSepolia, WorldChain, WorldChainSepolia, XDC, XDCApothem, XLayer, XLayerTestnet };
+export { Arbitrum, ArbitrumSepolia, Arc, ArcTestnet, Avalanche, AvalancheFuji, Base, BaseSepolia, Codex, CodexTestnet, Ethereum, EthereumSepolia, HyperEVM, HyperEVMTestnet, Ink, InkTestnet, Linea, LineaSepolia, Optimism, OptimismSepolia, Plasma, PlasmaTestnet, Plume, PlumeTestnet, Polygon, PolygonAmoy, Sei, SeiTestnet, Solana, SolanaDevnet, Sonic, SonicTestnet, Unichain, UnichainSepolia, WorldChain, WorldChainSepolia, XDC, XDCApothem, XLayer, XLayerTestnet };
 //# sourceMappingURL=chains.mjs.map