@cetusprotocol/aggregator-sdk 1.1.2 → 1.1.4

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 (28) hide show
  1. package/.claude/settings.local.json +41 -0
  2. package/dist/index.d.mts +6 -3
  3. package/dist/index.d.ts +6 -3
  4. package/dist/index.js +86 -52
  5. package/dist/index.mjs +86 -52
  6. package/package.json +2 -2
  7. package/.github/workflows/test.yml +0 -152
  8. package/.vscode/settings.json +0 -8
  9. package/CLAUDE.md +0 -101
  10. package/benchmark-results/benchmark-results-2025-07-17T12-03-15-563Z.csv +0 -3
  11. package/benchmark-results/benchmark-results-2025-07-17T12-03-15-563Z.json +0 -56
  12. package/benchmark-results/benchmark-results-2025-07-17T12-03-34-148Z.csv +0 -3
  13. package/benchmark-results/benchmark-results-2025-07-17T12-03-34-148Z.json +0 -56
  14. package/benchmark-results/benchmark-results-2025-07-21T03-31-59-263Z.csv +0 -21
  15. package/benchmark-results/benchmark-results-2025-07-21T03-31-59-263Z.json +0 -444
  16. package/benchmark-results/benchmark-results-2025-07-21T07-54-54-916Z.csv +0 -21
  17. package/benchmark-results/benchmark-results-2025-07-21T07-54-54-916Z.json +0 -503
  18. package/benchmark-results/error-report-2025-07-17T12-03-34-148Z.md +0 -18
  19. package/benchmark-results/error-report-2025-07-21T03-31-59-263Z.md +0 -18
  20. package/benchmark-results/error-report-2025-07-21T07-54-54-916Z.md +0 -18
  21. package/benchmark-results/gas-analysis-report-2025-07-17T12-03-15-563Z.md +0 -80
  22. package/benchmark-results/gas-analysis-report-2025-07-17T12-03-34-148Z.md +0 -80
  23. package/benchmark-results/gas-analysis-report-2025-07-21T03-31-59-263Z.md +0 -296
  24. package/benchmark-results/gas-analysis-report-2025-07-21T07-54-54-916Z.md +0 -323
  25. package/docs/Cetus_Aggregator_V3_/346/216/245/345/217/243/346/226/207/346/241/243.md +0 -706
  26. package/docs/REFACTOR.md +0 -24
  27. package/docs//350/267/257/345/276/204/346/213/223/346/211/221/346/216/222/345/272/217.md +0 -208
  28. package/script/copy-to-sui-aggregator.sh +0 -85
@@ -1,503 +0,0 @@
1
- {
2
- "v2": [
3
- {
4
- "gasMetrics": {
5
- "computationCost": "1420000",
6
- "storageCost": "21378800",
7
- "storageRebate": "20186892",
8
- "nonRefundableStorageFee": "203908",
9
- "totalGasCost": "2815816",
10
- "gasUsed": "1420000",
11
- "gasPrice": "1000",
12
- "success": true
13
- },
14
- "amountIn": "4c4b40",
15
- "amountOut": "4a7c4250",
16
- "priceImpact": -24893.14,
17
- "gasEfficiency": 443,
18
- "provider": "MAGMA",
19
- "route": [
20
- "MAGMA",
21
- "MAGMA"
22
- ],
23
- "timestamp": 1753084009245,
24
- "originalPathCount": 2,
25
- "mergedPathCount": 2
26
- },
27
- {
28
- "gasMetrics": {
29
- "computationCost": "1420000",
30
- "storageCost": "40910800",
31
- "storageRebate": "39523572",
32
- "nonRefundableStorageFee": "399228",
33
- "totalGasCost": "3206456",
34
- "gasUsed": "1420000",
35
- "gasPrice": "1000",
36
- "success": true
37
- },
38
- "amountIn": "02faf080",
39
- "amountOut": "02e8a4c520",
40
- "priceImpact": -24886.09,
41
- "gasEfficiency": 3896,
42
- "provider": "MAGMA",
43
- "route": [
44
- "MAGMA",
45
- "MAGMA",
46
- "MAGMA"
47
- ],
48
- "timestamp": 1753084017093,
49
- "originalPathCount": 3,
50
- "mergedPathCount": 3
51
- },
52
- {
53
- "gasMetrics": {
54
- "computationCost": "1420000",
55
- "storageCost": "54134800",
56
- "storageRebate": "52615332",
57
- "nonRefundableStorageFee": "531468",
58
- "totalGasCost": "3470936",
59
- "gasUsed": "1420000",
60
- "gasPrice": "1000",
61
- "success": true
62
- },
63
- "amountIn": "1dcd6500",
64
- "amountOut": "1d0dbbef55",
65
- "priceImpact": -24856.89,
66
- "gasEfficiency": 35951,
67
- "provider": "MAGMA",
68
- "route": [
69
- "MAGMA",
70
- "MAGMA",
71
- "MAGMA",
72
- "MAGMA"
73
- ],
74
- "timestamp": 1753084025711,
75
- "originalPathCount": 4,
76
- "mergedPathCount": 4
77
- },
78
- {
79
- "gasMetrics": {
80
- "computationCost": "2130000",
81
- "storageCost": "108626800",
82
- "storageRebate": "106562412",
83
- "nonRefundableStorageFee": "1076388",
84
- "totalGasCost": "5270776",
85
- "gasUsed": "2130000",
86
- "gasPrice": "1000",
87
- "success": true
88
- },
89
- "amountIn": "174876e800",
90
- "amountOut": "165f68adc8a0",
91
- "priceImpact": -24499.03,
92
- "gasEfficiency": 4667061,
93
- "provider": "MAGMA",
94
- "route": [
95
- "MAGMA",
96
- "MAGMA"
97
- ],
98
- "timestamp": 1753084037553,
99
- "originalPathCount": 2,
100
- "mergedPathCount": 2
101
- },
102
- {
103
- "gasMetrics": {
104
- "computationCost": "710000",
105
- "storageCost": "16446400",
106
- "storageRebate": "15303816",
107
- "nonRefundableStorageFee": "154584",
108
- "totalGasCost": "2007168",
109
- "gasUsed": "710000",
110
- "gasPrice": "1000",
111
- "success": true
112
- },
113
- "amountIn": "07a120",
114
- "amountOut": "0772d4ea",
115
- "priceImpact": -24893.22,
116
- "gasEfficiency": 62,
117
- "provider": "CETUS",
118
- "route": [
119
- "CETUS -> CETUS"
120
- ],
121
- "timestamp": 1753084050469,
122
- "originalPathCount": 2,
123
- "mergedPathCount": 2
124
- },
125
- {
126
- "gasMetrics": {
127
- "computationCost": "710000",
128
- "storageCost": "10298000",
129
- "storageRebate": "9216900",
130
- "nonRefundableStorageFee": "93100",
131
- "totalGasCost": "1884200",
132
- "gasUsed": "710000",
133
- "gasPrice": "1000",
134
- "success": true
135
- },
136
- "amountIn": "4c4b40",
137
- "amountOut": "4a78851b",
138
- "priceImpact": -24888.24,
139
- "gasEfficiency": 663,
140
- "provider": "CETUS",
141
- "route": [
142
- "CETUS"
143
- ],
144
- "timestamp": 1753084061383,
145
- "originalPathCount": 1,
146
- "mergedPathCount": 1
147
- },
148
- {
149
- "gasMetrics": {
150
- "computationCost": "710000",
151
- "storageCost": "17814400",
152
- "storageRebate": "16658136",
153
- "nonRefundableStorageFee": "168264",
154
- "totalGasCost": "2034528",
155
- "gasUsed": "710000",
156
- "gasPrice": "1000",
157
- "success": true
158
- },
159
- "amountIn": "02faf080",
160
- "amountOut": "02e896dab4",
161
- "priceImpact": -24884.27,
162
- "gasEfficiency": 6140,
163
- "provider": "CETUS",
164
- "route": [
165
- "CETUS",
166
- "CETUS"
167
- ],
168
- "timestamp": 1753084073839,
169
- "originalPathCount": 2,
170
- "mergedPathCount": 2
171
- },
172
- {
173
- "gasMetrics": {
174
- "computationCost": "710000",
175
- "storageCost": "11757200",
176
- "storageRebate": "10661508",
177
- "nonRefundableStorageFee": "107692",
178
- "totalGasCost": "1913384",
179
- "gasUsed": "710000",
180
- "gasPrice": "1000",
181
- "success": true
182
- },
183
- "amountIn": "02540be400",
184
- "amountOut": "024599aebb53",
185
- "priceImpact": -24879.54,
186
- "gasEfficiency": 1305516,
187
- "provider": "CETUS",
188
- "route": [
189
- "CETUS"
190
- ],
191
- "timestamp": 1753084089280,
192
- "originalPathCount": 1,
193
- "mergedPathCount": 1
194
- },
195
- {
196
- "gasMetrics": {
197
- "computationCost": "710000",
198
- "storageCost": "17814400",
199
- "storageRebate": "16658136",
200
- "nonRefundableStorageFee": "168264",
201
- "totalGasCost": "2034528",
202
- "gasUsed": "710000",
203
- "gasPrice": "1000",
204
- "success": true
205
- },
206
- "amountIn": "02540be400",
207
- "amountOut": "0262503d",
208
- "priceImpact": 99.6,
209
- "gasEfficiency": 19,
210
- "provider": "CETUS",
211
- "route": [
212
- "CETUS",
213
- "CETUS"
214
- ],
215
- "timestamp": 1753084250912,
216
- "originalPathCount": 2,
217
- "mergedPathCount": 2
218
- },
219
- {
220
- "gasMetrics": {
221
- "computationCost": "3550000",
222
- "storageCost": "67693200",
223
- "storageRebate": "66038148",
224
- "nonRefundableStorageFee": "667052",
225
- "totalGasCost": "5872104",
226
- "gasUsed": "3550000",
227
- "gasPrice": "1000",
228
- "success": true
229
- },
230
- "amountIn": "174876e800",
231
- "amountOut": "17cd8677",
232
- "priceImpact": 99.6,
233
- "gasEfficiency": 68,
234
- "provider": "CETUS",
235
- "route": [
236
- "CETUS",
237
- "CETUS -> CETUS",
238
- "CETUS -> CETUS",
239
- "CETUS -> CETUS -> CETUS",
240
- "CETUS",
241
- "CETUS -> CETUS"
242
- ],
243
- "timestamp": 1753084442109,
244
- "originalPathCount": 11,
245
- "mergedPathCount": 11
246
- }
247
- ],
248
- "v3": [
249
- {
250
- "gasMetrics": {
251
- "computationCost": "710000",
252
- "storageCost": "21378800",
253
- "storageRebate": "20186892",
254
- "nonRefundableStorageFee": "203908",
255
- "totalGasCost": "2105816",
256
- "gasUsed": "710000",
257
- "gasPrice": "1000",
258
- "success": true
259
- },
260
- "amountIn": "4c4b40",
261
- "amountOut": "4a7c4250",
262
- "priceImpact": -24893.14,
263
- "gasEfficiency": 593,
264
- "provider": "MAGMA",
265
- "route": [
266
- "MAGMA",
267
- "MAGMA"
268
- ],
269
- "timestamp": 1753084011913,
270
- "originalPathCount": 2,
271
- "mergedPathCount": 2
272
- },
273
- {
274
- "gasMetrics": {
275
- "computationCost": "710000",
276
- "storageCost": "40910800",
277
- "storageRebate": "39523572",
278
- "nonRefundableStorageFee": "399228",
279
- "totalGasCost": "2496456",
280
- "gasUsed": "710000",
281
- "gasPrice": "1000",
282
- "success": true
283
- },
284
- "amountIn": "02faf080",
285
- "amountOut": "02e8a4c520",
286
- "priceImpact": -24886.09,
287
- "gasEfficiency": 5004,
288
- "provider": "MAGMA",
289
- "route": [
290
- "MAGMA",
291
- "MAGMA",
292
- "MAGMA"
293
- ],
294
- "timestamp": 1753084019807,
295
- "originalPathCount": 3,
296
- "mergedPathCount": 3
297
- },
298
- {
299
- "gasMetrics": {
300
- "computationCost": "1420000",
301
- "storageCost": "54134800",
302
- "storageRebate": "52615332",
303
- "nonRefundableStorageFee": "531468",
304
- "totalGasCost": "3470936",
305
- "gasUsed": "1420000",
306
- "gasPrice": "1000",
307
- "success": true
308
- },
309
- "amountIn": "1dcd6500",
310
- "amountOut": "1d0dabcb03",
311
- "priceImpact": -24856.68,
312
- "gasEfficiency": 35950,
313
- "provider": "MAGMA",
314
- "route": [
315
- "MAGMA",
316
- "MAGMA",
317
- "MAGMA",
318
- "MAGMA"
319
- ],
320
- "timestamp": 1753084028301,
321
- "originalPathCount": 4,
322
- "mergedPathCount": 4
323
- },
324
- {
325
- "gasMetrics": {
326
- "computationCost": "1420000",
327
- "storageCost": "108626800",
328
- "storageRebate": "106562412",
329
- "nonRefundableStorageFee": "1076388",
330
- "totalGasCost": "4560776",
331
- "gasUsed": "1420000",
332
- "gasPrice": "1000",
333
- "success": true
334
- },
335
- "amountIn": "174876e800",
336
- "amountOut": "165f68adc8a0",
337
- "priceImpact": -24499.03,
338
- "gasEfficiency": 5393607,
339
- "provider": "MAGMA",
340
- "route": [
341
- "MAGMA",
342
- "MAGMA"
343
- ],
344
- "timestamp": 1753084041285,
345
- "originalPathCount": 2,
346
- "mergedPathCount": 2
347
- },
348
- {
349
- "gasMetrics": {
350
- "computationCost": "710000",
351
- "storageCost": "16446400",
352
- "storageRebate": "15303816",
353
- "nonRefundableStorageFee": "154584",
354
- "totalGasCost": "2007168",
355
- "gasUsed": "710000",
356
- "gasPrice": "1000",
357
- "success": true
358
- },
359
- "amountIn": "07a120",
360
- "amountOut": "0772d4ea",
361
- "priceImpact": -24893.22,
362
- "gasEfficiency": 62,
363
- "provider": "CETUS",
364
- "route": [
365
- "CETUS -> CETUS"
366
- ],
367
- "timestamp": 1753084053505,
368
- "originalPathCount": 2,
369
- "mergedPathCount": 2
370
- },
371
- {
372
- "gasMetrics": {
373
- "computationCost": "710000",
374
- "storageCost": "10298000",
375
- "storageRebate": "9216900",
376
- "nonRefundableStorageFee": "93100",
377
- "totalGasCost": "1884200",
378
- "gasUsed": "710000",
379
- "gasPrice": "1000",
380
- "success": true
381
- },
382
- "amountIn": "4c4b40",
383
- "amountOut": "4a78851b",
384
- "priceImpact": -24888.24,
385
- "gasEfficiency": 663,
386
- "provider": "CETUS",
387
- "route": [
388
- "CETUS"
389
- ],
390
- "timestamp": 1753084065192,
391
- "originalPathCount": 1,
392
- "mergedPathCount": 1
393
- },
394
- {
395
- "gasMetrics": {
396
- "computationCost": "1420000",
397
- "storageCost": "31334800",
398
- "storageRebate": "30043332",
399
- "nonRefundableStorageFee": "303468",
400
- "totalGasCost": "3014936",
401
- "gasUsed": "1420000",
402
- "gasPrice": "1000",
403
- "success": true
404
- },
405
- "amountIn": "02faf080",
406
- "amountOut": "02e88e0be5",
407
- "priceImpact": -24883.11,
408
- "gasEfficiency": 4143,
409
- "provider": "CETUS",
410
- "route": [
411
- "CETUS",
412
- "CETUS",
413
- "CETUS -> CETUS"
414
- ],
415
- "timestamp": 1753084077894,
416
- "originalPathCount": 4,
417
- "mergedPathCount": 4
418
- },
419
- {
420
- "gasMetrics": {
421
- "computationCost": "710000",
422
- "storageCost": "11757200",
423
- "storageRebate": "10661508",
424
- "nonRefundableStorageFee": "107692",
425
- "totalGasCost": "1913384",
426
- "gasUsed": "710000",
427
- "gasPrice": "1000",
428
- "success": true
429
- },
430
- "amountIn": "02540be400",
431
- "amountOut": "0245985303f5",
432
- "priceImpact": -24879.31,
433
- "gasEfficiency": 1305504,
434
- "provider": "CETUS",
435
- "route": [
436
- "CETUS"
437
- ],
438
- "timestamp": 1753084093134,
439
- "originalPathCount": 1,
440
- "mergedPathCount": 1
441
- },
442
- {
443
- "gasMetrics": {
444
- "computationCost": "2840000",
445
- "storageCost": "63832400",
446
- "storageRebate": "62215956",
447
- "nonRefundableStorageFee": "628444",
448
- "totalGasCost": "5084888",
449
- "gasUsed": "2840000",
450
- "gasPrice": "1000",
451
- "success": true
452
- },
453
- "amountIn": "02540be400",
454
- "amountOut": "0261ce44",
455
- "priceImpact": 99.6,
456
- "gasEfficiency": 7,
457
- "provider": "CETUS",
458
- "route": [
459
- "CETUS -> CETUS",
460
- "CETUS -> CETUS -> CETUS",
461
- "CETUS -> CETUS -> CETUS",
462
- "CETUS -> CETUS"
463
- ],
464
- "timestamp": 1753084303624,
465
- "originalPathCount": 10,
466
- "mergedPathCount": 9
467
- },
468
- {
469
- "gasMetrics": {
470
- "computationCost": "1420000",
471
- "storageCost": "45022400",
472
- "storageRebate": "43594056",
473
- "nonRefundableStorageFee": "440344",
474
- "totalGasCost": "3288688",
475
- "gasUsed": "1420000",
476
- "gasPrice": "1000",
477
- "success": true
478
- },
479
- "amountIn": "174876e800",
480
- "amountOut": "17ce21ed",
481
- "priceImpact": 99.6,
482
- "gasEfficiency": 121,
483
- "provider": "CETUS",
484
- "route": [
485
- "CETUS",
486
- "CETUS -> CETUS",
487
- "CETUS -> CETUS -> CETUS",
488
- "CETUS"
489
- ],
490
- "timestamp": 1753084493911,
491
- "originalPathCount": 7,
492
- "mergedPathCount": 6
493
- }
494
- ],
495
- "summary": {
496
- "v2AverageGas": "3050989",
497
- "v3AverageGas": "2982724",
498
- "gasSavingsPercent": 2.23,
499
- "v2SuccessRate": 100,
500
- "v3SuccessRate": 100,
501
- "totalTests": 20
502
- }
503
- }
@@ -1,18 +0,0 @@
1
- # Cetus Aggregator Error Analysis Report
2
-
3
- **Generated**: 2025-07-17T12:03:34.164Z
4
-
5
- ## Executive Summary
6
-
7
- This report analyzes failed route discoveries and simulation errors encountered during benchmark testing.
8
-
9
- ### Error Statistics
10
-
11
- - **Total Errors**: 0
12
- - **V2 Errors**: 0
13
- - **V3 Errors**: 0
14
-
15
- ✅ **No errors encountered during testing!**
16
-
17
- All route discoveries and transaction simulations completed successfully.
18
-
@@ -1,18 +0,0 @@
1
- # Cetus Aggregator Error Analysis Report
2
-
3
- **Generated**: 2025-07-21T03:31:59.291Z
4
-
5
- ## Executive Summary
6
-
7
- This report analyzes failed route discoveries and simulation errors encountered during benchmark testing.
8
-
9
- ### Error Statistics
10
-
11
- - **Total Errors**: 0
12
- - **V2 Errors**: 0
13
- - **V3 Errors**: 0
14
-
15
- ✅ **No errors encountered during testing!**
16
-
17
- All route discoveries and transaction simulations completed successfully.
18
-
@@ -1,18 +0,0 @@
1
- # Cetus Aggregator Error Analysis Report
2
-
3
- **Generated**: 2025-07-21T07:54:54.943Z
4
-
5
- ## Executive Summary
6
-
7
- This report analyzes failed route discoveries and simulation errors encountered during benchmark testing.
8
-
9
- ### Error Statistics
10
-
11
- - **Total Errors**: 0
12
- - **V2 Errors**: 0
13
- - **V3 Errors**: 0
14
-
15
- ✅ **No errors encountered during testing!**
16
-
17
- All route discoveries and transaction simulations completed successfully.
18
-
@@ -1,80 +0,0 @@
1
- # Cetus Aggregator V2 vs V3 Gas Efficiency Analysis
2
-
3
- **Generated**: 2025-07-17T12:03:15.564Z
4
-
5
- ## Executive Summary
6
-
7
- This analysis compares gas consumption between Cetus Aggregator V2 and V3 across multiple DEX providers and trading scenarios.
8
-
9
- ### Key Metrics
10
-
11
- - **Tests Executed**: 1
12
- - **V2 Success Rate**: 100.0%
13
- - **V3 Success Rate**: 100.0%
14
- - **Average Gas Savings**: 27.78%
15
-
16
- ### Gas Consumption Comparison
17
-
18
- | Version | Average Gas (MIST) | Average Gas (SUI) | Success Tests |
19
- |---------|-------------------|-------------------|---------------|
20
- | V2 | 2555288 | 0.002555 | 1 |
21
- | V3 | 1845288 | 0.001845 | 1 |
22
-
23
- ## Analysis
24
-
25
- ### Gas Efficiency
26
-
27
- The V3 aggregator demonstrates **27.78%** average gas savings compared to V2, representing:
28
- - **0.000710 SUI** savings per transaction
29
- - **710000 MIST** reduction in gas consumption
30
-
31
- ### Performance Insights
32
-
33
- ✅ **V3 Improvements**: The V3 client shows measurable gas efficiency improvements through optimized transaction structures and better route selection algorithms.
34
-
35
- ### Success Rate Analysis
36
-
37
- ✅ **Reliability**: V3 maintains or improves success rates while optimizing gas consumption.
38
-
39
- ## Per-Config Analysis
40
-
41
- ### Test Configuration Results
42
-
43
- | Config Name | Amount Multiplier | V2 Success Rate | V3 Success Rate | V2 Avg Gas (MIST) | V3 Avg Gas (MIST) | Gas Savings |
44
- |-------------|------------------|-----------------|-----------------|-------------------|-------------------|-------------|
45
- | MagmaChecker-1_0.1x | 0.1x | 100.0% | 100.0% | 2555288 | 1845288 | 27.79% |
46
-
47
-
48
- ### Detailed Gas Breakdown by Test Case
49
-
50
- #### MagmaChecker-1_0.1x
51
-
52
- **V2 Gas Breakdown:**
53
- - Computation Cost: 1,420,000 MIST
54
- - Storage Cost: 8,352,400 MIST
55
- - Storage Rebate: -7,290,756 MIST
56
- - Non-Refundable Fee: 73,644 MIST
57
- - **Total Gas Cost: 2,555,288 MIST**
58
-
59
- **V3 Gas Breakdown:**
60
- - Computation Cost: 710,000 MIST
61
- - Storage Cost: 8,352,400 MIST
62
- - Storage Rebate: -7,290,756 MIST
63
- - Non-Refundable Fee: 73,644 MIST
64
- - **Total Gas Cost: 1,845,288 MIST**
65
-
66
- **Gas Comparison:**
67
- - Absolute Savings: 710,000 MIST
68
- - Percentage Savings: 27.79%
69
- - V2 to V3 Ratio: 0.722
70
-
71
- ---
72
-
73
-
74
-
75
- ## Conclusion
76
-
77
- The V3 aggregator client represents a significant improvement in gas efficiency, delivering meaningful cost savings for users while maintaining transaction reliability.
78
-
79
- ---
80
- *Generated by Cetus Aggregator Gas Benchmark Tool*