@cetusprotocol/aggregator-sdk 1.1.2 → 1.1.4

package/dist/index.mjs

@@ -2993,7 +2993,7 @@ var GAS_TYPE_ARG = "0x2::sui::SUI";
 var GAS_TYPE_ARG_LONG = "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI";
 var GAS_SYMBOL = "SUI";
 var DEFAULT_NFT_TRANSFER_GAS_FEE = 450;
-var SUI_SYSTEM_STATE_OBJECT_ID = "0x0000000000000000000000000000000000000005";
+var SUI_SYSTEM_STATE_OBJECT_ID = "0x0000000000000000000000000000000000000000000000000000000000000005";
 var CoinUtils = class _CoinUtils {
   /**
    * Get the coin type argument from a SuiMoveObject.
@@ -3101,10 +3101,18 @@ var CoinUtils = class _CoinUtils {
    * @returns The CoinAsset objects that have a balance greater than or equal to the given amount.
    */
   static selectCoinObjectIdGreaterThanOrEqual(coins, amount, exclude = []) {
-    const selectedResult = _CoinUtils.selectCoinAssetGreaterThanOrEqual(coins, amount, exclude);
-    const objectArray = selectedResult.selectedCoins.map((item) => item.coinObjectId);
+    const selectedResult = _CoinUtils.selectCoinAssetGreaterThanOrEqual(
+      coins,
+      amount,
+      exclude
+    );
+    const objectArray = selectedResult.selectedCoins.map(
+      (item) => item.coinObjectId
+    );
     const remainCoins = selectedResult.remainingCoins;
-    const amountArray = selectedResult.selectedCoins.map((item) => item.balance.toString());
+    const amountArray = selectedResult.selectedCoins.map(
+      (item) => item.balance.toString()
+    );
     return { objectArray, remainCoins, amountArray };
   }
   /**
@@ -3116,7 +3124,9 @@ var CoinUtils = class _CoinUtils {
    * @returns The CoinAsset objects that have a balance greater than or equal to the given amount.
    */
   static selectCoinAssetGreaterThanOrEqual(coins, amount, exclude = []) {
-    const sortedCoins = _CoinUtils.sortByBalance(coins.filter((c) => !exclude.includes(c.coinObjectId)));
+    const sortedCoins = _CoinUtils.sortByBalance(
+      coins.filter((c) => !exclude.includes(c.coinObjectId))
+    );
     const total = _CoinUtils.calculateTotalBalance(sortedCoins);
     if (total < amount) {
       return { selectedCoins: [], remainingCoins: sortedCoins };
@@ -3129,9 +3139,13 @@ var CoinUtils = class _CoinUtils {
     const remainingCoins = [...sortedCoins];
     while (sum2 < total) {
       const target = amount - sum2;
-      const coinWithSmallestSufficientBalanceIndex = remainingCoins.findIndex((c) => c.balance >= target);
+      const coinWithSmallestSufficientBalanceIndex = remainingCoins.findIndex(
+        (c) => c.balance >= target
+      );
       if (coinWithSmallestSufficientBalanceIndex !== -1) {
-        selectedCoins.push(remainingCoins[coinWithSmallestSufficientBalanceIndex]);
+        selectedCoins.push(
+          remainingCoins[coinWithSmallestSufficientBalanceIndex]
+        );
         remainingCoins.splice(coinWithSmallestSufficientBalanceIndex, 1);
         break;
       }
@@ -3141,7 +3155,10 @@ var CoinUtils = class _CoinUtils {
         sum2 += coinWithLargestBalance.balance;
       }
     }
-    return { selectedCoins: _CoinUtils.sortByBalance(selectedCoins), remainingCoins: _CoinUtils.sortByBalance(remainingCoins) };
+    return {
+      selectedCoins: _CoinUtils.sortByBalance(selectedCoins),
+      remainingCoins: _CoinUtils.sortByBalance(remainingCoins)
+    };
   }
   /**
    * Sort the CoinAsset objects by their balance.
@@ -3150,10 +3167,14 @@ var CoinUtils = class _CoinUtils {
    * @returns The sorted CoinAsset objects.
    */
   static sortByBalance(coins) {
-    return coins.sort((a, b) => a.balance < b.balance ? -1 : a.balance > b.balance ? 1 : 0);
+    return coins.sort(
+      (a, b) => a.balance < b.balance ? -1 : a.balance > b.balance ? 1 : 0
+    );
   }
   static sortByBalanceDes(coins) {
-    return coins.sort((a, b) => a.balance > b.balance ? -1 : a.balance < b.balance ? 0 : 1);
+    return coins.sort(
+      (a, b) => a.balance > b.balance ? -1 : a.balance < b.balance ? 0 : 1
+    );
   }
   /**
    * Calculate the total balance of a list of CoinAsset objects.
@@ -3391,8 +3412,9 @@ var DEEPBOOK_V3_DEEP_FEE_TYPES = {
 var CLIENT_CONFIG = {
   DEFAULT_PYTH_URL: "https://hermes.pyth.network",
   PYTH_TIMEOUT: 3e3,
-  MAX_OVERLAY_FEE_RATE: 0.1,
+  MAX_OVERLAY_FEE_RATE_PARAMS: 0.1,
   FEE_RATE_MULTIPLIER: 1e6,
+  MAX_FEE_RATE: 1e5,
   DEFAULT_OVERLAY_FEE_RECEIVER: "0x0",
   // Error Messages
   ERRORS: {
@@ -3405,7 +3427,8 @@ var CLIENT_CONFIG = {
     PYTH_UNAVAILABLE: "All Pyth price nodes are unavailable. Cannot fetch price data. Please switch to or add new available Pyth nodes",
     QUOTE_ID_REQUIRED: "Quote ID is required",
     AGGREGATOR_V3_PACKAGE_REQUIRED: "Aggregator V3 package is required",
-    PACKAGES_REQUIRED: "Packages are required"
+    PACKAGES_REQUIRED: "Packages are required",
+    OVERLAY_FEE_RECEIVER_REQUIRED: "Overlay fee rate is set, but overlay fee receiver is not set"
   }
 };
 var AGGREGATOR_V3_CONFIG = {
@@ -3420,7 +3443,7 @@ var AGGREGATOR_V3_CONFIG = {
 };
 
 // src/api.ts
-var SDK_VERSION = 1010102;
+var SDK_VERSION = 1010104;
 function parseRouterResponse(data, byAmountIn) {
   let packages = /* @__PURE__ */ new Map();
   if (data.packages) {
@@ -3438,6 +3461,7 @@ function parseRouterResponse(data, byAmountIn) {
     amountOut: new import_bn2.default(data.amount_out.toString()),
     byAmountIn,
     insufficientLiquidity: false,
+    deviationRatio: data.deviation_ratio,
     packages,
     paths: data.paths.map((path) => ({
       id: path.id,
@@ -6689,7 +6713,7 @@ var SpringsuiRouter = class {
     const args = [
       swapContext,
       txb.object(swapData.poolId),
-      txb.object("0x5"),
+      txb.object(SUI_SYSTEM_STATE_OBJECT_ID),
       txb.pure.u64(swapData.amountIn),
       txb.pure.bool(swapData.direction)
     ];
@@ -7371,8 +7395,7 @@ var VoloRouter = class {
       swapContext,
       txb.object(this.stakePool),
       txb.object(this.metadata),
-      txb.object("0x5"),
-      // SuiSystemState
+      txb.object(SUI_SYSTEM_STATE_OBJECT_ID),
       txb.pure.bool(swapData.direction),
       txb.pure.u64(swapData.amountIn)
     ];
@@ -7423,8 +7446,7 @@ var AfsuiRouter = class {
       swapContext,
       txb.object(this.stakedSuiVault),
       txb.object(this.safe),
-      txb.object("0x5"),
-      // SuiSystemState
+      txb.object(SUI_SYSTEM_STATE_OBJECT_ID),
       txb.object(this.referVault),
       txb.object(this.validator),
       txb.pure.bool(swapData.direction),
@@ -7469,8 +7491,7 @@ var HaedalRouter = class {
     const args = [
       swapContext,
       txb.object(swapData.poolId),
-      txb.object("0x5"),
-      // SuiSystemState
+      txb.object(SUI_SYSTEM_STATE_OBJECT_ID),
       txb.pure.bool(swapData.direction),
       txb.pure.u64(swapData.amountIn)
     ];
@@ -8229,7 +8250,7 @@ var _AggregatorClient = class _AggregatorClient {
     this.apiKey = params.apiKey || "";
     this.partner = params.partner;
     if (params.overlayFeeRate) {
-      if (params.overlayFeeRate > 0 && params.overlayFeeRate <= CLIENT_CONFIG.MAX_OVERLAY_FEE_RATE) {
+      if (params.overlayFeeRate > 0 && params.overlayFeeRate <= CLIENT_CONFIG.MAX_OVERLAY_FEE_RATE_PARAMS) {
         this.overlayFeeRate = params.overlayFeeRate * AGGREGATOR_V3_CONFIG.FEE_DENOMINATOR;
         if (this.overlayFeeRate > AGGREGATOR_V3_CONFIG.MAX_FEE_RATE) {
           throw new Error(
@@ -8260,6 +8281,11 @@ var _AggregatorClient = class _AggregatorClient {
       return DEEPBOOK_V3_DEEP_FEE_TYPES.Testnet;
     }
   }
+  getDeepbookV3Config() {
+    return __async(this, null, function* () {
+      return yield getDeepbookV3Config(this.endpoint);
+    });
+  }
   getOneCoinUsedToMerge(coinType) {
     return __async(this, null, function* () {
       try {
@@ -8510,20 +8536,22 @@ var _AggregatorClient = class _AggregatorClient {
   }
   routerSwap(params) {
     return __async(this, null, function* () {
-      const { router, inputCoin, slippage, txb, fixable, partner } = params;
+      const { router, inputCoin, slippage, txb, partner } = params;
       if (slippage > 1 || slippage < 0) {
         throw new Error(CLIENT_CONFIG.ERRORS.INVALID_SLIPPAGE);
       }
+      if (!params.router.packages || !params.router.packages.get(PACKAGE_NAMES.AGGREGATOR_V3)) {
+        throw new Error(CLIENT_CONFIG.ERRORS.PACKAGES_REQUIRED);
+      }
       const byAmountIn = params.router.byAmountIn;
       const amountIn = router.amountIn;
       const amountOut = router.amountOut;
+      checkOverlayFeeConfig(this.overlayFeeRate, this.overlayFeeReceiver);
       let overlayFee = new import_bn6.default(0);
-      if (this.overlayFeeRate > 0 && this.overlayFeeReceiver !== "0x0") {
-        if (byAmountIn) {
-          overlayFee = amountOut.mul(new import_bn6.default(this.overlayFeeRate)).div(new import_bn6.default(1e6));
-        } else {
-          overlayFee = amountIn.mul(new import_bn6.default(this.overlayFeeRate)).div(new import_bn6.default(1e6));
-        }
+      if (byAmountIn) {
+        overlayFee = amountOut.mul(new import_bn6.default(this.overlayFeeRate)).div(new import_bn6.default(1e6));
+      } else {
+        overlayFee = amountIn.mul(new import_bn6.default(this.overlayFeeRate)).div(new import_bn6.default(1e6));
       }
       const expectedAmountOut = byAmountIn ? amountOut.sub(overlayFee) : amountOut;
       const expectedAmountIn = byAmountIn ? amountIn : amountIn.add(overlayFee);
@@ -8532,9 +8560,6 @@ var _AggregatorClient = class _AggregatorClient {
         byAmountIn,
         slippage
       );
-      if (!params.router.packages || !params.router.packages.get(PACKAGE_NAMES.AGGREGATOR_V3)) {
-        throw new Error(CLIENT_CONFIG.ERRORS.PACKAGES_REQUIRED);
-      }
       const priceIDs = findPythPriceIDs(router.paths);
       const priceInfoObjectIds = priceIDs.length > 0 ? yield this.updatePythPriceIDs(priceIDs, txb) : /* @__PURE__ */ new Map();
       if (byAmountIn) {
@@ -8567,17 +8592,16 @@ var _AggregatorClient = class _AggregatorClient {
       const fromCoinType = router.paths[0].from;
       const targetCoinType = router.paths[router.paths.length - 1].target;
       const byAmountIn = router.byAmountIn;
+      checkOverlayFeeConfig(this.overlayFeeRate, this.overlayFeeReceiver);
       let overlayFee = 0;
-      if (this.overlayFeeRate > 0 && this.overlayFeeReceiver !== "0x0") {
-        if (byAmountIn) {
-          overlayFee = Number(
-            router.amountOut.mul(new import_bn6.default(this.overlayFeeRate)).div(new import_bn6.default(1e6)).toString()
-          );
-        } else {
-          overlayFee = Number(
-            router.amountIn.mul(new import_bn6.default(this.overlayFeeRate)).div(new import_bn6.default(1e6)).toString()
-          );
-        }
+      if (byAmountIn) {
+        overlayFee = Number(
+          router.amountOut.mul(new import_bn6.default(this.overlayFeeRate)).div(new import_bn6.default(1e6)).toString()
+        );
+      } else {
+        overlayFee = Number(
+          router.amountIn.mul(new import_bn6.default(this.overlayFeeRate)).div(new import_bn6.default(1e6)).toString()
+        );
       }
       const expectedAmountOut = byAmountIn ? router.amountOut.sub(new import_bn6.default(overlayFee)) : router.amountOut;
       const expectedAmountIn = byAmountIn ? router.amountIn : router.amountIn.add(new import_bn6.default(overlayFee));
@@ -8629,18 +8653,17 @@ var _AggregatorClient = class _AggregatorClient {
   }
   fixableRouterSwapV3(params) {
     return __async(this, null, function* () {
-      const { router, inputCoin, slippage, txb, deepbookv3DeepFee, partner } = params;
+      const { router, inputCoin, slippage, txb, partner } = params;
+      checkOverlayFeeConfig(this.overlayFeeRate, this.overlayFeeReceiver);
       let overlayFee = 0;
-      if (this.overlayFeeRate > 0 && this.overlayFeeReceiver !== "0x0") {
-        if (router.byAmountIn) {
-          overlayFee = Number(
-            router.amountOut.mul(new import_bn6.default(this.overlayFeeRate)).div(new import_bn6.default(1e6)).toString()
-          );
-        } else {
-          overlayFee = Number(
-            router.amountIn.mul(new import_bn6.default(this.overlayFeeRate)).div(new import_bn6.default(1e6)).toString()
-          );
-        }
+      if (router.byAmountIn) {
+        overlayFee = Number(
+          router.amountOut.mul(new import_bn6.default(this.overlayFeeRate)).div(new import_bn6.default(1e6)).toString()
+        );
+      } else {
+        overlayFee = Number(
+          router.amountIn.mul(new import_bn6.default(this.overlayFeeRate)).div(new import_bn6.default(1e6)).toString()
+        );
       }
       const expectedAmountOut = router.byAmountIn ? router.amountOut.sub(new import_bn6.default(overlayFee)) : router.amountOut;
       const expectedAmountIn = router.byAmountIn ? router.amountIn : router.amountIn.add(new import_bn6.default(overlayFee));
@@ -8749,6 +8772,7 @@ var _AggregatorClient = class _AggregatorClient {
       const routeData = {
         amountIn,
         amountOut: new import_bn6.default((_d = event.amount_out) != null ? _d : 0),
+        deviationRatio: 0,
         paths: [
           {
             id: pools[tempIndex],
@@ -8866,6 +8890,16 @@ function recordFirstCoinIndex(paths) {
   }
   return newCoinRecord;
 }
+function checkOverlayFeeConfig(overlayFeeRate, overlayFeeReceiver) {
+  if (overlayFeeRate > CLIENT_CONFIG.MAX_FEE_RATE) {
+    throw new Error(CLIENT_CONFIG.ERRORS.INVALID_OVERLAY_FEE_RATE);
+  }
+  if (overlayFeeReceiver === "0x0" && overlayFeeRate > 0) {
+    throw new Error(
+      CLIENT_CONFIG.ERRORS.OVERLAY_FEE_RECEIVER_REQUIRED
+    );
+  }
+}
 
 // src/types/sui.ts
 var getDefaultSuiInputType = (value) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cetusprotocol/aggregator-sdk",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "sideEffects": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -45,4 +45,4 @@
     "ts-jest": "^29.1.3",
     "typescript": "^5.0.0"
   }
-}
+}

package/.github/workflows/test.yml

@@ -1,152 +0,0 @@
-name: Automated Testing with Success Rate
-
-on:
-  push:
-    branches: [ main, develop, refactor-v3 ]
-  pull_request:
-    branches: [ main, develop, refactor-v3 ]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    
-    steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-      
-    - name: Setup Bun
-      uses: oven-sh/setup-bun@v1
-      with:
-        bun-version: latest
-        
-    - name: Install dependencies
-      run: bun install
-      
-    - name: Run tests with coverage and statistics
-      run: |
-        echo "🧪 Running all tests..."
-        
-        # Run tests with JSON output for parsing
-        bun test --json --outputFile=test-results.json --coverage || true
-        
-        # Also run regular test output for display
-        echo "📊 Test Results:"
-        bun test --verbose || TEST_EXIT_CODE=$?
-        
-        # Parse test results and calculate success rate
-        echo "📈 Calculating test success rate..."
-        
-        # Create a simple Node.js script to parse JSON results
-        cat > calculate-stats.js << 'EOF'
-        const fs = require('fs');
-        
-        try {
-          // Try to read the JSON results file
-          let results;
-          if (fs.existsSync('test-results.json')) {
-            const data = fs.readFileSync('test-results.json', 'utf8');
-            results = JSON.parse(data);
-          } else {
-            console.log('⚠️  JSON results file not found, using alternative method');
-            process.exit(1);
-          }
-          
-          // Calculate statistics
-          const totalTests = results.numTotalTests || 0;
-          const passedTests = results.numPassedTests || 0;
-          const failedTests = results.numFailedTests || 0;
-          const successRate = totalTests > 0 ? ((passedTests / totalTests) * 100).toFixed(2) : 0;
-          
-          console.log('\n📊 =================================');
-          console.log('📊 TEST EXECUTION SUMMARY');
-          console.log('📊 =================================');
-          console.log(`📊 Total Tests: ${totalTests}`);
-          console.log(`✅ Passed Tests: ${passedTests}`);
-          console.log(`❌ Failed Tests: ${failedTests}`);
-          console.log(`📈 Success Rate: ${successRate}%`);
-          console.log('📊 =================================\n');
-          
-          // Set environment variables for GitHub Actions
-          console.log(`::set-output name=total_tests::${totalTests}`);
-          console.log(`::set-output name=passed_tests::${passedTests}`);
-          console.log(`::set-output name=failed_tests::${failedTests}`);
-          console.log(`::set-output name=success_rate::${successRate}`);
-          
-          // Exit with non-zero code if tests failed
-          if (failedTests > 0) {
-            process.exit(1);
-          }
-          
-        } catch (error) {
-          console.error('Error parsing test results:', error);
-          process.exit(1);
-        }
-        EOF
-        
-        # Run the statistics calculation
-        node calculate-stats.js || {
-          echo "⚠️  Falling back to alternative statistics calculation..."
-          
-          # Alternative method using grep on test output
-          echo "📊 ================================="
-          echo "📊 TEST EXECUTION SUMMARY"
-          echo "📊 ================================="
-          
-          # Count test files
-          TEST_FILES=$(find tests -name "*.test.ts" | wc -l)
-          echo "📊 Total Test Files: $TEST_FILES"
-          
-          # Try to get basic stats from bun test output
-          echo "📊 Running tests again for statistics..."
-          bun test 2>&1 | tee test-output.log
-          
-          # Parse the output for basic statistics
-          if grep -q "Tests:" test-output.log; then
-            STATS=$(grep "Tests:" test-output.log | tail -1)
-            echo "📊 $STATS"
-          fi
-          
-          echo "📊 ================================="
-          
-          # Clean up
-          rm -f test-output.log
-        }
-        
-        # Clean up
-        rm -f calculate-stats.js test-results.json
-        
-        # Exit with the original test exit code
-        exit ${TEST_EXIT_CODE:-0}
-      
-    - name: Upload test results
-      uses: actions/upload-artifact@v3
-      if: always()
-      with:
-        name: test-results
-        path: |
-          coverage/
-          test-results.json
-        retention-days: 30
-        
-    - name: Comment PR with test results
-      uses: actions/github-script@v6
-      if: github.event_name == 'pull_request'
-      with:
-        script: |
-          const output = `## 🧪 Test Results
-          
-          **Test Execution Summary:**
-          - Total Tests: \${{ steps.test.outputs.total_tests || 'N/A' }}
-          - Passed Tests: \${{ steps.test.outputs.passed_tests || 'N/A' }}
-          - Failed Tests: \${{ steps.test.outputs.failed_tests || 'N/A' }}
-          - Success Rate: \${{ steps.test.outputs.success_rate || 'N/A' }}%
-          
-          \${{ steps.test.outputs.failed_tests > 0 && '❌ Some tests failed. Please review the test output above.' || '✅ All tests passed!' }}
-          `;
-          
-          github.rest.issues.createComment({
-            issue_number: context.issue.number,
-            owner: context.repo.owner,
-            repo: context.repo.repo,
-            body: output
-          });

package/.vscode/settings.json

@@ -1,8 +0,0 @@
-{
-  "licenser.license": "AL2",
-  "licenser.author": "0xBondSui <sugar@cetus.zone>",
-  "licenser.projectName": "Cetus Aggregator TS SDK",
-  "licenser.useSingleLineStyle": true,
-  "licenser.disableAutoSave": false,
-  "licenser.disableAutoHeaderInsertion": false
-}

package/CLAUDE.md

@@ -1,101 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-The **Cetus Aggregator SDK** is a TypeScript library for the Sui blockchain ecosystem that provides swap aggregation across 25+ decentralized exchanges (DEXs). The SDK finds optimal trading routes, best prices, and lowest slippage by integrating multiple DEXs including Cetus, DeepBook, Kriya, FlowX, Turbos, Aftermath, and many others.
-
-## Development Commands
-
-### Build and Development
-
-- `bun run build` - Compile TypeScript to CommonJS/ESM with type definitions using tsup
-- `bun run dev` - Development mode with file watching
-- `bun run clean` - Remove build artifacts and dependencies
-- `bun run publish:test` - Publish experimental version to bun
-
-### Testing
-
-- `bun test` - Run Jest test suite with ESM support
-- Tests are organized by aggregator versions (v2/v3) in `/tests/` directory
-- Individual DEX tests located in `/tests/aggregatorv2/router/`
-- Mathematical function tests in `/tests/math.test.ts`
-
-## Architecture
-
-### Core Components
-
-**Main Entry Points:**
-
-- `src/index.ts` - Main export barrel
-- `src/client.ts` - Aggregator v2 client implementation
-- `src/clientv3.ts` - Aggregator v3 client implementation
-
-**Key Directories:**
-
-- `src/transaction/` - DEX-specific swap implementations (25+ integrations)
-- `src/utils/` - Utility functions for coins, transactions, API calls
-- `src/types/` - TypeScript type definitions
-- `src/movecall/` - Move contract interaction helpers
-- `src/api/` - API interaction layer
-- `src/math/` - Mathematical calculations for trading
-
-### DEX Integration Pattern
-
-Each DEX has its own transaction module in `src/transaction/` following a consistent pattern:
-
-- Import from main client class (AggregatorClient/AggregatorClient)
-- Implement DEX-specific swap logic
-- Handle transaction building and execution
-- Support both amount-in and amount-out calculations
-
-### TypeScript Configuration
-
-- Uses path mapping: `~/*` maps to `src/*`
-- Jest configured with same path mapping
-- Targets ES6 with CommonJS modules
-- Strict TypeScript enabled
-
-### Key Dependencies
-
-- `@mysten/sui@^1.6.0` - Official Sui SDK for blockchain interactions
-- `@pythnetwork/pyth-sui-js@^2.1.0` - Pyth oracle integration for price feeds
-- `bn.js@^5.2.1` - Big number handling for precise calculations
-- `decimal.js@^10.4.3` - Decimal arithmetic for financial calculations
-
-### Multi-Version Support
-
-The SDK supports both Aggregator v2 and v3 APIs:
-
-- v2: Legacy aggregator with extensive DEX support
-- v3: Newer aggregator with enhanced features and performance
-
-### Testing Strategy
-
-- Unit tests for mathematical functions (`tests/math.test.ts`)
-- Integration tests for each DEX in `tests/aggregatorv2/router/`
-- Router functionality tests (`tests/aggregatorv2/router.test.ts`)
-- Wallet interaction tests (`tests/wallet.test.ts`)
-
-### Build Process
-
-Uses `tsup` for bundling with:
-
-- Multiple output formats (CJS, ESM, TypeScript declarations)
-- Tree shaking enabled
-- Code splitting support
-- Development watch mode
-
-### Contract Addresses
-
-The SDK works with multiple contract versions on Sui mainnet:
-
-- CetusAggregatorV2: `0x3864c7c59a4889fec05d1aae4bc9dba5a0e0940594b424fbed44cb3f6ac4c032`
-- CetusAggregatorV2ExtendV1: `0x39402d188b7231036e52266ebafad14413b4bf3daea4ac17115989444e6cd516`
-- CetusAggregatorV2ExtendV2: `0x368d13376443a8051b22b42a9125f6a3bc836422bb2d9c4a53984b8d6624c326`
-- CetusAggregatorSimple: `0x594d67abc0778023ac852800578271dd7e18698ad06e6298034858c77612333d`
-
-### Environment Setup
-
-The SDK works with Sui mainnet and testnet environments via the `Env` enum. Configure clients with appropriate RPC endpoints and package configurations for the target network.

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

@@ -1,3 +0,0 @@
-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

@@ -1,56 +0,0 @@
-{
-  "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

@@ -1,3 +0,0 @@
-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