@cetusprotocol/aggregator-sdk 1.2.0 → 1.2.1

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as _mysten_sui_client from '@mysten/sui/client';
 import { SuiClient, DevInspectResults, SuiMoveObject } from '@mysten/sui/client';
-import { Transaction, TransactionObjectArgument, TransactionArgument } from '@mysten/sui/transactions';
+import { TransactionObjectArgument, Transaction, TransactionArgument } from '@mysten/sui/transactions';
 import BN from 'bn.js';
 import Decimal from 'decimal.js';
 import { SuiPriceServiceConnection, SuiPythClient } from '@pythnetwork/pyth-sui-js';
@@ -18,6 +18,64 @@ interface FindRouterParams {
     providers?: string[];
     liquidityChanges?: PreSwapLpChangeParams[];
 }
+interface MergeSwapFromCoin {
+    coinType: string;
+    amount: BN | string | number;
+}
+interface MergeSwapFromCoin {
+    coinType: string;
+    amount: BN | string | number;
+}
+interface MergeSwapParams {
+    target: string;
+    byAmountIn: boolean;
+    depth?: number;
+    providers?: string[];
+    froms: MergeSwapFromCoin[];
+}
+interface MergeSwapParams {
+    target: string;
+    byAmountIn: boolean;
+    depth?: number;
+    providers?: string[];
+    froms: MergeSwapFromCoin[];
+}
+interface MergeSwapInputCoin {
+    coinType: string;
+    coin: TransactionObjectArgument;
+}
+interface MergeSwapInputCoin {
+    coinType: string;
+    coin: TransactionObjectArgument;
+}
+interface BuildMergeSwapParams {
+    router: MergeSwapRouterData;
+    inputCoins: MergeSwapInputCoin[];
+    slippage: number;
+    txb: Transaction;
+    partner?: string;
+}
+interface BuildMergeSwapParams {
+    router: MergeSwapRouterData;
+    inputCoins: MergeSwapInputCoin[];
+    slippage: number;
+    txb: Transaction;
+    partner?: string;
+}
+interface BuildFastMergeSwapParams {
+    router: MergeSwapRouterData;
+    slippage: number;
+    txb: Transaction;
+    partner?: string;
+    payDeepFeeAmount?: number;
+}
+interface BuildFastMergeSwapParams {
+    router: MergeSwapRouterData;
+    slippage: number;
+    txb: Transaction;
+    partner?: string;
+    payDeepFeeAmount?: number;
+}
 interface PreSwapLpChangeParams {
     poolID: string;
     ticklower: number;
@@ -113,6 +171,20 @@ type RouterDataV3 = {
     error?: RouterError;
     overlayFee?: number;
 };
+type MergeRoute = {
+    amountIn: BN;
+    amountOut: BN;
+    deviationRatio: string;
+    paths: Path[];
+};
+type MergeSwapRouterData = {
+    quoteID?: string;
+    totalAmountOut: BN;
+    allRoutes: MergeRoute[];
+    packages?: Map<string, string>;
+    gas?: number;
+    error?: RouterError;
+};
 type FlattenedPath = {
     path: Path;
     isLastUseOfIntermediateToken: boolean;
@@ -199,6 +271,7 @@ declare class AggregatorConfig {
 }
 
 declare function getRouterResult(endpoint: string, apiKey: string, params: FindRouterParams, overlayFee: number, overlayFeeReceiver: string): Promise<RouterDataV3 | null>;
+declare function getMergeSwapResult(endpoint: string, apiKey: string, params: MergeSwapParams, overlayFee: number, overlayFeeReceiver: string): Promise<MergeSwapRouterData | null>;
 declare function getDeepbookV3Config(endpoint: string): Promise<DeepbookV3ConfigResponse | null>;
 declare function processFlattenRoutes(routerData: RouterDataV3): ProcessedRouterData;
 
@@ -240,6 +313,7 @@ declare const MAGMA = "MAGMA";
 declare const SEVENK = "SEVENK";
 declare const HAEDALHMMV2 = "HAEDALHMMV2";
 declare const FULLSAIL = "FULLSAIL";
+declare const CETUSDLMM = "CETUSDLMM";
 declare const DEFAULT_ENDPOINT = "https://api-sui.cetus.zone/router_v3";
 declare const ALL_DEXES: string[];
 type BuildRouterSwapParamsV3 = {
@@ -293,6 +367,7 @@ type AggregatorClientParams = {
     partner?: string;
     overlayFeeRate?: number;
     overlayFeeReceiver?: string;
+    cetusDlmmPartner?: string;
 };
 declare class AggregatorClient {
     endpoint: string;
@@ -305,6 +380,7 @@ declare class AggregatorClient {
     protected overlayFeeRate: number;
     protected overlayFeeReceiver: string;
     protected partner?: string;
+    protected cetusDlmmPartner?: string;
     private static readonly CONFIG;
     constructor(params: AggregatorClientParams);
     newPythClients(pythUrls: string[]): SuiPriceServiceConnection[];
@@ -312,13 +388,16 @@ declare class AggregatorClient {
     getDeepbookV3Config(): Promise<DeepbookV3ConfigResponse | null>;
     getOneCoinUsedToMerge(coinType: string): Promise<string | null>;
     findRouters(params: FindRouterParams): Promise<RouterDataV3 | null>;
+    findMergeSwapRouters(params: MergeSwapParams): Promise<MergeSwapRouterData | null>;
     executeFlexibleInputSwap(txb: Transaction, inputCoin: TransactionObjectArgument, routerData: RouterDataV3, expectedAmountOut: string, amountLimit: string, pythPriceIDs: Map<string, string>, partner?: string, deepbookv3DeepFee?: TransactionObjectArgument, packages?: Map<string, string>): Promise<void>;
-    newDexRouterV3(provider: string, pythPriceIDs: Map<string, string>, partner?: string): DexRouter;
-    expectInputSwapV3(txb: Transaction, inputCoin: TransactionObjectArgument, routerData: RouterDataV3, expectAmountOut: string, amountOutLimit: string, pythPriceIDs: Map<string, string>, partner?: string): TransactionObjectArgument;
+    newDexRouterV3(provider: string, pythPriceIDs: Map<string, string>, partner?: string, cetusDlmmPartner?: string): DexRouter;
+    expectInputSwapV3(txb: Transaction, inputCoin: TransactionObjectArgument, routerData: RouterDataV3, expectAmountOut: string, amountOutLimit: string, pythPriceIDs: Map<string, string>, partner?: string, cetusDlmmPartner?: string): TransactionObjectArgument;
     expectOutputSwapV3(txb: Transaction, inputCoin: TransactionObjectArgument, routerData: RouterDataV3, amountOut: string, _amountLimit: string, // it will set when build inputcoin
     partner?: string): TransactionObjectArgument;
     routerSwap(params: BuildRouterSwapParamsV3): Promise<TransactionObjectArgument>;
     fastRouterSwap(params: BuildFastRouterSwapParamsV3): Promise<void>;
+    mergeSwap(params: BuildMergeSwapParams): Promise<TransactionObjectArgument>;
+    fastMergeSwap(params: BuildFastMergeSwapParams): Promise<void>;
     fixableRouterSwapV3(params: BuildRouterSwapParamsV3): Promise<TransactionObjectArgument>;
     swapInPools(params: SwapInPoolsParams): Promise<SwapInPoolsResultV3>;
     updatePythPriceIDs(priceIDs: string[], txb: Transaction): Promise<Map<string, string>>;
@@ -725,14 +804,7 @@ declare enum TransactionErrorCode {
     MissTurbosFeeType = "MissTurbosFeeType",
     MissAftermathLpSupplyType = "MissAftermathLpSupplyType"
 }
-declare enum AggregatorServerErrorCode {
-    NumberTooLarge = 1000,
-    RateLimitExceeded = 1001,
-    InsufficientLiquidity = 1002,
-    HoneyPot = 1003
-}
 type AggregatorErrorCode = TypesErrorCode;
-declare function getAggregatorServerErrorMessage(code: AggregatorServerErrorCode): string;
 /**
  * AggregatorError is a custom error class that extends the built-in Error class. It is used to represent errors that occur during aggregation operations.
  * The key functionality of this code includes:
@@ -745,6 +817,21 @@ declare class AggregatorError extends Error {
     constructor(message: string, errorCode?: AggregatorErrorCode | string);
     static isAggregatorErrorCode(e: any, code: AggregatorErrorCode): boolean;
 }
+declare enum AggregatorServerErrorCode {
+    NumberTooLarge = 1000,
+    RateLimitExceeded = 1001,
+    InsufficientLiquidity = 1002,
+    HoneyPot = 1003,
+    BadRequest = 1004,
+    Forbidden = 1005,
+    InternalServerError = 1006,
+    NotFoundRoute = 1007,
+    ServiceUnavailable = 1008,
+    UnsupportedApiVersion = 1009,
+    HoneyPotScam = 1010,
+    UnknownError = 400
+}
+declare function getAggregatorServerErrorMessage(code: AggregatorServerErrorCode, msg?: string): string;
 
 type BuildRouterSwapParams = {
     routers: Router[];
@@ -906,4 +993,4 @@ declare class CoinUtils {
     static calculateTotalBalance(coins: CoinAsset[]): bigint;
 }
 
-export { AFSUI, AFTERMATH, AFTERMATH_AMM, AFTERMATH_MODULE, AGGREGATOR, AGGREGATOR_V3_CONFIG, ALL_DEXES, ALPHAFI, AggregatorClient, type AggregatorClientParams, AggregatorConfig, AggregatorError, type AggregatorErrorCode, type AggregatorResponse, AggregatorServerErrorCode, BLUEFIN, BLUEMOVE, type BigNumber, type BuildCoinResult, type BuildFastRouterSwapParams, type BuildFastRouterSwapParamsV2, type BuildFastRouterSwapParamsV3, type BuildRouterSwapParams, type BuildRouterSwapParamsV2, type BuildRouterSwapParamsV3, CETUS, CETUS_DEX, CETUS_MODULE, CETUS_PUBLISHED_AT, CETUS_V3_PUBLISHED_AT, CHECK_COINS_THRESHOLD_FUNC, CLIENT_CONFIG, CLOCK_ADDRESS, type CoinAsset, CoinInfoAddress, CoinStoreAddress, CoinUtils, type ComparisonResult, ConfigErrorCode, DEEPBOOKV2, DEEPBOOKV3, DEEPBOOK_CLOB_V2_MODULE, DEEPBOOK_CUSTODIAN_V2_MODULE, DEEPBOOK_DEX, DEEPBOOK_MODULE, DEEPBOOK_PACKAGE_ID, DEEPBOOK_PUBLISHED_AT, DEEPBOOK_V3_DEEP_FEE_TYPES, DEFAULT_AGG_V2_ENDPOINT, DEFAULT_AGG_V3_ENDPOINT, DEFAULT_ENDPOINT, DEFAULT_GAS_BUDGET_FOR_MERGE, DEFAULT_GAS_BUDGET_FOR_SPLIT, DEFAULT_GAS_BUDGET_FOR_STAKE, DEFAULT_GAS_BUDGET_FOR_TRANSFER, DEFAULT_GAS_BUDGET_FOR_TRANSFER_SUI, DEFAULT_NFT_TRANSFER_GAS_FEE, type DeepbookV3Config, type DeepbookV3ConfigResponse, type Dex, Env, type ExtendedDetails, FLOWXV2, FLOWXV3, FLOWX_AMM, FLOWX_AMM_MODULE, FULLSAIL, type FindRouterParams, FlashSwapA2BFunc, FlashSwapB2AFunc, FlashSwapFunc, FlashSwapWithPartnerA2BFunc, FlashSwapWithPartnerB2AFunc, FlashSwapWithPartnerFunc, type FlattenedPath, GAS_SYMBOL, GAS_TYPE_ARG, GAS_TYPE_ARG_LONG, type GasMetrics, type GetOrCreateAccountCapResult, HAEDAL, HAEDALHMMV2, HAEDALPMM, HAWAL, INTEGRATE, JOIN_FUNC, KRIYA, KRIYAV3, KRIYA_DEX, KRIYA_MODULE, MAGMA, MAINNET_AFTERMATH_INSURANCE_FUND_ID, MAINNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, MAINNET_AFTERMATH_REFERRAL_VAULT_ID, MAINNET_AFTERMATH_REGISTRY_ID, MAINNET_AFTERMATH_TREASURY_ID, MAINNET_CETUS_GLOBAL_CONFIG_ID, MAINNET_FLOWX_AMM_CONTAINER_ID, METASTABLE, MOMENTUM, type NFT, OBRIC, ONE, PACKAGE_NAMES, PAY_MODULE, POOL_MODULT, PUBLISHED_ADDRESSES, PYTH_CONFIG, type Package, type Path, type PathV2, type PreSwapLpChangeParams, type ProcessedRouterData, type PythConfig, REPAY_FLASH_SWAP_A2B_FUNC, REPAY_FLASH_SWAP_B2A_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_A2B_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_B2A_FUNC, RepayFalshSwapFunc, RepayFlashSwapWithPartnerFunc, type Router, type RouterData, type RouterDataV2, type RouterDataV3, type RouterError, type RouterV2, SCALLOP, SEVENK, SPRINGSUI, STEAMM, STEAMM_OMM, STEAMM_OMM_V2, SUILEND, SUI_SYSTEM_STATE_OBJECT_ID, SWAP_A2B_FUNC, SWAP_B2A_FUNC, type SuiAddress, type SuiBasicTypes, type SuiInputTypes, type SuiObjectIdType, type SuiResource, type SuiStructTag, type SuiTxArg, SuiZeroCoinFn, type SwapGasAnalysis, type SwapInPoolsParams, type SwapInPoolsResultV3, TEN_POW_NINE, TESTNET_AFTERMATH_INSURANCE_FUND_ID, TESTNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, TESTNET_AFTERMATH_REFERRAL_VAULT_ID, TESTNET_AFTERMATH_REGISTRY_ID, TESTNET_AFTERMATH_TREASURY_ID, TESTNET_CETUS_GLOBAL_CONFIG_ID, TESTNET_FLOWX_AMM_CONTAINER_ID, TRANSFER_ACCOUNT_CAP, TRANSFER_OR_DESTORY_COIN_FUNC, TURBOS, TURBOS_DEX, TURBOS_MODULE, TURBOS_VERSIONED, TWO, TransactionErrorCode, TypesErrorCode, U128, U64_MAX, U64_MAX_BN, UTILS_MODULE, VOLO, ZERO, buildInputCoin, calculateGasEfficiency, calculatePriceImpact, checkInvalidSuiAddress, compareCoins, compareGasMetrics, completionCoin, composeType, createTarget, dealWithFastRouterSwapParamsForMsafe, exportToCSV, exportToJSON, extractAddressFromType, extractGasMetrics, extractStructTagFromType, extractTimestampFromDowngradeUuid6, fixSuiObjectId, formatGasMetrics, generateDowngradeUuid6, generateSimpleDowngradeUuid6, getAggregatorServerErrorMessage, getAggregatorV2Extend2PublishedAt, getAggregatorV2ExtendPublishedAt, getAggregatorV2PublishedAt, getAllProviders, getDeepbookV3Config, getDefaultSuiInputType, getOrCreateAccountCap, getProvidersExcluding, getProvidersIncluding, getRouterResult, isSortedSymbols, isValidDowngradeUuid6, mintZeroCoin, normalizeCoinType, parseAftermathFeeType, parseTurbosPoolFeeType, patchFixSuiObjectId, printTransaction, processEndpoint, processFlattenRoutes, restituteMsafeFastRouterSwapParams };
+export { AFSUI, AFTERMATH, AFTERMATH_AMM, AFTERMATH_MODULE, AGGREGATOR, AGGREGATOR_V3_CONFIG, ALL_DEXES, ALPHAFI, AggregatorClient, type AggregatorClientParams, AggregatorConfig, AggregatorError, type AggregatorErrorCode, type AggregatorResponse, AggregatorServerErrorCode, BLUEFIN, BLUEMOVE, type BigNumber, type BuildCoinResult, type BuildFastMergeSwapParams, type BuildFastRouterSwapParams, type BuildFastRouterSwapParamsV2, type BuildFastRouterSwapParamsV3, type BuildMergeSwapParams, type BuildRouterSwapParams, type BuildRouterSwapParamsV2, type BuildRouterSwapParamsV3, CETUS, CETUSDLMM, CETUS_DEX, CETUS_MODULE, CETUS_PUBLISHED_AT, CETUS_V3_PUBLISHED_AT, CHECK_COINS_THRESHOLD_FUNC, CLIENT_CONFIG, CLOCK_ADDRESS, type CoinAsset, CoinInfoAddress, CoinStoreAddress, CoinUtils, type ComparisonResult, ConfigErrorCode, DEEPBOOKV2, DEEPBOOKV3, DEEPBOOK_CLOB_V2_MODULE, DEEPBOOK_CUSTODIAN_V2_MODULE, DEEPBOOK_DEX, DEEPBOOK_MODULE, DEEPBOOK_PACKAGE_ID, DEEPBOOK_PUBLISHED_AT, DEEPBOOK_V3_DEEP_FEE_TYPES, DEFAULT_AGG_V2_ENDPOINT, DEFAULT_AGG_V3_ENDPOINT, DEFAULT_ENDPOINT, DEFAULT_GAS_BUDGET_FOR_MERGE, DEFAULT_GAS_BUDGET_FOR_SPLIT, DEFAULT_GAS_BUDGET_FOR_STAKE, DEFAULT_GAS_BUDGET_FOR_TRANSFER, DEFAULT_GAS_BUDGET_FOR_TRANSFER_SUI, DEFAULT_NFT_TRANSFER_GAS_FEE, type DeepbookV3Config, type DeepbookV3ConfigResponse, type Dex, Env, type ExtendedDetails, FLOWXV2, FLOWXV3, FLOWX_AMM, FLOWX_AMM_MODULE, FULLSAIL, type FindRouterParams, FlashSwapA2BFunc, FlashSwapB2AFunc, FlashSwapFunc, FlashSwapWithPartnerA2BFunc, FlashSwapWithPartnerB2AFunc, FlashSwapWithPartnerFunc, type FlattenedPath, GAS_SYMBOL, GAS_TYPE_ARG, GAS_TYPE_ARG_LONG, type GasMetrics, type GetOrCreateAccountCapResult, HAEDAL, HAEDALHMMV2, HAEDALPMM, HAWAL, INTEGRATE, JOIN_FUNC, KRIYA, KRIYAV3, KRIYA_DEX, KRIYA_MODULE, MAGMA, MAINNET_AFTERMATH_INSURANCE_FUND_ID, MAINNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, MAINNET_AFTERMATH_REFERRAL_VAULT_ID, MAINNET_AFTERMATH_REGISTRY_ID, MAINNET_AFTERMATH_TREASURY_ID, MAINNET_CETUS_GLOBAL_CONFIG_ID, MAINNET_FLOWX_AMM_CONTAINER_ID, METASTABLE, MOMENTUM, type MergeRoute, type MergeSwapFromCoin, type MergeSwapInputCoin, type MergeSwapParams, type MergeSwapRouterData, type NFT, OBRIC, ONE, PACKAGE_NAMES, PAY_MODULE, POOL_MODULT, PUBLISHED_ADDRESSES, PYTH_CONFIG, type Package, type Path, type PathV2, type PreSwapLpChangeParams, type ProcessedRouterData, type PythConfig, REPAY_FLASH_SWAP_A2B_FUNC, REPAY_FLASH_SWAP_B2A_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_A2B_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_B2A_FUNC, RepayFalshSwapFunc, RepayFlashSwapWithPartnerFunc, type Router, type RouterData, type RouterDataV2, type RouterDataV3, type RouterError, type RouterV2, SCALLOP, SEVENK, SPRINGSUI, STEAMM, STEAMM_OMM, STEAMM_OMM_V2, SUILEND, SUI_SYSTEM_STATE_OBJECT_ID, SWAP_A2B_FUNC, SWAP_B2A_FUNC, type SuiAddress, type SuiBasicTypes, type SuiInputTypes, type SuiObjectIdType, type SuiResource, type SuiStructTag, type SuiTxArg, SuiZeroCoinFn, type SwapGasAnalysis, type SwapInPoolsParams, type SwapInPoolsResultV3, TEN_POW_NINE, TESTNET_AFTERMATH_INSURANCE_FUND_ID, TESTNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, TESTNET_AFTERMATH_REFERRAL_VAULT_ID, TESTNET_AFTERMATH_REGISTRY_ID, TESTNET_AFTERMATH_TREASURY_ID, TESTNET_CETUS_GLOBAL_CONFIG_ID, TESTNET_FLOWX_AMM_CONTAINER_ID, TRANSFER_ACCOUNT_CAP, TRANSFER_OR_DESTORY_COIN_FUNC, TURBOS, TURBOS_DEX, TURBOS_MODULE, TURBOS_VERSIONED, TWO, TransactionErrorCode, TypesErrorCode, U128, U64_MAX, U64_MAX_BN, UTILS_MODULE, VOLO, ZERO, buildInputCoin, calculateGasEfficiency, calculatePriceImpact, checkInvalidSuiAddress, compareCoins, compareGasMetrics, completionCoin, composeType, createTarget, dealWithFastRouterSwapParamsForMsafe, exportToCSV, exportToJSON, extractAddressFromType, extractGasMetrics, extractStructTagFromType, extractTimestampFromDowngradeUuid6, fixSuiObjectId, formatGasMetrics, generateDowngradeUuid6, generateSimpleDowngradeUuid6, getAggregatorServerErrorMessage, getAggregatorV2Extend2PublishedAt, getAggregatorV2ExtendPublishedAt, getAggregatorV2PublishedAt, getAllProviders, getDeepbookV3Config, getDefaultSuiInputType, getMergeSwapResult, getOrCreateAccountCap, getProvidersExcluding, getProvidersIncluding, getRouterResult, isSortedSymbols, isValidDowngradeUuid6, mintZeroCoin, normalizeCoinType, parseAftermathFeeType, parseTurbosPoolFeeType, patchFixSuiObjectId, printTransaction, processEndpoint, processFlattenRoutes, restituteMsafeFastRouterSwapParams };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _mysten_sui_client from '@mysten/sui/client';
 import { SuiClient, DevInspectResults, SuiMoveObject } from '@mysten/sui/client';
-import { Transaction, TransactionObjectArgument, TransactionArgument } from '@mysten/sui/transactions';
+import { TransactionObjectArgument, Transaction, TransactionArgument } from '@mysten/sui/transactions';
 import BN from 'bn.js';
 import Decimal from 'decimal.js';
 import { SuiPriceServiceConnection, SuiPythClient } from '@pythnetwork/pyth-sui-js';
@@ -18,6 +18,64 @@ interface FindRouterParams {
     providers?: string[];
     liquidityChanges?: PreSwapLpChangeParams[];
 }
+interface MergeSwapFromCoin {
+    coinType: string;
+    amount: BN | string | number;
+}
+interface MergeSwapFromCoin {
+    coinType: string;
+    amount: BN | string | number;
+}
+interface MergeSwapParams {
+    target: string;
+    byAmountIn: boolean;
+    depth?: number;
+    providers?: string[];
+    froms: MergeSwapFromCoin[];
+}
+interface MergeSwapParams {
+    target: string;
+    byAmountIn: boolean;
+    depth?: number;
+    providers?: string[];
+    froms: MergeSwapFromCoin[];
+}
+interface MergeSwapInputCoin {
+    coinType: string;
+    coin: TransactionObjectArgument;
+}
+interface MergeSwapInputCoin {
+    coinType: string;
+    coin: TransactionObjectArgument;
+}
+interface BuildMergeSwapParams {
+    router: MergeSwapRouterData;
+    inputCoins: MergeSwapInputCoin[];
+    slippage: number;
+    txb: Transaction;
+    partner?: string;
+}
+interface BuildMergeSwapParams {
+    router: MergeSwapRouterData;
+    inputCoins: MergeSwapInputCoin[];
+    slippage: number;
+    txb: Transaction;
+    partner?: string;
+}
+interface BuildFastMergeSwapParams {
+    router: MergeSwapRouterData;
+    slippage: number;
+    txb: Transaction;
+    partner?: string;
+    payDeepFeeAmount?: number;
+}
+interface BuildFastMergeSwapParams {
+    router: MergeSwapRouterData;
+    slippage: number;
+    txb: Transaction;
+    partner?: string;
+    payDeepFeeAmount?: number;
+}
 interface PreSwapLpChangeParams {
     poolID: string;
     ticklower: number;
@@ -113,6 +171,20 @@ type RouterDataV3 = {
     error?: RouterError;
     overlayFee?: number;
 };
+type MergeRoute = {
+    amountIn: BN;
+    amountOut: BN;
+    deviationRatio: string;
+    paths: Path[];
+};
+type MergeSwapRouterData = {
+    quoteID?: string;
+    totalAmountOut: BN;
+    allRoutes: MergeRoute[];
+    packages?: Map<string, string>;
+    gas?: number;
+    error?: RouterError;
+};
 type FlattenedPath = {
     path: Path;
     isLastUseOfIntermediateToken: boolean;
@@ -199,6 +271,7 @@ declare class AggregatorConfig {
 }
 
 declare function getRouterResult(endpoint: string, apiKey: string, params: FindRouterParams, overlayFee: number, overlayFeeReceiver: string): Promise<RouterDataV3 | null>;
+declare function getMergeSwapResult(endpoint: string, apiKey: string, params: MergeSwapParams, overlayFee: number, overlayFeeReceiver: string): Promise<MergeSwapRouterData | null>;
 declare function getDeepbookV3Config(endpoint: string): Promise<DeepbookV3ConfigResponse | null>;
 declare function processFlattenRoutes(routerData: RouterDataV3): ProcessedRouterData;
 
@@ -240,6 +313,7 @@ declare const MAGMA = "MAGMA";
 declare const SEVENK = "SEVENK";
 declare const HAEDALHMMV2 = "HAEDALHMMV2";
 declare const FULLSAIL = "FULLSAIL";
+declare const CETUSDLMM = "CETUSDLMM";
 declare const DEFAULT_ENDPOINT = "https://api-sui.cetus.zone/router_v3";
 declare const ALL_DEXES: string[];
 type BuildRouterSwapParamsV3 = {
@@ -293,6 +367,7 @@ type AggregatorClientParams = {
     partner?: string;
     overlayFeeRate?: number;
     overlayFeeReceiver?: string;
+    cetusDlmmPartner?: string;
 };
 declare class AggregatorClient {
     endpoint: string;
@@ -305,6 +380,7 @@ declare class AggregatorClient {
     protected overlayFeeRate: number;
     protected overlayFeeReceiver: string;
     protected partner?: string;
+    protected cetusDlmmPartner?: string;
     private static readonly CONFIG;
     constructor(params: AggregatorClientParams);
     newPythClients(pythUrls: string[]): SuiPriceServiceConnection[];
@@ -312,13 +388,16 @@ declare class AggregatorClient {
     getDeepbookV3Config(): Promise<DeepbookV3ConfigResponse | null>;
     getOneCoinUsedToMerge(coinType: string): Promise<string | null>;
     findRouters(params: FindRouterParams): Promise<RouterDataV3 | null>;
+    findMergeSwapRouters(params: MergeSwapParams): Promise<MergeSwapRouterData | null>;
     executeFlexibleInputSwap(txb: Transaction, inputCoin: TransactionObjectArgument, routerData: RouterDataV3, expectedAmountOut: string, amountLimit: string, pythPriceIDs: Map<string, string>, partner?: string, deepbookv3DeepFee?: TransactionObjectArgument, packages?: Map<string, string>): Promise<void>;
-    newDexRouterV3(provider: string, pythPriceIDs: Map<string, string>, partner?: string): DexRouter;
-    expectInputSwapV3(txb: Transaction, inputCoin: TransactionObjectArgument, routerData: RouterDataV3, expectAmountOut: string, amountOutLimit: string, pythPriceIDs: Map<string, string>, partner?: string): TransactionObjectArgument;
+    newDexRouterV3(provider: string, pythPriceIDs: Map<string, string>, partner?: string, cetusDlmmPartner?: string): DexRouter;
+    expectInputSwapV3(txb: Transaction, inputCoin: TransactionObjectArgument, routerData: RouterDataV3, expectAmountOut: string, amountOutLimit: string, pythPriceIDs: Map<string, string>, partner?: string, cetusDlmmPartner?: string): TransactionObjectArgument;
     expectOutputSwapV3(txb: Transaction, inputCoin: TransactionObjectArgument, routerData: RouterDataV3, amountOut: string, _amountLimit: string, // it will set when build inputcoin
     partner?: string): TransactionObjectArgument;
     routerSwap(params: BuildRouterSwapParamsV3): Promise<TransactionObjectArgument>;
     fastRouterSwap(params: BuildFastRouterSwapParamsV3): Promise<void>;
+    mergeSwap(params: BuildMergeSwapParams): Promise<TransactionObjectArgument>;
+    fastMergeSwap(params: BuildFastMergeSwapParams): Promise<void>;
     fixableRouterSwapV3(params: BuildRouterSwapParamsV3): Promise<TransactionObjectArgument>;
     swapInPools(params: SwapInPoolsParams): Promise<SwapInPoolsResultV3>;
     updatePythPriceIDs(priceIDs: string[], txb: Transaction): Promise<Map<string, string>>;
@@ -725,14 +804,7 @@ declare enum TransactionErrorCode {
     MissTurbosFeeType = "MissTurbosFeeType",
     MissAftermathLpSupplyType = "MissAftermathLpSupplyType"
 }
-declare enum AggregatorServerErrorCode {
-    NumberTooLarge = 1000,
-    RateLimitExceeded = 1001,
-    InsufficientLiquidity = 1002,
-    HoneyPot = 1003
-}
 type AggregatorErrorCode = TypesErrorCode;
-declare function getAggregatorServerErrorMessage(code: AggregatorServerErrorCode): string;
 /**
  * AggregatorError is a custom error class that extends the built-in Error class. It is used to represent errors that occur during aggregation operations.
  * The key functionality of this code includes:
@@ -745,6 +817,21 @@ declare class AggregatorError extends Error {
     constructor(message: string, errorCode?: AggregatorErrorCode | string);
     static isAggregatorErrorCode(e: any, code: AggregatorErrorCode): boolean;
 }
+declare enum AggregatorServerErrorCode {
+    NumberTooLarge = 1000,
+    RateLimitExceeded = 1001,
+    InsufficientLiquidity = 1002,
+    HoneyPot = 1003,
+    BadRequest = 1004,
+    Forbidden = 1005,
+    InternalServerError = 1006,
+    NotFoundRoute = 1007,
+    ServiceUnavailable = 1008,
+    UnsupportedApiVersion = 1009,
+    HoneyPotScam = 1010,
+    UnknownError = 400
+}
+declare function getAggregatorServerErrorMessage(code: AggregatorServerErrorCode, msg?: string): string;
 
 type BuildRouterSwapParams = {
     routers: Router[];
@@ -906,4 +993,4 @@ declare class CoinUtils {
     static calculateTotalBalance(coins: CoinAsset[]): bigint;
 }
 
-export { AFSUI, AFTERMATH, AFTERMATH_AMM, AFTERMATH_MODULE, AGGREGATOR, AGGREGATOR_V3_CONFIG, ALL_DEXES, ALPHAFI, AggregatorClient, type AggregatorClientParams, AggregatorConfig, AggregatorError, type AggregatorErrorCode, type AggregatorResponse, AggregatorServerErrorCode, BLUEFIN, BLUEMOVE, type BigNumber, type BuildCoinResult, type BuildFastRouterSwapParams, type BuildFastRouterSwapParamsV2, type BuildFastRouterSwapParamsV3, type BuildRouterSwapParams, type BuildRouterSwapParamsV2, type BuildRouterSwapParamsV3, CETUS, CETUS_DEX, CETUS_MODULE, CETUS_PUBLISHED_AT, CETUS_V3_PUBLISHED_AT, CHECK_COINS_THRESHOLD_FUNC, CLIENT_CONFIG, CLOCK_ADDRESS, type CoinAsset, CoinInfoAddress, CoinStoreAddress, CoinUtils, type ComparisonResult, ConfigErrorCode, DEEPBOOKV2, DEEPBOOKV3, DEEPBOOK_CLOB_V2_MODULE, DEEPBOOK_CUSTODIAN_V2_MODULE, DEEPBOOK_DEX, DEEPBOOK_MODULE, DEEPBOOK_PACKAGE_ID, DEEPBOOK_PUBLISHED_AT, DEEPBOOK_V3_DEEP_FEE_TYPES, DEFAULT_AGG_V2_ENDPOINT, DEFAULT_AGG_V3_ENDPOINT, DEFAULT_ENDPOINT, DEFAULT_GAS_BUDGET_FOR_MERGE, DEFAULT_GAS_BUDGET_FOR_SPLIT, DEFAULT_GAS_BUDGET_FOR_STAKE, DEFAULT_GAS_BUDGET_FOR_TRANSFER, DEFAULT_GAS_BUDGET_FOR_TRANSFER_SUI, DEFAULT_NFT_TRANSFER_GAS_FEE, type DeepbookV3Config, type DeepbookV3ConfigResponse, type Dex, Env, type ExtendedDetails, FLOWXV2, FLOWXV3, FLOWX_AMM, FLOWX_AMM_MODULE, FULLSAIL, type FindRouterParams, FlashSwapA2BFunc, FlashSwapB2AFunc, FlashSwapFunc, FlashSwapWithPartnerA2BFunc, FlashSwapWithPartnerB2AFunc, FlashSwapWithPartnerFunc, type FlattenedPath, GAS_SYMBOL, GAS_TYPE_ARG, GAS_TYPE_ARG_LONG, type GasMetrics, type GetOrCreateAccountCapResult, HAEDAL, HAEDALHMMV2, HAEDALPMM, HAWAL, INTEGRATE, JOIN_FUNC, KRIYA, KRIYAV3, KRIYA_DEX, KRIYA_MODULE, MAGMA, MAINNET_AFTERMATH_INSURANCE_FUND_ID, MAINNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, MAINNET_AFTERMATH_REFERRAL_VAULT_ID, MAINNET_AFTERMATH_REGISTRY_ID, MAINNET_AFTERMATH_TREASURY_ID, MAINNET_CETUS_GLOBAL_CONFIG_ID, MAINNET_FLOWX_AMM_CONTAINER_ID, METASTABLE, MOMENTUM, type NFT, OBRIC, ONE, PACKAGE_NAMES, PAY_MODULE, POOL_MODULT, PUBLISHED_ADDRESSES, PYTH_CONFIG, type Package, type Path, type PathV2, type PreSwapLpChangeParams, type ProcessedRouterData, type PythConfig, REPAY_FLASH_SWAP_A2B_FUNC, REPAY_FLASH_SWAP_B2A_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_A2B_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_B2A_FUNC, RepayFalshSwapFunc, RepayFlashSwapWithPartnerFunc, type Router, type RouterData, type RouterDataV2, type RouterDataV3, type RouterError, type RouterV2, SCALLOP, SEVENK, SPRINGSUI, STEAMM, STEAMM_OMM, STEAMM_OMM_V2, SUILEND, SUI_SYSTEM_STATE_OBJECT_ID, SWAP_A2B_FUNC, SWAP_B2A_FUNC, type SuiAddress, type SuiBasicTypes, type SuiInputTypes, type SuiObjectIdType, type SuiResource, type SuiStructTag, type SuiTxArg, SuiZeroCoinFn, type SwapGasAnalysis, type SwapInPoolsParams, type SwapInPoolsResultV3, TEN_POW_NINE, TESTNET_AFTERMATH_INSURANCE_FUND_ID, TESTNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, TESTNET_AFTERMATH_REFERRAL_VAULT_ID, TESTNET_AFTERMATH_REGISTRY_ID, TESTNET_AFTERMATH_TREASURY_ID, TESTNET_CETUS_GLOBAL_CONFIG_ID, TESTNET_FLOWX_AMM_CONTAINER_ID, TRANSFER_ACCOUNT_CAP, TRANSFER_OR_DESTORY_COIN_FUNC, TURBOS, TURBOS_DEX, TURBOS_MODULE, TURBOS_VERSIONED, TWO, TransactionErrorCode, TypesErrorCode, U128, U64_MAX, U64_MAX_BN, UTILS_MODULE, VOLO, ZERO, buildInputCoin, calculateGasEfficiency, calculatePriceImpact, checkInvalidSuiAddress, compareCoins, compareGasMetrics, completionCoin, composeType, createTarget, dealWithFastRouterSwapParamsForMsafe, exportToCSV, exportToJSON, extractAddressFromType, extractGasMetrics, extractStructTagFromType, extractTimestampFromDowngradeUuid6, fixSuiObjectId, formatGasMetrics, generateDowngradeUuid6, generateSimpleDowngradeUuid6, getAggregatorServerErrorMessage, getAggregatorV2Extend2PublishedAt, getAggregatorV2ExtendPublishedAt, getAggregatorV2PublishedAt, getAllProviders, getDeepbookV3Config, getDefaultSuiInputType, getOrCreateAccountCap, getProvidersExcluding, getProvidersIncluding, getRouterResult, isSortedSymbols, isValidDowngradeUuid6, mintZeroCoin, normalizeCoinType, parseAftermathFeeType, parseTurbosPoolFeeType, patchFixSuiObjectId, printTransaction, processEndpoint, processFlattenRoutes, restituteMsafeFastRouterSwapParams };
+export { AFSUI, AFTERMATH, AFTERMATH_AMM, AFTERMATH_MODULE, AGGREGATOR, AGGREGATOR_V3_CONFIG, ALL_DEXES, ALPHAFI, AggregatorClient, type AggregatorClientParams, AggregatorConfig, AggregatorError, type AggregatorErrorCode, type AggregatorResponse, AggregatorServerErrorCode, BLUEFIN, BLUEMOVE, type BigNumber, type BuildCoinResult, type BuildFastMergeSwapParams, type BuildFastRouterSwapParams, type BuildFastRouterSwapParamsV2, type BuildFastRouterSwapParamsV3, type BuildMergeSwapParams, type BuildRouterSwapParams, type BuildRouterSwapParamsV2, type BuildRouterSwapParamsV3, CETUS, CETUSDLMM, CETUS_DEX, CETUS_MODULE, CETUS_PUBLISHED_AT, CETUS_V3_PUBLISHED_AT, CHECK_COINS_THRESHOLD_FUNC, CLIENT_CONFIG, CLOCK_ADDRESS, type CoinAsset, CoinInfoAddress, CoinStoreAddress, CoinUtils, type ComparisonResult, ConfigErrorCode, DEEPBOOKV2, DEEPBOOKV3, DEEPBOOK_CLOB_V2_MODULE, DEEPBOOK_CUSTODIAN_V2_MODULE, DEEPBOOK_DEX, DEEPBOOK_MODULE, DEEPBOOK_PACKAGE_ID, DEEPBOOK_PUBLISHED_AT, DEEPBOOK_V3_DEEP_FEE_TYPES, DEFAULT_AGG_V2_ENDPOINT, DEFAULT_AGG_V3_ENDPOINT, DEFAULT_ENDPOINT, DEFAULT_GAS_BUDGET_FOR_MERGE, DEFAULT_GAS_BUDGET_FOR_SPLIT, DEFAULT_GAS_BUDGET_FOR_STAKE, DEFAULT_GAS_BUDGET_FOR_TRANSFER, DEFAULT_GAS_BUDGET_FOR_TRANSFER_SUI, DEFAULT_NFT_TRANSFER_GAS_FEE, type DeepbookV3Config, type DeepbookV3ConfigResponse, type Dex, Env, type ExtendedDetails, FLOWXV2, FLOWXV3, FLOWX_AMM, FLOWX_AMM_MODULE, FULLSAIL, type FindRouterParams, FlashSwapA2BFunc, FlashSwapB2AFunc, FlashSwapFunc, FlashSwapWithPartnerA2BFunc, FlashSwapWithPartnerB2AFunc, FlashSwapWithPartnerFunc, type FlattenedPath, GAS_SYMBOL, GAS_TYPE_ARG, GAS_TYPE_ARG_LONG, type GasMetrics, type GetOrCreateAccountCapResult, HAEDAL, HAEDALHMMV2, HAEDALPMM, HAWAL, INTEGRATE, JOIN_FUNC, KRIYA, KRIYAV3, KRIYA_DEX, KRIYA_MODULE, MAGMA, MAINNET_AFTERMATH_INSURANCE_FUND_ID, MAINNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, MAINNET_AFTERMATH_REFERRAL_VAULT_ID, MAINNET_AFTERMATH_REGISTRY_ID, MAINNET_AFTERMATH_TREASURY_ID, MAINNET_CETUS_GLOBAL_CONFIG_ID, MAINNET_FLOWX_AMM_CONTAINER_ID, METASTABLE, MOMENTUM, type MergeRoute, type MergeSwapFromCoin, type MergeSwapInputCoin, type MergeSwapParams, type MergeSwapRouterData, type NFT, OBRIC, ONE, PACKAGE_NAMES, PAY_MODULE, POOL_MODULT, PUBLISHED_ADDRESSES, PYTH_CONFIG, type Package, type Path, type PathV2, type PreSwapLpChangeParams, type ProcessedRouterData, type PythConfig, REPAY_FLASH_SWAP_A2B_FUNC, REPAY_FLASH_SWAP_B2A_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_A2B_FUNC, REPAY_FLASH_SWAP_WITH_PARTNER_B2A_FUNC, RepayFalshSwapFunc, RepayFlashSwapWithPartnerFunc, type Router, type RouterData, type RouterDataV2, type RouterDataV3, type RouterError, type RouterV2, SCALLOP, SEVENK, SPRINGSUI, STEAMM, STEAMM_OMM, STEAMM_OMM_V2, SUILEND, SUI_SYSTEM_STATE_OBJECT_ID, SWAP_A2B_FUNC, SWAP_B2A_FUNC, type SuiAddress, type SuiBasicTypes, type SuiInputTypes, type SuiObjectIdType, type SuiResource, type SuiStructTag, type SuiTxArg, SuiZeroCoinFn, type SwapGasAnalysis, type SwapInPoolsParams, type SwapInPoolsResultV3, TEN_POW_NINE, TESTNET_AFTERMATH_INSURANCE_FUND_ID, TESTNET_AFTERMATH_PROTOCOL_FEE_VAULT_ID, TESTNET_AFTERMATH_REFERRAL_VAULT_ID, TESTNET_AFTERMATH_REGISTRY_ID, TESTNET_AFTERMATH_TREASURY_ID, TESTNET_CETUS_GLOBAL_CONFIG_ID, TESTNET_FLOWX_AMM_CONTAINER_ID, TRANSFER_ACCOUNT_CAP, TRANSFER_OR_DESTORY_COIN_FUNC, TURBOS, TURBOS_DEX, TURBOS_MODULE, TURBOS_VERSIONED, TWO, TransactionErrorCode, TypesErrorCode, U128, U64_MAX, U64_MAX_BN, UTILS_MODULE, VOLO, ZERO, buildInputCoin, calculateGasEfficiency, calculatePriceImpact, checkInvalidSuiAddress, compareCoins, compareGasMetrics, completionCoin, composeType, createTarget, dealWithFastRouterSwapParamsForMsafe, exportToCSV, exportToJSON, extractAddressFromType, extractGasMetrics, extractStructTagFromType, extractTimestampFromDowngradeUuid6, fixSuiObjectId, formatGasMetrics, generateDowngradeUuid6, generateSimpleDowngradeUuid6, getAggregatorServerErrorMessage, getAggregatorV2Extend2PublishedAt, getAggregatorV2ExtendPublishedAt, getAggregatorV2PublishedAt, getAllProviders, getDeepbookV3Config, getDefaultSuiInputType, getMergeSwapResult, getOrCreateAccountCap, getProvidersExcluding, getProvidersIncluding, getRouterResult, isSortedSymbols, isValidDowngradeUuid6, mintZeroCoin, normalizeCoinType, parseAftermathFeeType, parseTurbosPoolFeeType, patchFixSuiObjectId, printTransaction, processEndpoint, processFlattenRoutes, restituteMsafeFastRouterSwapParams };