@7kprotocol/sdk-ts 3.5.4 → 3.6.1-beta.0

package/lib/cjs/utils/sui.js

@@ -1,33 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SuiUtils = void 0;
-const transactions_1 = require("@mysten/sui/transactions");
+exports.isSystemAddress = exports.SuiUtils = void 0;
+const aggregator_sdk_1 = require("@cetusprotocol/aggregator-sdk");
 const utils_1 = require("@mysten/sui/utils");
-const config_1 = require("../config");
 const _7k_1 = require("../constants/_7k");
-const token_1 = require("./token");
 exports.SuiUtils = {
     getSuiCoin(amount, txb) {
         const [coin] = txb.splitCoins(txb.gas, [amount]);
         return coin;
     },
-    mergeCoins(coinObjects, txb) {
-        if (coinObjects.length == 1) {
-            return typeof coinObjects[0] == "string"
-                ? txb.object(coinObjects[0])
-                : coinObjects[0];
-        }
-        const firstCoin = typeof coinObjects[0] == "string"
-            ? txb.object(coinObjects[0])
-            : coinObjects[0];
-        txb.mergeCoins(
-        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-        // @ts-ignore
-        firstCoin, coinObjects
-            .slice(1)
-            .map((coin) => (typeof coin == "string" ? txb.object(coin) : coin)));
-        return firstCoin;
-    },
     getCoinValue(coinType, coinObject, txb) {
         const inputCoinObject = typeof coinObject == "string" ? txb.object(coinObject) : coinObject;
         const [value] = txb.moveCall({
@@ -37,128 +18,6 @@ exports.SuiUtils = {
         });
         return value;
     },
-    getExactCoinByAmount(coinType, coins, amount, txb) {
-        if ((0, token_1.checkIsSui)(coinType)) {
-            const [coinA] = txb.splitCoins(txb.gas, [amount]);
-            return coinA;
-        }
-        else {
-            const coinsX = exports.SuiUtils.getCoinsGreaterThanAmount(amount, coins);
-            if (coinsX.length > 1) {
-                txb.mergeCoins(txb.object(coinsX[0]), coinsX.slice(1).map((coin) => txb.object(coin)));
-            }
-            const [coinA] = txb.splitCoins(txb.object(coinsX[0]), [amount]);
-            return coinA;
-        }
-    },
-    async mergeAllUserCoins(coinType, signerAddress) {
-        try {
-            const coins = await exports.SuiUtils.getAllUserCoins({
-                address: signerAddress,
-                type: coinType,
-            });
-            let totalBalance = BigInt(0);
-            coins.forEach((coin) => {
-                totalBalance += BigInt(coin.balance);
-            });
-            const txb = new transactions_1.Transaction();
-            if ((0, token_1.checkIsSui)(coinType)) {
-                totalBalance = totalBalance - BigInt("1000");
-                txb.splitCoins(txb.gas, [totalBalance]);
-            }
-            const coinObjectsIds = coins.map((coin) => coin.coinObjectId);
-            if (coins.length > 1) {
-                txb.mergeCoins(txb.object(coinObjectsIds[0]), coinObjectsIds.slice(1).map((coin) => txb.object(coin)));
-            }
-            return txb;
-        }
-        catch (error) {
-            console.log(error);
-        }
-    },
-    mergeAllCoinsWithoutFetch(coins, coinType, txb) {
-        let totalBalance = BigInt(0);
-        coins.forEach((coin) => {
-            totalBalance += BigInt(coin.balance);
-        });
-        if ((0, token_1.checkIsSui)(coinType)) {
-            totalBalance = totalBalance - BigInt("1000");
-            txb.splitCoins(txb.gas, [totalBalance]);
-        }
-        const coinObjectsIds = coins.map((coin) => coin.coinObjectId);
-        if (coins.length > 1) {
-            txb.mergeCoins(txb.object(coinObjectsIds[0]), coinObjectsIds.slice(1).map((coin) => txb.object(coin)));
-        }
-    },
-    async getAllUserCoins({ address, type }) {
-        let cursor = undefined;
-        let coins = [];
-        let iter = 0;
-        do {
-            try {
-                const res = await config_1.Config.getSuiClient().getCoins({
-                    owner: address,
-                    coinType: type,
-                    cursor: cursor,
-                    limit: 50,
-                });
-                coins = coins.concat(res.data);
-                cursor = res.nextCursor;
-                if (!res.hasNextPage || iter === 8) {
-                    cursor = null;
-                }
-            }
-            catch (error) {
-                console.log(error);
-                cursor = null;
-            }
-            iter++;
-        } while (cursor !== null);
-        return coins;
-    },
-    getCoinsGreaterThanAmount(amount, coins) {
-        const coinsWithBalance = [];
-        let collectedAmount = BigInt(0);
-        for (const coin of coins) {
-            if (collectedAmount < amount &&
-                !coinsWithBalance.includes(coin.objectId)) {
-                coinsWithBalance.push(coin.objectId);
-                collectedAmount = collectedAmount + coin.balance;
-            }
-            if (coin.balance === BigInt(0) &&
-                !coinsWithBalance.includes(coin.objectId))
-                coinsWithBalance.push(coin.objectId);
-        }
-        if (collectedAmount >= amount) {
-            return coinsWithBalance;
-        }
-        else {
-            throw new Error("Insufficient balance");
-        }
-    },
-    async getOwnedObjectsByPage(owner, query, paginationArgs = "all") {
-        let result = [];
-        let hasNextPage = true;
-        const queryAll = paginationArgs === "all";
-        let nextCursor = queryAll ? null : paginationArgs.cursor;
-        do {
-            const res = await config_1.Config.getSuiClient().getOwnedObjects({
-                owner,
-                ...query,
-                cursor: nextCursor,
-                limit: queryAll ? null : paginationArgs.limit,
-            });
-            if (res.data) {
-                result = [...result, ...res.data];
-                hasNextPage = res.hasNextPage;
-                nextCursor = res.nextCursor;
-            }
-            else {
-                hasNextPage = false;
-            }
-        } while (queryAll && hasNextPage);
-        return { data: result, nextCursor, hasNextPage };
-    },
     isValidStructTag(value) {
         try {
             return !!(0, utils_1.parseStructTag)(value);
@@ -204,16 +63,30 @@ exports.SuiUtils = {
     },
     collectDust(tx, coinType, coin) {
         tx.moveCall({
-            target: `${_7k_1._7K_PACKAGE_ID}::vault::collect_dust`,
+            target: `${_7k_1._7K_META_PACKAGE_ID}::vault::collect_dust`,
             typeArguments: [coinType],
-            arguments: [tx.object(_7k_1._7K_VAULT), tx.object(_7k_1._7K_CONFIG), coin],
+            arguments: [tx.object(_7k_1._7K_META_VAULT), tx.object(_7k_1._7K_META_CONFIG), coin],
         });
     },
     transferOrDestroyZeroCoin(tx, coinType, coin, address) {
         tx.moveCall({
-            target: `${_7k_1._7K_PACKAGE_ID}::utils::transfer_or_destroy`,
+            target: `${_7k_1._7K_META_PACKAGE_ID}::utils::transfer_or_destroy`,
             typeArguments: [coinType],
             arguments: [coin, tx.pure.address(address)],
         });
     },
 };
+const isSystemAddress = (address) => {
+    const addr = (0, utils_1.normalizeSuiAddress)(address);
+    const addresses = [
+        utils_1.SUI_SYSTEM_ADDRESS,
+        utils_1.MOVE_STDLIB_ADDRESS,
+        utils_1.SUI_FRAMEWORK_ADDRESS,
+        utils_1.SUI_CLOCK_OBJECT_ID,
+        utils_1.SUI_RANDOM_OBJECT_ID,
+        aggregator_sdk_1.SUI_SYSTEM_STATE_OBJECT_ID,
+        "0x0",
+    ].map((v) => (0, utils_1.normalizeSuiAddress)(v));
+    return addresses.includes(addr);
+};
+exports.isSystemAddress = isSystemAddress;

package/lib/cjs/utils/swap.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExpectedReturn = void 0;
+/**
+ * Calculate expected return amount after applying slippage, commission, and tip
+ * @param returnAmount - The raw return amount (with decimals)
+ * @param slippageBps - Slippage in basis points (1 bps = 0.01%)
+ * @param commissionBps - Commission in basis points
+ * @param tipBps - Tip in basis points (default: 0)
+ * @returns Object containing tipAmount, minAmount, commissionAmount, and expectedAmount
+ */
+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;

package/lib/esm/config/fetchClient.js

@@ -1,14 +1,6 @@
-import { Config } from "./index";
 export async function fetchClient(input, init) {
     const headers = new Headers(init?.headers);
-    const apiKey = (Config.getApiKey() || "").trim();
-    const bluefinXApiKey = (Config.getBluefinXApiKey() || "").trim();
-    if (apiKey) {
-        headers.set("apiKey", apiKey);
-    }
-    if (bluefinXApiKey) {
-        headers.set("Bluefin-X-API-Key", bluefinXApiKey);
-    }
+    // intercept the request and add the headers go here...
     const modifiedInit = {
         ...init,
         headers,

package/lib/esm/constants/_7k.js

@@ -1,12 +1,15 @@
-export const _7K_PACKAGE_ID = "0x62412b7268c35f3808336aee57a52836501f40b8ba5d936f8ad275e672befd04";
-//legacy V4: "0xe8f996ea6ff38c557c253d3b93cfe2ebf393816487266786371aa4532a9229f2";
-//legacy V3: "0x7ea6e27ad7af6f3b8671d59df1aaebd7c03dddab893e52a714227b2f4fe91519";
-//legacy V2: "0xa13447019cd982d6bef91cf7b46ad384a52583b1dfc2bdecf31ef0c4bd787a0f";
-//legacy V1: "0xd48e7cdc9e92bec69ce3baa75578010458a0c5b2733d661a84971e8cef6806bc";
-export const _7K_CONFIG = "0x47442a93f7727d188ba7cb71031170d1786af70013cb7ad5115f3fe877ff0c54";
-//legacy v3: "0x0f8fc23dbcc9362b72c7a4c5aa53fcefa02ebfbb83a812c8c262ccd2c076d9ee";
-export const _7K_VAULT = "0x442ad50389ed5cda6f7a6f5a7ae6361a4c05ef1d9fb2e54fbba5a268d690bfe6";
-//legacy v3: "0x39a3c55742c0e011b6f65548e73cf589e1ae5e82dbfab449ca57f24c3bcd9514";
+// export const _7K_PACKAGE_ID =
+//   "0x62412b7268c35f3808336aee57a52836501f40b8ba5d936f8ad275e672befd04";
+// //legacy V4: "0xe8f996ea6ff38c557c253d3b93cfe2ebf393816487266786371aa4532a9229f2";
+// //legacy V3: "0x7ea6e27ad7af6f3b8671d59df1aaebd7c03dddab893e52a714227b2f4fe91519";
+// //legacy V2: "0xa13447019cd982d6bef91cf7b46ad384a52583b1dfc2bdecf31ef0c4bd787a0f";
+// //legacy V1: "0xd48e7cdc9e92bec69ce3baa75578010458a0c5b2733d661a84971e8cef6806bc";
+// export const _7K_CONFIG =
+//   "0x47442a93f7727d188ba7cb71031170d1786af70013cb7ad5115f3fe877ff0c54";
+// //legacy v3: "0x0f8fc23dbcc9362b72c7a4c5aa53fcefa02ebfbb83a812c8c262ccd2c076d9ee";
+// export const _7K_VAULT =
+//   "0x442ad50389ed5cda6f7a6f5a7ae6361a4c05ef1d9fb2e54fbba5a268d690bfe6";
+// //legacy v3: "0x39a3c55742c0e011b6f65548e73cf589e1ae5e82dbfab449ca57f24c3bcd9514";
 export const _7K_META_PUBLISHED_AT = "0x17c0b1f7a6ad73f51268f16b8c06c049eecc2f28a270cdd29c06e3d2dea23302";
 export const _7K_META_PACKAGE_ID = "0x17c0b1f7a6ad73f51268f16b8c06c049eecc2f28a270cdd29c06e3d2dea23302";
 export const _7K_META_VAULT = "0x9a8abd32fe5721307ce3b697cf982ee84e9ffbd58d667a4a199f1683c1a3d23c";

package/lib/esm/constants/apiEndpoints.js

@@ -1,6 +1,6 @@
 export const API_ENDPOINTS = {
     MAIN: "https://api.7k.ag",
     LO_DCA: "https://lod-dca.7k.ag",
-    PRICES: "https://prices.7k.ag",
+    PRICES: "https://lp-pro-api.7k.ag/price",
     STATISTIC: "https://statistic.7k.ag",
 };

package/lib/esm/features/metaAg/common.js

@@ -0,0 +1,96 @@
+import { coinWithBalance, Transaction, } from "@mysten/sui/transactions";
+import { _7K_META_CONFIG, _7K_META_PACKAGE_ID, _7K_META_PUBLISHED_AT, _7K_META_VAULT, } from "../../constants/_7k";
+import { getExpectedReturn } from "../../utils/swap";
+import { MetaAgError, MetaAgErrorCode } from "./error";
+export const simulateSwapTx = async (tx, inspector, simulation) => {
+    const res = await timeout(() => inspector.devInspectTransactionBlock({
+        sender: simulation.sender,
+        transactionBlock: tx,
+    }), simulation.timeout ?? 2000);
+    if (res.effects.status.status === "failure") {
+        throw new MetaAgError(res.error ?? "Simulation failed", MetaAgErrorCode.SIMULATION_FAILED, { error: res.error });
+    }
+    const amountOut = extractAmountOutWrapper(res.events);
+    return {
+        simulatedAmountOut: amountOut,
+        gasUsed: res.effects.gasUsed,
+    };
+};
+export const simulateAggregator = async (provider, quote, simulation, inspector, options) => {
+    const tx = new Transaction();
+    const coinOut = await provider.swap({
+        quote,
+        coinIn: coinWithBalance({
+            balance: BigInt(quote.amountIn),
+            type: quote.coinTypeIn,
+            useGasCoin: false,
+        }),
+        signer: simulation.sender,
+        tx,
+    });
+    tx.add(metaSettle(quote, coinOut, 10000, options.tipBps, options.partner, options.partnerCommissionBps));
+    tx.transferObjects([coinOut], simulation.sender);
+    const res = await simulateSwapTx(tx, inspector, simulation);
+    return {
+        id: quote.id,
+        provider: provider.kind,
+        ...res,
+    };
+};
+/**
+ * this settlement does not charge commission fee for partner, since all integrated aggregators already charge commission fee for partner
+ * @param quote Meta Aggregator Quote
+ * @param coinOut Coin Out Object
+ * @param slippageBps Slippage Bps
+ * @param tipBps Tip Bps default = 0
+ * @param partner address of partner for analytic default is zero address
+ */
+export const metaSettle = (quote, coinOut, slippageBps = 100, tipBps = 0, partner, commissionBps = 0) => {
+    return (tx) => {
+        const { minAmount, expectedAmount } = getExpectedReturn(quote.rawAmountOut, slippageBps, commissionBps, tipBps);
+        if (tipBps > 0) {
+            tx.moveCall({
+                target: `${_7K_META_PUBLISHED_AT}::vault::collect_tip`,
+                typeArguments: [quote.coinTypeOut],
+                arguments: [
+                    tx.object(_7K_META_VAULT),
+                    tx.object(_7K_META_CONFIG),
+                    coinOut,
+                    tx.pure.u64(tipBps),
+                ],
+            });
+        }
+        tx.moveCall({
+            target: `${_7K_META_PUBLISHED_AT}::settle::settle`,
+            typeArguments: [quote.coinTypeIn, quote.coinTypeOut],
+            arguments: [
+                tx.object(_7K_META_CONFIG),
+                tx.object(_7K_META_VAULT),
+                tx.pure.u64(quote.amountIn),
+                coinOut,
+                tx.pure.u64(minAmount),
+                tx.pure.u64(expectedAmount),
+                tx.pure.option("address", partner),
+                tx.pure.u64(commissionBps),
+                tx.pure.u64(0), // ps
+            ],
+        });
+    };
+};
+const extractAmountOutWrapper = (events) => {
+    const swapEvent = events
+        .filter((event) => event.type === `${_7K_META_PACKAGE_ID}::settle::Swap`)
+        ?.pop();
+    return swapEvent?.parsedJson?.amount_out;
+};
+export const timeout = async (fn, timeout, msg) => {
+    if (timeout <= 0)
+        return fn();
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new MetaAgError(`Timeout ${msg ?? "operation"}`, MetaAgErrorCode.TIMEOUT, { timeout })), timeout);
+        fn()
+            .then(resolve)
+            .catch(reject)
+            .finally(() => clearTimeout(timer));
+    });
+};

package/lib/esm/features/metaAg/error.js

@@ -0,0 +1,29 @@
+export var MetaAgErrorCode;
+(function (MetaAgErrorCode) {
+    MetaAgErrorCode[MetaAgErrorCode["UNKNOWN"] = 1000] = "UNKNOWN";
+    MetaAgErrorCode[MetaAgErrorCode["TIMEOUT"] = 1001] = "TIMEOUT";
+    MetaAgErrorCode[MetaAgErrorCode["PROVIDER_NOT_FOUND"] = 1002] = "PROVIDER_NOT_FOUND";
+    MetaAgErrorCode[MetaAgErrorCode["PROVIDER_NOT_SUPPORTED"] = 1003] = "PROVIDER_NOT_SUPPORTED";
+    MetaAgErrorCode[MetaAgErrorCode["INVALID_QUOTE"] = 1004] = "INVALID_QUOTE";
+    MetaAgErrorCode[MetaAgErrorCode["QUOTE_NOT_FOUND"] = 1005] = "QUOTE_NOT_FOUND";
+    MetaAgErrorCode[MetaAgErrorCode["INVALID_SIGNER_ADDRESS"] = 1006] = "INVALID_SIGNER_ADDRESS";
+    MetaAgErrorCode[MetaAgErrorCode["PROVIDER_NOT_SUPPORT_SWAP"] = 1007] = "PROVIDER_NOT_SUPPORT_SWAP";
+    MetaAgErrorCode[MetaAgErrorCode["SIMULATION_FAILED"] = 1008] = "SIMULATION_FAILED";
+    // OKX error
+    MetaAgErrorCode[MetaAgErrorCode["OKX_FINALIZE_COMMAND_NOT_FOUND"] = 1100] = "OKX_FINALIZE_COMMAND_NOT_FOUND";
+})(MetaAgErrorCode || (MetaAgErrorCode = {}));
+export class MetaAgError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.name = "MetaAgError";
+        this.code = code ?? MetaAgErrorCode.UNKNOWN;
+        this.details = details;
+    }
+    static assert(condition, message, code, details) {
+        if (!condition) {
+            throw new MetaAgError(message ?? "Assertion failed", code, details);
+        }
+    }
+}