Changelog
The aggregator contract needs to be upgraded to the latest version. In this new version, we have not only upgraded the dependent CLMM contract but also integrated several non-dex liquidity paths. The latest npm packge version is v1.7.3 More details can refer to Cetus Aggregator.
aggregator-sdk v1.7.3
Date: 2026-09-20
Updated the CETUS CLMM package configuration for Aggregator V3 in production.
aggregator-sdk v1.7.2
Date: 2026-08-26
Optimized Pyth availability checks to improve routing reliability.
aggregator-sdk v1.7.1
Date: 2026-08-17
Added typed error codes for Aggregator V3 contract aborts.
Automatically excludes CETUS_TIDE routes when the requested slippage is at or below 0.1%.
aggregator-sdk v1.7.0
Date: 2026-08-13
Reduced the maximum gas budget for swaps with 40 or more transaction commands from 0.5 SUI to 0.4 SUI.
aggregator-sdk v1.6.9
Date: 2026-08-12
Added support for CETUS_TIDE / PQF Orderbook V2 .
Added support for canonical multi-signature quote bundles.
Added PQF rebalance quote retrieval and transaction-building support.
aggregator-sdk v1.6.8
Date: 2026.7.28
Add additional slippage check logics.
Updated the production Aggregator V3 package configuration.
aggregator-sdk v1.6.7
Date: 2026.7.22
Added support for Cetus Pyth price update endpoints with fallback handling.
Added Pyth Core V2 support for Haedal Prop AMM routes.
Added support for binding API keys to individual Pyth price data URLs.
aggregator-sdk v1.6.6
Date: 2026.7.6
Updated the Pyth price feed configuration for Haedal Prop AMM.
aggregator-sdk v1.6.5
Date: 2026.7.6
Fixed restoration of the router
packagesmap when using the SDK with MSafe.Fixed serialization and restoration of extended route details in MSafe transactions.
aggregator-sdk v1.6.3
Date: 2026.6.30
Supporting the liquidity path of CETUS TIDE.
Added support for loading CETUS TIDE shared-object configuration from the Aggregator service.
aggregator-sdk v1.6.2
Date: 2026.6.25
Added optional Pyth availability checks when finding regular and merge-swap routes.
Added automatic filtering of Pyth-dependent providers when the configured Pyth endpoint is unavailable.
Added the
pythAvailabilityCheckIntervalconfiguration option for controlling the availability-check interval.
aggregator-sdk v1.6.1
Date: 2026.6.16
Added support for Sui sponsored transactions.
aggregator-sdk v1.6.0
Date: 2026.6.15
Optimized exact-output pool selection in swapInPools.
aggregator-sdk v1.5.9
Date: 2026.6.10
Supporting the liquidity path of Haedal Prop AMM.
aggregator-sdk v1.5.5
Date: 2026.5.20
Supporting the liquidity path of MAGMA PRO PAMM.
Change to Sui gRPC client(sui-v2.16.3).
aggregator-sdk v1.5.2
Date: 2026.4.23
Supporting the liquidity path of BOLT.
Change back to JSON-RPC client (waiting for gRPC to stablize on Sui).
aggregator-sdk v1.4.8
Date: 2026.4.2
Fixed: propagate cetusDlmmPartner from constructor to swap execution.
aggregator-sdk v1.4.7
Date: 2026.4.1
Migrate to SuiGrpcClient with @mysten/sui ^2.13.2, add built-in Pyth adapter, and deprecate SevenK integration.
aggregator-sdk v1.4.6
Date: 2026.3.18
Upgraded sui sdk to v2.6.0.
aggregator-sdk v1.4.5
Date: 2026.2.3
Fixed map API error code 5010 to NotFoundRoute for insufficient liquidity scenarios.
aggregator-sdk v1.4.4
Date: 2026.2.2
Upgraded DeepBookV3 router contract to fix immutable reference bug in
add_deep_price_pointparameter passing.
aggregator-sdk v1.4.3
Date: 2026.1.5
Support updating DEEP price in DeepBookV3 when using DEEP as fee.
aggregator-sdk v1.4.2
Date: 2025.10.28
Update CETUS CLMM contract address on Testnet
aggregator-sdk v1.4.1
Date: 2025.10.20
Add a
routerSwapWithMaxAmountInmethod with input amount cap validation supported.Key difference with existing method:
routerSwapmethod will completely consume the input coin amount;routerSwapWithMaxAmountIncomes with a maxAmountIn input and the final executed amount won't exceed this cap
aggregator-sdk v1.4.0
Date: 2025.10.17
Supporting the liquidity path of FERRA CLMM.
aggregator-sdk v1.3.0
Date: 2025.10.16
Supporting the liquidity path of FERRA DLMM.
aggregator-sdk v1.2.1
Date: 2025.9.15
Supporting the liquidity path of CETUS DLMM.
aggregator-sdk v1.2.0
Date: 2025.9.15
Update the default Cetus Router package IDs during downgrading swaps.
Optimized swap execution.
aggregator-sdk v1.1.6
Date: 2025.9.9
Restructure package.json
Adapt to recent package upgrades of external liquidity sources
aggregator-sdk v1.1.5
Date: 2025.9.4
Update the default Aggregator v3 and Cetus Router package IDs during downgrading swaps.
aggregator-sdk v1.1.4
Date: 2025.9.1
Fix the display of deviationRatio parameter in response.
aggregator-sdk v1.1.2
Date: 2025.8.29
Update data type export rules.
aggregator-sdk v1.1.1
Date: 2025.8.25
Upgrade to Aggregator V3 service
Adapt to the latest aggregator contract version.
Optimizes returned path structure by merging duplicate pools for reduced gas consumption.
aggregator-sdk v0.16.0
Date: 2025.8.14
Supporting the liquidity path of fullsail.
aggregator-sdk v0.15.0
Date: 2025.8.12
Optimize swap construction related to steamm.
Optimize liquidity path of haedalhmm.
Upgrade the contract versions of Momentum dependencies.
aggregator-sdk v0.14.2
Date: 2025.7.6
Supporting deviationRatio in findRoute response.
aggregator-sdk v0.14.0
Date: 2025.7.1
Supporting the liquidity path of 7k spot.
aggregator-sdk v0.13.0
Date: 2025.6.24
Supporting the liquidity path of magma.
aggregator-sdk v0.12.0
Date: 2025.6.08
Update default contracts address.
aggregator-sdk v0.11.1
Date: 2025.5.30
Provide advanced methods for selecting providers.
aggregator-sdk v0.11.0
Date: 2025.5.29
Upgrade the contract versions of Bluefin, FlowXv3, KryiaV3, and Momentum dependencies.
aggregator-sdk v0.10.0
Date: 2025.5.12
Supporting the liquidity path of steamm omm v2.
aggregator-sdk v0.9.1
Date: 2025.5.12
Optimize by amount out swap.
aggregator-sdk v0.9.0
Date: 2025.5.9
Upgrade volo contract version.
aggregator-sdk v0.8.0
Date: 2025.4.21
Supporting the liquidity path of momentum.
Optimize the gas usage of the Steamm CPMM.
aggregator-sdk v0.7.0
Date: 2025.4.18
Supporting the liquidity path of Steamm OMM.
aggregator-sdk v0.6.0
Date: 2025.4.9
Upgrade the fee sponsoring mechanism for deepbookv3.
aggregator-sdk v0.5.0
Date: 2025.4.1
Supporting the hawal in Haedal LSD.
Added support for Overlay Fee.
aggregator-sdk v0.4.4
Date: 2025.3.25
Optimized the coin construction method for scenarios where users have a large number of coin objects.
aggregator-sdk v0.4.3
Allow custom Pyth node URLs, aggregator endpoints, and API keys when initializing the aggregator client.
aggregator-sdk v0.4.0
Supporting the liquidity path of obric.
aggregator-sdk v0.3.32
The SCALLOP contract enforces an upgrade(version 16), which corresponds to an upgrade of the aggregator contract.
aggregator-sdk v0.3.30
Supporting the liquidity path of Metastable.
aggregator-sdk v0.3.28
Optimize build steamm swap.
Support version control.
aggregator-sdk v0.3.27
Updates the project's ES Module entry file extension from
.jsto.mjsfor explicit module declaration, better Node.js compatibility.
aggregator-sdk v0.3.26
Supporting the liquidity path of STEAMM.
aggregator-sdk v0.3.23
Upgrade aggregator contract to package verison 8 (Depend on the CLMM contract verison 10 )
aggregator-sdk v0.3.22
Optimize build haedalhmm swap, reduce gas used.
aggregator-sdk v0.3.21
Supporting Haedal instant unstake
aggregator-sdk v0.3.19
Supporting ecosystem LSTs from SpringSui.
Adding the liquidity path of stSUI stake and redeem.
Adapting to Bluefin package change
Supporting dynamic package update
aggregator-sdk v0.3.16
Supporting the liquidity path of Haedal HMM
aggregator-sdk v0.3.12
Optimize swap info display when aggregator service is experiencing downgrade swap.
Last updated