@7kprotocol/sdk-ts 3.4.0 → 3.4.2-beta.0

package/lib/cjs/features/limitDca/placeLimitOrder.js

@@ -1,11 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.placeLimitOrder = placeLimitOrder;
-const getSplitCoinForTx_1 = require("../../libs/getSplitCoinForTx");
-const token_1 = require("../../utils/token");
+const transactions_1 = require("@mysten/sui/transactions");
 const constants_1 = require("./constants");
 async function placeLimitOrder({ accountAddress, payCoinType, targetCoinType, payCoinAmount, rate, slippage, expireTs, devInspect, }) {
-    const { tx, coinData: payCoin } = await (0, getSplitCoinForTx_1.getSplitCoinForTx)(accountAddress, payCoinAmount.toString(), [payCoinAmount.toString()], (0, token_1.denormalizeTokenType)(payCoinType), undefined, devInspect);
+    const tx = new transactions_1.Transaction();
+    const payCoin = tx.add((0, transactions_1.coinWithBalance)({
+        type: payCoinType,
+        balance: payCoinAmount,
+        useGasCoin: !devInspect,
+    }));
     tx.moveCall({
         target: `${constants_1.LIMIT_ORDER_MODULE_ID}::place_limit_order`,
         arguments: [
@@ -18,5 +22,6 @@ async function placeLimitOrder({ accountAddress, payCoinType, targetCoinType, pa
         ],
         typeArguments: [payCoinType, targetCoinType],
     });
+    tx.setSenderIfNotSet(accountAddress);
     return tx;
 }

package/lib/cjs/features/swap/buildTx.js

@@ -1,19 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildTx = void 0;
+exports.buildBluefinXTx = exports.settle = exports.getExpectedReturn = exports.validateRoutes = exports.updatePythPriceFeedsIfAny = exports.getPythPriceFeeds = exports.buildTx = void 0;
 const transactions_1 = require("@mysten/sui/transactions");
 const utils_1 = require("@mysten/sui/utils");
 const config_1 = require("../../config");
 const _7k_1 = require("../../constants/_7k");
-const getSplitCoinForTx_1 = require("../../libs/getSplitCoinForTx");
 const groupSwapRoutes_1 = require("../../libs/groupSwapRoutes");
 const client_1 = require("../../libs/protocols/bluefinx/client");
 const types_1 = require("../../libs/protocols/bluefinx/types");
 const swapWithRoute_1 = require("../../libs/swapWithRoute");
 const aggregator_1 = require("../../types/aggregator");
 const sui_1 = require("../../utils/sui");
-const token_1 = require("../../utils/token");
 const config_2 = require("./config");
+const getQuote_1 = require("./getQuote");
 const buildTx = async ({ quoteResponse, accountAddress, slippage, commission: __commission, devInspect, extendTx, isSponsored, }) => {
     const isBluefinX = (0, aggregator_1.isBluefinXRouting)(quoteResponse);
     const _commission = {
@@ -21,7 +20,7 @@ const buildTx = async ({ quoteResponse, accountAddress, slippage, commission: __
         // commission is ignored for bluefinx
         commissionBps: isBluefinX ? 0 : __commission.commissionBps,
     };
-    const { tx: _tx, coinIn } = extendTx || {};
+    const { tx: _tx, coinIn: _coinIn } = extendTx || {};
     let coinOut;
     if (isBluefinX && devInspect) {
         throw new Error("BluefinX tx is sponsored, skip devInspect");
@@ -37,17 +36,17 @@ const buildTx = async ({ quoteResponse, accountAddress, slippage, commission: __
     }
     const tx = _tx || new transactions_1.Transaction();
     const routes = (0, groupSwapRoutes_1.groupSwapRoutes)(quoteResponse);
+    (0, exports.validateRoutes)(routes, isSponsored);
     const splits = routes.map((group) => group[0]?.amount ?? "0");
-    let coinData;
-    if (coinIn) {
-        coinData = tx.splitCoins(coinIn, splits);
-        sui_1.SuiUtils.transferOrDestroyZeroCoin(tx, quoteResponse.tokenIn, coinIn, accountAddress);
-    }
-    else {
-        const { coinData: _data } = await (0, getSplitCoinForTx_1.getSplitCoinForTx)(accountAddress, quoteResponse.swapAmountWithDecimal, splits, (0, token_1.denormalizeTokenType)(quoteResponse.tokenIn), tx, devInspect, isSponsored || isBluefinX);
-        coinData = _data;
-    }
-    const pythMap = await updatePythPriceFeedsIfAny(tx, quoteResponse);
+    const coinIn = _coinIn ||
+        tx.add((0, transactions_1.coinWithBalance)({
+            type: quoteResponse.tokenIn,
+            balance: BigInt(quoteResponse.swapAmountWithDecimal),
+            useGasCoin: !isSponsored && !isBluefinX,
+        }));
+    const coinData = tx.splitCoins(coinIn, splits);
+    sui_1.SuiUtils.transferOrDestroyZeroCoin(tx, quoteResponse.tokenIn, coinIn, accountAddress);
+    const pythMap = await (0, exports.updatePythPriceFeedsIfAny)(tx, [quoteResponse]);
     const coinObjects = [];
     const config = await (0, config_2.getConfig)();
     await Promise.all(routes.map(async (route, index) => {
@@ -65,79 +64,43 @@ const buildTx = async ({ quoteResponse, accountAddress, slippage, commission: __
         }
     }));
     if (coinObjects.length > 0) {
-        const mergeCoin = coinObjects.length > 1
-            ? sui_1.SuiUtils.mergeCoins(coinObjects, tx)
-            : coinObjects[0];
-        const returnAmountAfterCommission = (BigInt(10000 - _commission.commissionBps) *
-            BigInt(quoteResponse.returnAmountWithDecimal)) /
-            BigInt(10000);
-        const minReceived = (BigInt(1e9 - +slippage * 1e9) * BigInt(returnAmountAfterCommission)) /
-            BigInt(1e9);
-        tx.moveCall({
-            target: `${_7k_1._7K_PACKAGE_ID}::settle::settle`,
-            typeArguments: [quoteResponse.tokenIn, quoteResponse.tokenOut],
-            arguments: [
-                tx.object(_7k_1._7K_CONFIG),
-                tx.object(_7k_1._7K_VAULT),
-                tx.pure.u64(quoteResponse.swapAmountWithDecimal),
-                mergeCoin,
-                tx.pure.u64(minReceived), // minimum received
-                tx.pure.u64(returnAmountAfterCommission), // expected amount out
-                tx.pure.option("address", (0, utils_1.isValidSuiAddress)(_commission.partner) ? _commission.partner : null),
-                tx.pure.u64(_commission.commissionBps),
-                tx.pure.u64(0),
-            ],
-        });
+        const mergedCoin = tx.add((0, exports.settle)(coinObjects, quoteResponse, Math.floor(+slippage * 10000), _commission));
         if (!extendTx) {
-            tx.transferObjects([mergeCoin], tx.pure.address(accountAddress));
+            tx.transferObjects([mergedCoin], tx.pure.address(accountAddress));
         }
         else {
-            coinOut = mergeCoin;
+            coinOut = mergedCoin;
         }
     }
     if (isBluefinX) {
-        const extra = quoteResponse.swaps[0].extra;
-        if (extra.quoteExpiresAtUtcMillis < Date.now()) {
-            throw new Error("Quote expired");
-        }
-        tx.setSenderIfNotSet(accountAddress);
-        const bytes = await tx.build({
-            client: config_1.Config.getSuiClient(),
-            onlyTransactionKind: true,
-        });
-        const res = await (0, client_1.sponsorBluefinX)({
-            quoteId: extra.quoteId,
-            txBytes: (0, utils_1.toBase64)(bytes),
-            sender: accountAddress,
-        });
-        if (!res.success) {
-            throw new Error("Sponsor failed");
-        }
         return {
-            tx: new types_1.BluefinXTx(res.quoteId, res.data.txBytes),
+            tx: await (0, exports.buildBluefinXTx)(tx, accountAddress, quoteResponse),
             coinOut,
         };
     }
+    tx.setSenderIfNotSet(accountAddress);
     return { tx, coinOut };
 };
 exports.buildTx = buildTx;
-const getPythPriceFeeds = (res) => {
+const getPythPriceFeeds = (responses) => {
     const ids = new Set();
-    for (const s of res.swaps) {
-        for (const o of (s.extra?.oracles || [])) {
-            // FIXME: deprecation price_identifier in the next version
-            const bytes = o.Pyth?.bytes || o.Pyth?.price_identifier?.bytes;
-            if (bytes) {
-                ids.add("0x" + (0, utils_1.toHex)(Uint8Array.from(bytes)));
+    for (const res of responses) {
+        for (const s of res.swaps) {
+            for (const o of s.extra?.oracles || []) {
+                const bytes = o.Pyth?.price_identifier?.bytes || o.Pyth?.bytes;
+                if (bytes) {
+                    ids.add("0x" + (0, utils_1.toHex)(Uint8Array.from(bytes)));
+                }
             }
         }
     }
     return Array.from(ids);
 };
+exports.getPythPriceFeeds = getPythPriceFeeds;
 const updatePythPriceFeedsIfAny = async (tx, quoteResponse) => {
     // update oracles price if any
     const pythMap = {};
-    const pythIds = getPythPriceFeeds(quoteResponse);
+    const pythIds = (0, exports.getPythPriceFeeds)(quoteResponse);
     if (pythIds.length > 0) {
         const prices = await config_1.Config.getPythConnection().getPriceFeedsUpdateData(pythIds);
         const ids = await config_1.Config.getPythClient().updatePriceFeeds(tx, prices, pythIds);
@@ -147,3 +110,86 @@ const updatePythPriceFeedsIfAny = async (tx, quoteResponse) => {
     }
     return pythMap;
 };
+exports.updatePythPriceFeedsIfAny = updatePythPriceFeedsIfAny;
+const validateRoutes = (routes, isSponsored) => {
+    if (!isSponsored) {
+        return;
+    }
+    const hasOracleBasedSource = routes.some((g) => g.some((s) => getQuote_1.ORACLE_BASED_SOURCES.has(s.pool.type)));
+    if (hasOracleBasedSource) {
+        throw new Error("Oracle based sources are not supported for sponsored tx");
+    }
+};
+exports.validateRoutes = validateRoutes;
+const getExpectedReturn = (returnAmount, slippageBps, commissionBps, tipBps = 0) => {
+    if (slippageBps > 10000) {
+        throw new Error("Slippage must be less than 100%");
+    }
+    if (commissionBps > 10000) {
+        throw new Error("Commission must be less than 100%");
+    }
+    if (tipBps > 10000) {
+        throw new Error("Tip must be less than 100%");
+    }
+    const returnAmountWithDecimal = BigInt(returnAmount);
+    const tipAmountWithDecimal = (returnAmountWithDecimal * BigInt(tipBps || 0)) / 10000n;
+    const commissionAmountWithDecimal = ((returnAmountWithDecimal - tipAmountWithDecimal) * BigInt(commissionBps)) /
+        10000n;
+    const expectedReturnWithDecimal = returnAmountWithDecimal -
+        tipAmountWithDecimal -
+        commissionAmountWithDecimal;
+    const minAmountWithDecimal = (expectedReturnWithDecimal * BigInt(1e4 - slippageBps)) / 10000n;
+    return {
+        tipAmount: tipAmountWithDecimal,
+        minAmount: minAmountWithDecimal,
+        commissionAmount: commissionAmountWithDecimal,
+        expectedAmount: expectedReturnWithDecimal.toString(10),
+    };
+};
+exports.getExpectedReturn = getExpectedReturn;
+const settle = (coinObjects, quoteResponse, slippageBps, _commission) => {
+    return (tx) => {
+        const mergeCoin = coinObjects.length > 1
+            ? (tx.mergeCoins(coinObjects[0], coinObjects.slice(1)), coinObjects[0])
+            : coinObjects[0];
+        const { minAmount, expectedAmount } = (0, exports.getExpectedReturn)(quoteResponse.returnAmountWithDecimal, slippageBps, _commission.commissionBps);
+        tx.moveCall({
+            target: `${_7k_1._7K_PACKAGE_ID}::settle::settle`,
+            typeArguments: [quoteResponse.tokenIn, quoteResponse.tokenOut],
+            arguments: [
+                tx.object(_7k_1._7K_CONFIG),
+                tx.object(_7k_1._7K_VAULT),
+                tx.pure.u64(quoteResponse.swapAmountWithDecimal),
+                mergeCoin,
+                tx.pure.u64(minAmount), // minimum received
+                tx.pure.u64(expectedAmount), // expected amount out
+                tx.pure.option("address", (0, utils_1.isValidSuiAddress)(_commission.partner) ? _commission.partner : null),
+                tx.pure.u64(_commission.commissionBps),
+                tx.pure.u64(0),
+            ],
+        });
+        return mergeCoin;
+    };
+};
+exports.settle = settle;
+const buildBluefinXTx = async (tx, accountAddress, quoteResponse) => {
+    const extra = quoteResponse.swaps[0].extra;
+    if (extra.quoteExpiresAtUtcMillis < Date.now()) {
+        throw new Error("Quote expired");
+    }
+    tx.setSenderIfNotSet(accountAddress);
+    const bytes = await tx.build({
+        client: config_1.Config.getSuiClient(),
+        onlyTransactionKind: true,
+    });
+    const res = await (0, client_1.sponsorBluefinX)({
+        quoteId: extra.quoteId,
+        txBytes: (0, utils_1.toBase64)(bytes),
+        sender: accountAddress,
+    });
+    if (!res.success) {
+        throw new Error("Sponsor failed");
+    }
+    return new types_1.BluefinXTx(res.quoteId, res.data.txBytes);
+};
+exports.buildBluefinXTx = buildBluefinXTx;

package/lib/cjs/features/swap/buildTxV2.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.multiSwap = exports.optimize = exports.buildTxV2 = void 0;
+const transactions_1 = require("@mysten/sui/transactions");
+const utils_1 = require("@mysten/sui/utils");
+const groupSwapRoutes_1 = require("../../libs/groupSwapRoutes");
+const swapWithRoute_1 = require("../../libs/swapWithRoute");
+const aggregator_1 = require("../../types/aggregator");
+const sui_1 = require("../../utils/sui");
+const buildTx_1 = require("./buildTx");
+const config_1 = require("./config");
+/**
+ * Wave-based transaction builder that optimizes swap execution by:
+ * 1. Grouping swaps into execution waves based on readiness
+ * 2. Merging redundant swaps to the same pool within each wave
+ * 3. Processing waves sequentially, passing intermediate tokens between waves
+ */
+const buildTxV2 = async ({ quoteResponse, accountAddress, slippage, commission: __commission, devInspect, extendTx, isSponsored, }) => {
+    const isBluefinX = (0, aggregator_1.isBluefinXRouting)(quoteResponse);
+    const _commission = {
+        ...__commission,
+        commissionBps: isBluefinX ? 0 : __commission.commissionBps,
+    };
+    const { tx: _tx, coinIn: _coinIn } = extendTx || {};
+    let coinOut;
+    if (isBluefinX && devInspect) {
+        throw new Error("BluefinX tx is sponsored, skip devInspect");
+    }
+    if (!accountAddress) {
+        throw new Error("Sender address is required");
+    }
+    if (!quoteResponse.routes) {
+        throw new Error("Invalid quote response: 'routes' are required");
+    }
+    if (!(0, utils_1.isValidSuiAddress)(_commission.partner)) {
+        throw new Error("Invalid commission partner address");
+    }
+    const tx = _tx || new transactions_1.Transaction();
+    const routes = (0, groupSwapRoutes_1.groupSwapRoutes)(quoteResponse);
+    (0, buildTx_1.validateRoutes)(routes, isSponsored);
+    const splits = routes.map((group) => group[0]?.amount ?? "0");
+    const coinIn = _coinIn ||
+        tx.add((0, transactions_1.coinWithBalance)({
+            type: quoteResponse.tokenIn,
+            balance: BigInt(quoteResponse.swapAmountWithDecimal),
+            useGasCoin: !isSponsored && !isBluefinX,
+        }));
+    const coinData = tx.splitCoins(coinIn, splits);
+    sui_1.SuiUtils.transferOrDestroyZeroCoin(tx, quoteResponse.tokenIn, coinIn, accountAddress);
+    const pythMap = await (0, buildTx_1.updatePythPriceFeedsIfAny)(tx, [quoteResponse]);
+    const config = await (0, config_1.getConfig)();
+    const finalCoins = await (0, exports.optimize)(pythMap, config, routes, coinData, tx, accountAddress);
+    // Merge all final coins
+    if (finalCoins.length > 0) {
+        let mergeCoin = tx.add((0, buildTx_1.settle)(finalCoins, quoteResponse, Math.floor(+slippage * 10000), _commission));
+        if (!extendTx) {
+            tx.transferObjects([mergeCoin], tx.pure.address(accountAddress));
+        }
+        else {
+            coinOut = mergeCoin;
+        }
+    }
+    if (isBluefinX) {
+        return {
+            tx: await (0, buildTx_1.buildBluefinXTx)(tx, accountAddress, quoteResponse),
+            coinOut,
+        };
+    }
+    tx.setSenderIfNotSet(accountAddress);
+    return { tx, coinOut };
+};
+exports.buildTxV2 = buildTxV2;
+const optimize = async (pythMap, config, routes, coinData, tx, accountAddress) => {
+    // Initialize route states with split coins
+    const routeStates = routes.map((route, index) => ({
+        routeIndex: index,
+        currentHopIndex: 0,
+        currentCoin: coinData[index],
+        swaps: route,
+        completed: false,
+    }));
+    const finalCoins = [];
+    const coinTypeOut = routes[0][routes[0].length - 1].assetOut;
+    // Execute swaps in waves
+    let waveNumber = 0;
+    while (true) {
+        const readyHops = [];
+        routeStates.forEach((state) => {
+            if (state.completed)
+                return;
+            if (state.currentHopIndex >= state.swaps.length) {
+                state.completed = true;
+                finalCoins.push(state.currentCoin);
+                return;
+            }
+            const swap = state.swaps[state.currentHopIndex];
+            readyHops.push({
+                routeIndex: state.routeIndex,
+                hopIndex: state.currentHopIndex,
+                swap,
+                inputCoin: state.currentCoin,
+            });
+        });
+        if (readyHops.length === 0)
+            break;
+        // Group hops by pool for merging opportunities
+        const poolGroups = new Map();
+        readyHops.forEach((hop) => {
+            const poolKey = `${hop.swap.poolId}|${hop.swap.assetIn}|${hop.swap.assetOut}`;
+            if (!poolGroups.has(poolKey)) {
+                poolGroups.set(poolKey, {
+                    swap: hop.swap,
+                    hops: [],
+                });
+            }
+            poolGroups.get(poolKey).hops.push(hop);
+        });
+        // Execute each pool group in this wave
+        const wavePromises = [];
+        for (const group of poolGroups.values()) {
+            const { swap, hops } = group;
+            // For merged swaps, we need to combine input coins first
+            const wavePromise = (async () => {
+                let combinedCoin;
+                if (hops.length > 1) {
+                    // Merge all input coins for this pool
+                    const inputCoins = hops.map((h) => h.inputCoin);
+                    tx.mergeCoins(inputCoins[0], inputCoins.slice(1));
+                    combinedCoin = inputCoins[0];
+                }
+                else {
+                    combinedCoin = hops[0].inputCoin;
+                }
+                // Execute the swap with the combined coin
+                const resultCoin = await (0, swapWithRoute_1.swapWithRoute)({
+                    route: [swap],
+                    inputCoinObject: combinedCoin,
+                    currentAccount: accountAddress,
+                    tx,
+                    config,
+                    pythMap,
+                });
+                if (!resultCoin) {
+                    throw new Error(`Swap failed for pool ${swap.poolId}`);
+                }
+                if (hops[0].swap.assetOut === coinTypeOut) {
+                    finalCoins.push(resultCoin);
+                    hops.forEach((hop) => {
+                        const state = routeStates[hop.routeIndex];
+                        state.completed = true;
+                        state.currentHopIndex++;
+                    });
+                    return;
+                }
+                // For merged swaps, we need to split the output proportionally
+                if (hops.length > 1) {
+                    // Split output proportionally (except the last one which gets the remainder)
+                    const splitAmounts = hops
+                        .slice(1)
+                        .map((hop) => hop.swap.returnAmount);
+                    const splitCoins = splitAmounts.length > 0
+                        ? [resultCoin, ...tx.splitCoins(resultCoin, splitAmounts)]
+                        : [resultCoin];
+                    // Assign split coins back to routes
+                    hops.forEach((hop, index) => {
+                        const state = routeStates[hop.routeIndex];
+                        state.currentCoin = splitCoins[index];
+                        state.currentHopIndex++;
+                    });
+                }
+                else {
+                    // Single swap - simply update the route state
+                    const state = routeStates[hops[0].routeIndex];
+                    state.currentCoin = resultCoin;
+                    state.currentHopIndex++;
+                }
+            })();
+            wavePromises.push(wavePromise);
+        }
+        // Wait for all swaps in this wave to complete
+        await Promise.all(wavePromises);
+        waveNumber++;
+    }
+    return finalCoins;
+};
+exports.optimize = optimize;
+/**
+ * execute multiple swap in single transaction
+ *
+ * User must handle the coins from return
+ * @param param - MultiSwapParams
+ * @returns a map of coinType to coinObject
+ */
+const multiSwap = async ({ sender, slippageBps, swaps, tx, commission, }) => {
+    if (swaps.some((s) => (0, aggregator_1.isBluefinXRouting)(s.quote))) {
+        throw Error("BluefinX routing not supported yet");
+    }
+    // update oracles price if any
+    const pythMap = await (0, buildTx_1.updatePythPriceFeedsIfAny)(tx, swaps.map((s) => s.quote));
+    const map = {};
+    const config = await (0, config_1.getConfig)();
+    for (const { quote: sorResponse, coinIn } of swaps) {
+        const routes = (0, groupSwapRoutes_1.groupSwapRoutes)(sorResponse);
+        const splits = routes.map((group) => group[0]?.amount ?? "0");
+        const coinData = splits.length === 1
+            ? [coinIn]
+            : [coinIn, ...tx.splitCoins(coinIn, splits.slice(1))];
+        const coinObjects = await (0, exports.optimize)(pythMap, config, routes, coinData, tx, sender);
+        if (coinObjects.length > 0) {
+            const mergeCoin = tx.add((0, buildTx_1.settle)(coinObjects, sorResponse, slippageBps, commission));
+            if (!map[(0, utils_1.normalizeStructTag)(sorResponse.tokenOut)]) {
+                map[(0, utils_1.normalizeStructTag)(sorResponse.tokenOut)] = [];
+            }
+            map[(0, utils_1.normalizeStructTag)(sorResponse.tokenOut)].push(mergeCoin);
+        }
+    }
+    const result = {};
+    for (const [tokenOut, coins] of Object.entries(map)) {
+        if (coins.length > 1) {
+            tx.mergeCoins(coins[0], coins.slice(1));
+        }
+        result[tokenOut] = coins[0];
+    }
+    tx.setSenderIfNotSet(sender);
+    return result;
+};
+exports.multiSwap = multiSwap;

package/lib/cjs/features/swap/getQuote.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_SOURCES = void 0;
+exports.ORACLE_BASED_SOURCES = exports.DEFAULT_SOURCES = void 0;
 exports.getQuote = getQuote;
 const utils_1 = require("@mysten/sui/utils");
 const fetchClient_1 = require("../../config/fetchClient");
@@ -30,7 +30,18 @@ exports.DEFAULT_SOURCES = [
     "sevenk_v1",
     "fullsail",
 ];
-async function getQuote({ tokenIn, tokenOut, amountIn, sources = exports.DEFAULT_SOURCES, commissionBps, targetPools, excludedPools, taker, }) {
+exports.ORACLE_BASED_SOURCES = new Set([
+    "obric",
+    "haedal_pmm",
+    "sevenk_v1",
+    "steamm_oracle_quoter",
+    "steamm_oracle_quoter_v2",
+]);
+async function getQuote({ tokenIn, tokenOut, amountIn, sources: _sources = exports.DEFAULT_SOURCES, commissionBps, targetPools, excludedPools, taker, isSponsored, }) {
+    let sources = _sources;
+    if (isSponsored) {
+        sources = _sources.filter((s) => !exports.ORACLE_BASED_SOURCES.has(s));
+    }
     const params = new URLSearchParams({
         amount: amountIn,
         from: (0, utils_1.normalizeStructTag)(tokenIn),

package/lib/cjs/features/swap/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./buildTx"), exports);
+__exportStar(require("./buildTxV2"), exports);
 __exportStar(require("./estimateGasFee"), exports);
 __exportStar(require("./executeTx"), exports);
 __exportStar(require("./getQuote"), exports);

package/lib/cjs/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDcaOrderExecutions = exports.getClosedDcaOrders = exports.cancelDcaOrder = exports.getOpenDcaOrders = exports.placeDcaOrder = exports.getClosedLimitOrders = exports.claimExpiredLimitOrder = exports.cancelLimitOrder = exports.getOpenLimitOrders = exports.placeLimitOrder = exports.DEFAULT_SOURCES = exports.executeBluefinTx = exports.executeTx = exports.getSwapHistory = exports.buildTx = exports.estimateGasFee = exports.getQuote = exports.getSuiPrice = exports.getTokenPrices = exports.getTokenPrice = exports.setSuiClient = exports.getSuiClient = exports.Config = void 0;
+exports.setSuiClient = exports.placeLimitOrder = exports.placeDcaOrder = exports.multiSwap = exports.getTokenPrices = exports.getTokenPrice = exports.getSwapHistory = exports.getSuiPrice = exports.getSuiClient = exports.getQuote = exports.getOpenLimitOrders = exports.getOpenDcaOrders = exports.getDcaOrderExecutions = exports.getClosedLimitOrders = exports.getClosedDcaOrders = exports.executeTx = exports.executeBluefinTx = exports.estimateGasFee = exports.DEFAULT_SOURCES = exports.Config = exports.claimExpiredLimitOrder = exports.cancelLimitOrder = exports.cancelDcaOrder = exports.buildTxV2 = exports.buildTx = void 0;
 __exportStar(require("./types/aggregator"), exports);
 const config_1 = require("./config");
 Object.defineProperty(exports, "Config", { enumerable: true, get: function () { return config_1.Config; } });
@@ -26,11 +26,13 @@ const client_1 = require("./libs/protocols/bluefinx/client");
 Object.defineProperty(exports, "executeBluefinTx", { enumerable: true, get: function () { return client_1.executeBluefinTx; } });
 const swap_1 = require("./features/swap");
 Object.defineProperty(exports, "buildTx", { enumerable: true, get: function () { return swap_1.buildTx; } });
+Object.defineProperty(exports, "buildTxV2", { enumerable: true, get: function () { return swap_1.buildTxV2; } });
+Object.defineProperty(exports, "DEFAULT_SOURCES", { enumerable: true, get: function () { return swap_1.DEFAULT_SOURCES; } });
 Object.defineProperty(exports, "estimateGasFee", { enumerable: true, get: function () { return swap_1.estimateGasFee; } });
 Object.defineProperty(exports, "executeTx", { enumerable: true, get: function () { return swap_1.executeTx; } });
 Object.defineProperty(exports, "getQuote", { enumerable: true, get: function () { return swap_1.getQuote; } });
 Object.defineProperty(exports, "getSwapHistory", { enumerable: true, get: function () { return swap_1.getSwapHistory; } });
-Object.defineProperty(exports, "DEFAULT_SOURCES", { enumerable: true, get: function () { return swap_1.DEFAULT_SOURCES; } });
+Object.defineProperty(exports, "multiSwap", { enumerable: true, get: function () { return swap_1.multiSwap; } });
 const limitDca_1 = require("./features/limitDca");
 Object.defineProperty(exports, "cancelDcaOrder", { enumerable: true, get: function () { return limitDca_1.cancelDcaOrder; } });
 Object.defineProperty(exports, "cancelLimitOrder", { enumerable: true, get: function () { return limitDca_1.cancelLimitOrder; } });
@@ -61,6 +63,8 @@ exports.default = {
     getQuote: swap_1.getQuote,
     estimateGasFee: swap_1.estimateGasFee,
     buildTx: swap_1.buildTx,
+    buildTxV2: swap_1.buildTxV2,
+    multiSwap: swap_1.multiSwap,
     getSwapHistory: swap_1.getSwapHistory,
     executeTx: swap_1.executeTx,
     executeBluefinTx: client_1.executeBluefinTx,

package/lib/cjs/types/features/limitDca/placeLimitOrder.d.ts

@@ -1,3 +1,4 @@
+import { Transaction } from "@mysten/sui/transactions";
 export interface PlaceLimitOrderParams {
     accountAddress: string;
     payCoinType: string;
@@ -8,5 +9,5 @@ export interface PlaceLimitOrderParams {
     expireTs: bigint;
     devInspect?: boolean;
 }
-export declare function placeLimitOrder({ accountAddress, payCoinType, targetCoinType, payCoinAmount, rate, slippage, expireTs, devInspect, }: PlaceLimitOrderParams): Promise<import("@mysten/sui/dist/cjs/transactions").Transaction>;
+export declare function placeLimitOrder({ accountAddress, payCoinType, targetCoinType, payCoinAmount, rate, slippage, expireTs, devInspect, }: PlaceLimitOrderParams): Promise<Transaction>;
 //# sourceMappingURL=placeLimitOrder.d.ts.map

package/lib/cjs/types/features/limitDca/placeLimitOrder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"placeLimitOrder.d.ts","sourceRoot":"","sources":["../../../../../src/features/limitDca/placeLimitOrder.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,eAAe,CAAC,EACpC,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,UAAU,GACX,EAAE,qBAAqB,oEAwBvB"}
+{"version":3,"file":"placeLimitOrder.d.ts","sourceRoot":"","sources":["../../../../../src/features/limitDca/placeLimitOrder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGxE,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,eAAe,CAAC,EACpC,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,UAAU,GACX,EAAE,qBAAqB,wBAyBvB"}

package/lib/cjs/types/features/swap/buildTx.d.ts

@@ -1,4 +1,17 @@
-import { BuildTxResult } from "../../types/aggregator";
+import { Transaction, TransactionObjectArgument } from "@mysten/sui/transactions";
+import { BluefinXTx } from "../../libs/protocols/bluefinx/types";
+import { BuildTxResult, Commission, QuoteResponse, TxSorSwap } from "../../types/aggregator";
 import { BuildTxParams } from "../../types/tx";
 export declare const buildTx: ({ quoteResponse, accountAddress, slippage, commission: __commission, devInspect, extendTx, isSponsored, }: BuildTxParams) => Promise<BuildTxResult>;
+export declare const getPythPriceFeeds: (responses: QuoteResponse[]) => string[];
+export declare const updatePythPriceFeedsIfAny: (tx: Transaction, quoteResponse: QuoteResponse[]) => Promise<Record<string, string>>;
+export declare const validateRoutes: (routes: TxSorSwap[][], isSponsored?: boolean) => void;
+export declare const getExpectedReturn: (returnAmount: string, slippageBps: number, commissionBps: number, tipBps?: number) => {
+    tipAmount: bigint;
+    minAmount: bigint;
+    commissionAmount: bigint;
+    expectedAmount: string;
+};
+export declare const settle: (coinObjects: TransactionObjectArgument[], quoteResponse: QuoteResponse, slippageBps: number, _commission: Commission) => (tx: Transaction) => TransactionObjectArgument;
+export declare const buildBluefinXTx: (tx: Transaction, accountAddress: string, quoteResponse: QuoteResponse) => Promise<BluefinXTx>;
 //# sourceMappingURL=buildTx.d.ts.map

package/lib/cjs/types/features/swap/buildTx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildTx.d.ts","sourceRoot":"","sources":["../../../../../src/features/swap/buildTx.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,aAAa,EAId,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAK/C,eAAO,MAAM,OAAO,GAAU,2GAQ3B,aAAa,KAAG,OAAO,CAAC,aAAa,CA4IvC,CAAC"}
+{"version":3,"file":"buildTx.d.ts","sourceRoot":"","sources":["../../../../../src/features/swap/buildTx.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EACX,yBAAyB,EAC1B,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEjE,OAAO,EACL,aAAa,EACb,UAAU,EAEV,aAAa,EACb,SAAS,EACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAK/C,eAAO,MAAM,OAAO,GAAU,2GAQ3B,aAAa,KAAG,OAAO,CAAC,aAAa,CA0FvC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,WAAW,aAAa,EAAE,aAa3D,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,IAAI,WAAW,EACf,eAAe,aAAa,EAAE,oCAmB/B,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,QAAQ,SAAS,EAAE,EAAE,EACrB,cAAc,OAAO,SAWtB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,cAAc,MAAM,EACpB,aAAa,MAAM,EACnB,eAAe,MAAM,EACrB,SAAQ,MAAU;;;;;CA8BnB,CAAC;AAEF,eAAO,MAAM,MAAM,GACjB,aAAa,yBAAyB,EAAE,EACxC,eAAe,aAAa,EAC5B,aAAa,MAAM,EACnB,aAAa,UAAU,MAEf,IAAI,WAAW,8BAiCxB,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,IAAI,WAAW,EACf,gBAAgB,MAAM,EACtB,eAAe,aAAa,wBAsB7B,CAAC"}

package/lib/cjs/types/features/swap/buildTxV2.d.ts

@@ -0,0 +1,20 @@
+import { Transaction, TransactionObjectArgument } from "@mysten/sui/transactions";
+import { BuildTxResult, Config, TxSorSwap } from "../../types/aggregator";
+import { BuildTxParams, MultiSwapParams } from "../../types/tx";
+/**
+ * Wave-based transaction builder that optimizes swap execution by:
+ * 1. Grouping swaps into execution waves based on readiness
+ * 2. Merging redundant swaps to the same pool within each wave
+ * 3. Processing waves sequentially, passing intermediate tokens between waves
+ */
+export declare const buildTxV2: ({ quoteResponse, accountAddress, slippage, commission: __commission, devInspect, extendTx, isSponsored, }: BuildTxParams) => Promise<BuildTxResult>;
+export declare const optimize: (pythMap: Record<string, string>, config: Config, routes: TxSorSwap[][], coinData: TransactionObjectArgument[], tx: Transaction, accountAddress: string) => Promise<TransactionObjectArgument[]>;
+/**
+ * execute multiple swap in single transaction
+ *
+ * User must handle the coins from return
+ * @param param - MultiSwapParams
+ * @returns a map of coinType to coinObject
+ */
+export declare const multiSwap: ({ sender, slippageBps, swaps, tx, commission, }: MultiSwapParams) => Promise<Record<string, TransactionObjectArgument>>;
+//# sourceMappingURL=buildTxV2.d.ts.map

package/lib/cjs/types/features/swap/buildTxV2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTxV2.d.ts","sourceRoot":"","sources":["../../../../../src/features/swap/buildTxV2.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EACX,yBAAyB,EAC1B,MAAM,0BAA0B,CAAC;AAIlC,OAAO,EACL,aAAa,EACb,MAAM,EAEN,SAAS,EACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAUhE;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAU,2GAQ7B,aAAa,KAAG,OAAO,CAAC,aAAa,CAuFvC,CAAC;AAEF,eAAO,MAAM,QAAQ,GACnB,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,QAAQ,MAAM,EACd,QAAQ,SAAS,EAAE,EAAE,EACrB,UAAU,yBAAyB,EAAE,EACrC,IAAI,WAAW,EACf,gBAAgB,MAAM,yCA0JvB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAU,iDAM7B,eAAe,uDAiDjB,CAAC"}

package/lib/cjs/types/features/swap/getQuote.d.ts

@@ -15,8 +15,11 @@ interface Params {
     excludedPools?: string[];
     /** The taker address, required for bluefinx */
     taker?: string;
+    /** If true, excludes all liquidity sources that depend on pyth price feeds - pyth client use tx.gas to pay the fee*/
+    isSponsored?: boolean;
 }
 export declare const DEFAULT_SOURCES: SourceDex[];
-export declare function getQuote({ tokenIn, tokenOut, amountIn, sources, commissionBps, targetPools, excludedPools, taker, }: Params): Promise<QuoteResponse>;
+export declare const ORACLE_BASED_SOURCES: Set<SourceDex>;
+export declare function getQuote({ tokenIn, tokenOut, amountIn, sources: _sources, commissionBps, targetPools, excludedPools, taker, isSponsored, }: Params): Promise<QuoteResponse>;
 export {};
 //# sourceMappingURL=getQuote.d.ts.map