@7kprotocol/sdk-ts 3.5.0 → 3.5.2-beta.0

package/README.md

@@ -1,5 +1,45 @@
 # 7K TypeScript SDK
 
+The 7K Protocol TypeScript SDK provides a comprehensive toolkit for interacting
+with DeFi services on the Sui blockchain. It offers seamless integration with
+token swaps, price feeds, limit orders, dollar-cost averaging (DCA), and
+multi-provider aggregation services.
+
+## Introduction
+
+The 7K TypeScript SDK is designed to simplify DeFi development on Sui by
+providing a unified, type-safe interface for accessing liquidity and trading
+services. Whether you're building a wallet, trading application, or DeFi
+protocol, this SDK offers the tools you need to integrate advanced trading
+functionality.
+
+Key features:
+
+- **Meta Aggregator (Active Simulation)**: The SDK includes an active simulation
+  of the Meta Aggregator, allowing developers to test and compare quotes from
+  multiple sources — including Bluefin7K, FlowX, and Cetus. This provides a
+  preview of how the unified aggregator will optimize routing and liquidity
+  aggregation across providers.
+
+  ➤ Additional aggregators and RFQ-based liquidity sources are planned for
+  integration in future releases.
+
+- **Price Service**: Fetch token prices with support for single tokens and batch
+  queries
+- **Limit Orders**: Place and manage limit orders for token swaps
+- **DCA Orders**: Set up dollar-cost averaging strategies for automated
+  recurring purchases
+- **BluefinX Integration**: Access RFQ-based trading with sponsored transactions
+  and MEV protection
+- **Type Safety**: Full TypeScript support with comprehensive type definitions
+- **Mainnet Support**: Production-ready SDK for Sui mainnet
+- **Flexible Configuration**: Customize API keys, slippage, commissions, and
+  more
+
+The SDK is built with developer experience in mind, providing both a default
+export for convenience and named exports for tree-shaking and modular
+development.
+
 ## Installation
 
 ```bash
@@ -12,7 +52,7 @@ 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 |
+| `@mysten/sui`              | `^1.44.0` | Sui blockchain interaction   | Core functionality |
 | `@pythnetwork/pyth-sui-js` | `^2.2.0`  | Pyth price feeds integration | Price feeds        |
 
 **Required peer dependencies:**
@@ -75,65 +115,11 @@ or import specific functions as needed:
 import { getQuote, buildTx } from "@7kprotocol/sdk-ts";
 ```
 
-## Config
-
-Configuration is optional, but if provided, it must be set before invoking any
-SDK functions.
-
-### Set API Key
-
-You can use our SDK with a default rate limit of **5 requests per second**
-without needing an API key.
-
-- For **frontend (in-browser) usage**, no API key is required, and the rate
-  limit cannot be increased.
-
-- For **backend (server-side) usage**, the API key is **optional** for default
-  usage. However, to request a **higher rate limit**, you must provide both an
-  **API key** and **partner information**.
-
-To request a rate limit increase, please submit your request at:
-
-🔗 <https://7k.ag/collab> and select **"SDK - increase request rate"**.
-
-| Usage    | API Key Required                      | Default Rate Limit              | Can Request Higher Rate Limit                |
-| -------- | ------------------------------------- | ------------------------------- | -------------------------------------------- |
-| Frontend | No                                    | 5 requests/second               | No                                           |
-| Backend  | Optional (required to increase limit) | 5 requests/second (without key) | Yes (requires API Key & partner information) |
-
-```typescript
-import { Config } from "@7kprotocol/sdk-ts";
-
-Config.setApiKey("YOUR_API_KEY");
-console.log("API key", Config.getApiKey());
-```
-
-### Set BluefinX API key
-
-Setting a BluefinX API key is optional. However, if you'd like to use one — for
-example, to avoid rate limits when routing through BluefinX — you'll need to
-request an API key directly from Bluefin.
-
-```typescript
-import { Config } from "@7kprotocol/sdk-ts";
-
-Config.setBluefinXApiKey("YOUR_BLUEFINX_API_KEY");
-console.log("BluefinX API key", Config.getBluefinXApiKey());
-```
-
-### Set Sui Client
-
-```typescript
-import { SuiClient, getFullnodeUrl } from "@mysten/sui/client";
-import { Config } from "@7kprotocol/sdk-ts";
+Note: this package only supports **mainnet**.
 
-const network = "mainnet";
-const suiClient = new SuiClient({ url: getFullnodeUrl(network) });
-Config.setSuiClient(suiClient);
-console.log("Sui client", Config.getSuiClient());
-```
+## MetaAg (Multi-Provider Aggregation)
 
-Note: this package only supports **mainnet**.
+See [Meta Aggregator](docs/META_AG.md).
 
 ## Swap
 
@@ -151,121 +137,9 @@ 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",
-);
-
-const tokenPrices = await getTokenPrices([
-  "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
-  "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
-]);
-
-const suiPrice = await getSuiPrice();
-```
+See [Prices](docs/PRICE.md).
 
 ## Miscellaneous
 

package/lib/cjs/config/index.js

@@ -6,6 +6,7 @@ const pyth_sui_js_1 = require("@pythnetwork/pyth-sui-js");
 const HERMES_API = "https://hermes.pyth.network";
 const WORMHOLE_STATE_ID = "0xaeab97f96cf9877fee2883315d459552b2b921edc16d7ceac6eab944dd88919c";
 const PYTH_STATE_ID = "0x1f9310238ee9298fb703c3419030b35b22bb1cc37113e3bb5007c99aec79e5b8";
+let api = "";
 let apiKey = "";
 let bluefinXApiKey = "";
 let suiClient = new client_1.SuiClient({
@@ -13,6 +14,12 @@ let suiClient = new client_1.SuiClient({
 });
 let pythClient = new pyth_sui_js_1.SuiPythClient(suiClient, PYTH_STATE_ID, WORMHOLE_STATE_ID);
 let pythConnection = new pyth_sui_js_1.SuiPriceServiceConnection(HERMES_API);
+function setApi(url) {
+    api = url;
+}
+function getApi() {
+    return api;
+}
 function setApiKey(key) {
     apiKey = key;
 }
@@ -44,6 +51,8 @@ function getPythConnection() {
     return pythConnection;
 }
 const Config = {
+    setApi,
+    getApi,
     setApiKey,
     getApiKey,
     setBluefinXApiKey,

package/lib/cjs/constants/_7k.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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_PARTNER_ADDRESS = 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";
@@ -14,3 +14,4 @@ exports._7K_META_PUBLISHED_AT = "0x17c0b1f7a6ad73f51268f16b8c06c049eecc2f28a270c
 exports._7K_META_PACKAGE_ID = "0x17c0b1f7a6ad73f51268f16b8c06c049eecc2f28a270cdd29c06e3d2dea23302";
 exports._7K_META_VAULT = "0x9a8abd32fe5721307ce3b697cf982ee84e9ffbd58d667a4a199f1683c1a3d23c";
 exports._7K_META_CONFIG = "0xbbb3a51877ed9b492f26f4e2181811cfb2bd70c532f6f7621263d122d5e96b56";
+exports._7K_PARTNER_ADDRESS = "0x93ead46c1e48a9b62e25b6787f2ea6f75caedabb21726f12431acc4381f5f4c5";

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

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timeout = exports.metaSettle = exports.simulateAggregator = exports.simulateSwapTx = exports.simulateBluefinX = void 0;
+const transactions_1 = require("@mysten/sui/transactions");
+const _7k_1 = require("../../constants/_7k");
+const buildTx_1 = require("../swap/buildTx");
+const DEFAULT_GAS_USED = {
+    computationCost: "0",
+    nonRefundableStorageFee: "0",
+    storageCost: "0",
+    storageRebate: "0",
+};
+const simulateBluefinX = (quote) => {
+    return {
+        id: quote.id,
+        simulatedAmountOut: quote.amountOut,
+        gasUsed: DEFAULT_GAS_USED,
+        provider: quote.provider,
+    };
+};
+exports.simulateBluefinX = simulateBluefinX;
+const simulateSwapTx = async (tx, inspector, simulation) => {
+    const res = await (0, exports.timeout)(() => inspector.devInspectTransactionBlock({
+        sender: simulation.sender,
+        transactionBlock: tx,
+    }), simulation.timeout ?? 2000);
+    if (res.effects.status.status === "failure") {
+        throw new Error(res.error ?? "Simulation failed");
+    }
+    const amountOut = extractAmountOutWrapper(res.events);
+    return {
+        simulatedAmountOut: amountOut,
+        gasUsed: res.effects.gasUsed,
+    };
+};
+exports.simulateSwapTx = simulateSwapTx;
+const simulateAggregator = async (provider, quote, simulation, inspector, options) => {
+    const tx = new transactions_1.Transaction();
+    const coinOut = await provider.swap({
+        quote,
+        coinIn: (0, transactions_1.coinWithBalance)({
+            balance: BigInt(quote.amountIn),
+            type: quote.coinTypeIn,
+            useGasCoin: false,
+        }),
+        signer: simulation.sender,
+        tx,
+    });
+    tx.add((0, exports.metaSettle)(quote, coinOut, 10000, options.tipBps, options.partner, options.partnerCommissionBps));
+    tx.transferObjects([coinOut], simulation.sender);
+    const res = await (0, exports.simulateSwapTx)(tx, inspector, simulation);
+    return {
+        id: quote.id,
+        provider: provider.kind,
+        ...res,
+    };
+};
+exports.simulateAggregator = simulateAggregator;
+/**
+ * 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, 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(commissionBps),
+                tx.pure.u64(0), // ps
+            ],
+        });
+    };
+};
+exports.metaSettle = metaSettle;
+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 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));
+    });
+};
+exports.timeout = timeout;

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

@@ -37,18 +37,22 @@ exports.MetaAg = void 0;
 const client_1 = require("@mysten/sui/client");
 const transactions_1 = require("@mysten/sui/transactions");
 const utils_1 = require("@mysten/sui/utils");
-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 common_1 = require("./common");
 const bluefin_1 = require("./providers/bluefin");
+const bluefinx_1 = require("./providers/bluefinx");
+const okx_1 = require("./providers/okx");
 const HERMES_API = "https://hermes.pyth.network";
 const DEFAULT_PROVIDERS = {
     [metaAg_1.EProvider.BLUEFIN7K]: {},
     [metaAg_1.EProvider.FLOWX]: {},
     [metaAg_1.EProvider.CETUS]: {},
+    [metaAg_1.EProvider.ASTRO]: {},
+    [metaAg_1.EProvider.BLUEFINX]: {},
 };
 class MetaAg {
     constructor(options) {
@@ -85,6 +89,16 @@ class MetaAg {
                 const { CetusProvider } = await Promise.resolve().then(() => __importStar(require("./providers/cetus"))).catch(catchImportError(metaAg_1.EProvider.CETUS));
                 this.providers[metaAg_1.EProvider.CETUS] = new CetusProvider(providerOptions, this.options, this.client);
                 break;
+            case metaAg_1.EProvider.OKX:
+                this.providers[metaAg_1.EProvider.OKX] = new okx_1.OkxProvider(providerOptions, this.options, this.client);
+                break;
+            case metaAg_1.EProvider.BLUEFINX:
+                this.providers[metaAg_1.EProvider.BLUEFINX] = new bluefinx_1.BluefinXProvider(providerOptions);
+                break;
+            case metaAg_1.EProvider.ASTRO:
+                const { AstroProvider } = await Promise.resolve().then(() => __importStar(require("./providers/astro"))).catch(catchImportError(metaAg_1.EProvider.ASTRO));
+                this.providers[metaAg_1.EProvider.ASTRO] = new AstroProvider(providerOptions);
+                break;
             default:
                 throw new Error(`Provider not supported: ${provider}`);
         }
@@ -92,51 +106,40 @@ class MetaAg {
     }
     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,
-                    useGasCoin: false,
-                }),
-                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}`);
-            if (res.effects.status.status === "failure") {
-                throw new Error(res.error ?? "Simulation failed");
+            if ((0, metaAg_1.isAggregatorProvider)(provider)) {
+                return (0, common_1.simulateAggregator)(provider, quote, simulation, this.inspector, this.options);
+            }
+            switch (quote.provider) {
+                case metaAg_1.EProvider.BLUEFINX:
+                    return (0, common_1.simulateBluefinX)(quote);
+                case metaAg_1.EProvider.OKX:
+                    return (0, okx_1.simulateOKXSwap)(quote, this.inspector, simulation, this.options);
+                default:
+                    throw new Error(`Provider not supported: ${provider.kind}`);
             }
-            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);
+            console.warn(error, { provider: provider.kind, quote: quote.id });
         }
     }
     async _quote(provider, options, simulation) {
-        const quote = await timeout(async () => {
+        const quote = await (0, common_1.timeout)(async () => {
             const quote = await provider.quote(options);
+            if (!quote)
+                return null;
             const { expectedAmount } = (0, buildTx_1.getExpectedReturn)(quote.rawAmountOut, 0, this.options.partnerCommissionBps, this.options.tipBps);
             quote.amountOut = expectedAmount;
             return quote;
-        }, options.timeout ?? 2000, `quote for ${provider.kind} provider from ${options.coinInType} to ${options.coinOutType}`);
-        if (simulation) {
+        }, options.timeout ?? 2000, `quote for ${provider.kind} provider from ${options.coinTypeIn} to ${options.coinTypeOut}`);
+        if (quote && simulation) {
             if (simulation.onSimulated) {
                 this._simulate(provider, quote, simulation).then((payload) => {
                     if (payload) {
-                        simulation.onSimulated?.(payload);
+                        setTimeout(() => {
+                            quote.simulatedAmountOut = payload.simulatedAmountOut;
+                            quote.gasUsed = payload.gasUsed;
+                            simulation.onSimulated?.({ ...quote });
+                        });
                     }
                 });
             }
@@ -148,6 +151,29 @@ class MetaAg {
         }
         return quote;
     }
+    async _fastSwap({ quote, signer, useGasCoin, signTransaction }, getTransactionBlockParams) {
+        const tx = new transactions_1.Transaction();
+        const coin = await this.swap({
+            quote,
+            signer,
+            tx,
+            coinIn: (0, transactions_1.coinWithBalance)({
+                type: quote.coinTypeIn,
+                balance: BigInt(quote.amountIn),
+                useGasCoin,
+            }),
+        });
+        tx.transferObjects([coin], signer);
+        tx.setSenderIfNotSet(signer);
+        const txBytes = await tx.build({ client: this.client });
+        const { signature, bytes } = await signTransaction((0, utils_1.toBase64)(txBytes));
+        return this.client.executeTransactionBlock({
+            transactionBlock: bytes,
+            signature,
+            options: getTransactionBlockParams?.options,
+            signal: getTransactionBlockParams?.signal,
+        });
+    }
     /**
      * Get quotes from all providers
      * @param options - quote options
@@ -157,8 +183,8 @@ class MetaAg {
     async quote(options, simulation) {
         const opts = {
             ...options,
-            coinInType: (0, utils_1.normalizeStructTag)(options.coinInType),
-            coinOutType: (0, utils_1.normalizeStructTag)(options.coinOutType),
+            coinTypeIn: (0, utils_1.normalizeStructTag)(options.coinTypeIn),
+            coinTypeOut: (0, utils_1.normalizeStructTag)(options.coinTypeOut),
         };
         const quotes = await Promise.allSettled(Object.entries(this.options.providers)
             .filter(([_k, v]) => !v.disabled)
@@ -174,6 +200,8 @@ class MetaAg {
     }
     /**
      * Build transaction from quote
+     * @info Use this function to build composable transaction (ie: add more commands after the swap, consume the coin out object)
+     * @warning Providers that build transaction on the fly (typically RFQ, Swap-API providers ie: BluefinX, Okx, ...) are not supported, please use `fastSwap` instead
      * @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
@@ -181,11 +209,32 @@ class MetaAg {
     async swap(options, slippageBps) {
         const provider = await this._getProvider(options.quote.provider);
         (0, condition_1.assert)(!!provider, `Provider not found: ${options.quote.provider}`);
+        (0, condition_1.assert)((0, metaAg_1.isAggregatorProvider)(provider), `Provider does not support swap: ${provider.kind}`);
         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));
+        options.tx.add((0, common_1.metaSettle)(options.quote, coinOut, slippageBps ?? this.options.slippageBps ?? 100, this.options.tipBps, this.options.partner, this.options.partnerCommissionBps));
         options.tx.setSenderIfNotSet(options.signer);
         return coinOut;
     }
+    /**
+     * Build, Sign, and Execute transaction in one step
+     * @param options - fast swap options
+     * @returns - txDigest of the transaction
+     */
+    async fastSwap(options, getTransactionBlockParams) {
+        const provider = await this._getProvider(options.quote.provider);
+        if ((0, metaAg_1.isAggregatorProvider)(provider)) {
+            return this._fastSwap(options, getTransactionBlockParams);
+        }
+        else if ((0, metaAg_1.isSwapAPIProvider)(provider)) {
+            return this.client.waitForTransaction({
+                ...getTransactionBlockParams,
+                digest: await provider.fastSwap(options),
+            });
+        }
+        else {
+            throw new Error(`Provider not supported: ${provider.kind}`);
+        }
+    }
     /**
      * Update meta aggregator options
      * @param options - update options payload
@@ -219,71 +268,17 @@ class MetaAg {
     }
 }
 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, 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(commissionBps),
-                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",
+            [metaAg_1.EProvider.ASTRO]: "@naviprotocol/astros-aggregator-sdk",
+            [metaAg_1.EProvider.OKX]: "",
+            [metaAg_1.EProvider.BLUEFINX]: "",
         };
         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));
-    });
-};