@circle-fin/app-kit 1.0.1 → 1.1.0

package/README.md

@@ -63,9 +63,9 @@ The App Kit provides a **unified interface** for both cross-chain transfers and
 - **🔧 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 **35 chains** with **578 total bridge routes** through Circle's CCTPv2
-  - **Mainnet (17 chains)**: Arbitrum, Avalanche, Base, Codex, Ethereum, HyperEVM, Ink, Linea, OP Mainnet, Plume, Polygon PoS, Sei, Solana, Sonic, Unichain, World Chain, XDC
-  - **Testnet (18 chains)**: Arc Testnet, Arbitrum Sepolia, Avalanche Fuji, Base Sepolia, Codex Testnet, Ethereum Sepolia, HyperEVM Testnet, Ink Testnet, Linea Sepolia, OP Sepolia, Plume Testnet, Polygon PoS Amoy, Sei Testnet, Solana Devnet, Sonic Testnet, Unichain Sepolia, World Chain Sepolia, XDC Apothem
+- **🌍 Multi-chain support**: Bridge across **41 chains** with **800 total bridge routes** through Circle's CCTPv2
+  - **Mainnet (20 chains)**: Arbitrum, Avalanche, Base, Codex, Edge, Ethereum, HyperEVM, Ink, Linea, Monad, Morph, OP Mainnet, Plume, Polygon PoS, Sei, Solana, Sonic, Unichain, World Chain, XDC
+  - **Testnet (21 chains)**: Arc Testnet, Arbitrum Sepolia, Avalanche Fuji, Base Sepolia, Codex Testnet, Edge Testnet, Ethereum Sepolia, HyperEVM Testnet, Ink Testnet, Linea Sepolia, Monad Testnet, Morph Testnet, OP Sepolia, Plume Testnet, Polygon PoS Amoy, Sei Testnet, Solana Devnet, Sonic Testnet, Unichain Sepolia, World Chain Sepolia, XDC Apothem
 - **🔄 Swap support**: Same-chain token swaps powered by Circle's Stablecoin Service
 - **🎯 Flexible adapters**: Supporting EVM (Viem, Ethers) and Solana (@solana/web3)
 - **📡 Real-time event monitoring**: Track progress throughout the operation lifecycle
@@ -155,7 +155,7 @@ const result = await kit.bridge({
 })
 ```
 
-All 35 CCTPv2-supported chains are available for import.
+All 41 CCTPv2-supported chains are available for import.
 
 ## Quick Start
 

package/chains.cjs

@@ -52,6 +52,8 @@ var Blockchain;
     Blockchain["Celo_Alfajores_Testnet"] = "Celo_Alfajores_Testnet";
     Blockchain["Codex"] = "Codex";
     Blockchain["Codex_Testnet"] = "Codex_Testnet";
+    Blockchain["Edge"] = "Edge";
+    Blockchain["Edge_Testnet"] = "Edge_Testnet";
     Blockchain["Ethereum"] = "Ethereum";
     Blockchain["Ethereum_Sepolia"] = "Ethereum_Sepolia";
     Blockchain["Hedera"] = "Hedera";
@@ -64,6 +66,8 @@ var Blockchain;
     Blockchain["Linea_Sepolia"] = "Linea_Sepolia";
     Blockchain["Monad"] = "Monad";
     Blockchain["Monad_Testnet"] = "Monad_Testnet";
+    Blockchain["Morph"] = "Morph";
+    Blockchain["Morph_Testnet"] = "Morph_Testnet";
     Blockchain["NEAR"] = "NEAR";
     Blockchain["NEAR_Testnet"] = "NEAR_Testnet";
     Blockchain["Noble"] = "Noble";
@@ -267,11 +271,13 @@ var BridgeChain;
     BridgeChain["Avalanche"] = "Avalanche";
     BridgeChain["Base"] = "Base";
     BridgeChain["Codex"] = "Codex";
+    BridgeChain["Edge"] = "Edge";
     BridgeChain["Ethereum"] = "Ethereum";
     BridgeChain["HyperEVM"] = "HyperEVM";
     BridgeChain["Ink"] = "Ink";
     BridgeChain["Linea"] = "Linea";
     BridgeChain["Monad"] = "Monad";
+    BridgeChain["Morph"] = "Morph";
     BridgeChain["Optimism"] = "Optimism";
     BridgeChain["Plume"] = "Plume";
     BridgeChain["Polygon"] = "Polygon";
@@ -287,11 +293,13 @@ var BridgeChain;
     BridgeChain["Avalanche_Fuji"] = "Avalanche_Fuji";
     BridgeChain["Base_Sepolia"] = "Base_Sepolia";
     BridgeChain["Codex_Testnet"] = "Codex_Testnet";
+    BridgeChain["Edge_Testnet"] = "Edge_Testnet";
     BridgeChain["Ethereum_Sepolia"] = "Ethereum_Sepolia";
     BridgeChain["HyperEVM_Testnet"] = "HyperEVM_Testnet";
     BridgeChain["Ink_Testnet"] = "Ink_Testnet";
     BridgeChain["Linea_Sepolia"] = "Linea_Sepolia";
     BridgeChain["Monad_Testnet"] = "Monad_Testnet";
+    BridgeChain["Morph_Testnet"] = "Morph_Testnet";
     BridgeChain["Optimism_Sepolia"] = "Optimism_Sepolia";
     BridgeChain["Plume_Testnet"] = "Plume_Testnet";
     BridgeChain["Polygon_Amoy_Testnet"] = "Polygon_Amoy_Testnet";
@@ -1088,6 +1096,94 @@ const CodexTestnet = defineChain({
     },
 });
 
+/**
+ * Edge Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Edge blockchain.
+ * Edge is an EVM-compatible blockchain.
+ */
+defineChain({
+    type: 'evm',
+    chain: Blockchain.Edge,
+    name: 'Edge',
+    title: 'Edge Mainnet',
+    nativeCurrency: {
+        name: 'Ether',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    chainId: 3343,
+    isTestnet: false,
+    explorerUrl: 'https://pro.edgex.exchange/en-US/explorer/tx/{hash}',
+    rpcEndpoints: ['https://edge-mainnet.g.alchemy.com/public'],
+    eurcAddress: null,
+    usdcAddress: '0x98d2919b9A214E6Fa5384AC81E6864bA686Ad74c',
+    usdtAddress: null,
+    cctp: {
+        domain: 28,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x98706A006bc632Df31CAdFCBD43F38887ce2ca5c',
+                messageTransmitter: '0x5b61381Fc9e58E70EfC13a4A97516997019198ee',
+                confirmations: 65,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
+    },
+    kitContracts: {
+        bridge: '0x6D1AaE1c34Aeb582022916a67f2A655C6f4eDFF2', //Unique bridge address as CCTP address for Edge is also unique
+    },
+});
+
+/**
+ * Edge Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Edge blockchain.
+ * Edge is an EVM-compatible blockchain.
+ */
+defineChain({
+    type: 'evm',
+    chain: Blockchain.Edge_Testnet,
+    name: 'Edge Testnet',
+    title: 'Edge Testnet',
+    nativeCurrency: {
+        name: 'Ether',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    chainId: 33431,
+    isTestnet: true,
+    explorerUrl: 'https://edge-testnet.explorer.alchemy.com/tx/{hash}',
+    rpcEndpoints: ['https://edge-testnet.g.alchemy.com/public'],
+    eurcAddress: null,
+    usdcAddress: '0x2d9F7CAD728051AA35Ecdc472a14cf8cDF5CFD6B',
+    usdtAddress: null,
+    cctp: {
+        domain: 28,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
+                confirmations: 65,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_TESTNET,
+    },
+});
+
 /**
  * Ethereum Mainnet chain definition
  * @remarks
@@ -1599,6 +1695,94 @@ defineChain({
     },
 });
 
+/**
+ * Morph Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Morph blockchain.
+ * Morph is an EVM-compatible Layer-2 blockchain built on the OP Stack.
+ */
+defineChain({
+    type: 'evm',
+    chain: Blockchain.Morph,
+    name: 'Morph',
+    title: 'Morph Mainnet',
+    nativeCurrency: {
+        name: 'Ether',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    chainId: 2818,
+    isTestnet: false,
+    explorerUrl: 'https://explorer.morph.network/tx/{hash}',
+    rpcEndpoints: ['https://rpc.morphl2.io'],
+    eurcAddress: null,
+    usdcAddress: '0xCfb1186F4e93D60E60a8bDd997427D1F33bc372B',
+    usdtAddress: null,
+    cctp: {
+        domain: 30,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+                confirmations: 64,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+    },
+});
+
+/**
+ * Morph Hoodi Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Morph blockchain.
+ * Morph is an EVM-compatible Layer-2 blockchain built on the OP Stack.
+ */
+defineChain({
+    type: 'evm',
+    chain: Blockchain.Morph_Testnet,
+    name: 'Morph Hoodi',
+    title: 'Morph Hoodi Testnet',
+    nativeCurrency: {
+        name: 'Ether',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    chainId: 2910,
+    isTestnet: true,
+    explorerUrl: 'https://explorer-hoodi.morphl2.io/tx/{hash}',
+    rpcEndpoints: ['https://rpc-hoodi.morphl2.io'],
+    eurcAddress: null,
+    usdcAddress: '0x7433b41C6c5e1d58D4Da99483609520255ab661B',
+    usdtAddress: null,
+    cctp: {
+        domain: 30,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
+                confirmations: 64,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_TESTNET,
+    },
+});
+
 /**
  * NEAR Protocol Mainnet chain definition
  * @remarks

package/chains.d.ts

@@ -44,6 +44,8 @@ declare enum Blockchain {
     Celo_Alfajores_Testnet = "Celo_Alfajores_Testnet",
     Codex = "Codex",
     Codex_Testnet = "Codex_Testnet",
+    Edge = "Edge",
+    Edge_Testnet = "Edge_Testnet",
     Ethereum = "Ethereum",
     Ethereum_Sepolia = "Ethereum_Sepolia",
     Hedera = "Hedera",
@@ -56,6 +58,8 @@ declare enum Blockchain {
     Linea_Sepolia = "Linea_Sepolia",
     Monad = "Monad",
     Monad_Testnet = "Monad_Testnet",
+    Morph = "Morph",
+    Morph_Testnet = "Morph_Testnet",
     NEAR = "NEAR",
     NEAR_Testnet = "NEAR_Testnet",
     Noble = "Noble",

package/chains.mjs

@@ -50,6 +50,8 @@ var Blockchain;
     Blockchain["Celo_Alfajores_Testnet"] = "Celo_Alfajores_Testnet";
     Blockchain["Codex"] = "Codex";
     Blockchain["Codex_Testnet"] = "Codex_Testnet";
+    Blockchain["Edge"] = "Edge";
+    Blockchain["Edge_Testnet"] = "Edge_Testnet";
     Blockchain["Ethereum"] = "Ethereum";
     Blockchain["Ethereum_Sepolia"] = "Ethereum_Sepolia";
     Blockchain["Hedera"] = "Hedera";
@@ -62,6 +64,8 @@ var Blockchain;
     Blockchain["Linea_Sepolia"] = "Linea_Sepolia";
     Blockchain["Monad"] = "Monad";
     Blockchain["Monad_Testnet"] = "Monad_Testnet";
+    Blockchain["Morph"] = "Morph";
+    Blockchain["Morph_Testnet"] = "Morph_Testnet";
     Blockchain["NEAR"] = "NEAR";
     Blockchain["NEAR_Testnet"] = "NEAR_Testnet";
     Blockchain["Noble"] = "Noble";
@@ -265,11 +269,13 @@ var BridgeChain;
     BridgeChain["Avalanche"] = "Avalanche";
     BridgeChain["Base"] = "Base";
     BridgeChain["Codex"] = "Codex";
+    BridgeChain["Edge"] = "Edge";
     BridgeChain["Ethereum"] = "Ethereum";
     BridgeChain["HyperEVM"] = "HyperEVM";
     BridgeChain["Ink"] = "Ink";
     BridgeChain["Linea"] = "Linea";
     BridgeChain["Monad"] = "Monad";
+    BridgeChain["Morph"] = "Morph";
     BridgeChain["Optimism"] = "Optimism";
     BridgeChain["Plume"] = "Plume";
     BridgeChain["Polygon"] = "Polygon";
@@ -285,11 +291,13 @@ var BridgeChain;
     BridgeChain["Avalanche_Fuji"] = "Avalanche_Fuji";
     BridgeChain["Base_Sepolia"] = "Base_Sepolia";
     BridgeChain["Codex_Testnet"] = "Codex_Testnet";
+    BridgeChain["Edge_Testnet"] = "Edge_Testnet";
     BridgeChain["Ethereum_Sepolia"] = "Ethereum_Sepolia";
     BridgeChain["HyperEVM_Testnet"] = "HyperEVM_Testnet";
     BridgeChain["Ink_Testnet"] = "Ink_Testnet";
     BridgeChain["Linea_Sepolia"] = "Linea_Sepolia";
     BridgeChain["Monad_Testnet"] = "Monad_Testnet";
+    BridgeChain["Morph_Testnet"] = "Morph_Testnet";
     BridgeChain["Optimism_Sepolia"] = "Optimism_Sepolia";
     BridgeChain["Plume_Testnet"] = "Plume_Testnet";
     BridgeChain["Polygon_Amoy_Testnet"] = "Polygon_Amoy_Testnet";
@@ -1086,6 +1094,94 @@ const CodexTestnet = defineChain({
     },
 });
 
+/**
+ * Edge Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Edge blockchain.
+ * Edge is an EVM-compatible blockchain.
+ */
+defineChain({
+    type: 'evm',
+    chain: Blockchain.Edge,
+    name: 'Edge',
+    title: 'Edge Mainnet',
+    nativeCurrency: {
+        name: 'Ether',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    chainId: 3343,
+    isTestnet: false,
+    explorerUrl: 'https://pro.edgex.exchange/en-US/explorer/tx/{hash}',
+    rpcEndpoints: ['https://edge-mainnet.g.alchemy.com/public'],
+    eurcAddress: null,
+    usdcAddress: '0x98d2919b9A214E6Fa5384AC81E6864bA686Ad74c',
+    usdtAddress: null,
+    cctp: {
+        domain: 28,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x98706A006bc632Df31CAdFCBD43F38887ce2ca5c',
+                messageTransmitter: '0x5b61381Fc9e58E70EfC13a4A97516997019198ee',
+                confirmations: 65,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
+    },
+    kitContracts: {
+        bridge: '0x6D1AaE1c34Aeb582022916a67f2A655C6f4eDFF2', //Unique bridge address as CCTP address for Edge is also unique
+    },
+});
+
+/**
+ * Edge Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Edge blockchain.
+ * Edge is an EVM-compatible blockchain.
+ */
+defineChain({
+    type: 'evm',
+    chain: Blockchain.Edge_Testnet,
+    name: 'Edge Testnet',
+    title: 'Edge Testnet',
+    nativeCurrency: {
+        name: 'Ether',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    chainId: 33431,
+    isTestnet: true,
+    explorerUrl: 'https://edge-testnet.explorer.alchemy.com/tx/{hash}',
+    rpcEndpoints: ['https://edge-testnet.g.alchemy.com/public'],
+    eurcAddress: null,
+    usdcAddress: '0x2d9F7CAD728051AA35Ecdc472a14cf8cDF5CFD6B',
+    usdtAddress: null,
+    cctp: {
+        domain: 28,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
+                confirmations: 65,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: true,
+            destination: true,
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_TESTNET,
+    },
+});
+
 /**
  * Ethereum Mainnet chain definition
  * @remarks
@@ -1597,6 +1693,94 @@ defineChain({
     },
 });
 
+/**
+ * Morph Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Morph blockchain.
+ * Morph is an EVM-compatible Layer-2 blockchain built on the OP Stack.
+ */
+defineChain({
+    type: 'evm',
+    chain: Blockchain.Morph,
+    name: 'Morph',
+    title: 'Morph Mainnet',
+    nativeCurrency: {
+        name: 'Ether',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    chainId: 2818,
+    isTestnet: false,
+    explorerUrl: 'https://explorer.morph.network/tx/{hash}',
+    rpcEndpoints: ['https://rpc.morphl2.io'],
+    eurcAddress: null,
+    usdcAddress: '0xCfb1186F4e93D60E60a8bDd997427D1F33bc372B',
+    usdtAddress: null,
+    cctp: {
+        domain: 30,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+                confirmations: 64,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+    },
+});
+
+/**
+ * Morph Hoodi Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Morph blockchain.
+ * Morph is an EVM-compatible Layer-2 blockchain built on the OP Stack.
+ */
+defineChain({
+    type: 'evm',
+    chain: Blockchain.Morph_Testnet,
+    name: 'Morph Hoodi',
+    title: 'Morph Hoodi Testnet',
+    nativeCurrency: {
+        name: 'Ether',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    chainId: 2910,
+    isTestnet: true,
+    explorerUrl: 'https://explorer-hoodi.morphl2.io/tx/{hash}',
+    rpcEndpoints: ['https://rpc-hoodi.morphl2.io'],
+    eurcAddress: null,
+    usdcAddress: '0x7433b41C6c5e1d58D4Da99483609520255ab661B',
+    usdtAddress: null,
+    cctp: {
+        domain: 30,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
+                confirmations: 64,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_TESTNET,
+    },
+});
+
 /**
  * NEAR Protocol Mainnet chain definition
  * @remarks