@circle-fin/bridge-kit 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/chains.cjs.js ADDED
@@ -0,0 +1,2250 @@
1
+ /**
2
+ * Copyright (c) 2025, Circle Internet Group, Inc. All rights reserved.
3
+ *
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ *
6
+ * Licensed under the Apache License, Version 2.0 (the "License");
7
+ * you may not use this file except in compliance with the License.
8
+ * You may obtain a copy of the License at
9
+ *
10
+ * http://www.apache.org/licenses/LICENSE-2.0
11
+ *
12
+ * Unless required by applicable law or agreed to in writing, software
13
+ * distributed under the License is distributed on an "AS IS" BASIS,
14
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
+ * See the License for the specific language governing permissions and
16
+ * limitations under the License.
17
+ */
18
+
19
+ 'use strict';
20
+
21
+ var zod = require('zod');
22
+
23
+ // -----------------------------------------------------------------------------
24
+ // Blockchain Enum
25
+ // -----------------------------------------------------------------------------
26
+ /**
27
+ * Enumeration of all blockchains supported by this library.
28
+ * @enum
29
+ * @category Enums
30
+ * @description Provides string identifiers for each supported blockchain.
31
+ */
32
+ var Blockchain;
33
+ (function (Blockchain) {
34
+ Blockchain["Algorand"] = "Algorand";
35
+ Blockchain["Algorand_Testnet"] = "Algorand_Testnet";
36
+ Blockchain["Aptos"] = "Aptos";
37
+ Blockchain["Aptos_Testnet"] = "Aptos_Testnet";
38
+ Blockchain["Arbitrum"] = "Arbitrum";
39
+ Blockchain["Arbitrum_Sepolia"] = "Arbitrum_Sepolia";
40
+ Blockchain["Avalanche"] = "Avalanche";
41
+ Blockchain["Avalanche_Fuji"] = "Avalanche_Fuji";
42
+ Blockchain["Base"] = "Base";
43
+ Blockchain["Base_Sepolia"] = "Base_Sepolia";
44
+ Blockchain["Celo"] = "Celo";
45
+ Blockchain["Celo_Alfajores_Testnet"] = "Celo_Alfajores_Testnet";
46
+ Blockchain["Codex"] = "Codex";
47
+ Blockchain["Codex_Testnet"] = "Codex_Testnet";
48
+ Blockchain["Ethereum"] = "Ethereum";
49
+ Blockchain["Ethereum_Sepolia"] = "Ethereum_Sepolia";
50
+ Blockchain["Hedera"] = "Hedera";
51
+ Blockchain["Hedera_Testnet"] = "Hedera_Testnet";
52
+ Blockchain["HyperEVM"] = "HyperEVM";
53
+ Blockchain["HyperEVM_Testnet"] = "HyperEVM_Testnet";
54
+ Blockchain["Ink"] = "Ink";
55
+ Blockchain["Ink_Testnet"] = "Ink_Testnet";
56
+ Blockchain["Linea"] = "Linea";
57
+ Blockchain["Linea_Sepolia"] = "Linea_Sepolia";
58
+ Blockchain["NEAR"] = "NEAR";
59
+ Blockchain["NEAR_Testnet"] = "NEAR_Testnet";
60
+ Blockchain["Noble"] = "Noble";
61
+ Blockchain["Noble_Testnet"] = "Noble_Testnet";
62
+ Blockchain["Optimism"] = "Optimism";
63
+ Blockchain["Optimism_Sepolia"] = "Optimism_Sepolia";
64
+ Blockchain["Polkadot_Asset_Hub"] = "Polkadot_Asset_Hub";
65
+ Blockchain["Polkadot_Westmint"] = "Polkadot_Westmint";
66
+ Blockchain["Plume"] = "Plume";
67
+ Blockchain["Plume_Testnet"] = "Plume_Testnet";
68
+ Blockchain["Polygon"] = "Polygon";
69
+ Blockchain["Polygon_Amoy_Testnet"] = "Polygon_Amoy_Testnet";
70
+ Blockchain["Sei"] = "Sei";
71
+ Blockchain["Sei_Testnet"] = "Sei_Testnet";
72
+ Blockchain["Solana"] = "Solana";
73
+ Blockchain["Solana_Devnet"] = "Solana_Devnet";
74
+ Blockchain["Sonic"] = "Sonic";
75
+ Blockchain["Sonic_Testnet"] = "Sonic_Testnet";
76
+ Blockchain["Stellar"] = "Stellar";
77
+ Blockchain["Stellar_Testnet"] = "Stellar_Testnet";
78
+ Blockchain["Sui"] = "Sui";
79
+ Blockchain["Sui_Testnet"] = "Sui_Testnet";
80
+ Blockchain["Unichain"] = "Unichain";
81
+ Blockchain["Unichain_Sepolia"] = "Unichain_Sepolia";
82
+ Blockchain["World_Chain"] = "World_Chain";
83
+ Blockchain["World_Chain_Sepolia"] = "World_Chain_Sepolia";
84
+ Blockchain["XDC"] = "XDC";
85
+ Blockchain["XDC_Apothem"] = "XDC_Apothem";
86
+ Blockchain["ZKSync_Era"] = "ZKSync_Era";
87
+ Blockchain["ZKSync_Sepolia"] = "ZKSync_Sepolia";
88
+ })(Blockchain || (Blockchain = {}));
89
+
90
+ /**
91
+ * Helper function to define a chain with proper TypeScript typing.
92
+ *
93
+ * This utility function works with TypeScript's `as const` assertion to create
94
+ * strongly-typed, immutable chain definition objects. It preserves literal types
95
+ * from the input and ensures the resulting object maintains all type information.
96
+ *
97
+ * When used with `as const`, it allows TypeScript to infer the most specific
98
+ * possible types for all properties, including string literals and numeric literals,
99
+ * rather than widening them to general types like string or number.
100
+ * @typeParam T - The specific chain definition type (must extend ChainDefinition)
101
+ * @param chain - The chain definition object, typically with an `as const` assertion
102
+ * @returns The same chain definition with preserved literal types
103
+ * @example
104
+ * ```typescript
105
+ * // Define an EVM chain with literal types preserved
106
+ * const Ethereum = defineChain({
107
+ * type: 'evm',
108
+ * chain: Blockchain.Ethereum,
109
+ * chainId: 1,
110
+ * name: 'Ethereum',
111
+ * nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
112
+ * isTestnet: false,
113
+ * usdcAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
114
+ * eurcAddress: null,
115
+ * cctp: {
116
+ * domain: 0,
117
+ * contracts: {
118
+ * TokenMessengerV1: '0xbd3fa81b58ba92a82136038b25adec7066af3155',
119
+ * MessageTransmitterV1: '0x0a992d191deec32afe36203ad87d7d289a738f81'
120
+ * }
121
+ * }
122
+ * } as const);
123
+ * ```
124
+ */
125
+ function defineChain(chain) {
126
+ return chain;
127
+ }
128
+
129
+ /**
130
+ * Algorand Mainnet chain definition
131
+ * @remarks
132
+ * This represents the official production network for the Algorand blockchain.
133
+ */
134
+ defineChain({
135
+ type: 'algorand',
136
+ chain: Blockchain.Algorand,
137
+ name: 'Algorand',
138
+ title: 'Algorand Mainnet',
139
+ nativeCurrency: {
140
+ name: 'Algo',
141
+ symbol: 'ALGO',
142
+ decimals: 6,
143
+ },
144
+ isTestnet: false,
145
+ explorerUrl: 'https://explorer.perawallet.app/tx/{hash}',
146
+ rpcEndpoints: ['https://mainnet-api.algonode.cloud'],
147
+ eurcAddress: null,
148
+ usdcAddress: '31566704',
149
+ cctp: null,
150
+ });
151
+
152
+ /**
153
+ * Algorand Testnet chain definition
154
+ * @remarks
155
+ * This represents the official testnet for the Algorand blockchain.
156
+ */
157
+ defineChain({
158
+ type: 'algorand',
159
+ chain: Blockchain.Algorand_Testnet,
160
+ name: 'Algorand Testnet',
161
+ title: 'Algorand Test Network',
162
+ nativeCurrency: {
163
+ name: 'Algo',
164
+ symbol: 'ALGO',
165
+ decimals: 6,
166
+ },
167
+ isTestnet: true,
168
+ explorerUrl: 'https://testnet.explorer.perawallet.app/tx/{hash}',
169
+ rpcEndpoints: ['https://testnet-api.algonode.cloud'],
170
+ eurcAddress: null,
171
+ usdcAddress: '10458941',
172
+ cctp: null,
173
+ });
174
+
175
+ /**
176
+ * Aptos Mainnet chain definition
177
+ * @remarks
178
+ * This represents the official production network for the Aptos blockchain.
179
+ */
180
+ defineChain({
181
+ type: 'aptos',
182
+ chain: Blockchain.Aptos,
183
+ name: 'Aptos',
184
+ title: 'Aptos Mainnet',
185
+ nativeCurrency: {
186
+ name: 'Aptos',
187
+ symbol: 'APT',
188
+ decimals: 8,
189
+ },
190
+ isTestnet: false,
191
+ explorerUrl: 'https://explorer.aptoslabs.com/txn/{hash}?network=mainnet',
192
+ rpcEndpoints: ['https://fullnode.mainnet.aptoslabs.com/v1'],
193
+ eurcAddress: null,
194
+ usdcAddress: '0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b',
195
+ cctp: {
196
+ domain: 9,
197
+ contracts: {
198
+ v1: {
199
+ type: 'split',
200
+ tokenMessenger: '0x9bce6734f7b63e835108e3bd8c36743d4709fe435f44791918801d0989640a9d',
201
+ messageTransmitter: '0x177e17751820e4b4371873ca8c30279be63bdea63b88ed0f2239c2eea10f1772',
202
+ confirmations: 1,
203
+ },
204
+ },
205
+ },
206
+ });
207
+
208
+ /**
209
+ * Aptos Testnet chain definition
210
+ * @remarks
211
+ * This represents the official test network for the Aptos blockchain.
212
+ */
213
+ defineChain({
214
+ type: 'aptos',
215
+ chain: Blockchain.Aptos_Testnet,
216
+ name: 'Aptos Testnet',
217
+ title: 'Aptos Test Network',
218
+ nativeCurrency: {
219
+ name: 'Aptos',
220
+ symbol: 'APT',
221
+ decimals: 8,
222
+ },
223
+ isTestnet: true,
224
+ explorerUrl: 'https://explorer.aptoslabs.com/txn/{hash}?network=testnet',
225
+ rpcEndpoints: ['https://fullnode.testnet.aptoslabs.com/v1'],
226
+ eurcAddress: null,
227
+ usdcAddress: '0x69091fbab5f7d635ee7ac5098cf0c1efbe31d68fec0f2cd565e8d168daf52832',
228
+ cctp: {
229
+ domain: 9,
230
+ contracts: {
231
+ v1: {
232
+ type: 'split',
233
+ tokenMessenger: '0x5f9b937419dda90aa06c1836b7847f65bbbe3f1217567758dc2488be31a477b9',
234
+ messageTransmitter: '0x081e86cebf457a0c6004f35bd648a2794698f52e0dde09a48619dcd3d4cc23d9',
235
+ confirmations: 1,
236
+ },
237
+ },
238
+ },
239
+ });
240
+
241
+ /**
242
+ * The bridge contract address for EVM testnet networks.
243
+ *
244
+ * This contract handles USDC transfers on testnet environments across
245
+ * EVM-compatible chains. Use this address when deploying or testing
246
+ * cross-chain USDC transfers on test networks.
247
+ */
248
+ const BRIDGE_CONTRACT_EVM_TESTNET = '0xC5567a5E3370d4DBfB0540025078e283e36A363d';
249
+ /**
250
+ * The bridge contract address for EVM mainnet networks.
251
+ *
252
+ * This contract handles USDC transfers on mainnet environments across
253
+ * EVM-compatible chains. Use this address for production cross-chain
254
+ * USDC transfers on live networks.
255
+ */
256
+ const BRIDGE_CONTRACT_EVM_MAINNET = '0xB3FA262d0fB521cc93bE83d87b322b8A23DAf3F0';
257
+
258
+ /**
259
+ * Arbitrum Mainnet chain definition
260
+ * @remarks
261
+ * This represents the official production network for the Arbitrum blockchain.
262
+ */
263
+ const Arbitrum = defineChain({
264
+ type: 'evm',
265
+ chain: Blockchain.Arbitrum,
266
+ name: 'Arbitrum',
267
+ title: 'Arbitrum Mainnet',
268
+ nativeCurrency: {
269
+ name: 'Ether',
270
+ symbol: 'ETH',
271
+ decimals: 18,
272
+ },
273
+ chainId: 42161,
274
+ isTestnet: false,
275
+ explorerUrl: 'https://arbiscan.io/tx/{hash}',
276
+ rpcEndpoints: ['https://arb1.arbitrum.io/rpc'],
277
+ eurcAddress: null,
278
+ usdcAddress: '0xaf88d065e77c8cc2239327c5edb3a432268e5831',
279
+ cctp: {
280
+ domain: 3,
281
+ contracts: {
282
+ v1: {
283
+ type: 'split',
284
+ tokenMessenger: '0x19330d10D9Cc8751218eaf51E8885D058642E08A',
285
+ messageTransmitter: '0xC30362313FBBA5cf9163F0bb16a0e01f01A896ca',
286
+ confirmations: 65,
287
+ },
288
+ v2: {
289
+ type: 'split',
290
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
291
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
292
+ confirmations: 65,
293
+ fastConfirmations: 1,
294
+ },
295
+ },
296
+ },
297
+ kitContracts: {
298
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
299
+ },
300
+ });
301
+
302
+ /**
303
+ * Arbitrum Sepolia Testnet chain definition
304
+ * @remarks
305
+ * This represents the official test network for the Arbitrum blockchain on Sepolia.
306
+ */
307
+ const ArbitrumSepolia = defineChain({
308
+ type: 'evm',
309
+ chain: Blockchain.Arbitrum_Sepolia,
310
+ name: 'Arbitrum Sepolia',
311
+ title: 'Arbitrum Sepolia Testnet',
312
+ nativeCurrency: {
313
+ name: 'Sepolia Ether',
314
+ symbol: 'ETH',
315
+ decimals: 18,
316
+ },
317
+ chainId: 421614,
318
+ isTestnet: true,
319
+ explorerUrl: 'https://sepolia.arbiscan.io/tx/{hash}',
320
+ rpcEndpoints: ['https://sepolia-rollup.arbitrum.io/rpc'],
321
+ eurcAddress: null,
322
+ usdcAddress: '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d',
323
+ cctp: {
324
+ domain: 3,
325
+ contracts: {
326
+ v1: {
327
+ type: 'split',
328
+ tokenMessenger: '0x9f3B8679c73C2Fef8b59B4f3444d4e156fb70AA5',
329
+ messageTransmitter: '0xaCF1ceeF35caAc005e15888dDb8A3515C41B4872',
330
+ confirmations: 65,
331
+ },
332
+ v2: {
333
+ type: 'split',
334
+ tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
335
+ messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
336
+ confirmations: 65,
337
+ fastConfirmations: 1,
338
+ },
339
+ },
340
+ },
341
+ kitContracts: {
342
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
343
+ },
344
+ });
345
+
346
+ /**
347
+ * Avalanche Mainnet chain definition
348
+ * @remarks
349
+ * This represents the official production network for the Avalanche blockchain.
350
+ */
351
+ const Avalanche = defineChain({
352
+ type: 'evm',
353
+ chain: Blockchain.Avalanche,
354
+ name: 'Avalanche',
355
+ title: 'Avalanche Mainnet',
356
+ nativeCurrency: {
357
+ name: 'Avalanche',
358
+ symbol: 'AVAX',
359
+ decimals: 18,
360
+ },
361
+ chainId: 43114,
362
+ isTestnet: false,
363
+ explorerUrl: 'https://subnets.avax.network/c-chain/tx/{hash}',
364
+ rpcEndpoints: ['https://api.avax.network/ext/bc/C/rpc'],
365
+ eurcAddress: '0xc891eb4cbdeff6e073e859e987815ed1505c2acd',
366
+ usdcAddress: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',
367
+ cctp: {
368
+ domain: 1,
369
+ contracts: {
370
+ v1: {
371
+ type: 'split',
372
+ tokenMessenger: '0x6b25532e1060ce10cc3b0a99e5683b91bfde6982',
373
+ messageTransmitter: '0x8186359af5f57fbb40c6b14a588d2a59c0c29880',
374
+ confirmations: 1,
375
+ },
376
+ v2: {
377
+ type: 'split',
378
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
379
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
380
+ confirmations: 1,
381
+ fastConfirmations: 1,
382
+ },
383
+ },
384
+ },
385
+ kitContracts: {
386
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
387
+ },
388
+ });
389
+
390
+ /**
391
+ * Avalanche Fuji Testnet chain definition
392
+ * @remarks
393
+ * This represents the official test network for the Avalanche blockchain.
394
+ */
395
+ const AvalancheFuji = defineChain({
396
+ type: 'evm',
397
+ chain: Blockchain.Avalanche_Fuji,
398
+ name: 'Avalanche Fuji',
399
+ title: 'Avalanche Fuji Testnet',
400
+ nativeCurrency: {
401
+ name: 'Avalanche',
402
+ symbol: 'AVAX',
403
+ decimals: 18,
404
+ },
405
+ chainId: 43113,
406
+ isTestnet: true,
407
+ explorerUrl: 'https://subnets-test.avax.network/c-chain/tx/{hash}',
408
+ eurcAddress: '0x5e44db7996c682e92a960b65ac713a54ad815c6b',
409
+ usdcAddress: '0x5425890298aed601595a70ab815c96711a31bc65',
410
+ cctp: {
411
+ domain: 1,
412
+ contracts: {
413
+ v1: {
414
+ type: 'split',
415
+ tokenMessenger: '0xeb08f243e5d3fcff26a9e38ae5520a669f4019d0',
416
+ messageTransmitter: '0xa9fb1b3009dcb79e2fe346c16a604b8fa8ae0a79',
417
+ confirmations: 1,
418
+ },
419
+ v2: {
420
+ type: 'split',
421
+ tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
422
+ messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
423
+ confirmations: 1,
424
+ fastConfirmations: 1,
425
+ },
426
+ },
427
+ },
428
+ rpcEndpoints: ['https://api.avax-test.network/ext/bc/C/rpc'],
429
+ kitContracts: {
430
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
431
+ },
432
+ });
433
+
434
+ /**
435
+ * Base chain definition
436
+ * @remarks
437
+ * This represents the official production network for the Base blockchain.
438
+ */
439
+ const Base = defineChain({
440
+ type: 'evm',
441
+ chain: Blockchain.Base,
442
+ name: 'Base',
443
+ title: 'Base Mainnet',
444
+ nativeCurrency: {
445
+ name: 'Ether',
446
+ symbol: 'ETH',
447
+ decimals: 18,
448
+ },
449
+ chainId: 8453,
450
+ isTestnet: false,
451
+ explorerUrl: 'https://basescan.org/tx/{hash}',
452
+ rpcEndpoints: ['https://mainnet.base.org', 'https://base.publicnode.com'],
453
+ eurcAddress: '0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42',
454
+ usdcAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
455
+ cctp: {
456
+ domain: 6,
457
+ contracts: {
458
+ v1: {
459
+ type: 'split',
460
+ tokenMessenger: '0x1682Ae6375C4E4A97e4B583BC394c861A46D8962',
461
+ messageTransmitter: '0xAD09780d193884d503182aD4588450C416D6F9D4',
462
+ confirmations: 65,
463
+ },
464
+ v2: {
465
+ type: 'split',
466
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
467
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
468
+ confirmations: 65,
469
+ fastConfirmations: 1,
470
+ },
471
+ },
472
+ },
473
+ kitContracts: {
474
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
475
+ },
476
+ });
477
+
478
+ /**
479
+ * Base Sepolia Testnet chain definition
480
+ * @remarks
481
+ * This represents the official test network for the Base blockchain on Sepolia.
482
+ */
483
+ const BaseSepolia = defineChain({
484
+ type: 'evm',
485
+ chain: Blockchain.Base_Sepolia,
486
+ name: 'Base Sepolia',
487
+ title: 'Base Sepolia Testnet',
488
+ nativeCurrency: {
489
+ name: 'Sepolia Ether',
490
+ symbol: 'ETH',
491
+ decimals: 18,
492
+ },
493
+ chainId: 84532,
494
+ isTestnet: true,
495
+ explorerUrl: 'https://sepolia.basescan.org/tx/{hash}',
496
+ rpcEndpoints: ['https://sepolia.base.org'],
497
+ eurcAddress: '0x808456652fdb597867f38412077A9182bf77359F',
498
+ usdcAddress: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
499
+ cctp: {
500
+ domain: 6,
501
+ contracts: {
502
+ v1: {
503
+ type: 'split',
504
+ tokenMessenger: '0x9f3B8679c73C2Fef8b59B4f3444d4e156fb70AA5',
505
+ messageTransmitter: '0x7865fAfC2db2093669d92c0F33AeEF291086BEFD',
506
+ confirmations: 65,
507
+ },
508
+ v2: {
509
+ type: 'split',
510
+ tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
511
+ messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
512
+ confirmations: 65,
513
+ fastConfirmations: 1,
514
+ },
515
+ },
516
+ },
517
+ kitContracts: {
518
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
519
+ },
520
+ });
521
+
522
+ /**
523
+ * Celo Mainnet chain definition
524
+ * @remarks
525
+ * This represents the official production network for the Celo blockchain.
526
+ */
527
+ defineChain({
528
+ type: 'evm',
529
+ chain: Blockchain.Celo,
530
+ name: 'Celo',
531
+ title: 'Celo Mainnet',
532
+ nativeCurrency: {
533
+ name: 'Celo',
534
+ symbol: 'CELO',
535
+ decimals: 18,
536
+ },
537
+ chainId: 42220,
538
+ isTestnet: false,
539
+ explorerUrl: 'https://celoscan.io/tx/{hash}',
540
+ rpcEndpoints: ['https://forno.celo.org'],
541
+ eurcAddress: null,
542
+ usdcAddress: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
543
+ cctp: null,
544
+ });
545
+
546
+ /**
547
+ * Celo Alfajores Testnet chain definition
548
+ * @remarks
549
+ * This represents the official test network for the Celo blockchain.
550
+ */
551
+ defineChain({
552
+ type: 'evm',
553
+ chain: Blockchain.Celo_Alfajores_Testnet,
554
+ name: 'Celo Alfajores',
555
+ title: 'Celo Alfajores Testnet',
556
+ nativeCurrency: {
557
+ name: 'Celo',
558
+ symbol: 'CELO',
559
+ decimals: 18,
560
+ },
561
+ chainId: 44787,
562
+ isTestnet: true,
563
+ explorerUrl: 'https://alfajores.celoscan.io/tx/{hash}',
564
+ rpcEndpoints: ['https://alfajores-forno.celo-testnet.org'],
565
+ eurcAddress: null,
566
+ usdcAddress: '0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B',
567
+ cctp: null,
568
+ });
569
+
570
+ /**
571
+ * Codex Mainnet chain definition
572
+ * @remarks
573
+ * This represents the main network for the Codex blockchain.
574
+ */
575
+ const Codex = defineChain({
576
+ type: 'evm',
577
+ chain: Blockchain.Codex,
578
+ name: 'Codex Mainnet',
579
+ title: 'Codex Mainnet',
580
+ nativeCurrency: {
581
+ name: 'ETH',
582
+ symbol: 'ETH',
583
+ decimals: 18,
584
+ },
585
+ chainId: 81224,
586
+ isTestnet: false,
587
+ explorerUrl: 'https://explorer.codex.xyz/tx/{hash}',
588
+ rpcEndpoints: ['https://rpc.codex.xyz'],
589
+ eurcAddress: null,
590
+ usdcAddress: '0xd996633a415985DBd7D6D12f4A4343E31f5037cf',
591
+ cctp: {
592
+ domain: 12,
593
+ contracts: {
594
+ v2: {
595
+ type: 'split',
596
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
597
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
598
+ confirmations: 65,
599
+ fastConfirmations: 1,
600
+ },
601
+ },
602
+ },
603
+ kitContracts: {
604
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
605
+ },
606
+ });
607
+
608
+ /**
609
+ * Codex Testnet chain definition
610
+ * @remarks
611
+ * This represents the test network for the Codex blockchain.
612
+ */
613
+ const CodexTestnet = defineChain({
614
+ type: 'evm',
615
+ chain: Blockchain.Codex_Testnet,
616
+ name: 'Codex Testnet',
617
+ title: 'Codex Testnet',
618
+ nativeCurrency: {
619
+ name: 'ETH',
620
+ symbol: 'ETH',
621
+ decimals: 18,
622
+ },
623
+ chainId: 812242,
624
+ isTestnet: true,
625
+ explorerUrl: 'https://explorer.codex-stg.xyz/tx/{hash}',
626
+ rpcEndpoints: ['https://rpc.codex-stg.xyz'],
627
+ eurcAddress: null,
628
+ usdcAddress: '0x6d7f141b6819C2c9CC2f818e6ad549E7Ca090F8f',
629
+ cctp: {
630
+ domain: 12,
631
+ contracts: {
632
+ v2: {
633
+ type: 'split',
634
+ tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
635
+ messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
636
+ confirmations: 65,
637
+ fastConfirmations: 1,
638
+ },
639
+ },
640
+ },
641
+ kitContracts: {
642
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
643
+ },
644
+ });
645
+
646
+ /**
647
+ * Ethereum Mainnet chain definition
648
+ * @remarks
649
+ * This represents the official production network for the Ethereum blockchain.
650
+ */
651
+ const Ethereum = defineChain({
652
+ type: 'evm',
653
+ chain: Blockchain.Ethereum,
654
+ name: 'Ethereum',
655
+ title: 'Ethereum Mainnet',
656
+ nativeCurrency: {
657
+ name: 'Ether',
658
+ symbol: 'ETH',
659
+ decimals: 18,
660
+ },
661
+ chainId: 1,
662
+ isTestnet: false,
663
+ explorerUrl: 'https://etherscan.io/tx/{hash}',
664
+ rpcEndpoints: ['https://eth.merkle.io', 'https://ethereum.publicnode.com'],
665
+ eurcAddress: '0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c',
666
+ usdcAddress: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
667
+ cctp: {
668
+ domain: 0,
669
+ contracts: {
670
+ v1: {
671
+ type: 'split',
672
+ tokenMessenger: '0xbd3fa81b58ba92a82136038b25adec7066af3155',
673
+ messageTransmitter: '0x0a992d191deec32afe36203ad87d7d289a738f81',
674
+ confirmations: 65,
675
+ },
676
+ v2: {
677
+ type: 'split',
678
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
679
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
680
+ confirmations: 65,
681
+ fastConfirmations: 2,
682
+ },
683
+ },
684
+ },
685
+ kitContracts: {
686
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
687
+ },
688
+ });
689
+
690
+ /**
691
+ * Ethereum Sepolia Testnet chain definition
692
+ * @remarks
693
+ * This represents the official test network for the Ethereum blockchain on Sepolia.
694
+ */
695
+ const EthereumSepolia = defineChain({
696
+ type: 'evm',
697
+ chain: Blockchain.Ethereum_Sepolia,
698
+ name: 'Ethereum Sepolia',
699
+ title: 'Ethereum Sepolia Testnet',
700
+ nativeCurrency: {
701
+ name: 'Sepolia Ether',
702
+ symbol: 'ETH',
703
+ decimals: 18,
704
+ },
705
+ chainId: 11155111,
706
+ isTestnet: true,
707
+ explorerUrl: 'https://sepolia.etherscan.io/tx/{hash}',
708
+ rpcEndpoints: ['https://sepolia.drpc.org'],
709
+ eurcAddress: '0x08210F9170F89Ab7658F0B5E3fF39b0E03C594D4',
710
+ usdcAddress: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
711
+ cctp: {
712
+ domain: 0,
713
+ contracts: {
714
+ v1: {
715
+ type: 'split',
716
+ tokenMessenger: '0x9f3B8679c73C2Fef8b59B4f3444d4e156fb70AA5',
717
+ messageTransmitter: '0x7865fAfC2db2093669d92c0F33AeEF291086BEFD',
718
+ confirmations: 65,
719
+ },
720
+ v2: {
721
+ type: 'split',
722
+ tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
723
+ messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
724
+ confirmations: 65,
725
+ fastConfirmations: 2,
726
+ },
727
+ },
728
+ },
729
+ kitContracts: {
730
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
731
+ },
732
+ });
733
+
734
+ /**
735
+ * Hedera Mainnet chain definition
736
+ * @remarks
737
+ * This represents the official production network for the Hedera blockchain.
738
+ */
739
+ defineChain({
740
+ type: 'hedera',
741
+ chain: Blockchain.Hedera,
742
+ name: 'Hedera',
743
+ title: 'Hedera Mainnet',
744
+ nativeCurrency: {
745
+ name: 'HBAR',
746
+ symbol: 'HBAR',
747
+ decimals: 18,
748
+ },
749
+ isTestnet: false,
750
+ explorerUrl: 'https://hashscan.io/mainnet/transaction/{hash}', // Note: Hedera uses `transaction_id`, not hash. Format is typically `0.0.X-YYYY...`.
751
+ rpcEndpoints: ['https://mainnet.hashio.io/api'],
752
+ eurcAddress: null,
753
+ usdcAddress: '0.0.456858',
754
+ cctp: null,
755
+ });
756
+
757
+ /**
758
+ * Hedera Testnet chain definition
759
+ * @remarks
760
+ * This represents the official test network for the Hedera blockchain.
761
+ */
762
+ defineChain({
763
+ type: 'hedera',
764
+ chain: Blockchain.Hedera_Testnet,
765
+ name: 'Hedera Testnet',
766
+ title: 'Hedera Test Network',
767
+ nativeCurrency: {
768
+ name: 'HBAR',
769
+ symbol: 'HBAR',
770
+ decimals: 18,
771
+ },
772
+ isTestnet: true,
773
+ explorerUrl: 'https://hashscan.io/testnet/transaction/{hash}', // Note: Hedera uses `transaction_id`, not hash. Format is typically `0.0.X-YYYY...`.
774
+ rpcEndpoints: ['https://testnet.hashio.io/api'],
775
+ eurcAddress: null,
776
+ usdcAddress: '0.0.429274',
777
+ cctp: null,
778
+ });
779
+
780
+ /**
781
+ * HyperEVM Mainnet chain definition
782
+ * @remarks
783
+ * This represents the official production network for the HyperEVM blockchain.
784
+ * HyperEVM is a Layer 1 blockchain specialized for DeFi and trading applications
785
+ * with native orderbook and matching engine.
786
+ */
787
+ defineChain({
788
+ type: 'evm',
789
+ chain: Blockchain.HyperEVM,
790
+ name: 'HyperEVM',
791
+ title: 'HyperEVM Mainnet',
792
+ nativeCurrency: {
793
+ name: 'Hype',
794
+ symbol: 'HYPE',
795
+ decimals: 18,
796
+ },
797
+ chainId: 999,
798
+ isTestnet: false,
799
+ explorerUrl: 'https://hyperevmscan.io/tx/{hash}',
800
+ rpcEndpoints: ['https://rpc.hyperliquid.xyz/evm'],
801
+ eurcAddress: null,
802
+ usdcAddress: '0xb88339CB7199b77E23DB6E890353E22632Ba630f',
803
+ cctp: {
804
+ domain: 19,
805
+ contracts: {
806
+ v2: {
807
+ type: 'split',
808
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
809
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
810
+ confirmations: 1,
811
+ fastConfirmations: 1,
812
+ },
813
+ },
814
+ },
815
+ kitContracts: {
816
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
817
+ },
818
+ });
819
+
820
+ /**
821
+ * HyperEVM Testnet chain definition
822
+ * @remarks
823
+ * This represents the official testnet for the HyperEVM blockchain.
824
+ * Used for development and testing purposes before deploying to mainnet.
825
+ */
826
+ defineChain({
827
+ type: 'evm',
828
+ chain: Blockchain.HyperEVM_Testnet,
829
+ name: 'HyperEVM Testnet',
830
+ title: 'HyperEVM Test Network',
831
+ nativeCurrency: {
832
+ name: 'Hype',
833
+ symbol: 'HYPE',
834
+ decimals: 18,
835
+ },
836
+ chainId: 998,
837
+ isTestnet: true,
838
+ explorerUrl: 'https://testnet.hyperliquid.xyz/explorer/tx/{hash}',
839
+ rpcEndpoints: ['https://rpc.hyperliquid-testnet.xyz/evm'],
840
+ eurcAddress: null,
841
+ usdcAddress: '0x2B3370eE501B4a559b57D449569354196457D8Ab',
842
+ cctp: {
843
+ domain: 19,
844
+ contracts: {
845
+ v2: {
846
+ type: 'split',
847
+ tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
848
+ messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
849
+ confirmations: 1,
850
+ fastConfirmations: 1,
851
+ },
852
+ },
853
+ },
854
+ kitContracts: {
855
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
856
+ },
857
+ });
858
+
859
+ /**
860
+ * Ink Mainnet chain definition
861
+ * @remarks
862
+ * This represents the official production network for the Ink blockchain.
863
+ * Ink is a Layer 1 blockchain specialized for DeFi and trading applications
864
+ * with native orderbook and matching engine.
865
+ */
866
+ defineChain({
867
+ type: 'evm',
868
+ chain: Blockchain.Ink,
869
+ name: 'Ink',
870
+ title: 'Ink Mainnet',
871
+ nativeCurrency: {
872
+ name: 'Ether',
873
+ symbol: 'ETH',
874
+ decimals: 18,
875
+ },
876
+ chainId: 57073,
877
+ isTestnet: false,
878
+ explorerUrl: 'https://explorer.inkonchain.com/tx/{hash}',
879
+ rpcEndpoints: [
880
+ 'https://rpc-gel.inkonchain.com',
881
+ 'https://rpc-qnd.inkonchain.com',
882
+ ],
883
+ eurcAddress: null,
884
+ usdcAddress: '0x2D270e6886d130D724215A266106e6832161EAEd',
885
+ cctp: {
886
+ domain: 21,
887
+ contracts: {
888
+ v2: {
889
+ type: 'split',
890
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
891
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
892
+ confirmations: 65,
893
+ fastConfirmations: 1,
894
+ },
895
+ },
896
+ },
897
+ kitContracts: {
898
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
899
+ },
900
+ });
901
+
902
+ /**
903
+ * Ink Testnet chain definition
904
+ * @remarks
905
+ * This represents the official testnet for the Ink blockchain.
906
+ * Used for development and testing purposes before deploying to mainnet.
907
+ */
908
+ defineChain({
909
+ type: 'evm',
910
+ chain: Blockchain.Ink_Testnet,
911
+ name: 'Ink Sepolia',
912
+ title: 'Ink Sepolia Testnet',
913
+ nativeCurrency: {
914
+ name: 'Sepolia Ether',
915
+ symbol: 'ETH',
916
+ decimals: 18,
917
+ },
918
+ chainId: 763373,
919
+ isTestnet: true,
920
+ explorerUrl: 'https://explorer-sepolia.inkonchain.com/tx/{hash}',
921
+ rpcEndpoints: [
922
+ 'https://rpc-gel-sepolia.inkonchain.com',
923
+ 'https://rpc-qnd-sepolia.inkonchain.com',
924
+ ],
925
+ eurcAddress: null,
926
+ usdcAddress: '0xFabab97dCE620294D2B0b0e46C68964e326300Ac',
927
+ cctp: {
928
+ domain: 21,
929
+ contracts: {
930
+ v2: {
931
+ type: 'split',
932
+ tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
933
+ messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
934
+ confirmations: 65,
935
+ fastConfirmations: 1,
936
+ },
937
+ },
938
+ },
939
+ kitContracts: {
940
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
941
+ },
942
+ });
943
+
944
+ /**
945
+ * Linea Mainnet chain definition
946
+ * @remarks
947
+ * This represents the official production network for the Linea blockchain.
948
+ */
949
+ const Linea = defineChain({
950
+ type: 'evm',
951
+ chain: Blockchain.Linea,
952
+ name: 'Linea',
953
+ title: 'Linea Mainnet',
954
+ nativeCurrency: {
955
+ name: 'Ether',
956
+ symbol: 'ETH',
957
+ decimals: 18,
958
+ },
959
+ chainId: 59144,
960
+ isTestnet: false,
961
+ explorerUrl: 'https://lineascan.build/tx/{hash}',
962
+ rpcEndpoints: ['https://rpc.linea.build'],
963
+ eurcAddress: null,
964
+ usdcAddress: '0x176211869ca2b568f2a7d4ee941e073a821ee1ff',
965
+ cctp: {
966
+ domain: 11,
967
+ contracts: {
968
+ v2: {
969
+ type: 'split',
970
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
971
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
972
+ confirmations: 1,
973
+ fastConfirmations: 1,
974
+ },
975
+ },
976
+ },
977
+ kitContracts: {
978
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
979
+ },
980
+ });
981
+
982
+ /**
983
+ * Linea Sepolia Testnet chain definition
984
+ * @remarks
985
+ * This represents the official test network for the Linea blockchain on Sepolia.
986
+ */
987
+ const LineaSepolia = defineChain({
988
+ type: 'evm',
989
+ chain: Blockchain.Linea_Sepolia,
990
+ name: 'Linea Sepolia',
991
+ title: 'Linea Sepolia Testnet',
992
+ nativeCurrency: {
993
+ name: 'Sepolia Ether',
994
+ symbol: 'ETH',
995
+ decimals: 18,
996
+ },
997
+ chainId: 59141,
998
+ isTestnet: true,
999
+ explorerUrl: 'https://sepolia.lineascan.build/tx/{hash}',
1000
+ rpcEndpoints: ['https://rpc.sepolia.linea.build'],
1001
+ eurcAddress: null,
1002
+ usdcAddress: '0xfece4462d57bd51a6a552365a011b95f0e16d9b7',
1003
+ cctp: {
1004
+ domain: 11,
1005
+ contracts: {
1006
+ v2: {
1007
+ type: 'split',
1008
+ tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
1009
+ messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
1010
+ confirmations: 1,
1011
+ fastConfirmations: 1,
1012
+ },
1013
+ },
1014
+ },
1015
+ kitContracts: {
1016
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
1017
+ },
1018
+ });
1019
+
1020
+ /**
1021
+ * NEAR Protocol Mainnet chain definition
1022
+ * @remarks
1023
+ * This represents the official production network for the NEAR Protocol blockchain.
1024
+ */
1025
+ defineChain({
1026
+ type: 'near',
1027
+ chain: Blockchain.NEAR,
1028
+ name: 'NEAR Protocol',
1029
+ title: 'NEAR Mainnet',
1030
+ nativeCurrency: {
1031
+ name: 'NEAR',
1032
+ symbol: 'NEAR',
1033
+ decimals: 24,
1034
+ },
1035
+ isTestnet: false,
1036
+ explorerUrl: 'https://nearblocks.io/txns/{hash}',
1037
+ rpcEndpoints: ['https://eth-rpc.mainnet.near.org'],
1038
+ eurcAddress: null,
1039
+ usdcAddress: '17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1',
1040
+ cctp: null,
1041
+ });
1042
+
1043
+ /**
1044
+ * NEAR Testnet chain definition
1045
+ * @remarks
1046
+ * This represents the official test network for the NEAR Protocol blockchain.
1047
+ */
1048
+ defineChain({
1049
+ type: 'near',
1050
+ chain: Blockchain.NEAR_Testnet,
1051
+ name: 'NEAR Protocol Testnet',
1052
+ title: 'NEAR Test Network',
1053
+ nativeCurrency: {
1054
+ name: 'NEAR',
1055
+ symbol: 'NEAR',
1056
+ decimals: 24,
1057
+ },
1058
+ isTestnet: true,
1059
+ explorerUrl: 'https://testnet.nearblocks.io/txns/{hash}',
1060
+ rpcEndpoints: ['https://eth-rpc.testnet.near.org'],
1061
+ eurcAddress: null,
1062
+ usdcAddress: '3e2210e1184b45b64c8a434c0a7e7b23cc04ea7eb7a6c3c32520d03d4afcb8af',
1063
+ cctp: null,
1064
+ });
1065
+
1066
+ /**
1067
+ * Noble Mainnet chain definition
1068
+ * @remarks
1069
+ * This represents the official production network for the Noble blockchain.
1070
+ */
1071
+ defineChain({
1072
+ type: 'noble',
1073
+ chain: Blockchain.Noble,
1074
+ name: 'Noble',
1075
+ title: 'Noble Mainnet',
1076
+ nativeCurrency: {
1077
+ name: 'Noble USDC',
1078
+ symbol: 'USDC',
1079
+ decimals: 6,
1080
+ },
1081
+ isTestnet: false,
1082
+ explorerUrl: 'https://www.mintscan.io/noble/tx/{hash}',
1083
+ rpcEndpoints: ['https://noble-rpc.polkachu.com'],
1084
+ eurcAddress: null,
1085
+ usdcAddress: 'uusdc',
1086
+ cctp: {
1087
+ domain: 4,
1088
+ contracts: {
1089
+ v1: {
1090
+ type: 'merged',
1091
+ contract: 'noble12l2w4ugfz4m6dd73yysz477jszqnfughxvkss5',
1092
+ confirmations: 1,
1093
+ },
1094
+ },
1095
+ },
1096
+ });
1097
+
1098
+ /**
1099
+ * Noble Testnet chain definition
1100
+ * @remarks
1101
+ * This represents the official test network for the Noble blockchain.
1102
+ */
1103
+ defineChain({
1104
+ type: 'noble',
1105
+ chain: Blockchain.Noble_Testnet,
1106
+ name: 'Noble Testnet',
1107
+ title: 'Noble Test Network',
1108
+ nativeCurrency: {
1109
+ name: 'Noble USDC',
1110
+ symbol: 'USDC',
1111
+ decimals: 6,
1112
+ },
1113
+ isTestnet: true,
1114
+ explorerUrl: 'https://www.mintscan.io/noble-testnet/tx/{hash}',
1115
+ rpcEndpoints: ['https://noble-testnet-rpc.polkachu.com'],
1116
+ eurcAddress: null,
1117
+ usdcAddress: 'uusdc',
1118
+ cctp: {
1119
+ domain: 4,
1120
+ contracts: {
1121
+ v1: {
1122
+ type: 'merged',
1123
+ contract: 'noble12l2w4ugfz4m6dd73yysz477jszqnfughxvkss5',
1124
+ confirmations: 1,
1125
+ },
1126
+ },
1127
+ },
1128
+ });
1129
+
1130
+ /**
1131
+ * Optimism Mainnet chain definition
1132
+ * @remarks
1133
+ * This represents the official production network for the Optimism blockchain.
1134
+ */
1135
+ const Optimism = defineChain({
1136
+ type: 'evm',
1137
+ chain: Blockchain.Optimism,
1138
+ name: 'Optimism',
1139
+ title: 'Optimism Mainnet',
1140
+ nativeCurrency: {
1141
+ name: 'Ether',
1142
+ symbol: 'ETH',
1143
+ decimals: 18,
1144
+ },
1145
+ chainId: 10,
1146
+ isTestnet: false,
1147
+ explorerUrl: 'https://optimistic.etherscan.io/tx/{hash}',
1148
+ rpcEndpoints: ['https://mainnet.optimism.io'],
1149
+ eurcAddress: null,
1150
+ usdcAddress: '0x0b2c639c533813f4aa9d7837caf62653d097ff85',
1151
+ cctp: {
1152
+ domain: 2,
1153
+ contracts: {
1154
+ v1: {
1155
+ type: 'split',
1156
+ tokenMessenger: '0x2B4069517957735bE00ceE0fadAE88a26365528f',
1157
+ messageTransmitter: '0x0a992d191deec32afe36203ad87d7d289a738f81',
1158
+ confirmations: 65,
1159
+ },
1160
+ v2: {
1161
+ type: 'split',
1162
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
1163
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
1164
+ confirmations: 65,
1165
+ fastConfirmations: 1,
1166
+ },
1167
+ },
1168
+ },
1169
+ kitContracts: {
1170
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
1171
+ },
1172
+ });
1173
+
1174
+ /**
1175
+ * Optimism Sepolia Testnet chain definition
1176
+ * @remarks
1177
+ * This represents the official test network for the Optimism blockchain on Sepolia.
1178
+ */
1179
+ const OptimismSepolia = defineChain({
1180
+ type: 'evm',
1181
+ chain: Blockchain.Optimism_Sepolia,
1182
+ name: 'Optimism Sepolia',
1183
+ title: 'Optimism Sepolia Testnet',
1184
+ nativeCurrency: {
1185
+ name: 'Sepolia Ether',
1186
+ symbol: 'ETH',
1187
+ decimals: 18,
1188
+ },
1189
+ chainId: 11155420,
1190
+ isTestnet: true,
1191
+ explorerUrl: 'https://sepolia-optimistic.etherscan.io/tx/{hash}',
1192
+ rpcEndpoints: ['https://sepolia.optimism.io'],
1193
+ eurcAddress: null,
1194
+ usdcAddress: '0x5fd84259d66Cd46123540766Be93DFE6D43130D7',
1195
+ cctp: {
1196
+ domain: 2,
1197
+ contracts: {
1198
+ v1: {
1199
+ type: 'split',
1200
+ tokenMessenger: '0x9f3B8679c73C2Fef8b59B4f3444d4e156fb70AA5',
1201
+ messageTransmitter: '0x7865fAfC2db2093669d92c0F33AeEF291086BEFD',
1202
+ confirmations: 65,
1203
+ },
1204
+ v2: {
1205
+ type: 'split',
1206
+ tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
1207
+ messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
1208
+ confirmations: 65,
1209
+ fastConfirmations: 1,
1210
+ },
1211
+ },
1212
+ },
1213
+ kitContracts: {
1214
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
1215
+ },
1216
+ });
1217
+
1218
+ /**
1219
+ * Plume Mainnet chain definition
1220
+ * @remarks
1221
+ * This represents the official production network for the Plume blockchain.
1222
+ * Plume is a Layer 1 blockchain specialized for DeFi and trading applications
1223
+ * with native orderbook and matching engine.
1224
+ */
1225
+ defineChain({
1226
+ type: 'evm',
1227
+ chain: Blockchain.Plume,
1228
+ name: 'Plume',
1229
+ title: 'Plume Mainnet',
1230
+ nativeCurrency: {
1231
+ name: 'Plume',
1232
+ symbol: 'PLUME',
1233
+ decimals: 18,
1234
+ },
1235
+ chainId: 98866,
1236
+ isTestnet: false,
1237
+ explorerUrl: 'https://explorer.plume.org/tx/{hash}',
1238
+ rpcEndpoints: ['https://rpc.plume.org'],
1239
+ eurcAddress: null,
1240
+ usdcAddress: '0x222365EF19F7947e5484218551B56bb3965Aa7aF',
1241
+ cctp: {
1242
+ domain: 22,
1243
+ contracts: {
1244
+ v2: {
1245
+ type: 'split',
1246
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
1247
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
1248
+ confirmations: 65,
1249
+ fastConfirmations: 1,
1250
+ },
1251
+ },
1252
+ },
1253
+ kitContracts: {
1254
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
1255
+ },
1256
+ });
1257
+
1258
+ /**
1259
+ * Plume Testnet chain definition
1260
+ * @remarks
1261
+ * This represents the official testnet for the Plume blockchain.
1262
+ * Used for development and testing purposes before deploying to mainnet.
1263
+ */
1264
+ defineChain({
1265
+ type: 'evm',
1266
+ chain: Blockchain.Plume_Testnet,
1267
+ name: 'Plume Testnet',
1268
+ title: 'Plume Test Network',
1269
+ nativeCurrency: {
1270
+ name: 'Plume',
1271
+ symbol: 'PLUME',
1272
+ decimals: 18,
1273
+ },
1274
+ chainId: 98867,
1275
+ isTestnet: true,
1276
+ explorerUrl: 'https://testnet-explorer.plume.org/tx/{hash}',
1277
+ rpcEndpoints: ['https://testnet-rpc.plume.org'],
1278
+ eurcAddress: null,
1279
+ usdcAddress: '0xcB5f30e335672893c7eb944B374c196392C19D18',
1280
+ cctp: {
1281
+ domain: 22,
1282
+ contracts: {
1283
+ v2: {
1284
+ type: 'split',
1285
+ tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
1286
+ messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
1287
+ confirmations: 65,
1288
+ fastConfirmations: 1,
1289
+ },
1290
+ },
1291
+ },
1292
+ kitContracts: {
1293
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
1294
+ },
1295
+ });
1296
+
1297
+ /**
1298
+ * Polkadot Asset Hub chain definition
1299
+ * @remarks
1300
+ * This represents the official asset management parachain for the Polkadot blockchain.
1301
+ */
1302
+ defineChain({
1303
+ type: 'polkadot',
1304
+ chain: Blockchain.Polkadot_Asset_Hub,
1305
+ name: 'Polkadot Asset Hub',
1306
+ title: 'Polkadot Asset Hub',
1307
+ nativeCurrency: {
1308
+ name: 'Polkadot',
1309
+ symbol: 'DOT',
1310
+ decimals: 10,
1311
+ },
1312
+ isTestnet: false,
1313
+ explorerUrl: 'https://polkadot.subscan.io/extrinsic/{hash}',
1314
+ rpcEndpoints: ['https://asset-hub-polkadot-rpc.n.dwellir.com'],
1315
+ eurcAddress: null,
1316
+ usdcAddress: '1337',
1317
+ cctp: null,
1318
+ });
1319
+
1320
+ /**
1321
+ * Polkadot Westmint chain definition
1322
+ * @remarks
1323
+ * This represents an asset management parachain in the Polkadot ecosystem.
1324
+ */
1325
+ defineChain({
1326
+ type: 'polkadot',
1327
+ chain: Blockchain.Polkadot_Westmint,
1328
+ name: 'Polkadot Westmint',
1329
+ title: 'Polkadot Westmint',
1330
+ nativeCurrency: {
1331
+ name: 'Polkadot',
1332
+ symbol: 'DOT',
1333
+ decimals: 10,
1334
+ },
1335
+ isTestnet: false,
1336
+ explorerUrl: 'https://assethub-polkadot.subscan.io/extrinsic/{hash}',
1337
+ rpcEndpoints: ['https://westmint-rpc.polkadot.io'],
1338
+ eurcAddress: null,
1339
+ usdcAddress: 'Asset ID 31337',
1340
+ cctp: null,
1341
+ });
1342
+
1343
+ /**
1344
+ * Polygon Mainnet chain definition
1345
+ * @remarks
1346
+ * This represents the official production network for the Polygon blockchain.
1347
+ */
1348
+ const Polygon = defineChain({
1349
+ type: 'evm',
1350
+ chain: Blockchain.Polygon,
1351
+ name: 'Polygon',
1352
+ title: 'Polygon Mainnet',
1353
+ nativeCurrency: {
1354
+ name: 'POL',
1355
+ symbol: 'POL',
1356
+ decimals: 18,
1357
+ },
1358
+ chainId: 137,
1359
+ isTestnet: false,
1360
+ explorerUrl: 'https://polygonscan.com/tx/{hash}',
1361
+ rpcEndpoints: ['https://polygon-rpc.com', 'https://polygon.publicnode.com'],
1362
+ eurcAddress: null,
1363
+ usdcAddress: '0x3c499c542cef5e3811e1192ce70d8cc03d5c3359',
1364
+ cctp: {
1365
+ domain: 7,
1366
+ contracts: {
1367
+ v1: {
1368
+ type: 'split',
1369
+ tokenMessenger: '0x9daF8c91AEFAE50b9c0E69629D3F6Ca40cA3B3FE',
1370
+ messageTransmitter: '0xF3be9355363857F3e001be68856A2f96b4C39Ba9',
1371
+ confirmations: 200,
1372
+ },
1373
+ v2: {
1374
+ type: 'split',
1375
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
1376
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
1377
+ confirmations: 33,
1378
+ fastConfirmations: 13,
1379
+ },
1380
+ },
1381
+ },
1382
+ kitContracts: {
1383
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
1384
+ },
1385
+ });
1386
+
1387
+ /**
1388
+ * Polygon Amoy Testnet chain definition
1389
+ * @remarks
1390
+ * This represents the official test network for the Polygon blockchain.
1391
+ */
1392
+ const PolygonAmoy = defineChain({
1393
+ type: 'evm',
1394
+ chain: Blockchain.Polygon_Amoy_Testnet,
1395
+ name: 'Polygon Amoy',
1396
+ title: 'Polygon Amoy Testnet',
1397
+ nativeCurrency: {
1398
+ name: 'POL',
1399
+ symbol: 'POL',
1400
+ decimals: 18,
1401
+ },
1402
+ chainId: 80002,
1403
+ isTestnet: true,
1404
+ explorerUrl: 'https://amoy.polygonscan.com/tx/{hash}',
1405
+ rpcEndpoints: ['https://rpc-amoy.polygon.technology'],
1406
+ eurcAddress: null,
1407
+ usdcAddress: '0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582',
1408
+ cctp: {
1409
+ domain: 7,
1410
+ contracts: {
1411
+ v1: {
1412
+ type: 'split',
1413
+ tokenMessenger: '0x9f3B8679c73C2Fef8b59B4f3444d4e156fb70AA5',
1414
+ messageTransmitter: '0x7865fAfC2db2093669d92c0F33AeEF291086BEFD',
1415
+ confirmations: 200,
1416
+ },
1417
+ v2: {
1418
+ type: 'split',
1419
+ tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
1420
+ messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
1421
+ confirmations: 33,
1422
+ fastConfirmations: 13,
1423
+ },
1424
+ },
1425
+ },
1426
+ kitContracts: {
1427
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
1428
+ },
1429
+ });
1430
+
1431
+ /**
1432
+ * Sei Mainnet chain definition
1433
+ * @remarks
1434
+ * This represents the official production network for the Sei blockchain.
1435
+ * Sei is a Layer 1 blockchain specialized for DeFi and trading applications
1436
+ * with native orderbook and matching engine.
1437
+ */
1438
+ defineChain({
1439
+ type: 'evm',
1440
+ chain: Blockchain.Sei,
1441
+ name: 'Sei',
1442
+ title: 'Sei Mainnet',
1443
+ nativeCurrency: {
1444
+ name: 'Sei',
1445
+ symbol: 'SEI',
1446
+ decimals: 18,
1447
+ },
1448
+ chainId: 1329,
1449
+ isTestnet: false,
1450
+ explorerUrl: 'https://seitrace.com/tx/{hash}?chain=pacific-1',
1451
+ rpcEndpoints: ['https://evm-rpc.sei-apis.com'],
1452
+ eurcAddress: null,
1453
+ usdcAddress: '0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392',
1454
+ cctp: {
1455
+ domain: 16,
1456
+ contracts: {
1457
+ v2: {
1458
+ type: 'split',
1459
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
1460
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
1461
+ confirmations: 1,
1462
+ fastConfirmations: 1,
1463
+ },
1464
+ },
1465
+ },
1466
+ kitContracts: {
1467
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
1468
+ },
1469
+ });
1470
+
1471
+ /**
1472
+ * Sei Testnet chain definition
1473
+ * @remarks
1474
+ * This represents the official testnet for the Sei blockchain.
1475
+ * Used for development and testing purposes before deploying to mainnet.
1476
+ */
1477
+ defineChain({
1478
+ type: 'evm',
1479
+ chain: Blockchain.Sei_Testnet,
1480
+ name: 'Sei Testnet',
1481
+ title: 'Sei Test Network',
1482
+ nativeCurrency: {
1483
+ name: 'Sei',
1484
+ symbol: 'SEI',
1485
+ decimals: 18,
1486
+ },
1487
+ chainId: 1328,
1488
+ isTestnet: true,
1489
+ explorerUrl: 'https://seitrace.com/tx/{hash}?chain=atlantic-2',
1490
+ rpcEndpoints: ['https://evm-rpc-testnet.sei-apis.com'],
1491
+ eurcAddress: null,
1492
+ usdcAddress: '0x4fCF1784B31630811181f670Aea7A7bEF803eaED',
1493
+ cctp: {
1494
+ domain: 16,
1495
+ contracts: {
1496
+ v2: {
1497
+ type: 'split',
1498
+ tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
1499
+ messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
1500
+ confirmations: 1,
1501
+ fastConfirmations: 1,
1502
+ },
1503
+ },
1504
+ },
1505
+ kitContracts: {
1506
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
1507
+ },
1508
+ });
1509
+
1510
+ /**
1511
+ * Sonic Mainnet chain definition
1512
+ * @remarks
1513
+ * This represents the official production network for the Sonic blockchain.
1514
+ */
1515
+ const Sonic = defineChain({
1516
+ type: 'evm',
1517
+ chain: Blockchain.Sonic,
1518
+ name: 'Sonic',
1519
+ title: 'Sonic Mainnet',
1520
+ nativeCurrency: {
1521
+ name: 'Sonic',
1522
+ symbol: 'S',
1523
+ decimals: 18,
1524
+ },
1525
+ chainId: 146,
1526
+ isTestnet: false,
1527
+ explorerUrl: 'https://sonicscan.org/tx/{hash}',
1528
+ rpcEndpoints: ['https://rpc.soniclabs.com'],
1529
+ eurcAddress: null,
1530
+ usdcAddress: '0x29219dd400f2Bf60E5a23d13Be72B486D4038894',
1531
+ cctp: {
1532
+ domain: 13,
1533
+ contracts: {
1534
+ v2: {
1535
+ type: 'split',
1536
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
1537
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
1538
+ confirmations: 1,
1539
+ fastConfirmations: 1,
1540
+ },
1541
+ },
1542
+ },
1543
+ kitContracts: {
1544
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
1545
+ },
1546
+ });
1547
+
1548
+ /**
1549
+ * Sonic Blaze Testnet chain definition
1550
+ * @remarks
1551
+ * This represents the official test network for the Sonic blockchain.
1552
+ */
1553
+ const SonicTestnet = defineChain({
1554
+ type: 'evm',
1555
+ chain: Blockchain.Sonic_Testnet,
1556
+ name: 'Sonic Blaze Testnet',
1557
+ title: 'Sonic Blaze Testnet',
1558
+ nativeCurrency: {
1559
+ name: 'Sonic',
1560
+ symbol: 'S',
1561
+ decimals: 18,
1562
+ },
1563
+ chainId: 57054,
1564
+ isTestnet: true,
1565
+ explorerUrl: 'https://testnet.sonicscan.org/tx/{hash}',
1566
+ rpcEndpoints: ['https://rpc.blaze.soniclabs.com'],
1567
+ eurcAddress: null,
1568
+ usdcAddress: '0xA4879Fed32Ecbef99399e5cbC247E533421C4eC6',
1569
+ cctp: {
1570
+ domain: 13,
1571
+ contracts: {
1572
+ v2: {
1573
+ type: 'split',
1574
+ tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
1575
+ messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
1576
+ confirmations: 1,
1577
+ fastConfirmations: 1,
1578
+ },
1579
+ },
1580
+ },
1581
+ kitContracts: {
1582
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
1583
+ },
1584
+ });
1585
+
1586
+ /**
1587
+ * Solana Mainnet chain definition
1588
+ * @remarks
1589
+ * This represents the official production network for the Solana blockchain.
1590
+ */
1591
+ const Solana = defineChain({
1592
+ type: 'solana',
1593
+ chain: Blockchain.Solana,
1594
+ name: 'Solana',
1595
+ title: 'Solana Mainnet',
1596
+ nativeCurrency: {
1597
+ name: 'Solana',
1598
+ symbol: 'SOL',
1599
+ decimals: 9,
1600
+ },
1601
+ isTestnet: false,
1602
+ explorerUrl: 'https://solscan.io/tx/{hash}',
1603
+ rpcEndpoints: ['https://api.mainnet-beta.solana.com'],
1604
+ eurcAddress: 'HzwqbKZw8HxMN6bF2yFZNrht3c2iXXzpKcFu7uBEDKtr',
1605
+ usdcAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
1606
+ cctp: {
1607
+ domain: 5,
1608
+ contracts: {
1609
+ v1: {
1610
+ type: 'split',
1611
+ tokenMessenger: 'CCTPiPYPc6AsJuwueEnWgSgucamXDZwBd53dQ11YiKX3',
1612
+ messageTransmitter: 'CCTPmbSD7gX1bxKPAmg77w8oFzNFpaQiQUWD43TKaecd',
1613
+ confirmations: 32,
1614
+ },
1615
+ v2: {
1616
+ type: 'split',
1617
+ tokenMessenger: 'CCTPV2vPZJS2u2BBsUoscuikbYjnpFmbFsvVuJdgUMQe',
1618
+ messageTransmitter: 'CCTPV2Sm4AdWt5296sk4P66VBZ7bEhcARwFaaS9YPbeC',
1619
+ confirmations: 32,
1620
+ fastConfirmations: 3,
1621
+ },
1622
+ },
1623
+ },
1624
+ kitContracts: {
1625
+ bridge: 'DFaauJEjmiHkPs1JG89A4p95hDWi9m9SAEERY1LQJiC3',
1626
+ },
1627
+ });
1628
+
1629
+ /**
1630
+ * Solana Devnet chain definition
1631
+ * @remarks
1632
+ * This represents the development test network for the Solana blockchain.
1633
+ */
1634
+ const SolanaDevnet = defineChain({
1635
+ type: 'solana',
1636
+ chain: Blockchain.Solana_Devnet,
1637
+ name: 'Solana Devnet',
1638
+ title: 'Solana Development Network',
1639
+ nativeCurrency: {
1640
+ name: 'Solana',
1641
+ symbol: 'SOL',
1642
+ decimals: 9,
1643
+ },
1644
+ isTestnet: true,
1645
+ explorerUrl: 'https://solscan.io/tx/{hash}?cluster=devnet',
1646
+ eurcAddress: 'HzwqbKZw8HxMN6bF2yFZNrht3c2iXXzpKcFu7uBEDKtr',
1647
+ usdcAddress: '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',
1648
+ cctp: {
1649
+ domain: 5,
1650
+ contracts: {
1651
+ v1: {
1652
+ type: 'split',
1653
+ tokenMessenger: 'CCTPiPYPc6AsJuwueEnWgSgucamXDZwBd53dQ11YiKX3',
1654
+ messageTransmitter: 'CCTPmbSD7gX1bxKPAmg77w8oFzNFpaQiQUWD43TKaecd',
1655
+ confirmations: 32,
1656
+ },
1657
+ v2: {
1658
+ type: 'split',
1659
+ tokenMessenger: 'CCTPV2vPZJS2u2BBsUoscuikbYjnpFmbFsvVuJdgUMQe',
1660
+ messageTransmitter: 'CCTPV2Sm4AdWt5296sk4P66VBZ7bEhcARwFaaS9YPbeC',
1661
+ confirmations: 32,
1662
+ fastConfirmations: 3,
1663
+ },
1664
+ },
1665
+ },
1666
+ kitContracts: {
1667
+ bridge: 'DFaauJEjmiHkPs1JG89A4p95hDWi9m9SAEERY1LQJiC3',
1668
+ },
1669
+ rpcEndpoints: ['https://api.devnet.solana.com'],
1670
+ });
1671
+
1672
+ /**
1673
+ * Stellar Mainnet chain definition
1674
+ * @remarks
1675
+ * This represents the official production network for the Stellar blockchain.
1676
+ */
1677
+ defineChain({
1678
+ type: 'stellar',
1679
+ chain: Blockchain.Stellar,
1680
+ name: 'Stellar',
1681
+ title: 'Stellar Mainnet',
1682
+ nativeCurrency: {
1683
+ name: 'Stellar Lumens',
1684
+ symbol: 'XLM',
1685
+ decimals: 7,
1686
+ },
1687
+ isTestnet: false,
1688
+ explorerUrl: 'https://stellar.expert/explorer/public/tx/{hash}',
1689
+ rpcEndpoints: ['https://horizon.stellar.org'],
1690
+ eurcAddress: 'EURC-GDHU6WRG4IEQXM5NZ4BMPKOXHW76MZM4Y2IEMFDVXBSDP6SJY4ITNPP2',
1691
+ usdcAddress: 'USDC-GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN',
1692
+ cctp: null,
1693
+ });
1694
+
1695
+ /**
1696
+ * Stellar Testnet chain definition
1697
+ * @remarks
1698
+ * This represents the official test network for the Stellar blockchain.
1699
+ */
1700
+ defineChain({
1701
+ type: 'stellar',
1702
+ chain: Blockchain.Stellar_Testnet,
1703
+ name: 'Stellar Testnet',
1704
+ title: 'Stellar Test Network',
1705
+ nativeCurrency: {
1706
+ name: 'Stellar Lumens',
1707
+ symbol: 'XLM',
1708
+ decimals: 7,
1709
+ },
1710
+ isTestnet: true,
1711
+ explorerUrl: 'https://stellar.expert/explorer/testnet/tx/{hash}',
1712
+ rpcEndpoints: ['https://horizon-testnet.stellar.org'],
1713
+ eurcAddress: 'EURC-GB3Q6QDZYTHWT7E5PVS3W7FUT5GVAFC5KSZFFLPU25GO7VTC3NM2ZTVO',
1714
+ usdcAddress: 'USDC-GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5',
1715
+ cctp: null,
1716
+ });
1717
+
1718
+ /**
1719
+ * Sui Mainnet chain definition
1720
+ * @remarks
1721
+ * This represents the official production network for the Sui blockchain.
1722
+ */
1723
+ defineChain({
1724
+ type: 'sui',
1725
+ chain: Blockchain.Sui,
1726
+ name: 'Sui',
1727
+ title: 'Sui Mainnet',
1728
+ nativeCurrency: {
1729
+ name: 'Sui',
1730
+ symbol: 'SUI',
1731
+ decimals: 9,
1732
+ },
1733
+ isTestnet: false,
1734
+ explorerUrl: 'https://suiscan.xyz/mainnet/tx/{hash}',
1735
+ rpcEndpoints: ['https://fullnode.mainnet.sui.io'],
1736
+ eurcAddress: null,
1737
+ usdcAddress: '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC',
1738
+ cctp: {
1739
+ domain: 8,
1740
+ contracts: {
1741
+ v1: {
1742
+ type: 'split',
1743
+ tokenMessenger: '0x2aa6c5d56376c371f88a6cc42e852824994993cb9bab8d3e6450cbe3cb32b94e',
1744
+ messageTransmitter: '0x08d87d37ba49e785dde270a83f8e979605b03dc552b5548f26fdf2f49bf7ed1b',
1745
+ confirmations: 1,
1746
+ },
1747
+ },
1748
+ },
1749
+ });
1750
+
1751
+ /**
1752
+ * Sui Testnet chain definition
1753
+ * @remarks
1754
+ * This represents the official test network for the Sui blockchain.
1755
+ */
1756
+ defineChain({
1757
+ type: 'sui',
1758
+ chain: Blockchain.Sui_Testnet,
1759
+ name: 'Sui Testnet',
1760
+ title: 'Sui Test Network',
1761
+ nativeCurrency: {
1762
+ name: 'Sui',
1763
+ symbol: 'SUI',
1764
+ decimals: 9,
1765
+ },
1766
+ isTestnet: true,
1767
+ explorerUrl: 'https://suiscan.xyz/testnet/tx/{hash}',
1768
+ rpcEndpoints: ['https://fullnode.testnet.sui.io'],
1769
+ eurcAddress: null,
1770
+ usdcAddress: '0xa1ec7fc00a6f40db9693ad1415d0c193ad3906494428cf252621037bd7117e29::usdc::USDC',
1771
+ cctp: {
1772
+ domain: 8,
1773
+ contracts: {
1774
+ v1: {
1775
+ type: 'split',
1776
+ tokenMessenger: '0x31cc14d80c175ae39777c0238f20594c6d4869cfab199f40b69f3319956b8beb',
1777
+ messageTransmitter: '0x4931e06dce648b3931f890035bd196920770e913e43e45990b383f6486fdd0a5',
1778
+ confirmations: 1,
1779
+ },
1780
+ },
1781
+ },
1782
+ });
1783
+
1784
+ /**
1785
+ * Unichain Mainnet chain definition
1786
+ * @remarks
1787
+ * This represents the official production network for the Unichain blockchain.
1788
+ */
1789
+ const Unichain = defineChain({
1790
+ type: 'evm',
1791
+ chain: Blockchain.Unichain,
1792
+ name: 'Unichain',
1793
+ title: 'Unichain Mainnet',
1794
+ nativeCurrency: {
1795
+ name: 'Uni',
1796
+ symbol: 'UNI',
1797
+ decimals: 18,
1798
+ },
1799
+ chainId: 130,
1800
+ isTestnet: false,
1801
+ explorerUrl: 'https://unichain.blockscout.com/tx/{hash}',
1802
+ rpcEndpoints: ['https://rpc.unichain.org', 'https://mainnet.unichain.org'],
1803
+ eurcAddress: null,
1804
+ usdcAddress: '0x078D782b760474a361dDA0AF3839290b0EF57AD6',
1805
+ cctp: {
1806
+ domain: 10,
1807
+ contracts: {
1808
+ v1: {
1809
+ type: 'split',
1810
+ tokenMessenger: '0x4e744b28E787c3aD0e810eD65A24461D4ac5a762',
1811
+ messageTransmitter: '0x353bE9E2E38AB1D19104534e4edC21c643Df86f4',
1812
+ confirmations: 65,
1813
+ },
1814
+ v2: {
1815
+ type: 'split',
1816
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
1817
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
1818
+ confirmations: 65,
1819
+ fastConfirmations: 1,
1820
+ },
1821
+ },
1822
+ },
1823
+ kitContracts: {
1824
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
1825
+ },
1826
+ });
1827
+
1828
+ /**
1829
+ * Unichain Sepolia Testnet chain definition
1830
+ * @remarks
1831
+ * This represents the official test network for the Unichain blockchain.
1832
+ */
1833
+ const UnichainSepolia = defineChain({
1834
+ type: 'evm',
1835
+ chain: Blockchain.Unichain_Sepolia,
1836
+ name: 'Unichain Sepolia',
1837
+ title: 'Unichain Sepolia Testnet',
1838
+ nativeCurrency: {
1839
+ name: 'Sepolia Uni',
1840
+ symbol: 'UNI',
1841
+ decimals: 18,
1842
+ },
1843
+ chainId: 1301,
1844
+ isTestnet: true,
1845
+ explorerUrl: 'https://unichain-sepolia.blockscout.com/tx/{hash}',
1846
+ rpcEndpoints: ['https://sepolia.unichain.org'],
1847
+ eurcAddress: null,
1848
+ usdcAddress: '0x31d0220469e10c4E71834a79b1f276d740d3768F',
1849
+ cctp: {
1850
+ domain: 10,
1851
+ contracts: {
1852
+ v1: {
1853
+ type: 'split',
1854
+ tokenMessenger: '0x8ed94B8dAd2Dc5453862ea5e316A8e71AAed9782',
1855
+ messageTransmitter: '0xbc498c326533d675cf571B90A2Ced265ACb7d086',
1856
+ confirmations: 65,
1857
+ },
1858
+ v2: {
1859
+ type: 'split',
1860
+ tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
1861
+ messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
1862
+ confirmations: 65,
1863
+ fastConfirmations: 1,
1864
+ },
1865
+ },
1866
+ },
1867
+ kitContracts: {
1868
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
1869
+ },
1870
+ });
1871
+
1872
+ /**
1873
+ * World Chain chain definition
1874
+ * @remarks
1875
+ * This represents the main network for the World Chain blockchain.
1876
+ */
1877
+ const WorldChain = defineChain({
1878
+ type: 'evm',
1879
+ chain: Blockchain.World_Chain,
1880
+ name: 'World Chain',
1881
+ title: 'World Chain',
1882
+ nativeCurrency: {
1883
+ name: 'Ether',
1884
+ symbol: 'ETH',
1885
+ decimals: 18,
1886
+ },
1887
+ chainId: 480,
1888
+ isTestnet: false,
1889
+ explorerUrl: 'https://worldscan.org/tx/{hash}',
1890
+ rpcEndpoints: ['https://worldchain-mainnet.g.alchemy.com/public'],
1891
+ eurcAddress: null,
1892
+ usdcAddress: '0x79A02482A880bCe3F13E09da970dC34dB4cD24D1',
1893
+ cctp: {
1894
+ domain: 14,
1895
+ contracts: {
1896
+ v2: {
1897
+ type: 'split',
1898
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cF5d',
1899
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
1900
+ confirmations: 65,
1901
+ fastConfirmations: 1,
1902
+ },
1903
+ },
1904
+ },
1905
+ kitContracts: {
1906
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
1907
+ },
1908
+ });
1909
+
1910
+ /**
1911
+ * World Chain Sepolia chain definition
1912
+ * @remarks
1913
+ * This represents the test network for the World Chain blockchain.
1914
+ */
1915
+ const WorldChainSepolia = defineChain({
1916
+ type: 'evm',
1917
+ chain: Blockchain.World_Chain_Sepolia,
1918
+ name: 'World Chain Sepolia',
1919
+ title: 'World Chain Sepolia',
1920
+ nativeCurrency: {
1921
+ name: 'Ether',
1922
+ symbol: 'ETH',
1923
+ decimals: 18,
1924
+ },
1925
+ chainId: 4801,
1926
+ isTestnet: true,
1927
+ explorerUrl: 'https://sepolia.worldscan.org/tx/{hash}',
1928
+ rpcEndpoints: [
1929
+ 'https://worldchain-sepolia.drpc.org',
1930
+ 'https://worldchain-sepolia.g.alchemy.com/public',
1931
+ ],
1932
+ eurcAddress: null,
1933
+ usdcAddress: '0x66145f38cBAC35Ca6F1Dfb4914dF98F1614aeA88',
1934
+ cctp: {
1935
+ domain: 14,
1936
+ contracts: {
1937
+ v2: {
1938
+ type: 'split',
1939
+ tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
1940
+ messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
1941
+ confirmations: 65,
1942
+ fastConfirmations: 1,
1943
+ },
1944
+ },
1945
+ },
1946
+ kitContracts: {
1947
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
1948
+ },
1949
+ });
1950
+
1951
+ /**
1952
+ * XDC Mainnet chain definition
1953
+ * @remarks
1954
+ * This represents the official production network for the XDC blockchain.
1955
+ * XDC is a Layer 1 blockchain specialized for DeFi and trading applications
1956
+ * with native orderbook and matching engine.
1957
+ */
1958
+ defineChain({
1959
+ type: 'evm',
1960
+ chain: Blockchain.XDC,
1961
+ name: 'XDC',
1962
+ title: 'XDC Mainnet',
1963
+ nativeCurrency: {
1964
+ name: 'XDC',
1965
+ symbol: 'XDC',
1966
+ decimals: 18,
1967
+ },
1968
+ chainId: 50,
1969
+ isTestnet: false,
1970
+ explorerUrl: 'https://xdcscan.io/tx/{hash}',
1971
+ rpcEndpoints: ['https://erpc.xinfin.network'],
1972
+ eurcAddress: null,
1973
+ usdcAddress: '0xfA2958CB79b0491CC627c1557F441eF849Ca8eb1',
1974
+ cctp: {
1975
+ domain: 18,
1976
+ contracts: {
1977
+ v2: {
1978
+ type: 'split',
1979
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
1980
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
1981
+ confirmations: 3,
1982
+ fastConfirmations: 3,
1983
+ },
1984
+ },
1985
+ },
1986
+ kitContracts: {
1987
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET,
1988
+ },
1989
+ });
1990
+
1991
+ /**
1992
+ * XDC Apothem Testnet chain definition
1993
+ * @remarks
1994
+ * This represents the official test network for the XDC Network, known as Apothem.
1995
+ */
1996
+ defineChain({
1997
+ type: 'evm',
1998
+ chain: Blockchain.XDC_Apothem,
1999
+ name: 'Apothem Network',
2000
+ title: 'Apothem Network',
2001
+ nativeCurrency: {
2002
+ name: 'TXDC',
2003
+ symbol: 'TXDC',
2004
+ decimals: 18,
2005
+ },
2006
+ chainId: 51,
2007
+ isTestnet: true,
2008
+ explorerUrl: 'https://testnet.xdcscan.com/tx/{hash}',
2009
+ rpcEndpoints: ['https://erpc.apothem.network'],
2010
+ eurcAddress: null,
2011
+ usdcAddress: '0xb5AB69F7bBada22B28e79C8FFAECe55eF1c771D4',
2012
+ cctp: {
2013
+ domain: 18,
2014
+ contracts: {
2015
+ v2: {
2016
+ type: 'split',
2017
+ tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
2018
+ messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
2019
+ confirmations: 3,
2020
+ fastConfirmations: 1,
2021
+ },
2022
+ },
2023
+ },
2024
+ kitContracts: {
2025
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET,
2026
+ },
2027
+ });
2028
+
2029
+ /**
2030
+ * ZKSync Era Mainnet chain definition
2031
+ * @remarks
2032
+ * This represents the official production network for the ZKSync Era blockchain.
2033
+ */
2034
+ defineChain({
2035
+ type: 'evm',
2036
+ chain: Blockchain.ZKSync_Era,
2037
+ name: 'ZKSync Era',
2038
+ title: 'ZKSync Era Mainnet',
2039
+ nativeCurrency: {
2040
+ name: 'Ether',
2041
+ symbol: 'ETH',
2042
+ decimals: 18,
2043
+ },
2044
+ chainId: 324,
2045
+ isTestnet: false,
2046
+ explorerUrl: 'https://explorer.zksync.io/tx/{hash}',
2047
+ rpcEndpoints: ['https://mainnet.era.zksync.io'],
2048
+ eurcAddress: null,
2049
+ usdcAddress: '0x1d17CBcF0D6D143135aE902365D2E5e2A16538D4',
2050
+ cctp: null,
2051
+ });
2052
+
2053
+ /**
2054
+ * ZKSync Era Sepolia Testnet chain definition
2055
+ * @remarks
2056
+ * This represents the official test network for the ZKSync Era blockchain on Sepolia.
2057
+ */
2058
+ defineChain({
2059
+ type: 'evm',
2060
+ chain: Blockchain.ZKSync_Sepolia,
2061
+ name: 'ZKSync Era Sepolia',
2062
+ title: 'ZKSync Era Sepolia Testnet',
2063
+ nativeCurrency: {
2064
+ name: 'Sepolia Ether',
2065
+ symbol: 'ETH',
2066
+ decimals: 18,
2067
+ },
2068
+ chainId: 300,
2069
+ isTestnet: true,
2070
+ explorerUrl: 'https://sepolia.explorer.zksync.io/tx/{hash}',
2071
+ rpcEndpoints: ['https://sepolia.era.zksync.dev'],
2072
+ eurcAddress: null,
2073
+ usdcAddress: '0xAe045DE5638162fa134807Cb558E15A3F5A7F853',
2074
+ cctp: null,
2075
+ });
2076
+
2077
+ /**
2078
+ * Base schema for common chain definition properties.
2079
+ * This contains all properties shared between EVM and non-EVM chains.
2080
+ */
2081
+ const baseChainDefinitionSchema = zod.z.object({
2082
+ chain: zod.z.nativeEnum(Blockchain, {
2083
+ required_error: 'Chain enum is required. Please provide a valid Blockchain enum value.',
2084
+ invalid_type_error: 'Chain must be a valid Blockchain enum value.',
2085
+ }),
2086
+ name: zod.z.string({
2087
+ required_error: 'Chain name is required. Please provide a valid chain name.',
2088
+ invalid_type_error: 'Chain name must be a string.',
2089
+ }),
2090
+ title: zod.z.string().optional(),
2091
+ nativeCurrency: zod.z.object({
2092
+ name: zod.z.string(),
2093
+ symbol: zod.z.string(),
2094
+ decimals: zod.z.number(),
2095
+ }),
2096
+ isTestnet: zod.z.boolean({
2097
+ required_error: 'isTestnet is required. Please specify whether this is a testnet.',
2098
+ invalid_type_error: 'isTestnet must be a boolean.',
2099
+ }),
2100
+ explorerUrl: zod.z.string({
2101
+ required_error: 'Explorer URL is required. Please provide a valid explorer URL.',
2102
+ invalid_type_error: 'Explorer URL must be a string.',
2103
+ }),
2104
+ rpcEndpoints: zod.z.array(zod.z.string()),
2105
+ eurcAddress: zod.z.string().nullable(),
2106
+ usdcAddress: zod.z.string().nullable(),
2107
+ cctp: zod.z.any().nullable(), // We'll accept any CCTP config structure
2108
+ kitContracts: zod.z
2109
+ .object({
2110
+ bridge: zod.z.string().optional(),
2111
+ })
2112
+ .optional(),
2113
+ });
2114
+ /**
2115
+ * Zod schema for validating EVM chain definitions specifically.
2116
+ * This schema extends the base schema with EVM-specific properties.
2117
+ *
2118
+ * @example
2119
+ * ```typescript
2120
+ * import { evmChainDefinitionSchema } from '@core/chains/validation'
2121
+ * import { Blockchain } from '@core/chains'
2122
+ *
2123
+ * const ethereumChain = {
2124
+ * type: 'evm',
2125
+ * chain: Blockchain.Ethereum,
2126
+ * name: 'Ethereum',
2127
+ * chainId: 1,
2128
+ * nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
2129
+ * isTestnet: false,
2130
+ * explorerUrl: 'https://etherscan.io/tx/{hash}',
2131
+ * usdcAddress: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
2132
+ * eurcAddress: null,
2133
+ * cctp: null
2134
+ * }
2135
+ *
2136
+ * const result = evmChainDefinitionSchema.safeParse(ethereumChain)
2137
+ * if (result.success) {
2138
+ * console.log('EVM chain definition is valid')
2139
+ * } else {
2140
+ * console.error('Validation failed:', result.error)
2141
+ * }
2142
+ * ```
2143
+ */
2144
+ const evmChainDefinitionSchema = baseChainDefinitionSchema
2145
+ .extend({
2146
+ type: zod.z.literal('evm'),
2147
+ chainId: zod.z.number({
2148
+ required_error: 'EVM chains must have a chainId. Please provide a valid EVM chain ID.',
2149
+ invalid_type_error: 'EVM chain ID must be a number.',
2150
+ }),
2151
+ })
2152
+ .strict(); //// Reject any additional properties not defined in the schema
2153
+ /**
2154
+ * Zod schema for validating non-EVM chain definitions.
2155
+ * This schema extends the base schema with non-EVM specific properties.
2156
+ */
2157
+ const nonEvmChainDefinitionSchema = baseChainDefinitionSchema
2158
+ .extend({
2159
+ type: zod.z.enum([
2160
+ 'algorand',
2161
+ 'avalanche',
2162
+ 'solana',
2163
+ 'aptos',
2164
+ 'near',
2165
+ 'stellar',
2166
+ 'sui',
2167
+ 'hedera',
2168
+ 'noble',
2169
+ 'polkadot',
2170
+ ]),
2171
+ })
2172
+ .strict(); // Reject any additional properties not defined in the schema
2173
+ /**
2174
+ * Discriminated union schema for all chain definitions.
2175
+ * This schema validates different chain types based on their 'type' field.
2176
+ *
2177
+ * @example
2178
+ * ```typescript
2179
+ * import { chainDefinitionSchema } from '@core/chains/validation'
2180
+ * import { Blockchain } from '@core/chains'
2181
+ *
2182
+ * // EVM chain
2183
+ * chainDefinitionSchema.parse({
2184
+ * type: 'evm',
2185
+ * chain: Blockchain.Ethereum,
2186
+ * chainId: 1,
2187
+ * // ... other properties
2188
+ * })
2189
+ *
2190
+ * // Non-EVM chain
2191
+ * chainDefinitionSchema.parse({
2192
+ * type: 'solana',
2193
+ * chain: Blockchain.Solana,
2194
+ * // ... other properties (no chainId)
2195
+ * })
2196
+ * ```
2197
+ */
2198
+ const chainDefinitionSchema = zod.z.discriminatedUnion('type', [
2199
+ evmChainDefinitionSchema,
2200
+ nonEvmChainDefinitionSchema,
2201
+ ]);
2202
+ /**
2203
+ * Zod schema for validating chain identifiers.
2204
+ * This schema accepts either a string blockchain identifier, a Blockchain enum value,
2205
+ * or a full ChainDefinition object.
2206
+ *
2207
+ * @example
2208
+ * ```typescript
2209
+ * import { chainIdentifierSchema } from '@core/chains/validation'
2210
+ * import { Blockchain, Ethereum } from '@core/chains'
2211
+ *
2212
+ * // All of these are valid:
2213
+ * chainIdentifierSchema.parse('Ethereum')
2214
+ * chainIdentifierSchema.parse(Blockchain.Ethereum)
2215
+ * chainIdentifierSchema.parse(Ethereum)
2216
+ * ```
2217
+ */
2218
+ zod.z.union([
2219
+ zod.z
2220
+ .string()
2221
+ .refine((val) => val in Blockchain, 'Must be a valid Blockchain enum value as string'),
2222
+ zod.z.nativeEnum(Blockchain),
2223
+ chainDefinitionSchema,
2224
+ ]);
2225
+
2226
+ exports.Arbitrum = Arbitrum;
2227
+ exports.ArbitrumSepolia = ArbitrumSepolia;
2228
+ exports.Avalanche = Avalanche;
2229
+ exports.AvalancheFuji = AvalancheFuji;
2230
+ exports.Base = Base;
2231
+ exports.BaseSepolia = BaseSepolia;
2232
+ exports.Codex = Codex;
2233
+ exports.CodexTestnet = CodexTestnet;
2234
+ exports.Ethereum = Ethereum;
2235
+ exports.EthereumSepolia = EthereumSepolia;
2236
+ exports.Linea = Linea;
2237
+ exports.LineaSepolia = LineaSepolia;
2238
+ exports.Optimism = Optimism;
2239
+ exports.OptimismSepolia = OptimismSepolia;
2240
+ exports.Polygon = Polygon;
2241
+ exports.PolygonAmoy = PolygonAmoy;
2242
+ exports.Solana = Solana;
2243
+ exports.SolanaDevnet = SolanaDevnet;
2244
+ exports.Sonic = Sonic;
2245
+ exports.SonicTestnet = SonicTestnet;
2246
+ exports.Unichain = Unichain;
2247
+ exports.UnichainSepolia = UnichainSepolia;
2248
+ exports.WorldChain = WorldChain;
2249
+ exports.WorldChainSepolia = WorldChainSepolia;
2250
+ //# sourceMappingURL=chains.cjs.js.map