@cetusprotocol/aggregator-sdk 0.0.0-experimental-20250811105138 → 0.0.0-experimental-20250813193744

package/README.md

@@ -29,123 +29,7 @@ Multi-Platform Support: Currently, we have integrated multiple mainstream DEXs o
 
 By using our aggregator, you can trade more efficiently and securely on the Sui blockchain, fully leveraging the various opportunities brought by decentralized finance (DeFi).
 
-## Supported Providers
-
-The Cetus Aggregator SDK supports 25+ decentralized exchanges (DEXs) on the Sui blockchain:
-
-- **Cetus**
-- **DeepBook V3**
-- **Kriya V2/V3**
-- **FlowX V2/V3**
-- **Turbos**
-- **Aftermath**
-- **Haedal**
-- **Volo**
-- **AfSui**
-- **Bluemove**
-- **Scallop**
-- **Suilend**
-- **Bluefin**
-- **HaedalHMM**
-- **Alphafi**
-- **SpringSui**
-- **Steamm CPMM**
-- **Steamm OMM**
-- **Metastable**
-- **Obric**
-- **HaWAL**
-- **Momentum**
-- **Magma**
-- **Sevenk**
-
-# Aggregator SDK V3
-
-## Advantages of Aggregator Client V3
-
-The new Aggregator Client V3 offers significant improvements over the previous version:
-
-### Transaction Traceability
-
-- **Complete Transaction History**: All swap transactions are fully traceable on the blockchain
-- **Detailed Route Information**: Track exactly which DEXs and pools were used in multi-hop swaps
-- **Gas Optimization Transparency**: See how transactions were optimized to reduce gas costs
-
-### Transaction Merging for Gas Optimization
-
-- **Reduced Gas Costs**: Significantly lower transaction fees through optimized execution paths
-- **Smart Route Aggregation**: Automatically combines similar operations to minimize gas usage
-
-### Enhanced Features
-
-- **Increased Reliability**: More robust transaction execution with better error handling
-
-## Migration from Aggregator Client to V3
-
-### Installation
-
-Both versions use the same package:
-
-```bash
-npm install @cetusprotocol/aggregator-sdk
-```
-
-### Key Changes
-
-1. **Client Initialization**
-
-   ```typescript
-   // V2 (Legacy)
-   const client = new AggregatorClient({})
-
-   // V3 (New)
-   const client = new AggregatorClient({})
-   ```
-
-2. **Router Finding**
-
-   ```typescript
-   // Both versions use the same API
-   const routers = await client.findRouters({
-     from: "0x2::sui::SUI",
-     target:
-       "0x06864a6f921804860930db6ddbe2e16acdf8504495ea7481637a1c8b9a8fe54b::cetus::CETUS",
-     amount: new BN(1000000),
-     byAmountIn: true,
-   })
-   ```
-
-3. **Transaction Building**
-
-   ```typescript
-   // V2 Method
-   await client.buildRouterSwap({
-     routers,
-     txb,
-     inputCoin,
-     slippage: 0.01,
-   })
-
-   // V3 Method (Recommended)
-   await client.fastRouterSwap({
-     routers,
-     txb,
-     slippage: 0.01,
-   })
-
-   // V3 Alternative (For PTB building)
-   const targetCoin = await client.routerSwap({
-     routers,
-     txb,
-     inputCoin,
-     slippage: 0.01,
-   })
-   ```
-
-4. **Benefits of Migration**
-   - Reduced gas costs through transaction merging
-   - Better transaction traceability
-   - Improved error handling and reliability
-   - Access to latest DEX integrations
+# Aggregator SDK
 
 ## Install
 
@@ -248,20 +132,18 @@ CetusAggregatorV2ExtendV1 = { git = "https://github.com/CetusProtocol/aggregator
 CetusAggregatorV2ExtendV2 = { git = "https://github.com/CetusProtocol/aggregator.git", subdir = "packages/cetus-aggregator-v2-extend-v2", rev = "mainnet", override = true }
 ```
 
-# Simple Aggregator Contract Interface
-
-- include: cetus, flowxv3, turbos, bluefin, haedalhmm, momentum, obric
+# Simple Aggregator Contract Interface(include cetus, flowxv3, turbos, bluefin)
 
 ## Tags corresponding to different networks
 
 | Contract              | Tag of Repo | Latest published at address                                        |
 | --------------------- | ----------- | ------------------------------------------------------------------ |
-| CetusAggregatorSimple | mainnet     | 0x44ca6438ab034be95cedfca7d4070e6d33fa12e088e9dce13abb1bf055093264 |
+| CetusAggregatorSimple | mainnet     | 0x594d67abc0778023ac852800578271dd7e18698ad06e6298034858c77612333d |
 
 ## Example
 
 ```
-CetusAggregatorSimple = { git = "https://github.com/CetusProtocol/aggregator.git", subdir = "packages/cetus-aggregator-v2/simple-mainnet", rev = "mainnet-v1.50.2", override = true }
+CetusAggregatorSimple = { git = "https://github.com/CetusProtocol/aggregator.git", subdir = "packages/cetus-aggregator-v2/simple-mainnet", rev = "mainnet-v1.49.1", override = true }
 ```
 
 ## Usage

package/benchmark-results/benchmark-results-2025-07-17T12-03-15-563Z.csv

@@ -0,0 +1,3 @@
+Version,Provider,Success,AmountIn,AmountOut,TotalGasCost,ComputationCost,GasEfficiency,PriceImpact,Timestamp
+V2,MAGMA,true,5000000,1243876327,2555288,1420000,486,-24777.52,1752753791128
+V3,MAGMA,true,5000000,1244172561,1845288,710000,674,-24783.45,1752753794556

package/benchmark-results/benchmark-results-2025-07-17T12-03-15-563Z.json

@@ -0,0 +1,56 @@
+{
+  "v2": [
+    {
+      "gasMetrics": {
+        "computationCost": "1420000",
+        "storageCost": "8352400",
+        "storageRebate": "7290756",
+        "nonRefundableStorageFee": "73644",
+        "totalGasCost": "2555288",
+        "gasUsed": "1420000",
+        "gasPrice": "1000",
+        "success": true
+      },
+      "amountIn": "4c4b40",
+      "amountOut": "4a240be7",
+      "priceImpact": -24777.52,
+      "gasEfficiency": 486,
+      "provider": "MAGMA",
+      "route": [
+        "MAGMA"
+      ],
+      "timestamp": 1752753791128
+    }
+  ],
+  "v3": [
+    {
+      "gasMetrics": {
+        "computationCost": "710000",
+        "storageCost": "8352400",
+        "storageRebate": "7290756",
+        "nonRefundableStorageFee": "73644",
+        "totalGasCost": "1845288",
+        "gasUsed": "710000",
+        "gasPrice": "1000",
+        "success": true
+      },
+      "amountIn": "4c4b40",
+      "amountOut": "4a289111",
+      "priceImpact": -24783.45,
+      "gasEfficiency": 674,
+      "provider": "MAGMA",
+      "route": [
+        "MAGMA"
+      ],
+      "timestamp": 1752753794556
+    }
+  ],
+  "summary": {
+    "v2AverageGas": "2555288",
+    "v3AverageGas": "1845288",
+    "gasSavingsPercent": 27.78,
+    "v2SuccessRate": 100,
+    "v3SuccessRate": 100,
+    "totalTests": 2
+  }
+}

package/benchmark-results/benchmark-results-2025-07-17T12-03-34-148Z.csv

@@ -0,0 +1,3 @@
+Version,Provider,Success,AmountIn,AmountOut,TotalGasCost,ComputationCost,GasEfficiency,PriceImpact,Timestamp
+V2,MAGMA,true,5000000,1244172561,2555288,1420000,486,-24783.45,1752753809734
+V3,MAGMA,true,5000000,1244172561,1845288,710000,674,-24783.45,1752753813146

package/benchmark-results/benchmark-results-2025-07-17T12-03-34-148Z.json

@@ -0,0 +1,56 @@
+{
+  "v2": [
+    {
+      "gasMetrics": {
+        "computationCost": "1420000",
+        "storageCost": "8352400",
+        "storageRebate": "7290756",
+        "nonRefundableStorageFee": "73644",
+        "totalGasCost": "2555288",
+        "gasUsed": "1420000",
+        "gasPrice": "1000",
+        "success": true
+      },
+      "amountIn": "4c4b40",
+      "amountOut": "4a289111",
+      "priceImpact": -24783.45,
+      "gasEfficiency": 486,
+      "provider": "MAGMA",
+      "route": [
+        "MAGMA"
+      ],
+      "timestamp": 1752753809734
+    }
+  ],
+  "v3": [
+    {
+      "gasMetrics": {
+        "computationCost": "710000",
+        "storageCost": "8352400",
+        "storageRebate": "7290756",
+        "nonRefundableStorageFee": "73644",
+        "totalGasCost": "1845288",
+        "gasUsed": "710000",
+        "gasPrice": "1000",
+        "success": true
+      },
+      "amountIn": "4c4b40",
+      "amountOut": "4a289111",
+      "priceImpact": -24783.45,
+      "gasEfficiency": 674,
+      "provider": "MAGMA",
+      "route": [
+        "MAGMA"
+      ],
+      "timestamp": 1752753813146
+    }
+  ],
+  "summary": {
+    "v2AverageGas": "2555288",
+    "v3AverageGas": "1845288",
+    "gasSavingsPercent": 27.78,
+    "v2SuccessRate": 100,
+    "v3SuccessRate": 100,
+    "totalTests": 2
+  }
+}

package/benchmark-results/benchmark-results-2025-07-21T03-31-59-263Z.csv

@@ -0,0 +1,21 @@
+Version,Provider,Success,AmountIn,AmountOut,TotalGasCost,ComputationCost,GasEfficiency,PriceImpact,Timestamp
+V2,MAGMA,true,5000000,1258299255,2556656,1420000,492,-25065.98,1753068334517
+V2,MAGMA,true,50000000,12574255625,2556656,1420000,4918,-25048.51,1753068346313
+V2,MAGMA,true,500000000,125480226090,2764288,1420000,45393,-24996.04,1753068356111
+V2,MAGMA,true,100000000000,24890183842651,5052200,2130000,4926603,-24790.18,1753068365179
+V2,CETUS,true,500000,125980647,2829040,1420000,44,-25096.12,1753068374839
+V2,CETUS,true,5000000,1258278343,2950184,1420000,426,-25065.56,1753068384363
+V2,CETUS,true,50000000,12578426109,3014936,1420000,4172,-25056.85,1753068392839
+V2,CETUS,true,10000000000,2515179479306,1913384,710000,1314518,-25051.79,1753068402439
+V2,CETUS,true,10000000000,39721642,1913384,710000,20,99.6,1753068481963
+V2,CETUS,true,100000000000,397530003,1913384,710000,207,99.6,1753068641345
+V3,MAGMA,true,5000000,1258299255,1846656,710000,681,-25065.98,1753068338942
+V3,MAGMA,true,50000000,12574255625,1846656,710000,6809,-25048.51,1753068351410
+V3,MAGMA,true,500000000,125480226090,2054288,710000,61082,-24996.04,1753068360046
+V3,MAGMA,true,100000000000,24890183842651,4342200,1420000,5732159,-24790.18,1753068369762
+V3,CETUS,true,500000,125980647,2119040,710000,59,-25096.12,1753068379188
+V3,CETUS,true,5000000,1258278343,2240184,710000,561,-25065.56,1753068387883
+V3,CETUS,true,50000000,12578426109,3014936,1420000,4172,-25056.85,1753068397989
+V3,CETUS,true,10000000000,2515179479306,1913384,710000,1314518,-25051.79,1753068407309
+V3,CETUS,true,10000000000,39738545,2033464,710000,19,99.6,1753068558374
+V3,CETUS,true,100000000000,398281652,1913384,710000,208,99.6,1753068718257