@7kprotocol/sdk-ts 3.4.2-beta.4 → 3.4.2-beta.5

package/README.md

@@ -6,13 +6,61 @@
 npm i @7kprotocol/sdk-ts
 ```
 
-This package requires `@pythnetwork/pyth-sui-js` as a peer dependency. If your
-project does not have it, you need to install it.
+### Peer Dependencies
+
+This package has peer dependencies that are required for core functionality:
+
+| Package                    | Version   | Purpose                      | Required For       |
+| -------------------------- | --------- | ---------------------------- | ------------------ |
+| `@mysten/sui`              | `^1.39.0` | Sui blockchain interaction   | Core functionality |
+| `@pythnetwork/pyth-sui-js` | `^2.2.0`  | Pyth price feeds integration | Price feeds        |
+
+**Required peer dependencies:**
 
 ```bash
-npm i @pythnetwork/pyth-sui-js
+npm i @mysten/sui@^1.39.0 @pythnetwork/pyth-sui-js@^2.2.0
 ```
 
+### Optional Dependencies (for MetaAg providers)
+
+The following dependencies are **optional** and only needed for specific MetaAg
+providers:
+
+| Package                         | Version   | Provider              |
+| ------------------------------- | --------- | --------------------- |
+| `@flowx-finance/sdk`            | `^1.13.8` | Flowx MetaAg provider |
+| `@cetusprotocol/aggregator-sdk` | `^1.4.1`  | Cetus MetaAg provider |
+
+**Note**: The Bluefin7K MetaAg provider is built-in and requires no additional
+dependencies.
+
+To use Flowx or Cetus providers, install their respective dependencies:
+
+```bash
+# For Flowx MetaAg provider
+npm i @flowx-finance/sdk@^1.13.8
+
+# For Cetus MetaAg provider
+npm i @cetusprotocol/aggregator-sdk@^1.4.1
+```
+
+### Graceful Degradation
+
+The SDK is designed to work gracefully even when optional dependencies are
+missing:
+
+- **Missing `@flowx-finance/sdk`**: Flowx MetaAg provider will not be available,
+  and a helpful warning with installation instructions will be shown
+- **Missing `@cetusprotocol/aggregator-sdk`**: Cetus MetaAg provider will not be
+  available, and a helpful warning with installation instructions will be shown
+- **Missing `@mysten/sui`**: Core functionality will fail (this is required)
+
+The SDK will provide clear error messages and installation instructions when
+optional dependencies are missing.
+
+**Note**: The Bluefin7K provider works out-of-the-box with no additional
+dependencies.
+
 ## Usage
 
 You can import the entire SDK as a module:
@@ -103,13 +151,112 @@ See [Limit Orders](docs/LIMIT.md).
 
 See [DCA Orders](docs/DCA.md).
 
+## MetaAg (Multi-Provider Aggregation)
+
+The MetaAg feature allows you to aggregate quotes from multiple DEX Aggregator
+providers. By default, all available providers are enabled. You can optionally
+configure specific providers or install optional dependencies to enable
+additional providers.
+
+### Using Default Providers
+
+The Bluefin7K provider is built-in and works without additional dependencies:
+
+```typescript
+import { MetaAg, EProvider } from "@7kprotocol/sdk-ts";
+
+const metaAg = new MetaAg();
+
+// Get quotes from all available providers
+const quotes = await metaAg.quote({
+  amountIn: "1000000000", // 1 SUI (9 decimals)
+  coinInType:
+    "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
+  coinOutType:
+    "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
+});
+
+// Find the best quote
+const bestQuote = quotes.reduce((best, current) =>
+  Number(current.amountOut) > Number(best.amountOut) ? current : best
+);
+```
+
+### Configuring Specific Providers
+
+You can configure specific providers and their options:
+
+```typescript
+const metaAg = new MetaAg({
+  providers: {
+    [EProvider.BLUEFIN7K]: {
+      apiKey: "your-bluefin-api-key", // Optional
+    },
+    [EProvider.FLOWX]: {
+      apiKey: "your-flowx-api-key", // Optional
+    },
+    [EProvider.CETUS]: {
+      apiKey: "your-cetus-api-key", // Optional
+    },
+  },
+});
+```
+
+**Note**: To use Flowx or Cetus providers, you must install their respective
+optional dependencies. See the
+[Optional Dependencies](#optional-dependencies-for-metaag-providers) section
+above.
+
+### Sponsored Transactions
+
+When building sponsored transactions, `tx.gas` can not be used for swap.
+
+**Important considerations:**
+
+1.  **Gas coin usage**: Set `useGasCoin: false` when creating your coin input
+    object to prevent the SDK from trying to use `tx.gas`.
+
+2.  **Pyth oracle dependencies**: Transactions that use the gas coin cannot be
+    sponsored because Pyth oracle fees are paid from `tx.gas`. Exclude DEX
+    sources that depend on Pyth oracles.
+
+**Example configuration:**
+
+```typescript
+import { MetaAg, EProvider } from "@7kprotocol/sdk-ts";
+import { coinWithBalance } from "@mysten/sui/transactions";
+import { Protocol } from "@flowx-finance/sdk"; // Required for Flowx sources
+import { CETUS, BLUEFIN } from "@cetusprotocol/aggregator-sdk
+
+const metaAg = new MetaAg({
+  providers: {
+    [EProvider.BLUEFIN7K]: {
+      sources: ["cetus", "bluefin"], // Excludes Pyth oracle-based DEX
+    },
+    [EProvider.FLOWX]: {
+      sources: [Protocol.BLUEFIN, Protocol.CETUS, Protocol.FLOWX_V3],
+    },
+    [EProvider.CETUS]: {
+      sources: [CETUS, BLUEFIN],
+    },
+  },
+});
+
+// Create coin input WITHOUT using the gas coin
+const coinIn = coinWithBalance({
+  balance: 1000000000n, // 1 SUI
+  type: "0x2::sui::SUI",
+  useGasCoin: false, // Important: must be false for sponsored transactions
+});
+```
+
 ## Prices
 
 ```typescript
 import { getTokenPrice, getTokenPrices, getSuiPrice } from "@7kprotocol/sdk-ts";
 
 const tokenPrice = await getTokenPrice(
-  "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
+  "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC"
 );
 
 const tokenPrices = await getTokenPrices([

package/lib/cjs/constants/_7k.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._7K_VAULT = exports._7K_CONFIG = exports._7K_PACKAGE_ID = void 0;
+exports._7K_META_CONFIG = exports._7K_META_VAULT = exports._7K_META_PACKAGE_ID = exports._7K_META_PUBLISHED_AT = exports._7K_VAULT = exports._7K_CONFIG = exports._7K_PACKAGE_ID = void 0;
 exports._7K_PACKAGE_ID = "0x62412b7268c35f3808336aee57a52836501f40b8ba5d936f8ad275e672befd04";
 //legacy V4: "0xe8f996ea6ff38c557c253d3b93cfe2ebf393816487266786371aa4532a9229f2";
 //legacy V3: "0x7ea6e27ad7af6f3b8671d59df1aaebd7c03dddab893e52a714227b2f4fe91519";
@@ -10,3 +10,7 @@ exports._7K_CONFIG = "0x47442a93f7727d188ba7cb71031170d1786af70013cb7ad5115f3fe8
 //legacy v3: "0x0f8fc23dbcc9362b72c7a4c5aa53fcefa02ebfbb83a812c8c262ccd2c076d9ee";
 exports._7K_VAULT = "0x442ad50389ed5cda6f7a6f5a7ae6361a4c05ef1d9fb2e54fbba5a268d690bfe6";
 //legacy v3: "0x39a3c55742c0e011b6f65548e73cf589e1ae5e82dbfab449ca57f24c3bcd9514";
+exports._7K_META_PUBLISHED_AT = "0x17c0b1f7a6ad73f51268f16b8c06c049eecc2f28a270cdd29c06e3d2dea23302";
+exports._7K_META_PACKAGE_ID = "0x17c0b1f7a6ad73f51268f16b8c06c049eecc2f28a270cdd29c06e3d2dea23302";
+exports._7K_META_VAULT = "0x9a8abd32fe5721307ce3b697cf982ee84e9ffbd58d667a4a199f1683c1a3d23c";
+exports._7K_META_CONFIG = "0xbbb3a51877ed9b492f26f4e2181811cfb2bd70c532f6f7621263d122d5e96b56";

package/lib/cjs/constants/sui.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUI_ADDRESS_ZERO = void 0;
+exports.SUI_ADDRESS_ZERO = "0x0000000000000000000000000000000000000000000000000000000000000000";

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

@@ -0,0 +1,243 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetaAg = void 0;
+const client_1 = require("@mysten/sui/client");
+const transactions_1 = require("@mysten/sui/transactions");
+const _7k_1 = require("../../constants/_7k");
+const sui_1 = require("../../constants/sui");
+const metaAg_1 = require("../../types/metaAg");
+const condition_1 = require("../../utils/condition");
+const SuiClientUtils_1 = require("../../utils/SuiClientUtils");
+const buildTx_1 = require("../swap/buildTx");
+const bluefin_1 = require("./providers/bluefin");
+const HERMES_API = "https://hermes.pyth.network";
+const DEFAULT_PROVIDERS = {
+    [metaAg_1.EProvider.BLUEFIN7K]: {},
+    [metaAg_1.EProvider.FLOWX]: {},
+    [metaAg_1.EProvider.CETUS]: {},
+};
+class MetaAg {
+    constructor(options) {
+        this.providers = {};
+        this.options = {
+            providers: options?.providers ?? DEFAULT_PROVIDERS,
+            slippageBps: options?.slippageBps ?? 100,
+            fullnodeUrl: options?.fullnodeUrl ?? (0, client_1.getFullnodeUrl)("mainnet"),
+            hermesApi: options?.hermesApi ?? HERMES_API,
+            partner: options?.partner ?? sui_1.SUI_ADDRESS_ZERO,
+            partnerCommissionBps: options?.partnerCommissionBps ?? 0,
+            tipBps: options?.tipBps ?? 0,
+        };
+        this.client = new client_1.SuiClient({
+            url: this.options.fullnodeUrl,
+        });
+        this.inspector = new SuiClientUtils_1.SuiClientUtils(this.client);
+    }
+    async _getProvider(provider) {
+        const p = this.providers[provider];
+        if (p)
+            return p;
+        switch (provider) {
+            case metaAg_1.EProvider.BLUEFIN7K:
+                const bluefinOptions = this.options.providers[provider];
+                (0, condition_1.assert)(!!bluefinOptions, `Provider not found: ${provider}`);
+                this.providers[metaAg_1.EProvider.BLUEFIN7K] = new bluefin_1.BluefinProvider(bluefinOptions, this.options, this.client);
+                break;
+            case metaAg_1.EProvider.FLOWX:
+                const flowxOptions = this.options.providers[provider];
+                (0, condition_1.assert)(!!flowxOptions, `Provider not found: ${provider}`);
+                const { FlowxProvider } = await Promise.resolve().then(() => __importStar(require("./providers/flowx"))).catch(catchImportError(metaAg_1.EProvider.FLOWX));
+                this.providers[metaAg_1.EProvider.FLOWX] = new FlowxProvider(flowxOptions, this.options, this.client);
+                break;
+            case metaAg_1.EProvider.CETUS:
+                const cetusOptions = this.options.providers[provider];
+                (0, condition_1.assert)(!!cetusOptions, `Provider not found: ${provider}`);
+                const { CetusProvider } = await Promise.resolve().then(() => __importStar(require("./providers/cetus"))).catch(catchImportError(metaAg_1.EProvider.CETUS));
+                this.providers[metaAg_1.EProvider.CETUS] = new CetusProvider(cetusOptions, this.options, this.client);
+                break;
+            default:
+                throw new Error(`Provider not supported: ${provider}`);
+        }
+        return this.providers[provider];
+    }
+    async _simulate(provider, quote, simulation) {
+        try {
+            const tx = new transactions_1.Transaction();
+            const id = quote.id;
+            const coinOut = await provider.swap({
+                quote,
+                coinIn: (0, transactions_1.coinWithBalance)({
+                    balance: BigInt(quote.amountIn),
+                    type: quote.coinTypeIn,
+                }),
+                signer: simulation.sender,
+                tx,
+            });
+            tx.add(metaSettle(quote, coinOut, 10000, this.options.tipBps, this.options.partner, this.options.partnerCommissionBps));
+            tx.transferObjects([coinOut], simulation.sender);
+            const res = await timeout(() => this.inspector.devInspectTransactionBlock({
+                sender: simulation.sender,
+                transactionBlock: tx,
+            }), simulation.timeout ?? 2000, `simulation for ${provider.kind} provider with id ${id}`);
+            const amountOut = extractAmountOutWrapper(res.events);
+            return {
+                id,
+                simulatedAmountOut: amountOut,
+                gasUsed: res.effects.gasUsed,
+                provider: provider.kind,
+            };
+        }
+        catch (error) {
+            console.warn(`Failed to simulate ${provider.kind}: `, error);
+        }
+    }
+    async _quote(provider, options, simulation) {
+        const quote = await timeout(() => provider.quote(options), options.timeout ?? 2000, `quote for ${provider.kind} provider from ${options.coinInType} to ${options.coinOutType}`);
+        if (simulation) {
+            if (simulation.onSimulated) {
+                this._simulate(provider, quote, simulation).then((payload) => {
+                    payload && simulation.onSimulated?.(payload);
+                });
+            }
+            else {
+                const updated = await this._simulate(provider, quote, simulation);
+                quote.simulatedAmountOut = updated?.simulatedAmountOut;
+                quote.gasUsed = updated?.gasUsed;
+            }
+        }
+        return quote;
+    }
+    /**
+     * Get quotes from all providers
+     * @param options - quote options
+     * @param simulation - if present, the quote will be simulated
+     * @returns quotes from all providers
+     */
+    async quote(options, simulation) {
+        const quotes = await Promise.allSettled(Object.keys(this.options.providers).map(async (provider) => {
+            const p = await this._getProvider(provider);
+            return this._quote(p, options, simulation);
+        }));
+        return quotes
+            .map((quote) => quote.status === "fulfilled"
+            ? quote.value
+            : (console.log(quote.reason), null))
+            .filter((quote) => quote !== null);
+    }
+    /**
+     * Build transaction from quote
+     * @param options - build tx options
+     * @param slippageBps - slippage bps if not specified, fallback to global slippage bps, if none of them specified, default to 100
+     * @returns coin out object, you must consume it by transferObjects, or other sub sequence commands
+     */
+    async swap(options, slippageBps) {
+        const provider = await this._getProvider(options.quote.provider);
+        (0, condition_1.assert)(!!provider, `Provider not found: ${options.quote.provider}`);
+        const coinOut = await provider.swap(options);
+        options.tx.add(metaSettle(options.quote, coinOut, slippageBps ?? this.options.slippageBps ?? 100, this.options.tipBps, this.options.partner, this.options.partnerCommissionBps));
+        return coinOut;
+    }
+}
+exports.MetaAg = MetaAg;
+/**
+ * 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
+ */
+const metaSettle = (quote, coinOut, slippageBps = 100, tipBps = 0, partner, commissionBps = 0) => {
+    return (tx) => {
+        const { minAmount, expectedAmount } = (0, buildTx_1.getExpectedReturn)(quote.rawAmountOut, slippageBps, commissionBps, // use for calculate expected amount out
+        tipBps);
+        if (tipBps > 0) {
+            tx.moveCall({
+                target: `${_7k_1._7K_META_PUBLISHED_AT}::vault::collect_tip`,
+                typeArguments: [quote.coinTypeOut],
+                arguments: [
+                    tx.object(_7k_1._7K_META_VAULT),
+                    tx.object(_7k_1._7K_META_CONFIG),
+                    coinOut,
+                    tx.pure.u64(tipBps),
+                ],
+            });
+        }
+        tx.moveCall({
+            target: `${_7k_1._7K_META_PUBLISHED_AT}::settle::settle`,
+            typeArguments: [quote.coinTypeIn, quote.coinTypeOut],
+            arguments: [
+                tx.object(_7k_1._7K_META_CONFIG),
+                tx.object(_7k_1._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(0), // commission must be 0 since all integrated aggregators already charge commission fee for partner
+                tx.pure.u64(0), // ps
+            ],
+        });
+    };
+};
+const extractAmountOutWrapper = (events) => {
+    const swapEvent = events
+        .filter((event) => event.type === `${_7k_1._7K_META_PACKAGE_ID}::settle::Swap`)
+        ?.pop();
+    return swapEvent?.parsedJson?.amount_out;
+};
+const catchImportError = (provider) => {
+    return (e) => {
+        const map = {
+            [metaAg_1.EProvider.CETUS]: "@cetusprotocol/aggregator-sdk",
+            [metaAg_1.EProvider.FLOWX]: "@flowx-finance/sdk",
+            [metaAg_1.EProvider.BLUEFIN7K]: "@7kprotocol/sdk-ts",
+        };
+        console.warn(`Please install ${map[provider]} to use ${provider} provider`);
+        throw e;
+    };
+};
+const timeout = async (fn, timeout, msg) => {
+    if (timeout <= 0)
+        return fn();
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(`Timeout ${msg ?? "operation"}`)), timeout);
+        fn()
+            .then(resolve)
+            .catch(reject)
+            .finally(() => clearTimeout(timer));
+    });
+};

package/lib/cjs/features/metaAg/providers/bluefin.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BluefinProvider = void 0;
+const pyth_sui_js_1 = require("@pythnetwork/pyth-sui-js");
+const uuid_1 = require("uuid");
+const config_1 = require("../../../config");
+const apiEndpoints_1 = require("../../../constants/apiEndpoints");
+const sui_1 = require("../../../constants/sui");
+const metaAg_1 = require("../../../types/metaAg");
+const condition_1 = require("../../../utils/condition");
+const buildTx_1 = require("../../swap/buildTx");
+const buildTxV2_1 = require("../../swap/buildTxV2");
+const getQuote_1 = require("../../swap/getQuote");
+const WORMHOLE_STATE_ID = "0xaeab97f96cf9877fee2883315d459552b2b921edc16d7ceac6eab944dd88919c";
+const PYTH_STATE_ID = "0x1f9310238ee9298fb703c3419030b35b22bb1cc37113e3bb5007c99aec79e5b8";
+class BluefinProvider {
+    constructor(options, metaOptions, client) {
+        this.options = options;
+        this.metaOptions = metaOptions;
+        this.kind = metaAg_1.EProvider.BLUEFIN7K;
+        const pythClient = new pyth_sui_js_1.SuiPythClient(client, PYTH_STATE_ID, WORMHOLE_STATE_ID);
+        const pythConnection = new pyth_sui_js_1.SuiPriceServiceConnection(this.metaOptions.hermesApi);
+        options.apiKey && config_1.Config.setApiKey(options.apiKey);
+        config_1.Config.setSuiClient(client);
+        config_1.Config.setPythClient(pythClient);
+        config_1.Config.setPythConnection(pythConnection);
+    }
+    async quote(options) {
+        const quote = await (0, getQuote_1.getQuote)({
+            amountIn: options.amountIn,
+            tokenIn: options.coinInType,
+            tokenOut: options.coinOutType,
+            api: this.options.api || apiEndpoints_1.API_ENDPOINTS.MAIN,
+            sources: this.options.sources,
+            maxPaths: this.options.maxPaths,
+            excludedPools: this.options.excludedPools,
+            targetPools: this.options.targetPools,
+        });
+        const { expectedAmount } = (0, buildTx_1.getExpectedReturn)(quote.returnAmountWithDecimal.toString(), 0, this.metaOptions.partnerCommissionBps ?? 0, this.metaOptions.tipBps ?? 0);
+        return {
+            id: (0, uuid_1.v4)(),
+            provider: metaAg_1.EProvider.BLUEFIN7K,
+            quote,
+            amountIn: quote.swapAmountWithDecimal,
+            rawAmountOut: quote.returnAmountWithDecimal,
+            amountOut: expectedAmount,
+            coinTypeIn: quote.tokenIn,
+            coinTypeOut: quote.tokenOut,
+        };
+    }
+    async swap({ quote, signer, tx, coinIn }) {
+        (0, condition_1.assert)(quote.provider === metaAg_1.EProvider.BLUEFIN7K, "Invalid quote");
+        const { coinOut } = await (0, buildTxV2_1.buildTxV2)({
+            quoteResponse: quote.quote,
+            accountAddress: signer,
+            commission: {
+                commissionBps: this.metaOptions.partnerCommissionBps ?? 0,
+                partner: this.metaOptions.partner ?? sui_1.SUI_ADDRESS_ZERO,
+            },
+            slippage: 1,
+            extendTx: {
+                tx,
+                coinIn,
+            },
+        });
+        return coinOut;
+    }
+}
+exports.BluefinProvider = BluefinProvider;

package/lib/cjs/features/metaAg/providers/cetus.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CetusProvider = void 0;
+const aggregator_sdk_1 = require("@cetusprotocol/aggregator-sdk");
+const uuid_1 = require("uuid");
+const metaAg_1 = require("../../../types/metaAg");
+const condition_1 = require("../../../utils/condition");
+const buildTx_1 = require("../../swap/buildTx");
+class CetusProvider {
+    constructor(options, metaOptions, client) {
+        this.options = options;
+        this.metaOptions = metaOptions;
+        this.kind = metaAg_1.EProvider.CETUS;
+        this.cetusClient = new aggregator_sdk_1.AggregatorClient({
+            apiKey: options.apiKey,
+            overlayFeeReceiver: metaOptions.partner,
+            overlayFeeRate: metaOptions.partnerCommissionBps
+                ? metaOptions.partnerCommissionBps / 10000
+                : undefined,
+            client,
+            endpoint: options.api,
+            env: aggregator_sdk_1.Env.Mainnet,
+            pythUrls: metaOptions.hermesApi ? [metaOptions.hermesApi] : [],
+        });
+    }
+    async quote(quoteOptions) {
+        const quote = await this.cetusClient.findRouters({
+            amount: quoteOptions.amountIn,
+            byAmountIn: true,
+            from: quoteOptions.coinInType,
+            target: quoteOptions.coinOutType,
+            providers: this.options.sources,
+            splitCount: this.options.splitCount,
+            splitAlgorithm: this.options.splitAlgorithm,
+            splitFactor: this.options.splitFactor,
+            depth: this.options.depth,
+            liquidityChanges: this.options.liquidityChanges,
+        });
+        (0, condition_1.assert)(!!quote, "No quote found");
+        const bps = BigInt(this.metaOptions.partnerCommissionBps ?? 0);
+        // calc amount out before any commission fees
+        const amountOut = ((BigInt(quote.amountOut.toString()) * 10000n) /
+            (10000n - bps)).toString();
+        const { expectedAmount } = (0, buildTx_1.getExpectedReturn)(amountOut, 0, this.metaOptions.partnerCommissionBps ?? 0, this.metaOptions.tipBps ?? 0);
+        return {
+            id: (0, uuid_1.v4)(),
+            provider: metaAg_1.EProvider.CETUS,
+            quote,
+            amountIn: quote.amountIn.toString(),
+            rawAmountOut: amountOut,
+            amountOut: expectedAmount,
+            coinTypeIn: quoteOptions.coinInType,
+            coinTypeOut: quoteOptions.coinOutType,
+        };
+    }
+    async swap(options) {
+        (0, condition_1.assert)(options.quote.provider === metaAg_1.EProvider.CETUS, "Expect Cetus quote");
+        const coinOut = await this.cetusClient.routerSwap({
+            inputCoin: options.coinIn,
+            router: options.quote.quote,
+            slippage: 1,
+            txb: options.tx,
+        });
+        return coinOut;
+    }
+}
+exports.CetusProvider = CetusProvider;

package/lib/cjs/features/metaAg/providers/flowx.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowxProvider = void 0;
+const sdk_1 = require("@flowx-finance/sdk");
+const uuid_1 = require("uuid");
+const metaAg_1 = require("../../../types/metaAg");
+const condition_1 = require("../../../utils/condition");
+const buildTx_1 = require("../../swap/buildTx");
+class FlowxProvider {
+    constructor(options, metaOptions, client) {
+        this.options = options;
+        this.metaOptions = metaOptions;
+        this.client = client;
+        this.kind = metaAg_1.EProvider.FLOWX;
+        this.quoter = new sdk_1.AggregatorQuoter("mainnet", options.apiKey);
+    }
+    async quote(quoteOptions) {
+        const quote = await this.quoter.getRoutes({
+            amountIn: quoteOptions.amountIn,
+            tokenIn: quoteOptions.coinInType,
+            tokenOut: quoteOptions.coinOutType,
+            includeSources: this.options.sources,
+            excludePools: this.options.excludePools,
+            excludeSources: this.options.excludeSources,
+            maxHops: this.options.maxHops,
+            splitDistributionPercent: this.options.splitDistributionPercent,
+        });
+        const { expectedAmount } = (0, buildTx_1.getExpectedReturn)(quote.amountOut.toString(), 0, this.metaOptions.partnerCommissionBps ?? 0, this.metaOptions.tipBps ?? 0);
+        return {
+            id: (0, uuid_1.v4)(),
+            provider: metaAg_1.EProvider.FLOWX,
+            quote: quote,
+            amountIn: quote.amountIn.toString(),
+            rawAmountOut: quote.amountOut.toString(),
+            amountOut: expectedAmount,
+            coinTypeIn: quoteOptions.coinInType,
+            coinTypeOut: quoteOptions.coinOutType,
+        };
+    }
+    async swap(options) {
+        (0, condition_1.assert)(options.quote.provider === metaAg_1.EProvider.FLOWX, "Invalid quote");
+        const builder = new sdk_1.TradeBuilder("mainnet", options.quote.quote.routes);
+        if (this.metaOptions.partner) {
+            builder.commission(new sdk_1.Commission(this.metaOptions.partner, options.quote.quote.coinOut, sdk_1.CommissionType.PERCENTAGE, (this.metaOptions.partnerCommissionBps ?? 0) * 100, true));
+        }
+        builder.sender(options.signer);
+        builder.slippage(10000 * 100);
+        const res = await builder.build().swap({
+            tx: options.tx,
+            client: this.client,
+            coinIn: options.coinIn,
+        });
+        return res;
+    }
+}
+exports.FlowxProvider = FlowxProvider;

package/lib/cjs/index.js

@@ -14,10 +14,13 @@ 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.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;
+exports.setSuiClient = exports.placeLimitOrder = exports.placeDcaOrder = exports.multiSwap = exports.MetaAg = 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);
+__exportStar(require("./types/metaAg"), exports);
 const config_1 = require("./config");
 Object.defineProperty(exports, "Config", { enumerable: true, get: function () { return config_1.Config; } });
+const metaAg_1 = require("./features/metaAg");
+Object.defineProperty(exports, "MetaAg", { enumerable: true, get: function () { return metaAg_1.MetaAg; } });
 const prices_1 = require("./features/prices");
 Object.defineProperty(exports, "getSuiPrice", { enumerable: true, get: function () { return prices_1.getSuiPrice; } });
 Object.defineProperty(exports, "getTokenPrice", { enumerable: true, get: function () { return prices_1.getTokenPrice; } });
@@ -81,4 +84,6 @@ exports.default = {
     cancelDcaOrder: limitDca_1.cancelDcaOrder,
     getClosedDcaOrders: limitDca_1.getClosedDcaOrders,
     getDcaOrderExecutions: limitDca_1.getDcaOrderExecutions,
+    // Meta aggregator
+    MetaAg: metaAg_1.MetaAg,
 };

package/lib/cjs/types/constants/_7k.d.ts

@@ -1,4 +1,8 @@
 export declare const _7K_PACKAGE_ID = "0x62412b7268c35f3808336aee57a52836501f40b8ba5d936f8ad275e672befd04";
 export declare const _7K_CONFIG = "0x47442a93f7727d188ba7cb71031170d1786af70013cb7ad5115f3fe877ff0c54";
 export declare const _7K_VAULT = "0x442ad50389ed5cda6f7a6f5a7ae6361a4c05ef1d9fb2e54fbba5a268d690bfe6";
+export declare const _7K_META_PUBLISHED_AT = "0x17c0b1f7a6ad73f51268f16b8c06c049eecc2f28a270cdd29c06e3d2dea23302";
+export declare const _7K_META_PACKAGE_ID = "0x17c0b1f7a6ad73f51268f16b8c06c049eecc2f28a270cdd29c06e3d2dea23302";
+export declare const _7K_META_VAULT = "0x9a8abd32fe5721307ce3b697cf982ee84e9ffbd58d667a4a199f1683c1a3d23c";
+export declare const _7K_META_CONFIG = "0xbbb3a51877ed9b492f26f4e2181811cfb2bd70c532f6f7621263d122d5e96b56";
 //# sourceMappingURL=_7k.d.ts.map

package/lib/cjs/types/constants/_7k.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_7k.d.ts","sourceRoot":"","sources":["../../../../src/constants/_7k.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,uEAC2C,CAAC;AAKvE,eAAO,MAAM,UAAU,uEAC+C,CAAC;AAGvE,eAAO,MAAM,SAAS,uEACgD,CAAC"}
+{"version":3,"file":"_7k.d.ts","sourceRoot":"","sources":["../../../../src/constants/_7k.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,uEAC2C,CAAC;AAKvE,eAAO,MAAM,UAAU,uEAC+C,CAAC;AAGvE,eAAO,MAAM,SAAS,uEACgD,CAAC;AAEvE,eAAO,MAAM,qBAAqB,uEACoC,CAAC;AACvE,eAAO,MAAM,mBAAmB,uEACsC,CAAC;AACvE,eAAO,MAAM,cAAc,uEAC2C,CAAC;AACvE,eAAO,MAAM,eAAe,uEAC0C,CAAC"}