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

package/lib/cjs/types/types/okx.d.ts

@@ -0,0 +1,193 @@
+/**
+ * OKX DEX Swap API Types
+ * Documentation: https://web3.okx.com/vi/build/docs/waas/dex-swap
+ */
+/**
+ * Gas level options for swap transactions
+ */
+export type GasLevel = "average" | "fast" | "slow";
+/**
+ * Swap API Request Parameters
+ */
+export interface OkxSwapRequest {
+    /** Chain ID (e.g., 1 for Ethereum) */
+    chainId: string;
+    /** The input amount of a token to be sold (set in minimal divisible units) */
+    amount: string;
+    /** The contract address of a token you want to send (e.g., 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee for native token) */
+    fromTokenAddress: string;
+    /** The contract address of a token you want to receive */
+    toTokenAddress: string;
+    /** Slippage limit (0-1 for EVM, 0-less than 1 for Solana) */
+    slippage: string;
+    /** User's wallet address */
+    userWalletAddress: string;
+    /** Recipient address of a purchased token (if not set, userWalletAddress will receive the token) */
+    swapReceiverAddress?: string;
+    /** The percentage of fromTokenAmount or toTokenAmount sent to referrer (0-3, max 2 decimal points) */
+    feePercent?: string;
+    /** Wallet address to receive commission fee from fromToken */
+    fromTokenReferrerWalletAddress?: string;
+    /** Wallet address to receive commission fee from toToken */
+    toTokenReferrerWalletAddress?: string;
+    /** When true, positive slippage revenue sent to referrer's address (default: false) */
+    enablePositiveSlippage?: boolean;
+    /** The gas (in wei) for the swap transaction */
+    gaslimit?: string;
+    /** Target gas price level (defaults to "average") */
+    gasLevel?: GasLevel;
+    /** DexId of liquidity pool for limited quotes, multiple separated by comma (e.g., "1,50,180") */
+    dexIds?: string;
+    /** When enabled, restricts routing to single liquidity pool (Solana only, default: false) */
+    directRoute?: boolean;
+    /** Percentage (0-1.0) of price impact allowed (default: 0.9) */
+    priceImpactProtectionPercentage?: string;
+    /** Custom parameters encoded as 128-character 64-bytes hexadecimal string (must start with "0x") */
+    callDataMemo?: string;
+    /** Used for Solana transactions, similar to gasPrice on Ethereum */
+    computeUnitPrice?: string;
+    /** Used for Solana transactions, similar to gasLimit on Ethereum */
+    computeUnitLimit?: string;
+    /** When true, API calculates auto slippage recommendations (default: false) */
+    autoSlippage?: boolean;
+    /** Maximum auto slippage when autoSlippage is true */
+    maxAutoSlippage?: string;
+}
+/**
+ * Token information
+ */
+export interface OkxTokenInfo {
+    /** Token contract address */
+    tokenContractAddress: string;
+    /** Token symbol (e.g., "USDC") */
+    tokenSymbol: string;
+    /** Token unit price in USD (may be null for special cases) */
+    tokenUnitPrice: string | null;
+    /** Decimal number defining smallest unit */
+    decimal: string;
+    /** Whether the token is a honeypot token */
+    isHoneyPot: boolean;
+    /** Token tax rate (0-1, where 0.01 = 1%) */
+    taxRate: string;
+}
+/**
+ * DEX Protocol information
+ */
+export interface OkxDexProtocol {
+    /** Name of the liquidity protocol (e.g., "Uniswap V3") */
+    dexName: string;
+    /** Percentage of assets handled by the protocol */
+    percent: string;
+}
+/**
+ * Sub-router information
+ */
+export interface OkxSubRouter {
+    /** Liquidity protocols used on the path */
+    dexProtocol: OkxDexProtocol[];
+    /** Information of token to be sold */
+    fromToken: OkxTokenInfo;
+    /** Information of token to be bought */
+    toToken: OkxTokenInfo;
+}
+/**
+ * Main router information
+ */
+export interface OkxRouter {
+    /** One of the main paths for the token swap */
+    router: string;
+    /** Percentage of assets handled by the main path */
+    routerPercent: string;
+    /** Quote path sub data set */
+    subRouterList: OkxSubRouter[];
+}
+/**
+ * Quote comparison information
+ */
+export interface OkxQuoteCompare {
+    /** DEX name of the quote route */
+    dexName: string;
+    /** DEX logo of the quote route */
+    dexLogo: string;
+    /** Estimated network fee (USD) of the quote route */
+    tradeFee: string;
+    /** Received amount of the quote route */
+    amountOut: string;
+    /** Price impact percentage */
+    priceImpactPercentage: string;
+}
+/**
+ * Transaction data model
+ */
+export interface OkxTransactionData {
+    /** Additional signing data (if required) */
+    signatureData?: string[];
+    /** User's wallet address */
+    from: string;
+    /** Estimated amount of the gas limit */
+    gas: string;
+    /** Gas price in wei */
+    gasPrice?: string;
+    /** EIP-1559: Recommended priority cost of gas per unit */
+    maxPriorityFeePerGas?: string;
+    /** The contract address of OKX DEX router */
+    to: string;
+    /** The amount of native tokens (in wei) to be sent to the contract */
+    value: string;
+    /** Minimum amount of token to buy when price reaches slippage limit */
+    minReceiveAmount: string;
+    /** Call data */
+    data: string;
+    /** Current transaction slippage value */
+    slippage: string;
+}
+/**
+ * Router result data
+ */
+export interface OkxRouterResult {
+    /** Chain ID */
+    chainId: string;
+    /** The input amount of a token to be sold */
+    fromTokenAmount: string;
+    /** The resulting amount of a token to be bought */
+    toTokenAmount: string;
+    /** Estimated network fee (USD) of the quote route */
+    tradeFee: string;
+    /** Estimated gas consumption in smallest units (e.g., wei) */
+    estimateGasFee: string;
+    /** Quote path data set */
+    dexRouterList: OkxRouter[];
+    /** Information of token to be sold */
+    fromToken: OkxTokenInfo;
+    /** Information of token to be bought */
+    toToken: OkxTokenInfo;
+    /** Price impact percentage */
+    priceImpactPercentage?: string;
+    /** Comparison of quote routes */
+    quoteCompareList?: OkxQuoteCompare[];
+}
+/**
+ * Swap API Response Data
+ */
+export interface OkxSwapResponseData {
+    /** Quote path data */
+    routerResult: OkxRouterResult;
+    /** Contract data model */
+    tx: OkxTransactionData;
+}
+/**
+ * OKX API Standard Response Wrapper
+ */
+export interface OkxApiResponse<T> {
+    /** Response code ("0" indicates success) */
+    code: string;
+    /** Response data array */
+    data: T[];
+    /** Response message */
+    msg: string;
+}
+/**
+ * Complete Swap API Response
+ */
+export type OkxSwapResponse = OkxApiResponse<OkxSwapResponseData>;
+//# sourceMappingURL=okx.d.ts.map

package/lib/cjs/types/types/okx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"okx.d.ts","sourceRoot":"","sources":["../../../../src/types/okx.ts"],"names":[],"mappings":"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"}

package/lib/cjs/types/utils/condition.d.ts

@@ -1,2 +1,2 @@
-export declare function assert(condition: boolean, message?: string | null): asserts condition;
+export declare function assert(condition: any, message?: string | null): asserts condition;
 //# sourceMappingURL=condition.d.ts.map

package/lib/cjs/types/utils/condition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"condition.d.ts","sourceRoot":"","sources":["../../../../src/utils/condition.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CACpB,SAAS,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC,SAAS,CAInB"}
+{"version":3,"file":"condition.d.ts","sourceRoot":"","sources":["../../../../src/utils/condition.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CACpB,SAAS,EAAE,GAAG,EACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC,SAAS,CAInB"}

package/lib/esm/config/index.js

@@ -3,6 +3,7 @@ import { SuiPriceServiceConnection, SuiPythClient, } from "@pythnetwork/pyth-sui
 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 SuiClient({
@@ -10,6 +11,12 @@ let suiClient = new SuiClient({
 });
 let pythClient = new SuiPythClient(suiClient, PYTH_STATE_ID, WORMHOLE_STATE_ID);
 let pythConnection = new SuiPriceServiceConnection(HERMES_API);
+function setApi(url) {
+    api = url;
+}
+function getApi() {
+    return api;
+}
 function setApiKey(key) {
     apiKey = key;
 }
@@ -41,6 +48,8 @@ function getPythConnection() {
     return pythConnection;
 }
 const Config = {
+    setApi,
+    getApi,
     setApiKey,
     getApiKey,
     setBluefinXApiKey,

package/lib/esm/constants/_7k.js

@@ -11,3 +11,4 @@ export const _7K_META_PUBLISHED_AT = "0x17c0b1f7a6ad73f51268f16b8c06c049eecc2f28
 export const _7K_META_PACKAGE_ID = "0x17c0b1f7a6ad73f51268f16b8c06c049eecc2f28a270cdd29c06e3d2dea23302";
 export const _7K_META_VAULT = "0x9a8abd32fe5721307ce3b697cf982ee84e9ffbd58d667a4a199f1683c1a3d23c";
 export const _7K_META_CONFIG = "0xbbb3a51877ed9b492f26f4e2181811cfb2bd70c532f6f7621263d122d5e96b56";
+export const _7K_PARTNER_ADDRESS = "0x93ead46c1e48a9b62e25b6787f2ea6f75caedabb21726f12431acc4381f5f4c5";

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

@@ -0,0 +1,109 @@
+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 "../swap/buildTx";
+const DEFAULT_GAS_USED = {
+    computationCost: "0",
+    nonRefundableStorageFee: "0",
+    storageCost: "0",
+    storageRebate: "0",
+};
+export const simulateBluefinX = (quote) => {
+    return {
+        id: quote.id,
+        simulatedAmountOut: quote.amountOut,
+        gasUsed: DEFAULT_GAS_USED,
+        provider: quote.provider,
+    };
+};
+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 Error(res.error ?? "Simulation failed");
+    }
+    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 Error(`Timeout ${msg ?? "operation"}`)), timeout);
+        fn()
+            .then(resolve)
+            .catch(reject)
+            .finally(() => clearTimeout(timer));
+    });
+};

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

@@ -1,18 +1,22 @@
-import { getFullnodeUrl, SuiClient } from "@mysten/sui/client";
+import { getFullnodeUrl, SuiClient, } from "@mysten/sui/client";
 import { coinWithBalance, Transaction, } from "@mysten/sui/transactions";
-import { normalizeStructTag } from "@mysten/sui/utils";
-import { _7K_META_CONFIG, _7K_META_PACKAGE_ID, _7K_META_PUBLISHED_AT, _7K_META_VAULT, } from "../../constants/_7k";
+import { normalizeStructTag, toBase64 } from "@mysten/sui/utils";
 import { SUI_ADDRESS_ZERO } from "../../constants/sui";
-import { EProvider, } from "../../types/metaAg";
+import { EProvider, isAggregatorProvider, isSwapAPIProvider, } from "../../types/metaAg";
 import { assert } from "../../utils/condition";
 import { SuiClientUtils } from "../../utils/SuiClientUtils";
 import { getExpectedReturn } from "../swap/buildTx";
+import { metaSettle, simulateAggregator, simulateBluefinX, timeout, } from "./common";
 import { BluefinProvider } from "./providers/bluefin";
+import { BluefinXProvider } from "./providers/bluefinx";
+import { OkxProvider, simulateOKXSwap } from "./providers/okx";
 const HERMES_API = "https://hermes.pyth.network";
 const DEFAULT_PROVIDERS = {
     [EProvider.BLUEFIN7K]: {},
     [EProvider.FLOWX]: {},
     [EProvider.CETUS]: {},
+    [EProvider.ASTRO]: {},
+    [EProvider.BLUEFINX]: {},
 };
 export class MetaAg {
     client;
@@ -52,6 +56,16 @@ export class MetaAg {
                 const { CetusProvider } = await import("./providers/cetus").catch(catchImportError(EProvider.CETUS));
                 this.providers[EProvider.CETUS] = new CetusProvider(providerOptions, this.options, this.client);
                 break;
+            case EProvider.OKX:
+                this.providers[EProvider.OKX] = new OkxProvider(providerOptions, this.options, this.client);
+                break;
+            case EProvider.BLUEFINX:
+                this.providers[EProvider.BLUEFINX] = new BluefinXProvider(providerOptions);
+                break;
+            case EProvider.ASTRO:
+                const { AstroProvider } = await import("./providers/astro").catch(catchImportError(EProvider.ASTRO));
+                this.providers[EProvider.ASTRO] = new AstroProvider(providerOptions);
+                break;
             default:
                 throw new Error(`Provider not supported: ${provider}`);
         }
@@ -59,51 +73,40 @@ export class MetaAg {
     }
     async _simulate(provider, quote, simulation) {
         try {
-            const tx = new Transaction();
-            const id = quote.id;
-            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, 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 (isAggregatorProvider(provider)) {
+                return simulateAggregator(provider, quote, simulation, this.inspector, this.options);
+            }
+            switch (quote.provider) {
+                case EProvider.BLUEFINX:
+                    return simulateBluefinX(quote);
+                case EProvider.OKX:
+                    return 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 provider.quote(options);
+            if (!quote)
+                return null;
             const { expectedAmount } = 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 });
+                        });
                     }
                 });
             }
@@ -115,6 +118,29 @@ export class MetaAg {
         }
         return quote;
     }
+    async _fastSwap({ quote, signer, useGasCoin, signTransaction }, getTransactionBlockParams) {
+        const tx = new Transaction();
+        const coin = await this.swap({
+            quote,
+            signer,
+            tx,
+            coinIn: 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(toBase64(txBytes));
+        return this.client.executeTransactionBlock({
+            transactionBlock: bytes,
+            signature,
+            options: getTransactionBlockParams?.options,
+            signal: getTransactionBlockParams?.signal,
+        });
+    }
     /**
      * Get quotes from all providers
      * @param options - quote options
@@ -124,8 +150,8 @@ export class MetaAg {
     async quote(options, simulation) {
         const opts = {
             ...options,
-            coinInType: normalizeStructTag(options.coinInType),
-            coinOutType: normalizeStructTag(options.coinOutType),
+            coinTypeIn: normalizeStructTag(options.coinTypeIn),
+            coinTypeOut: normalizeStructTag(options.coinTypeOut),
         };
         const quotes = await Promise.allSettled(Object.entries(this.options.providers)
             .filter(([_k, v]) => !v.disabled)
@@ -141,6 +167,8 @@ export 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
@@ -148,11 +176,32 @@ export class MetaAg {
     async swap(options, slippageBps) {
         const provider = await this._getProvider(options.quote.provider);
         assert(!!provider, `Provider not found: ${options.quote.provider}`);
+        assert(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.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 (isAggregatorProvider(provider)) {
+            return this._fastSwap(options, getTransactionBlockParams);
+        }
+        else if (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
@@ -185,71 +234,17 @@ export class 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 } = 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;
-};
 const catchImportError = (provider) => {
     return (e) => {
         const map = {
             [EProvider.CETUS]: "@cetusprotocol/aggregator-sdk",
             [EProvider.FLOWX]: "@flowx-finance/sdk",
             [EProvider.BLUEFIN7K]: "@7kprotocol/sdk-ts",
+            [EProvider.ASTRO]: "@naviprotocol/astros-aggregator-sdk",
+            [EProvider.OKX]: "",
+            [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));
-    });
-};

package/lib/esm/features/metaAg/providers/astro.js

@@ -0,0 +1,39 @@
+import { buildSwapPTBFromQuote, getQuote, } from "@naviprotocol/astros-aggregator-sdk";
+import { v4 } from "uuid";
+import { _7K_PARTNER_ADDRESS } from "../../../constants/_7k";
+import { EProvider, } from "../../../types/metaAg";
+import { assert } from "../../../utils/condition";
+export class AstroProvider {
+    options;
+    kind = EProvider.ASTRO;
+    constructor(options) {
+        this.options = options;
+    }
+    async quote({ amountIn, coinTypeIn, coinTypeOut, }) {
+        const quote = await getQuote(coinTypeIn, coinTypeOut, amountIn, this.options.api, {
+            baseUrl: this.options.api,
+            byAmountIn: true,
+            depth: this.options.depth,
+            dexList: this.options.dexList,
+            serviceFee: {
+                fee: 0,
+                receiverAddress: _7K_PARTNER_ADDRESS,
+            },
+        });
+        return {
+            id: v4(),
+            provider: this.kind,
+            quote,
+            amountIn,
+            rawAmountOut: quote.amount_out.toString(),
+            amountOut: quote.amount_out.toString(),
+            coinTypeIn,
+            coinTypeOut,
+        };
+    }
+    async swap({ signer, quote, coinIn, tx }) {
+        assert(quote.provider === EProvider.ASTRO, "Invalid quote");
+        const coin = await buildSwapPTBFromQuote(signer, tx, 0, coinIn, quote.quote);
+        return coin;
+    }
+}