@circle-fin/adapter-ethers-v6 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @circle-fin/adapter-ethers-v6
 
+## 1.4.0
+
+### Minor Changes
+
+- Monad chain support added
+
+  Monad mainnet and testnet are now supported for cross-chain USDC transfers. Use `'Monad'` or `'Monad_Testnet'` as chain identifiers in your bridge operations.
+
 ## 1.3.0
 
 ### Minor Changes

package/index.cjs

@@ -85,6 +85,8 @@ const ERROR_TYPES = {
     RPC: 'RPC',
     /** Internet connectivity, DNS resolution, connection issues */
     NETWORK: 'NETWORK',
+    /** Catch-all for unrecognized errors (code 0) */
+    UNKNOWN: 'UNKNOWN',
 };
 /**
  * Array of valid error type values for validation.
@@ -98,6 +100,8 @@ const ERROR_TYPE_ARRAY = [...ERROR_TYPE_VALUES];
 /**
  * Error code ranges for validation.
  * Single source of truth for valid error code ranges.
+ *
+ * Note: Code 0 is special - it's the UNKNOWN catch-all error.
  */
 const ERROR_CODE_RANGES = [
     { min: 1000, max: 1999, type: 'INPUT' },
@@ -106,6 +110,8 @@ const ERROR_CODE_RANGES = [
     { min: 5000, max: 5999, type: 'ONCHAIN' },
     { min: 9000, max: 9999, type: 'BALANCE' },
 ];
+/** Special code for UNKNOWN errors */
+const UNKNOWN_ERROR_CODE = 0;
 /**
  * Zod schema for validating ErrorDetails objects.
  *
@@ -144,6 +150,7 @@ const ERROR_CODE_RANGES = [
 const errorDetailsSchema = zod.z.object({
     /**
      * Numeric identifier following standardized ranges:
+     * - 0: UNKNOWN - Catch-all for unrecognized errors
      * - 1000-1999: INPUT errors - Parameter validation
      * - 3000-3999: NETWORK errors - Connectivity issues
      * - 4000-4999: RPC errors - Provider issues, gas estimation
@@ -153,8 +160,9 @@ const errorDetailsSchema = zod.z.object({
     code: zod.z
         .number()
         .int('Error code must be an integer')
-        .refine((code) => ERROR_CODE_RANGES.some((range) => code >= range.min && code <= range.max), {
-        message: 'Error code must be in valid ranges: 1000-1999 (INPUT), 3000-3999 (NETWORK), 4000-4999 (RPC), 5000-5999 (ONCHAIN), 9000-9999 (BALANCE)',
+        .refine((code) => code === UNKNOWN_ERROR_CODE ||
+        ERROR_CODE_RANGES.some((range) => code >= range.min && code <= range.max), {
+        message: 'Error code must be 0 (UNKNOWN) or in valid ranges: 1000-1999 (INPUT), 3000-3999 (NETWORK), 4000-4999 (RPC), 5000-5999 (ONCHAIN), 9000-9999 (BALANCE)',
     }),
     /** Human-readable ID (e.g., "INPUT_NETWORK_MISMATCH", "BALANCE_INSUFFICIENT_TOKEN") */
     name: zod.z
@@ -164,7 +172,7 @@ const errorDetailsSchema = zod.z.object({
     /** Error category indicating where the error originated */
     type: zod.z.enum(ERROR_TYPE_ARRAY, {
         errorMap: () => ({
-            message: 'Error type must be one of: INPUT, BALANCE, ONCHAIN, RPC, NETWORK',
+            message: 'Error type must be one of: INPUT, BALANCE, ONCHAIN, RPC, NETWORK, UNKNOWN',
         }),
     }),
     /** Error handling strategy */
@@ -347,6 +355,7 @@ class KitError extends Error {
 /**
  * Standardized error code ranges for consistent categorization:
  *
+ * - 0: UNKNOWN - Catch-all for unrecognized errors
  * - 1000-1999: INPUT errors - Parameter validation, input format errors
  * - 3000-3999: NETWORK errors - Internet connectivity, DNS, connection issues
  * - 4000-4999: RPC errors - Blockchain provider issues, gas estimation, nonce errors
@@ -1168,6 +1177,8 @@ exports.Blockchain = void 0;
     Blockchain["Ink_Testnet"] = "Ink_Testnet";
     Blockchain["Linea"] = "Linea";
     Blockchain["Linea_Sepolia"] = "Linea_Sepolia";
+    Blockchain["Monad"] = "Monad";
+    Blockchain["Monad_Testnet"] = "Monad_Testnet";
     Blockchain["NEAR"] = "NEAR";
     Blockchain["NEAR_Testnet"] = "NEAR_Testnet";
     Blockchain["Noble"] = "Noble";
@@ -1259,6 +1270,7 @@ var BridgeChain;
     BridgeChain["HyperEVM"] = "HyperEVM";
     BridgeChain["Ink"] = "Ink";
     BridgeChain["Linea"] = "Linea";
+    BridgeChain["Monad"] = "Monad";
     BridgeChain["Optimism"] = "Optimism";
     BridgeChain["Plume"] = "Plume";
     BridgeChain["Polygon"] = "Polygon";
@@ -1278,6 +1290,7 @@ var BridgeChain;
     BridgeChain["HyperEVM_Testnet"] = "HyperEVM_Testnet";
     BridgeChain["Ink_Testnet"] = "Ink_Testnet";
     BridgeChain["Linea_Sepolia"] = "Linea_Sepolia";
+    BridgeChain["Monad_Testnet"] = "Monad_Testnet";
     BridgeChain["Optimism_Sepolia"] = "Optimism_Sepolia";
     BridgeChain["Plume_Testnet"] = "Plume_Testnet";
     BridgeChain["Polygon_Amoy_Testnet"] = "Polygon_Amoy_Testnet";
@@ -2264,6 +2277,86 @@ const LineaSepolia = defineChain({
     },
 });
 
+/**
+ * Monad Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Monad blockchain.
+ * Monad is a high-performance EVM-compatible Layer-1 blockchain featuring
+ * over 10,000 TPS, sub-second finality, and near-zero gas fees.
+ */
+const Monad = defineChain({
+    type: 'evm',
+    chain: exports.Blockchain.Monad,
+    name: 'Monad',
+    title: 'Monad Mainnet',
+    nativeCurrency: {
+        name: 'Monad',
+        symbol: 'MON',
+        decimals: 18,
+    },
+    chainId: 143,
+    isTestnet: false,
+    explorerUrl: 'https://monadscan.com/tx/{hash}',
+    rpcEndpoints: ['https://rpc.monad.xyz'],
+    eurcAddress: null,
+    usdcAddress: '0x754704Bc059F8C67012fEd69BC8A327a5aafb603',
+    cctp: {
+        domain: 15,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+                confirmations: 1,
+                fastConfirmations: 1,
+            },
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+    },
+});
+
+/**
+ * Monad Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Monad blockchain.
+ * Monad is a high-performance EVM-compatible Layer-1 blockchain featuring
+ * over 10,000 TPS, sub-second finality, and near-zero gas fees.
+ */
+const MonadTestnet = defineChain({
+    type: 'evm',
+    chain: exports.Blockchain.Monad_Testnet,
+    name: 'Monad Testnet',
+    title: 'Monad Testnet',
+    nativeCurrency: {
+        name: 'Monad',
+        symbol: 'MON',
+        decimals: 18,
+    },
+    chainId: 10143,
+    isTestnet: true,
+    explorerUrl: 'https://testnet.monadscan.com/tx/{hash}',
+    rpcEndpoints: ['https://testnet-rpc.monad.xyz'],
+    eurcAddress: null,
+    usdcAddress: '0x534b2f3A21130d7a60830c2Df862319e593943A3',
+    cctp: {
+        domain: 15,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
+                confirmations: 1,
+                fastConfirmations: 1,
+            },
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_TESTNET,
+    },
+});
+
 /**
  * NEAR Protocol Mainnet chain definition
  * @remarks
@@ -3348,6 +3441,8 @@ var Blockchains = {
     InkTestnet: InkTestnet,
     Linea: Linea,
     LineaSepolia: LineaSepolia,
+    Monad: Monad,
+    MonadTestnet: MonadTestnet,
     NEAR: NEAR,
     NEARTestnet: NEARTestnet,
     Noble: Noble,
@@ -11943,7 +12038,7 @@ const createAdapterFromPrivateKey = createEthersAdapterFromPrivateKey;
  * const adapter = await createEthersAdapterFromProvider({
  *   provider: window.ethereum,
  *   getProvider: ({ chain }) => new JsonRpcProvider(
- *     `https://eth-mainnet.alchemyapi.io/v2/${process.env.ALCHEMY_KEY}`,
+ *     `https://eth-mainnet.g.alchemy.com/v2/${process.env.ALCHEMY_KEY}`,
  *     { name: chain.name, chainId: chain.chainId }
  *   )
  * })
@@ -12113,7 +12208,7 @@ const createEthersAdapterFromProvider = async (params) => {
  * const adapter = await createAdapterFromProvider({
  *   provider: window.ethereum,
  *   getProvider: ({ chain }) => new JsonRpcProvider(
- *     `https://eth-mainnet.alchemyapi.io/v2/${process.env.ALCHEMY_KEY}`,
+ *     `https://eth-mainnet.g.alchemy.com/v2/${process.env.ALCHEMY_KEY}`,
  *     { name: chain.name, chainId: chain.chainId }
  *   )
  * })

package/index.d.ts

@@ -437,6 +437,8 @@ declare enum Blockchain {
     Ink_Testnet = "Ink_Testnet",
     Linea = "Linea",
     Linea_Sepolia = "Linea_Sepolia",
+    Monad = "Monad",
+    Monad_Testnet = "Monad_Testnet",
     NEAR = "NEAR",
     NEAR_Testnet = "NEAR_Testnet",
     Noble = "Noble",
@@ -3792,7 +3794,7 @@ type CreateAdapterFromProviderParams = CreateEthersAdapterFromProviderParams;
  * const adapter = await createEthersAdapterFromProvider({
  *   provider: window.ethereum,
  *   getProvider: ({ chain }) => new JsonRpcProvider(
- *     `https://eth-mainnet.alchemyapi.io/v2/${process.env.ALCHEMY_KEY}`,
+ *     `https://eth-mainnet.g.alchemy.com/v2/${process.env.ALCHEMY_KEY}`,
  *     { name: chain.name, chainId: chain.chainId }
  *   )
  * })
@@ -3934,7 +3936,7 @@ declare const createEthersAdapterFromProvider: (params: CreateEthersAdapterFromP
  * const adapter = await createAdapterFromProvider({
  *   provider: window.ethereum,
  *   getProvider: ({ chain }) => new JsonRpcProvider(
- *     `https://eth-mainnet.alchemyapi.io/v2/${process.env.ALCHEMY_KEY}`,
+ *     `https://eth-mainnet.g.alchemy.com/v2/${process.env.ALCHEMY_KEY}`,
  *     { name: chain.name, chainId: chain.chainId }
  *   )
  * })

package/index.mjs

@@ -80,6 +80,8 @@ const ERROR_TYPES = {
     RPC: 'RPC',
     /** Internet connectivity, DNS resolution, connection issues */
     NETWORK: 'NETWORK',
+    /** Catch-all for unrecognized errors (code 0) */
+    UNKNOWN: 'UNKNOWN',
 };
 /**
  * Array of valid error type values for validation.
@@ -93,6 +95,8 @@ const ERROR_TYPE_ARRAY = [...ERROR_TYPE_VALUES];
 /**
  * Error code ranges for validation.
  * Single source of truth for valid error code ranges.
+ *
+ * Note: Code 0 is special - it's the UNKNOWN catch-all error.
  */
 const ERROR_CODE_RANGES = [
     { min: 1000, max: 1999, type: 'INPUT' },
@@ -101,6 +105,8 @@ const ERROR_CODE_RANGES = [
     { min: 5000, max: 5999, type: 'ONCHAIN' },
     { min: 9000, max: 9999, type: 'BALANCE' },
 ];
+/** Special code for UNKNOWN errors */
+const UNKNOWN_ERROR_CODE = 0;
 /**
  * Zod schema for validating ErrorDetails objects.
  *
@@ -139,6 +145,7 @@ const ERROR_CODE_RANGES = [
 const errorDetailsSchema = z.object({
     /**
      * Numeric identifier following standardized ranges:
+     * - 0: UNKNOWN - Catch-all for unrecognized errors
      * - 1000-1999: INPUT errors - Parameter validation
      * - 3000-3999: NETWORK errors - Connectivity issues
      * - 4000-4999: RPC errors - Provider issues, gas estimation
@@ -148,8 +155,9 @@ const errorDetailsSchema = z.object({
     code: z
         .number()
         .int('Error code must be an integer')
-        .refine((code) => ERROR_CODE_RANGES.some((range) => code >= range.min && code <= range.max), {
-        message: 'Error code must be in valid ranges: 1000-1999 (INPUT), 3000-3999 (NETWORK), 4000-4999 (RPC), 5000-5999 (ONCHAIN), 9000-9999 (BALANCE)',
+        .refine((code) => code === UNKNOWN_ERROR_CODE ||
+        ERROR_CODE_RANGES.some((range) => code >= range.min && code <= range.max), {
+        message: 'Error code must be 0 (UNKNOWN) or in valid ranges: 1000-1999 (INPUT), 3000-3999 (NETWORK), 4000-4999 (RPC), 5000-5999 (ONCHAIN), 9000-9999 (BALANCE)',
     }),
     /** Human-readable ID (e.g., "INPUT_NETWORK_MISMATCH", "BALANCE_INSUFFICIENT_TOKEN") */
     name: z
@@ -159,7 +167,7 @@ const errorDetailsSchema = z.object({
     /** Error category indicating where the error originated */
     type: z.enum(ERROR_TYPE_ARRAY, {
         errorMap: () => ({
-            message: 'Error type must be one of: INPUT, BALANCE, ONCHAIN, RPC, NETWORK',
+            message: 'Error type must be one of: INPUT, BALANCE, ONCHAIN, RPC, NETWORK, UNKNOWN',
         }),
     }),
     /** Error handling strategy */
@@ -342,6 +350,7 @@ class KitError extends Error {
 /**
  * Standardized error code ranges for consistent categorization:
  *
+ * - 0: UNKNOWN - Catch-all for unrecognized errors
  * - 1000-1999: INPUT errors - Parameter validation, input format errors
  * - 3000-3999: NETWORK errors - Internet connectivity, DNS, connection issues
  * - 4000-4999: RPC errors - Blockchain provider issues, gas estimation, nonce errors
@@ -1163,6 +1172,8 @@ var Blockchain;
     Blockchain["Ink_Testnet"] = "Ink_Testnet";
     Blockchain["Linea"] = "Linea";
     Blockchain["Linea_Sepolia"] = "Linea_Sepolia";
+    Blockchain["Monad"] = "Monad";
+    Blockchain["Monad_Testnet"] = "Monad_Testnet";
     Blockchain["NEAR"] = "NEAR";
     Blockchain["NEAR_Testnet"] = "NEAR_Testnet";
     Blockchain["Noble"] = "Noble";
@@ -1254,6 +1265,7 @@ var BridgeChain;
     BridgeChain["HyperEVM"] = "HyperEVM";
     BridgeChain["Ink"] = "Ink";
     BridgeChain["Linea"] = "Linea";
+    BridgeChain["Monad"] = "Monad";
     BridgeChain["Optimism"] = "Optimism";
     BridgeChain["Plume"] = "Plume";
     BridgeChain["Polygon"] = "Polygon";
@@ -1273,6 +1285,7 @@ var BridgeChain;
     BridgeChain["HyperEVM_Testnet"] = "HyperEVM_Testnet";
     BridgeChain["Ink_Testnet"] = "Ink_Testnet";
     BridgeChain["Linea_Sepolia"] = "Linea_Sepolia";
+    BridgeChain["Monad_Testnet"] = "Monad_Testnet";
     BridgeChain["Optimism_Sepolia"] = "Optimism_Sepolia";
     BridgeChain["Plume_Testnet"] = "Plume_Testnet";
     BridgeChain["Polygon_Amoy_Testnet"] = "Polygon_Amoy_Testnet";
@@ -2259,6 +2272,86 @@ const LineaSepolia = defineChain({
     },
 });
 
+/**
+ * Monad Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Monad blockchain.
+ * Monad is a high-performance EVM-compatible Layer-1 blockchain featuring
+ * over 10,000 TPS, sub-second finality, and near-zero gas fees.
+ */
+const Monad = defineChain({
+    type: 'evm',
+    chain: Blockchain.Monad,
+    name: 'Monad',
+    title: 'Monad Mainnet',
+    nativeCurrency: {
+        name: 'Monad',
+        symbol: 'MON',
+        decimals: 18,
+    },
+    chainId: 143,
+    isTestnet: false,
+    explorerUrl: 'https://monadscan.com/tx/{hash}',
+    rpcEndpoints: ['https://rpc.monad.xyz'],
+    eurcAddress: null,
+    usdcAddress: '0x754704Bc059F8C67012fEd69BC8A327a5aafb603',
+    cctp: {
+        domain: 15,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+                confirmations: 1,
+                fastConfirmations: 1,
+            },
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+    },
+});
+
+/**
+ * Monad Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Monad blockchain.
+ * Monad is a high-performance EVM-compatible Layer-1 blockchain featuring
+ * over 10,000 TPS, sub-second finality, and near-zero gas fees.
+ */
+const MonadTestnet = defineChain({
+    type: 'evm',
+    chain: Blockchain.Monad_Testnet,
+    name: 'Monad Testnet',
+    title: 'Monad Testnet',
+    nativeCurrency: {
+        name: 'Monad',
+        symbol: 'MON',
+        decimals: 18,
+    },
+    chainId: 10143,
+    isTestnet: true,
+    explorerUrl: 'https://testnet.monadscan.com/tx/{hash}',
+    rpcEndpoints: ['https://testnet-rpc.monad.xyz'],
+    eurcAddress: null,
+    usdcAddress: '0x534b2f3A21130d7a60830c2Df862319e593943A3',
+    cctp: {
+        domain: 15,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
+                confirmations: 1,
+                fastConfirmations: 1,
+            },
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_TESTNET,
+    },
+});
+
 /**
  * NEAR Protocol Mainnet chain definition
  * @remarks
@@ -3343,6 +3436,8 @@ var Blockchains = /*#__PURE__*/Object.freeze({
     InkTestnet: InkTestnet,
     Linea: Linea,
     LineaSepolia: LineaSepolia,
+    Monad: Monad,
+    MonadTestnet: MonadTestnet,
     NEAR: NEAR,
     NEARTestnet: NEARTestnet,
     Noble: Noble,
@@ -11938,7 +12033,7 @@ const createAdapterFromPrivateKey = createEthersAdapterFromPrivateKey;
  * const adapter = await createEthersAdapterFromProvider({
  *   provider: window.ethereum,
  *   getProvider: ({ chain }) => new JsonRpcProvider(
- *     `https://eth-mainnet.alchemyapi.io/v2/${process.env.ALCHEMY_KEY}`,
+ *     `https://eth-mainnet.g.alchemy.com/v2/${process.env.ALCHEMY_KEY}`,
  *     { name: chain.name, chainId: chain.chainId }
  *   )
  * })
@@ -12108,7 +12203,7 @@ const createEthersAdapterFromProvider = async (params) => {
  * const adapter = await createAdapterFromProvider({
  *   provider: window.ethereum,
  *   getProvider: ({ chain }) => new JsonRpcProvider(
- *     `https://eth-mainnet.alchemyapi.io/v2/${process.env.ALCHEMY_KEY}`,
+ *     `https://eth-mainnet.g.alchemy.com/v2/${process.env.ALCHEMY_KEY}`,
  *     { name: chain.name, chainId: chain.chainId }
  *   )
  * })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circle-fin/adapter-ethers-v6",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "EVM blockchain adapter powered by Ethers v6",
   "keywords": [
     "circle",