@circle-fin/app-kit 1.8.1 → 1.9.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.
Files changed (46) hide show
  1. package/CHANGELOG.md +45 -0
  2. package/README.md +3 -3
  3. package/bridge.cjs +425 -179
  4. package/bridge.d.cts +14 -0
  5. package/bridge.d.mts +14 -0
  6. package/bridge.d.ts +14 -0
  7. package/bridge.mjs +425 -179
  8. package/chains.cjs +94 -0
  9. package/chains.d.cts +2 -0
  10. package/chains.d.mts +2 -0
  11. package/chains.d.ts +2 -0
  12. package/chains.mjs +94 -0
  13. package/context.d.cts +14 -0
  14. package/context.d.mts +14 -0
  15. package/context.d.ts +14 -0
  16. package/earn.cjs +211 -30
  17. package/earn.d.cts +25 -5
  18. package/earn.d.mts +25 -5
  19. package/earn.d.ts +25 -5
  20. package/earn.mjs +211 -30
  21. package/estimateBridge.cjs +425 -179
  22. package/estimateBridge.d.cts +14 -0
  23. package/estimateBridge.d.mts +14 -0
  24. package/estimateBridge.d.ts +14 -0
  25. package/estimateBridge.mjs +425 -179
  26. package/estimateSwap.cjs +108 -7
  27. package/estimateSwap.d.cts +14 -0
  28. package/estimateSwap.d.mts +14 -0
  29. package/estimateSwap.d.ts +14 -0
  30. package/estimateSwap.mjs +108 -7
  31. package/index.cjs +586 -224
  32. package/index.d.cts +274 -17
  33. package/index.d.mts +274 -17
  34. package/index.d.ts +274 -17
  35. package/index.mjs +586 -224
  36. package/package.json +12 -6
  37. package/swap.cjs +108 -7
  38. package/swap.d.cts +14 -0
  39. package/swap.d.mts +14 -0
  40. package/swap.d.ts +14 -0
  41. package/swap.mjs +108 -7
  42. package/unifiedBalance.cjs +101 -1
  43. package/unifiedBalance.d.cts +2 -0
  44. package/unifiedBalance.d.mts +2 -0
  45. package/unifiedBalance.d.ts +2 -0
  46. package/unifiedBalance.mjs +101 -1
package/chains.cjs CHANGED
@@ -63,6 +63,8 @@ var zod = require('zod');
63
63
  Blockchain["Celo_Alfajores_Testnet"] = "Celo_Alfajores_Testnet";
64
64
  Blockchain["Codex"] = "Codex";
65
65
  Blockchain["Codex_Testnet"] = "Codex_Testnet";
66
+ Blockchain["Cronos"] = "Cronos";
67
+ Blockchain["Cronos_Testnet"] = "Cronos_Testnet";
66
68
  Blockchain["Edge"] = "Edge";
67
69
  Blockchain["Edge_Testnet"] = "Edge_Testnet";
68
70
  Blockchain["Ethereum"] = "Ethereum";
@@ -145,6 +147,7 @@ var BridgeChain;
145
147
  BridgeChain["Avalanche"] = "Avalanche";
146
148
  BridgeChain["Base"] = "Base";
147
149
  BridgeChain["Codex"] = "Codex";
150
+ BridgeChain["Cronos"] = "Cronos";
148
151
  BridgeChain["Edge"] = "Edge";
149
152
  BridgeChain["Ethereum"] = "Ethereum";
150
153
  BridgeChain["HyperEVM"] = "HyperEVM";
@@ -169,6 +172,7 @@ var BridgeChain;
169
172
  BridgeChain["Avalanche_Fuji"] = "Avalanche_Fuji";
170
173
  BridgeChain["Base_Sepolia"] = "Base_Sepolia";
171
174
  BridgeChain["Codex_Testnet"] = "Codex_Testnet";
175
+ BridgeChain["Cronos_Testnet"] = "Cronos_Testnet";
172
176
  BridgeChain["Edge_Testnet"] = "Edge_Testnet";
173
177
  BridgeChain["Ethereum_Sepolia"] = "Ethereum_Sepolia";
174
178
  BridgeChain["HyperEVM_Testnet"] = "HyperEVM_Testnet";
@@ -1214,6 +1218,96 @@ var EarnChain;
1214
1218
  }
1215
1219
  });
1216
1220
 
1221
+ /**
1222
+ * Cronos Mainnet chain definition
1223
+ * @remarks
1224
+ * This represents the official production network for the Cronos blockchain.
1225
+ * Cronos is an EVM-compatible blockchain.
1226
+ */ defineChain({
1227
+ type: 'evm',
1228
+ chain: Blockchain.Cronos,
1229
+ name: 'Cronos',
1230
+ title: 'Cronos Mainnet',
1231
+ nativeCurrency: {
1232
+ name: 'Cronos',
1233
+ symbol: 'CRO',
1234
+ decimals: 18
1235
+ },
1236
+ chainId: 25,
1237
+ isTestnet: false,
1238
+ explorerUrl: 'https://cronoscan.com/tx/{hash}',
1239
+ rpcEndpoints: [
1240
+ 'https://evm.cronos.org'
1241
+ ],
1242
+ eurcAddress: '0xA6dE01a2d62C6B5f3525d768f34d276652C554c8',
1243
+ usdcAddress: '0x3D7F2C478aAfdB65542BCB44bCeeC05849999d2D',
1244
+ usdtAddress: null,
1245
+ cctp: {
1246
+ domain: 32,
1247
+ contracts: {
1248
+ v2: {
1249
+ type: 'split',
1250
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
1251
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
1252
+ confirmations: 1,
1253
+ fastConfirmations: 1
1254
+ }
1255
+ },
1256
+ forwarderSupported: {
1257
+ source: false,
1258
+ destination: false
1259
+ }
1260
+ },
1261
+ kitContracts: {
1262
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET
1263
+ }
1264
+ });
1265
+
1266
+ /**
1267
+ * Cronos Testnet chain definition
1268
+ * @remarks
1269
+ * This represents the official test network for the Cronos blockchain.
1270
+ * Cronos is an EVM-compatible blockchain.
1271
+ */ defineChain({
1272
+ type: 'evm',
1273
+ chain: Blockchain.Cronos_Testnet,
1274
+ name: 'Cronos Testnet',
1275
+ title: 'Cronos Testnet',
1276
+ nativeCurrency: {
1277
+ name: 'CRO',
1278
+ symbol: 'tCRO',
1279
+ decimals: 18
1280
+ },
1281
+ chainId: 338,
1282
+ isTestnet: true,
1283
+ explorerUrl: 'https://explorer.cronos.org/testnet/tx/{hash}',
1284
+ rpcEndpoints: [
1285
+ 'https://evm-t3.cronos.org'
1286
+ ],
1287
+ eurcAddress: '0x31f7538adb53cF16350e6B0c89d03D91b7D12c46',
1288
+ usdcAddress: '0xEb33dc5fac03833e132593659e1dE7256aB59794',
1289
+ usdtAddress: null,
1290
+ cctp: {
1291
+ domain: 32,
1292
+ contracts: {
1293
+ v2: {
1294
+ type: 'split',
1295
+ tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
1296
+ messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
1297
+ confirmations: 1,
1298
+ fastConfirmations: 1
1299
+ }
1300
+ },
1301
+ forwarderSupported: {
1302
+ source: false,
1303
+ destination: false
1304
+ }
1305
+ },
1306
+ kitContracts: {
1307
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET
1308
+ }
1309
+ });
1310
+
1217
1311
  /**
1218
1312
  * Edge Mainnet chain definition
1219
1313
  * @remarks
package/chains.d.cts CHANGED
@@ -44,6 +44,8 @@ declare enum Blockchain {
44
44
  Celo_Alfajores_Testnet = "Celo_Alfajores_Testnet",
45
45
  Codex = "Codex",
46
46
  Codex_Testnet = "Codex_Testnet",
47
+ Cronos = "Cronos",
48
+ Cronos_Testnet = "Cronos_Testnet",
47
49
  Edge = "Edge",
48
50
  Edge_Testnet = "Edge_Testnet",
49
51
  Ethereum = "Ethereum",
package/chains.d.mts CHANGED
@@ -44,6 +44,8 @@ declare enum Blockchain {
44
44
  Celo_Alfajores_Testnet = "Celo_Alfajores_Testnet",
45
45
  Codex = "Codex",
46
46
  Codex_Testnet = "Codex_Testnet",
47
+ Cronos = "Cronos",
48
+ Cronos_Testnet = "Cronos_Testnet",
47
49
  Edge = "Edge",
48
50
  Edge_Testnet = "Edge_Testnet",
49
51
  Ethereum = "Ethereum",
package/chains.d.ts CHANGED
@@ -44,6 +44,8 @@ declare enum Blockchain {
44
44
  Celo_Alfajores_Testnet = "Celo_Alfajores_Testnet",
45
45
  Codex = "Codex",
46
46
  Codex_Testnet = "Codex_Testnet",
47
+ Cronos = "Cronos",
48
+ Cronos_Testnet = "Cronos_Testnet",
47
49
  Edge = "Edge",
48
50
  Edge_Testnet = "Edge_Testnet",
49
51
  Ethereum = "Ethereum",
package/chains.mjs CHANGED
@@ -61,6 +61,8 @@ import { z } from 'zod';
61
61
  Blockchain["Celo_Alfajores_Testnet"] = "Celo_Alfajores_Testnet";
62
62
  Blockchain["Codex"] = "Codex";
63
63
  Blockchain["Codex_Testnet"] = "Codex_Testnet";
64
+ Blockchain["Cronos"] = "Cronos";
65
+ Blockchain["Cronos_Testnet"] = "Cronos_Testnet";
64
66
  Blockchain["Edge"] = "Edge";
65
67
  Blockchain["Edge_Testnet"] = "Edge_Testnet";
66
68
  Blockchain["Ethereum"] = "Ethereum";
@@ -143,6 +145,7 @@ var BridgeChain;
143
145
  BridgeChain["Avalanche"] = "Avalanche";
144
146
  BridgeChain["Base"] = "Base";
145
147
  BridgeChain["Codex"] = "Codex";
148
+ BridgeChain["Cronos"] = "Cronos";
146
149
  BridgeChain["Edge"] = "Edge";
147
150
  BridgeChain["Ethereum"] = "Ethereum";
148
151
  BridgeChain["HyperEVM"] = "HyperEVM";
@@ -167,6 +170,7 @@ var BridgeChain;
167
170
  BridgeChain["Avalanche_Fuji"] = "Avalanche_Fuji";
168
171
  BridgeChain["Base_Sepolia"] = "Base_Sepolia";
169
172
  BridgeChain["Codex_Testnet"] = "Codex_Testnet";
173
+ BridgeChain["Cronos_Testnet"] = "Cronos_Testnet";
170
174
  BridgeChain["Edge_Testnet"] = "Edge_Testnet";
171
175
  BridgeChain["Ethereum_Sepolia"] = "Ethereum_Sepolia";
172
176
  BridgeChain["HyperEVM_Testnet"] = "HyperEVM_Testnet";
@@ -1212,6 +1216,96 @@ var EarnChain;
1212
1216
  }
1213
1217
  });
1214
1218
 
1219
+ /**
1220
+ * Cronos Mainnet chain definition
1221
+ * @remarks
1222
+ * This represents the official production network for the Cronos blockchain.
1223
+ * Cronos is an EVM-compatible blockchain.
1224
+ */ defineChain({
1225
+ type: 'evm',
1226
+ chain: Blockchain.Cronos,
1227
+ name: 'Cronos',
1228
+ title: 'Cronos Mainnet',
1229
+ nativeCurrency: {
1230
+ name: 'Cronos',
1231
+ symbol: 'CRO',
1232
+ decimals: 18
1233
+ },
1234
+ chainId: 25,
1235
+ isTestnet: false,
1236
+ explorerUrl: 'https://cronoscan.com/tx/{hash}',
1237
+ rpcEndpoints: [
1238
+ 'https://evm.cronos.org'
1239
+ ],
1240
+ eurcAddress: '0xA6dE01a2d62C6B5f3525d768f34d276652C554c8',
1241
+ usdcAddress: '0x3D7F2C478aAfdB65542BCB44bCeeC05849999d2D',
1242
+ usdtAddress: null,
1243
+ cctp: {
1244
+ domain: 32,
1245
+ contracts: {
1246
+ v2: {
1247
+ type: 'split',
1248
+ tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
1249
+ messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
1250
+ confirmations: 1,
1251
+ fastConfirmations: 1
1252
+ }
1253
+ },
1254
+ forwarderSupported: {
1255
+ source: false,
1256
+ destination: false
1257
+ }
1258
+ },
1259
+ kitContracts: {
1260
+ bridge: BRIDGE_CONTRACT_EVM_MAINNET
1261
+ }
1262
+ });
1263
+
1264
+ /**
1265
+ * Cronos Testnet chain definition
1266
+ * @remarks
1267
+ * This represents the official test network for the Cronos blockchain.
1268
+ * Cronos is an EVM-compatible blockchain.
1269
+ */ defineChain({
1270
+ type: 'evm',
1271
+ chain: Blockchain.Cronos_Testnet,
1272
+ name: 'Cronos Testnet',
1273
+ title: 'Cronos Testnet',
1274
+ nativeCurrency: {
1275
+ name: 'CRO',
1276
+ symbol: 'tCRO',
1277
+ decimals: 18
1278
+ },
1279
+ chainId: 338,
1280
+ isTestnet: true,
1281
+ explorerUrl: 'https://explorer.cronos.org/testnet/tx/{hash}',
1282
+ rpcEndpoints: [
1283
+ 'https://evm-t3.cronos.org'
1284
+ ],
1285
+ eurcAddress: '0x31f7538adb53cF16350e6B0c89d03D91b7D12c46',
1286
+ usdcAddress: '0xEb33dc5fac03833e132593659e1dE7256aB59794',
1287
+ usdtAddress: null,
1288
+ cctp: {
1289
+ domain: 32,
1290
+ contracts: {
1291
+ v2: {
1292
+ type: 'split',
1293
+ tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
1294
+ messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
1295
+ confirmations: 1,
1296
+ fastConfirmations: 1
1297
+ }
1298
+ },
1299
+ forwarderSupported: {
1300
+ source: false,
1301
+ destination: false
1302
+ }
1303
+ },
1304
+ kitContracts: {
1305
+ bridge: BRIDGE_CONTRACT_EVM_TESTNET
1306
+ }
1307
+ });
1308
+
1215
1309
  /**
1216
1310
  * Edge Mainnet chain definition
1217
1311
  * @remarks
package/context.d.cts CHANGED
@@ -659,6 +659,8 @@ declare enum Blockchain {
659
659
  Celo_Alfajores_Testnet = "Celo_Alfajores_Testnet",
660
660
  Codex = "Codex",
661
661
  Codex_Testnet = "Codex_Testnet",
662
+ Cronos = "Cronos",
663
+ Cronos_Testnet = "Cronos_Testnet",
662
664
  Edge = "Edge",
663
665
  Edge_Testnet = "Edge_Testnet",
664
666
  Ethereum = "Ethereum",
@@ -900,6 +902,7 @@ declare enum BridgeChain {
900
902
  Avalanche = "Avalanche",
901
903
  Base = "Base",
902
904
  Codex = "Codex",
905
+ Cronos = "Cronos",
903
906
  Edge = "Edge",
904
907
  Ethereum = "Ethereum",
905
908
  HyperEVM = "HyperEVM",
@@ -923,6 +926,7 @@ declare enum BridgeChain {
923
926
  Avalanche_Fuji = "Avalanche_Fuji",
924
927
  Base_Sepolia = "Base_Sepolia",
925
928
  Codex_Testnet = "Codex_Testnet",
929
+ Cronos_Testnet = "Cronos_Testnet",
926
930
  Edge_Testnet = "Edge_Testnet",
927
931
  Ethereum_Sepolia = "Ethereum_Sepolia",
928
932
  HyperEVM_Testnet = "HyperEVM_Testnet",
@@ -6374,6 +6378,16 @@ interface AppKitContext {
6374
6378
  * @defaultValue false
6375
6379
  */
6376
6380
  disableErrorReporting?: boolean;
6381
+ /**
6382
+ * Custom HTTP headers forwarded with the underlying CCTP provider's
6383
+ * attestation (Iris) API requests made by bridge operations.
6384
+ *
6385
+ * @remarks
6386
+ * Headers are merged on top of the SDK defaults (such as `Content-Type`)
6387
+ * rather than replacing them. The header is forwarded as-is to Circle's API;
6388
+ * the SDK does not interpret it.
6389
+ */
6390
+ headers?: Record<string, string>;
6377
6391
  }
6378
6392
 
6379
6393
  /**
package/context.d.mts CHANGED
@@ -659,6 +659,8 @@ declare enum Blockchain {
659
659
  Celo_Alfajores_Testnet = "Celo_Alfajores_Testnet",
660
660
  Codex = "Codex",
661
661
  Codex_Testnet = "Codex_Testnet",
662
+ Cronos = "Cronos",
663
+ Cronos_Testnet = "Cronos_Testnet",
662
664
  Edge = "Edge",
663
665
  Edge_Testnet = "Edge_Testnet",
664
666
  Ethereum = "Ethereum",
@@ -900,6 +902,7 @@ declare enum BridgeChain {
900
902
  Avalanche = "Avalanche",
901
903
  Base = "Base",
902
904
  Codex = "Codex",
905
+ Cronos = "Cronos",
903
906
  Edge = "Edge",
904
907
  Ethereum = "Ethereum",
905
908
  HyperEVM = "HyperEVM",
@@ -923,6 +926,7 @@ declare enum BridgeChain {
923
926
  Avalanche_Fuji = "Avalanche_Fuji",
924
927
  Base_Sepolia = "Base_Sepolia",
925
928
  Codex_Testnet = "Codex_Testnet",
929
+ Cronos_Testnet = "Cronos_Testnet",
926
930
  Edge_Testnet = "Edge_Testnet",
927
931
  Ethereum_Sepolia = "Ethereum_Sepolia",
928
932
  HyperEVM_Testnet = "HyperEVM_Testnet",
@@ -6374,6 +6378,16 @@ interface AppKitContext {
6374
6378
  * @defaultValue false
6375
6379
  */
6376
6380
  disableErrorReporting?: boolean;
6381
+ /**
6382
+ * Custom HTTP headers forwarded with the underlying CCTP provider's
6383
+ * attestation (Iris) API requests made by bridge operations.
6384
+ *
6385
+ * @remarks
6386
+ * Headers are merged on top of the SDK defaults (such as `Content-Type`)
6387
+ * rather than replacing them. The header is forwarded as-is to Circle's API;
6388
+ * the SDK does not interpret it.
6389
+ */
6390
+ headers?: Record<string, string>;
6377
6391
  }
6378
6392
 
6379
6393
  /**
package/context.d.ts CHANGED
@@ -659,6 +659,8 @@ declare enum Blockchain {
659
659
  Celo_Alfajores_Testnet = "Celo_Alfajores_Testnet",
660
660
  Codex = "Codex",
661
661
  Codex_Testnet = "Codex_Testnet",
662
+ Cronos = "Cronos",
663
+ Cronos_Testnet = "Cronos_Testnet",
662
664
  Edge = "Edge",
663
665
  Edge_Testnet = "Edge_Testnet",
664
666
  Ethereum = "Ethereum",
@@ -900,6 +902,7 @@ declare enum BridgeChain {
900
902
  Avalanche = "Avalanche",
901
903
  Base = "Base",
902
904
  Codex = "Codex",
905
+ Cronos = "Cronos",
903
906
  Edge = "Edge",
904
907
  Ethereum = "Ethereum",
905
908
  HyperEVM = "HyperEVM",
@@ -923,6 +926,7 @@ declare enum BridgeChain {
923
926
  Avalanche_Fuji = "Avalanche_Fuji",
924
927
  Base_Sepolia = "Base_Sepolia",
925
928
  Codex_Testnet = "Codex_Testnet",
929
+ Cronos_Testnet = "Cronos_Testnet",
926
930
  Edge_Testnet = "Edge_Testnet",
927
931
  Ethereum_Sepolia = "Ethereum_Sepolia",
928
932
  HyperEVM_Testnet = "HyperEVM_Testnet",
@@ -6374,6 +6378,16 @@ interface AppKitContext {
6374
6378
  * @defaultValue false
6375
6379
  */
6376
6380
  disableErrorReporting?: boolean;
6381
+ /**
6382
+ * Custom HTTP headers forwarded with the underlying CCTP provider's
6383
+ * attestation (Iris) API requests made by bridge operations.
6384
+ *
6385
+ * @remarks
6386
+ * Headers are merged on top of the SDK defaults (such as `Content-Type`)
6387
+ * rather than replacing them. The header is forwarded as-is to Circle's API;
6388
+ * the SDK does not interpret it.
6389
+ */
6390
+ headers?: Record<string, string>;
6377
6391
  }
6378
6392
 
6379
6393
  /**