@circle-fin/bridge-kit 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @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

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
   ]),

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

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";
@@ -1158,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
@@ -2419,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",
@@ -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";
@@ -1156,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
@@ -2400,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

package/index.cjs

@@ -122,6 +122,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.
@@ -135,6 +137,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' },
@@ -143,6 +147,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.
  *
@@ -181,6 +187,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
@@ -190,8 +197,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
@@ -201,7 +209,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 */
@@ -418,6 +426,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
@@ -966,6 +975,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";
@@ -1057,6 +1068,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";
@@ -1076,6 +1088,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";
@@ -2062,6 +2075,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
@@ -3146,6 +3239,8 @@ var Blockchains = {
     InkTestnet: InkTestnet,
     Linea: Linea,
     LineaSepolia: LineaSepolia,
+    Monad: Monad,
+    MonadTestnet: MonadTestnet,
     NEAR: NEAR,
     NEARTestnet: NEARTestnet,
     Noble: Noble,
@@ -3557,14 +3652,41 @@ function isFatalError(error) {
     return isKitError(error) && error.recoverability === 'FATAL';
 }
 /**
- * Checks if an error is a KitError with RETRYABLE recoverability.
+ * Error codes that are considered retryable by default.
+ *
+ * @remarks
+ * These are typically transient errors that may succeed on retry:
+ * - Network connectivity issues (3001, 3002)
+ * - Provider unavailability (4001, 4002)
+ * - RPC nonce errors (4003)
+ */
+const DEFAULT_RETRYABLE_ERROR_CODES = [
+    // Network errors
+    3001, // NETWORK_CONNECTION_FAILED
+    3002, // NETWORK_TIMEOUT
+    // Provider errors
+    4001, // PROVIDER_UNAVAILABLE
+    4002, // PROVIDER_TIMEOUT
+    4003, // RPC_NONCE_ERROR
+];
+/**
+ * Checks if an error is retryable.
+ *
+ * @remarks
+ * Check order for KitError instances:
+ * 1. If `recoverability === 'RETRYABLE'`, return `true` immediately (priority check).
+ * 2. Otherwise, check if `error.code` is in `DEFAULT_RETRYABLE_ERROR_CODES` (fallback check).
+ * 3. Non-KitError instances always return `false`.
+ *
+ * This two-tier approach allows both explicit recoverability control and
+ * backward-compatible code-based retry logic.
  *
  * RETRYABLE errors indicate transient failures that may succeed on
  * subsequent attempts, such as network timeouts or temporary service
  * unavailability. These errors are safe to retry after a delay.
  *
  * @param error - Unknown error to check
- * @returns True if error is a KitError with RETRYABLE recoverability
+ * @returns True if error is retryable
  *
  * @example
  * ```typescript
@@ -3579,9 +3701,51 @@ function isFatalError(error) {
  *   }
  * }
  * ```
+ *
+ * @example
+ * ```typescript
+ * import { isRetryableError, createNetworkConnectionError, KitError } from '@core/errors'
+ *
+ * // KitError with RETRYABLE recoverability (priority check)
+ * const error1 = createNetworkConnectionError('Ethereum')
+ * isRetryableError(error1) // true
+ *
+ * // KitError with default retryable code (fallback check)
+ * const error2 = new KitError({
+ *   code: 3002, // NETWORK_TIMEOUT - in DEFAULT_RETRYABLE_ERROR_CODES
+ *   name: 'NETWORK_TIMEOUT',
+ *   type: 'NETWORK',
+ *   recoverability: 'FATAL', // Not RETRYABLE
+ *   message: 'Timeout',
+ * })
+ * isRetryableError(error2) // true (code 3002 is in default list)
+ *
+ * // KitError with non-retryable code and FATAL recoverability
+ * const error3 = new KitError({
+ *   code: 1001,
+ *   name: 'INVALID_INPUT',
+ *   type: 'INPUT',
+ *   recoverability: 'FATAL',
+ *   message: 'Invalid input',
+ * })
+ * isRetryableError(error3) // false
+ *
+ * // Non-KitError
+ * const error4 = new Error('Standard error')
+ * isRetryableError(error4) // false
+ * ```
  */
 function isRetryableError(error) {
-    return isKitError(error) && error.recoverability === 'RETRYABLE';
+    // Use proper type guard to check if it's a KitError
+    if (isKitError(error)) {
+        // Priority check: explicit recoverability
+        if (error.recoverability === 'RETRYABLE') {
+            return true;
+        }
+        // Fallback check: error code against default retryable codes
+        return DEFAULT_RETRYABLE_ERROR_CODES.includes(error.code);
+    }
+    return false;
 }
 /**
  * Type guard to check if error is KitError with INPUT type.
@@ -4639,7 +4803,7 @@ const parseAmount = (params) => {
 };
 
 var name = "@circle-fin/bridge-kit";
-var version = "1.4.0";
+var version = "1.5.0";
 var pkg = {
 	name: name,
 	version: version};

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",
@@ -523,6 +525,7 @@ declare enum BridgeChain {
     HyperEVM = "HyperEVM",
     Ink = "Ink",
     Linea = "Linea",
+    Monad = "Monad",
     Optimism = "Optimism",
     Plume = "Plume",
     Polygon = "Polygon",
@@ -541,6 +544,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",
@@ -1491,6 +1495,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";
+    };
+};
+
 /**
  * NEAR Protocol Mainnet chain definition
  * @remarks
@@ -2570,6 +2654,8 @@ declare const Chains_Ink: typeof Ink;
 declare const Chains_InkTestnet: typeof InkTestnet;
 declare const Chains_Linea: typeof Linea;
 declare const Chains_LineaSepolia: typeof LineaSepolia;
+declare const Chains_Monad: typeof Monad;
+declare const Chains_MonadTestnet: typeof MonadTestnet;
 declare const Chains_NEAR: typeof NEAR;
 declare const Chains_NEARTestnet: typeof NEARTestnet;
 declare const Chains_Noble: typeof Noble;
@@ -2627,6 +2713,8 @@ declare namespace Chains {
     Chains_InkTestnet as InkTestnet,
     Chains_Linea as Linea,
     Chains_LineaSepolia as LineaSepolia,
+    Chains_Monad as Monad,
+    Chains_MonadTestnet as MonadTestnet,
     Chains_NEAR as NEAR,
     Chains_NEARTestnet as NEARTestnet,
     Chains_Noble as Noble,
@@ -6598,7 +6686,7 @@ type Recoverability = (typeof RECOVERABILITY_VALUES)[number];
  * Array of valid error type values for validation.
  * Derived from ERROR_TYPES const object.
  */
-declare const ERROR_TYPE_VALUES: ("INPUT" | "BALANCE" | "ONCHAIN" | "RPC" | "NETWORK")[];
+declare const ERROR_TYPE_VALUES: ("INPUT" | "BALANCE" | "ONCHAIN" | "RPC" | "NETWORK" | "UNKNOWN")[];
 /**
  * Error type indicating the category of the error.
  */
@@ -6725,6 +6813,7 @@ declare class KitError extends Error implements ErrorDetails {
 /**
  * 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
@@ -7008,14 +7097,23 @@ declare function isKitError(error: unknown): error is KitError;
  */
 declare function isFatalError(error: unknown): boolean;
 /**
- * Checks if an error is a KitError with RETRYABLE recoverability.
+ * Checks if an error is retryable.
+ *
+ * @remarks
+ * Check order for KitError instances:
+ * 1. If `recoverability === 'RETRYABLE'`, return `true` immediately (priority check).
+ * 2. Otherwise, check if `error.code` is in `DEFAULT_RETRYABLE_ERROR_CODES` (fallback check).
+ * 3. Non-KitError instances always return `false`.
+ *
+ * This two-tier approach allows both explicit recoverability control and
+ * backward-compatible code-based retry logic.
  *
  * RETRYABLE errors indicate transient failures that may succeed on
  * subsequent attempts, such as network timeouts or temporary service
  * unavailability. These errors are safe to retry after a delay.
  *
  * @param error - Unknown error to check
- * @returns True if error is a KitError with RETRYABLE recoverability
+ * @returns True if error is retryable
  *
  * @example
  * ```typescript
@@ -7030,6 +7128,39 @@ declare function isFatalError(error: unknown): boolean;
  *   }
  * }
  * ```
+ *
+ * @example
+ * ```typescript
+ * import { isRetryableError, createNetworkConnectionError, KitError } from '@core/errors'
+ *
+ * // KitError with RETRYABLE recoverability (priority check)
+ * const error1 = createNetworkConnectionError('Ethereum')
+ * isRetryableError(error1) // true
+ *
+ * // KitError with default retryable code (fallback check)
+ * const error2 = new KitError({
+ *   code: 3002, // NETWORK_TIMEOUT - in DEFAULT_RETRYABLE_ERROR_CODES
+ *   name: 'NETWORK_TIMEOUT',
+ *   type: 'NETWORK',
+ *   recoverability: 'FATAL', // Not RETRYABLE
+ *   message: 'Timeout',
+ * })
+ * isRetryableError(error2) // true (code 3002 is in default list)
+ *
+ * // KitError with non-retryable code and FATAL recoverability
+ * const error3 = new KitError({
+ *   code: 1001,
+ *   name: 'INVALID_INPUT',
+ *   type: 'INPUT',
+ *   recoverability: 'FATAL',
+ *   message: 'Invalid input',
+ * })
+ * isRetryableError(error3) // false
+ *
+ * // Non-KitError
+ * const error4 = new Error('Standard error')
+ * isRetryableError(error4) // false
+ * ```
  */
 declare function isRetryableError(error: unknown): boolean;
 /**

package/index.mjs

@@ -120,6 +120,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.
@@ -133,6 +135,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' },
@@ -141,6 +145,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.
  *
@@ -179,6 +185,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
@@ -188,8 +195,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
@@ -199,7 +207,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 */
@@ -416,6 +424,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
@@ -964,6 +973,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";
@@ -1055,6 +1066,7 @@ var BridgeChain;
     BridgeChain["HyperEVM"] = "HyperEVM";
     BridgeChain["Ink"] = "Ink";
     BridgeChain["Linea"] = "Linea";
+    BridgeChain["Monad"] = "Monad";
     BridgeChain["Optimism"] = "Optimism";
     BridgeChain["Plume"] = "Plume";
     BridgeChain["Polygon"] = "Polygon";
@@ -1074,6 +1086,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";
@@ -2060,6 +2073,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
@@ -3144,6 +3237,8 @@ var Blockchains = /*#__PURE__*/Object.freeze({
     InkTestnet: InkTestnet,
     Linea: Linea,
     LineaSepolia: LineaSepolia,
+    Monad: Monad,
+    MonadTestnet: MonadTestnet,
     NEAR: NEAR,
     NEARTestnet: NEARTestnet,
     Noble: Noble,
@@ -3555,14 +3650,41 @@ function isFatalError(error) {
     return isKitError(error) && error.recoverability === 'FATAL';
 }
 /**
- * Checks if an error is a KitError with RETRYABLE recoverability.
+ * Error codes that are considered retryable by default.
+ *
+ * @remarks
+ * These are typically transient errors that may succeed on retry:
+ * - Network connectivity issues (3001, 3002)
+ * - Provider unavailability (4001, 4002)
+ * - RPC nonce errors (4003)
+ */
+const DEFAULT_RETRYABLE_ERROR_CODES = [
+    // Network errors
+    3001, // NETWORK_CONNECTION_FAILED
+    3002, // NETWORK_TIMEOUT
+    // Provider errors
+    4001, // PROVIDER_UNAVAILABLE
+    4002, // PROVIDER_TIMEOUT
+    4003, // RPC_NONCE_ERROR
+];
+/**
+ * Checks if an error is retryable.
+ *
+ * @remarks
+ * Check order for KitError instances:
+ * 1. If `recoverability === 'RETRYABLE'`, return `true` immediately (priority check).
+ * 2. Otherwise, check if `error.code` is in `DEFAULT_RETRYABLE_ERROR_CODES` (fallback check).
+ * 3. Non-KitError instances always return `false`.
+ *
+ * This two-tier approach allows both explicit recoverability control and
+ * backward-compatible code-based retry logic.
  *
  * RETRYABLE errors indicate transient failures that may succeed on
  * subsequent attempts, such as network timeouts or temporary service
  * unavailability. These errors are safe to retry after a delay.
  *
  * @param error - Unknown error to check
- * @returns True if error is a KitError with RETRYABLE recoverability
+ * @returns True if error is retryable
  *
  * @example
  * ```typescript
@@ -3577,9 +3699,51 @@ function isFatalError(error) {
  *   }
  * }
  * ```
+ *
+ * @example
+ * ```typescript
+ * import { isRetryableError, createNetworkConnectionError, KitError } from '@core/errors'
+ *
+ * // KitError with RETRYABLE recoverability (priority check)
+ * const error1 = createNetworkConnectionError('Ethereum')
+ * isRetryableError(error1) // true
+ *
+ * // KitError with default retryable code (fallback check)
+ * const error2 = new KitError({
+ *   code: 3002, // NETWORK_TIMEOUT - in DEFAULT_RETRYABLE_ERROR_CODES
+ *   name: 'NETWORK_TIMEOUT',
+ *   type: 'NETWORK',
+ *   recoverability: 'FATAL', // Not RETRYABLE
+ *   message: 'Timeout',
+ * })
+ * isRetryableError(error2) // true (code 3002 is in default list)
+ *
+ * // KitError with non-retryable code and FATAL recoverability
+ * const error3 = new KitError({
+ *   code: 1001,
+ *   name: 'INVALID_INPUT',
+ *   type: 'INPUT',
+ *   recoverability: 'FATAL',
+ *   message: 'Invalid input',
+ * })
+ * isRetryableError(error3) // false
+ *
+ * // Non-KitError
+ * const error4 = new Error('Standard error')
+ * isRetryableError(error4) // false
+ * ```
  */
 function isRetryableError(error) {
-    return isKitError(error) && error.recoverability === 'RETRYABLE';
+    // Use proper type guard to check if it's a KitError
+    if (isKitError(error)) {
+        // Priority check: explicit recoverability
+        if (error.recoverability === 'RETRYABLE') {
+            return true;
+        }
+        // Fallback check: error code against default retryable codes
+        return DEFAULT_RETRYABLE_ERROR_CODES.includes(error.code);
+    }
+    return false;
 }
 /**
  * Type guard to check if error is KitError with INPUT type.
@@ -4637,7 +4801,7 @@ const parseAmount = (params) => {
 };
 
 var name = "@circle-fin/bridge-kit";
-var version = "1.4.0";
+var version = "1.5.0";
 var pkg = {
 	name: name,
 	version: version};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circle-fin/bridge-kit",
-  "version": "1.4.0",
+  "version": "1.5.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.2.0",
+    "@circle-fin/provider-cctp-v2": "^1.3.0",
     "abitype": "^1.1.0",
     "@solana/web3.js": "^1.98.4",
     "@ethersproject/address": "^5.8.0",