@circle-fin/bridge-kit 1.3.0 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @circle-fin/bridge-kit
 
+## 1.5.0
+
+### Minor Changes
+
+- **Monad support**: Bridge Kit now supports Monad mainnet and testnet. You can include Monad in cross-chain USDC transfer flows without additional configuration or changes to existing integrations.
+
+- **Automatic re-attestation for fast transfers**: When retrying a failed CCTP v2 fast transfer, the kit now automatically detects if the mint failed due to an expired attestation and triggers re-attestation. This eliminates manual intervention when attestations expire before the mint transaction completes.
+
+## 1.4.0
+
+### Minor Changes
+
+- Add optional filtering to `getSupportedChains()` method to filter chains by type (EVM, Solana) and network (mainnet/testnet)
+
 ## 1.3.0
 
 ### Minor Changes

package/QUICKSTART.md

@@ -273,7 +273,7 @@ const adapter = createViemAdapterFromPrivateKey({
     createPublicClient({
       chain,
       transport: http(
-        `https://eth-mainnet.alchemyapi.io/v2/${process.env.ALCHEMY_KEY}`,
+        `https://eth-mainnet.g.alchemy.com/v2/${process.env.ALCHEMY_KEY}`,
         {
           retryCount: 3,
           timeout: 10000,
@@ -1150,7 +1150,7 @@ import { mainnet } from 'viem/chains'
 const publicClient = createPublicClient({
   chain: mainnet,
   transport: fallback([
-    http('https://eth-mainnet.alchemyapi.io/v2/your-key'),
+    http('https://eth-mainnet.g.alchemy.com/v2/your-key'),
     http('https://mainnet.infura.io/v3/your-key'),
     http(), // Default public RPC as fallback
   ]),
@@ -1421,7 +1421,7 @@ const attestation = await retryWithBackoff(
 
 ## Next Steps
 
-- **Explore Examples**: Check out the [examples directory](https://github.com/circlefin/stablecoin-kits-private/tree/main/examples) for more detailed implementations
+- **Explore Examples**: Check out the [examples directory](https://github.com/crcl-main/stablecoin-kits-private/tree/main/examples) for more detailed implementations
 - **Join the community**: Connect with other developers on [discord](https://discord.com/invite/buildoncircle) building on Circle's stablecoin infrastructure
 
 Ready to start bridging? Let's make cross-chain bridging as easy as a single function call! 🌉

package/README.md

@@ -72,9 +72,9 @@ The Bridge Kit enables cross-chain stablecoin transfers via a type-safe, develop
 - **🔧 Bring your own infrastructure**: Seamlessly integrate with your existing setup when needed
 - **🔒 Production-ready security**: Leverages Circle's CCTPv2 with deterministic quotes and finality tracking
 - **🚀 Developer experience**: Complete TypeScript support, comprehensive validation, and instant connectivity
-- **🌍 Cross-chain bridging**: The Bridge Kit supports **34 chains** with **544 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 (17 chains)**: 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
+- **🌍 Cross-chain bridging**: The Bridge Kit supports **37 chains** with **666 total bridge routes** through Circle's CCTPv2
+  - **Mainnet (18 chains)**: Arbitrum, Avalanche, Base, Codex, Ethereum, HyperEVM, Ink, Linea, Monad, OP Mainnet, Plume, Polygon PoS, Sei, Solana, Sonic, Unichain, World Chain, XDC
+  - **Testnet (19 chains)**: Arc Testnet, Arbitrum Sepolia, Avalanche Fuji, Base Sepolia, Codex Testnet, Ethereum Sepolia, HyperEVM Testnet, Ink Testnet, Linea Sepolia, Monad Testnet, OP Sepolia, Plume Testnet, Polygon PoS Amoy, Sei Testnet, Solana Devnet, Sonic Testnet, Unichain Sepolia, World Chain Sepolia, XDC Apothem
 - **🎯 Flexible adapters**: Supporting EVM (Viem, Ethers) and Solana (@solana/web3)
 - **⚙️ Configurable bridge speeds**: FAST/SLOW options with fee optimization
 - **📡 Real-time event monitoring**: Track progress throughout the transfer lifecycle
@@ -194,26 +194,50 @@ const resultWithDifferentAdapter = await kit.bridge({
 
 **Best for**: Production applications, better reliability, custom configuration
 
+Bridging involves **two chains** (source and destination), and both require properly configured RPC endpoints. Use dynamic RPC mapping by chain ID to support multiple chains in a single adapter:
+
 ```typescript
-import { createPublicClient, http } from 'viem'
+import 'dotenv/config'
+import { BridgeKit } from '@circle-fin/bridge-kit'
+import { Ethereum, Base } from '@circle-fin/bridge-kit/chains'
+import { createViemAdapterFromPrivateKey } from '@circle-fin/adapter-viem-v2'
+import { createPublicClient, http, fallback } from 'viem'
+
+// Define RPCs mapped by chain ID
+const RPC_BY_CHAIN_ID: Record<number, string[]> = {
+  // The array allows providing multiple RPC URLs for fallback, e.g.,
+  // `[ "https://primary-rpc-url.com/...", "https://secondary-rpc-url.com/..." ]`
+  [Ethereum.chainId]: [
+    `https://eth-mainnet.g.alchemy.com/v2/${process.env.ALCHEMY_KEY}`,
+  ],
+  [Base.chainId]: [
+    `https://base-mainnet.g.alchemy.com/v2/${process.env.ALCHEMY_KEY}`,
+  ],
+}
 
-// Production-ready setup with custom RPC endpoints
 const adapter = createViemAdapterFromPrivateKey({
-  privateKey: process.env.PRIVATE_KEY as string,
-  getPublicClient: ({ chain }) =>
-    createPublicClient({
+  privateKey: process.env.PRIVATE_KEY as `0x${string}`,
+  getPublicClient: ({ chain }) => {
+    const rpcUrls = RPC_BY_CHAIN_ID[chain.id]
+    if (!rpcUrls) {
+      throw new Error(`No RPC configured for chainId=${chain.id}`)
+    }
+    return createPublicClient({
       chain,
-      transport: http(
-        `https://eth-mainnet.alchemyapi.io/v2/${process.env.ALCHEMY_KEY}`,
-        {
-          retryCount: 3,
-          timeout: 10000,
-        },
+      transport: fallback(
+        rpcUrls.map((url) =>
+          http(url, {
+            timeout: 10_000,
+            retryCount: 3,
+          }),
+        ),
       ),
-    }),
+    })
+  },
 })
 
-// Same simple usage, but with production-grade RPC
+const kit = new BridgeKit()
+
 const result = await kit.bridge({
   from: { adapter, chain: 'Ethereum' },
   to: { adapter, chain: 'Base' },
@@ -221,13 +245,22 @@ const result = await kit.bridge({
 })
 ```
 
+**Best practices:**
+
+- **Use paid RPC providers** (Alchemy, Infura, QuickNode) for improved reliability
+- **Implement `fallback()` transport** for automatic failover between endpoints
+- **Configure timeout and retry options** to handle network variability
+
 ### 🌐 Browser/Wallet Provider Support
 
 **Best for**: Browser applications, wallet integrations, user-controlled transactions
 
 ```typescript
+import { BridgeKit } from '@circle-fin/bridge-kit'
 import { createViemAdapterFromProvider } from '@circle-fin/adapter-viem-v2'
 
+const kit = new BridgeKit()
+
 // Create adapters from browser wallet providers
 const adapter = await createViemAdapterFromProvider({
   provider: window.ethereum,
@@ -254,10 +287,10 @@ import { privateKeyToAccount } from 'viem/accounts'
 
 const account = privateKeyToAccount(process.env.PRIVATE_KEY as string)
 
-// Chain-specific RPC URLs
-const rpcUrls = {
-  [Ethereum.id]: 'https://eth-mainnet.alchemyapi.io/v2/YOUR_KEY',
-  [Base.id]: 'https://base-mainnet.g.alchemy.com/v2/YOUR_KEY',
+// Chain-specific RPC URLs mapped by chain ID
+const rpcUrls: Record<number, string> = {
+  [Ethereum.chainId]: 'https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY',
+  [Base.chainId]: 'https://base-mainnet.g.alchemy.com/v2/YOUR_KEY',
 }
 
 // Create one multi-chain adapter with chain-specific RPC configuration
@@ -445,8 +478,12 @@ For dynamic fee calculation across all transfers, use kit-level policies:
 
 ```typescript
 import { BridgeKit } from '@circle-fin/bridge-kit'
+import { createViemAdapterFromPrivateKey } from '@circle-fin/adapter-viem-v2'
 
 const kit = new BridgeKit()
+const adapter = createViemAdapterFromPrivateKey({
+  privateKey: process.env.PRIVATE_KEY as `0x${string}`,
+})
 
 kit.setCustomFeePolicy({
   computeFee: (params) => {

package/chains.cjs

@@ -62,6 +62,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";
@@ -153,6 +155,7 @@ exports.BridgeChain = void 0;
     BridgeChain["HyperEVM"] = "HyperEVM";
     BridgeChain["Ink"] = "Ink";
     BridgeChain["Linea"] = "Linea";
+    BridgeChain["Monad"] = "Monad";
     BridgeChain["Optimism"] = "Optimism";
     BridgeChain["Plume"] = "Plume";
     BridgeChain["Polygon"] = "Polygon";
@@ -172,6 +175,7 @@ exports.BridgeChain = void 0;
     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";
@@ -366,8 +370,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,
@@ -1155,6 +1162,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
@@ -2416,6 +2503,8 @@ exports.Ink = Ink;
 exports.InkTestnet = InkTestnet;
 exports.Linea = Linea;
 exports.LineaSepolia = LineaSepolia;
+exports.Monad = Monad;
+exports.MonadTestnet = MonadTestnet;
 exports.Optimism = Optimism;
 exports.OptimismSepolia = OptimismSepolia;
 exports.Plume = Plume;

package/chains.d.ts

@@ -54,6 +54,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",
@@ -140,6 +142,7 @@ declare enum BridgeChain {
     HyperEVM = "HyperEVM",
     Ink = "Ink",
     Linea = "Linea",
+    Monad = "Monad",
     Optimism = "Optimism",
     Plume = "Plume",
     Polygon = "Polygon",
@@ -158,6 +161,7 @@ declare enum BridgeChain {
     HyperEVM_Testnet = "HyperEVM_Testnet",
     Ink_Testnet = "Ink_Testnet",
     Linea_Sepolia = "Linea_Sepolia",
+    Monad_Testnet = "Monad_Testnet",
     Optimism_Sepolia = "Optimism_Sepolia",
     Plume_Testnet = "Plume_Testnet",
     Polygon_Amoy_Testnet = "Polygon_Amoy_Testnet",
@@ -184,8 +188,8 @@ declare const ArcTestnet: {
     readonly name: "Arc Testnet";
     readonly title: "ArcTestnet";
     readonly nativeCurrency: {
-        readonly name: "Arc";
-        readonly symbol: "Arc";
+        readonly name: "USDC";
+        readonly symbol: "USDC";
         readonly decimals: 18;
     };
     readonly chainId: 5042002;
@@ -873,6 +877,86 @@ declare const LineaSepolia: {
     };
 };
 
+/**
+ * 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.
+ */
+declare const Monad: {
+    readonly type: "evm";
+    readonly chain: Blockchain.Monad;
+    readonly name: "Monad";
+    readonly title: "Monad Mainnet";
+    readonly nativeCurrency: {
+        readonly name: "Monad";
+        readonly symbol: "MON";
+        readonly decimals: 18;
+    };
+    readonly chainId: 143;
+    readonly isTestnet: false;
+    readonly explorerUrl: "https://monadscan.com/tx/{hash}";
+    readonly rpcEndpoints: readonly ["https://rpc.monad.xyz"];
+    readonly eurcAddress: null;
+    readonly usdcAddress: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603";
+    readonly cctp: {
+        readonly domain: 15;
+        readonly contracts: {
+            readonly v2: {
+                readonly type: "split";
+                readonly tokenMessenger: "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d";
+                readonly messageTransmitter: "0x81D40F21F12A8F0E3252Bccb954D722d4c464B64";
+                readonly confirmations: 1;
+                readonly fastConfirmations: 1;
+            };
+        };
+    };
+    readonly kitContracts: {
+        readonly bridge: "0xB3FA262d0fB521cc93bE83d87b322b8A23DAf3F0";
+    };
+};
+
+/**
+ * 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.
+ */
+declare const MonadTestnet: {
+    readonly type: "evm";
+    readonly chain: Blockchain.Monad_Testnet;
+    readonly name: "Monad Testnet";
+    readonly title: "Monad Testnet";
+    readonly nativeCurrency: {
+        readonly name: "Monad";
+        readonly symbol: "MON";
+        readonly decimals: 18;
+    };
+    readonly chainId: 10143;
+    readonly isTestnet: true;
+    readonly explorerUrl: "https://testnet.monadscan.com/tx/{hash}";
+    readonly rpcEndpoints: readonly ["https://testnet-rpc.monad.xyz"];
+    readonly eurcAddress: null;
+    readonly usdcAddress: "0x534b2f3A21130d7a60830c2Df862319e593943A3";
+    readonly cctp: {
+        readonly domain: 15;
+        readonly contracts: {
+            readonly v2: {
+                readonly type: "split";
+                readonly tokenMessenger: "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
+                readonly messageTransmitter: "0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275";
+                readonly confirmations: 1;
+                readonly fastConfirmations: 1;
+            };
+        };
+    };
+    readonly kitContracts: {
+        readonly bridge: "0xC5567a5E3370d4DBfB0540025078e283e36A363d";
+    };
+};
+
 /**
  * Optimism Mainnet chain definition
  * @remarks
@@ -1611,4 +1695,4 @@ declare const XDCApothem: {
     };
 };
 
-export { Arbitrum, ArbitrumSepolia, ArcTestnet, Avalanche, AvalancheFuji, Base, BaseSepolia, BridgeChain, Codex, CodexTestnet, Ethereum, EthereumSepolia, HyperEVM, HyperEVMTestnet, Ink, InkTestnet, Linea, LineaSepolia, Optimism, OptimismSepolia, Plume, PlumeTestnet, Polygon, PolygonAmoy, Sei, SeiTestnet, Solana, SolanaDevnet, Sonic, SonicTestnet, Unichain, UnichainSepolia, WorldChain, WorldChainSepolia, XDC, XDCApothem };
+export { Arbitrum, ArbitrumSepolia, ArcTestnet, Avalanche, AvalancheFuji, Base, BaseSepolia, BridgeChain, Codex, CodexTestnet, Ethereum, EthereumSepolia, HyperEVM, HyperEVMTestnet, Ink, InkTestnet, Linea, LineaSepolia, Monad, MonadTestnet, Optimism, OptimismSepolia, Plume, PlumeTestnet, Polygon, PolygonAmoy, Sei, SeiTestnet, Solana, SolanaDevnet, Sonic, SonicTestnet, Unichain, UnichainSepolia, WorldChain, WorldChainSepolia, XDC, XDCApothem };

package/chains.mjs

@@ -60,6 +60,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";
@@ -151,6 +153,7 @@ var BridgeChain;
     BridgeChain["HyperEVM"] = "HyperEVM";
     BridgeChain["Ink"] = "Ink";
     BridgeChain["Linea"] = "Linea";
+    BridgeChain["Monad"] = "Monad";
     BridgeChain["Optimism"] = "Optimism";
     BridgeChain["Plume"] = "Plume";
     BridgeChain["Polygon"] = "Polygon";
@@ -170,6 +173,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";
@@ -364,8 +368,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,
@@ -1153,6 +1160,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
@@ -2397,5 +2484,5 @@ z.union([
     })),
 ]);
 
-export { Arbitrum, ArbitrumSepolia, ArcTestnet, Avalanche, AvalancheFuji, Base, BaseSepolia, BridgeChain, Codex, CodexTestnet, Ethereum, EthereumSepolia, HyperEVM, HyperEVMTestnet, Ink, InkTestnet, Linea, LineaSepolia, Optimism, OptimismSepolia, Plume, PlumeTestnet, Polygon, PolygonAmoy, Sei, SeiTestnet, Solana, SolanaDevnet, Sonic, SonicTestnet, Unichain, UnichainSepolia, WorldChain, WorldChainSepolia, XDC, XDCApothem };
+export { Arbitrum, ArbitrumSepolia, ArcTestnet, Avalanche, AvalancheFuji, Base, BaseSepolia, BridgeChain, Codex, CodexTestnet, Ethereum, EthereumSepolia, HyperEVM, HyperEVMTestnet, Ink, InkTestnet, Linea, LineaSepolia, Monad, MonadTestnet, Optimism, OptimismSepolia, Plume, PlumeTestnet, Polygon, PolygonAmoy, Sei, SeiTestnet, Solana, SolanaDevnet, Sonic, SonicTestnet, Unichain, UnichainSepolia, WorldChain, WorldChainSepolia, XDC, XDCApothem };
 //# sourceMappingURL=chains.mjs.map