@7kprotocol/sdk-ts 3.5.2-beta.2 → 3.5.2-beta.4

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

@@ -1,57 +1,57 @@
 /**
  * OKX DEX Swap API Types
- * Documentation: https://web3.okx.com/vi/build/docs/waas/dex-swap
+ * Documentation: https://web3.okx.com/vi/build/dev-docs/wallet-api/dex-swap
  */
 /**
  * Gas level options for swap transactions
  */
 export type GasLevel = "average" | "fast" | "slow";
 /**
- * Swap API Request Parameters
+ * Swap mode options
+ */
+export type SwapMode = "exactIn" | "exactOut";
+/**
+ * Swap API Request Parameters (v6)
  */
 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) */
+    /** Unique identifier for the chain */
+    chainIndex?: string;
+    /** The input amount of a token to be sold (set in minimal divisible units, e.g., 1.00 USDT set as 1000000) */
     amount: string;
+    /** Swap mode: "exactIn" or "exactOut" (default: "exactIn"). exactOut only supports Ethereum, Base, BSC, Arbitrum chains and Uni v3 protocols */
+    swapMode?: SwapMode;
     /** 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;
+    /** Slippage limit. For EVM: 0-100. For Solana: 0-less than 100 (e.g., 0.5 means 0.5%) */
+    slippagePercent: 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) */
+    /** The percentage of fromTokenAmount sent to referrer. Min > 0, max 10 for Solana, 3 for all other chains. Maximum of nine decimal places */
     feePercent?: string;
-    /** Wallet address to receive commission fee from fromToken */
+    /** Wallet address to receive commission fee for fromToken. Must set feePercent together. Can only choose either fromToken or toToken commission per transaction */
     fromTokenReferrerWalletAddress?: string;
-    /** Wallet address to receive commission fee from toToken */
+    /** Wallet address to receive commission fee for toToken. Must set feePercent together. Can only choose either fromToken or toToken commission per transaction */
     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") */
+    /** Positive slippage percentage (0-10, max 1 decimal point). Solana only, whitelist/enterprise clients only */
+    positiveSlippagePercent?: string;
+    /** Wallet address that receives positive slippage. Must set positiveSlippagePercent together. Solana only, whitelist/enterprise clients only */
+    positiveSlippageFeeAddress?: string;
+    /** The gas (in wei) for the swap transaction. EVM only. If too low, an error will be returned */
+    gasLimit?: string;
+    /** Target gas price level (defaults to "average"). EVM only */
     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 */
+    /** Used for Solana transactions, similar to gasPrice on Ethereum. Determines transaction priority */
     computeUnitPrice?: string;
-    /** Used for Solana transactions, similar to gasLimit on Ethereum */
+    /** Used for Solana transactions, similar to gasLimit on Ethereum. If tips is not 0, computeUnitPrice should be set to 0 */
     computeUnitLimit?: string;
-    /** When true, API calculates auto slippage recommendations (default: false) */
-    autoSlippage?: boolean;
-    /** Maximum auto slippage when autoSlippage is true */
-    maxAutoSlippage?: string;
+    /** Jito tips in SOL. Maximum is "2", minimum is "0.0000000001". Used for MEV protection. Solana only */
+    tips?: string;
+    /** DexId of liquidity pool for limited quotes, multiple separated by comma (e.g., "1,50,180") */
+    dexIds?: string;
 }
 /**
  * Token information
@@ -83,15 +83,20 @@ export interface OkxDexProtocol {
  * Sub-router information
  */
 export interface OkxSubRouter {
-    /** Liquidity protocols used on the path */
-    dexProtocol: OkxDexProtocol[];
+    /** Liquidity protocol used on the path */
+    dexProtocol: OkxDexProtocol;
+    /** Index of the from token */
+    fromTokenIndex: string;
+    /** Index of the to token */
+    toTokenIndex: string;
     /** Information of token to be sold */
     fromToken: OkxTokenInfo;
     /** Information of token to be bought */
     toToken: OkxTokenInfo;
 }
 /**
- * Main router information
+ * Main router information (deprecated in v6, kept for backward compatibility)
+ * In v6, dexRouterList is an array of OkxSubRouter directly
  */
 export interface OkxRouter {
     /** One of the main paths for the token swap */
@@ -120,11 +125,11 @@ export interface OkxQuoteCompare {
  * Transaction data model
  */
 export interface OkxTransactionData {
-    /** Additional signing data (if required) */
+    /** Additional signing data (if required). When tips is specified, represents calldata of jito tips transfer */
     signatureData?: string[];
     /** User's wallet address */
     from: string;
-    /** Estimated amount of the gas limit */
+    /** Estimated amount of the gas limit (increase by 50% for accurate data) */
     gas: string;
     /** Gas price in wei */
     gasPrice?: string;
@@ -134,35 +139,43 @@ export interface OkxTransactionData {
     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 */
+    /** The maximum amount of a token to spend when price reaches upper limit of slippage (applies to exactOut mode) */
+    maxSpendAmount?: string;
+    /** The minimum amount of a token to buy when price reaches upper limit of slippage */
     minReceiveAmount: string;
     /** Call data */
     data: string;
     /** Current transaction slippage value */
-    slippage: string;
+    slippagePercent: 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;
+    /** Unique identifier for the chain */
+    chainIndex: string;
+    /** Context slot (for Solana) */
+    contextSlot?: number;
+    /** Quote path data set - array of sub-routers */
+    dexRouterList: OkxSubRouter[];
     /** 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;
+    /** The input amount of a token to be sold */
+    fromTokenAmount: string;
+    /** Price impact percentage = (Received value – Paid value) / Paid value. Can be positive if received value exceeds paid value */
+    priceImpactPercent: string;
+    /** Router identifier */
+    router: string;
+    /** Swap mode: "exactIn" or "exactOut" */
+    swapMode: SwapMode;
     /** Information of token to be bought */
     toToken: OkxTokenInfo;
-    /** Price impact percentage */
-    priceImpactPercentage?: string;
+    /** The resulting amount of a token to be bought */
+    toTokenAmount: string;
+    /** Estimated network fee (USD) of the quote route */
+    tradeFee: string;
     /** Comparison of quote routes */
     quoteCompareList?: OkxQuoteCompare[];
 }

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

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

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

@@ -53,5 +53,6 @@ export declare const SuiUtils: {
     collectDust(tx: Transaction, coinType: string, coin: TransactionArgument): void;
     transferOrDestroyZeroCoin(tx: Transaction, coinType: string, coin: TransactionArgument, address: string): void;
 };
+export declare const isSystemAddress: (address: string) => boolean;
 export {};
 //# sourceMappingURL=sui.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sui.d.ts","sourceRoot":"","sources":["../../../../src/utils/sui.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAM5E,KAAK,QAAQ,CAAC,CAAC,IAAI;IACjB,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,KAAK,cAAc,GAAG,KAAK,GAAG,SAAS,CAAC;AAExC,eAAO,MAAM,QAAQ;uBAET,MAAM,GAAG,mBAAmB,OAC/B,WAAW,GACf,mBAAmB;4BAMP,KAAK,CAAC,MAAM,GAAG,mBAAmB,CAAC,OAC3C,WAAW,GACf,mBAAmB,GAAG,SAAS;2BAsBtB,MAAM,cACJ,MAAM,GAAG,mBAAmB,OACnC,WAAW,GACf,mBAAmB;mCAYV,MAAM,SACT;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,UACtC,MAAM,OACT,WAAW;;;;gCAoBgB,MAAM,iBAAiB,MAAM;qCAoCtD,UAAU,EAAE,YACT,MAAM,OACX,WAAW;uCAsBuB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;sCA8BhE,MAAM,SACP;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE;iCA6BvC,MAAM,SACN,sBAAsB,mBACb,cAAc,GAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;4BAyBD,MAAM;oBAQd,WAAW,YAAY,MAAM;;;;iBAQhC,WAAW,YAAY,MAAM;;;;wBASpC,WAAW,YACL,MAAM,cACJ,mBAAmB;;;;wBAU3B,WAAW,YACL,MAAM,WACP,mBAAmB;;;;2BAUxB,WAAW,YACL,MAAM,WACP,mBAAmB;oBASd,WAAW,YAAY,MAAM,QAAQ,mBAAmB;kCASlE,WAAW,YACL,MAAM,QACV,mBAAmB,WAChB,MAAM;CAQlB,CAAC"}
+{"version":3,"file":"sui.d.ts","sourceRoot":"","sources":["../../../../src/utils/sui.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EAEV,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAc5E,KAAK,QAAQ,CAAC,CAAC,IAAI;IACjB,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,KAAK,cAAc,GAAG,KAAK,GAAG,SAAS,CAAC;AAExC,eAAO,MAAM,QAAQ;uBAET,MAAM,GAAG,mBAAmB,OAC/B,WAAW,GACf,mBAAmB;4BAMP,KAAK,CAAC,MAAM,GAAG,mBAAmB,CAAC,OAC3C,WAAW,GACf,mBAAmB,GAAG,SAAS;2BAsBtB,MAAM,cACJ,MAAM,GAAG,mBAAmB,OACnC,WAAW,GACf,mBAAmB;mCAYV,MAAM,SACT;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,UACtC,MAAM,OACT,WAAW;;;;gCAoBgB,MAAM,iBAAiB,MAAM;qCAoCtD,UAAU,EAAE,YACT,MAAM,OACX,WAAW;uCAsBuB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;sCA8BhE,MAAM,SACP;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE;iCA6BvC,MAAM,SACN,sBAAsB,mBACb,cAAc,GAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;4BAyBD,MAAM;oBAQd,WAAW,YAAY,MAAM;;;;iBAQhC,WAAW,YAAY,MAAM;;;;wBASpC,WAAW,YACL,MAAM,cACJ,mBAAmB;;;;wBAU3B,WAAW,YACL,MAAM,WACP,mBAAmB;;;;2BAUxB,WAAW,YACL,MAAM,WACP,mBAAmB;oBASd,WAAW,YAAY,MAAM,QAAQ,mBAAmB;kCASlE,WAAW,YACL,MAAM,QACV,mBAAmB,WAChB,MAAM;CAQlB,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,YAY9C,CAAC"}

package/lib/cjs/utils/sui.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SuiUtils = void 0;
+exports.isSystemAddress = exports.SuiUtils = void 0;
+const aggregator_sdk_1 = require("@cetusprotocol/aggregator-sdk");
 const transactions_1 = require("@mysten/sui/transactions");
 const utils_1 = require("@mysten/sui/utils");
 const config_1 = require("../config");
@@ -217,3 +218,18 @@ exports.SuiUtils = {
         });
     },
 };
+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;
+console.log((0, exports.isSystemAddress)("0x0"));

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

@@ -1,6 +1,7 @@
 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";
+import { MetaAgError, MetaAgErrorCode } from "./error";
 const DEFAULT_GAS_USED = {
     computationCost: "0",
     nonRefundableStorageFee: "0",
@@ -21,7 +22,7 @@ export const simulateSwapTx = async (tx, inspector, simulation) => {
         transactionBlock: tx,
     }), simulation.timeout ?? 2000);
     if (res.effects.status.status === "failure") {
-        throw new Error(res.error ?? "Simulation failed");
+        throw new MetaAgError(res.error ?? "Simulation failed", MetaAgErrorCode.SIMULATION_FAILED, { error: res.error });
     }
     const amountOut = extractAmountOutWrapper(res.events);
     return {
@@ -100,7 +101,7 @@ 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);
+        const timer = setTimeout(() => reject(new MetaAgError(`Timeout ${msg ?? "operation"}`, MetaAgErrorCode.TIMEOUT, { timeout })), timeout);
         fn()
             .then(resolve)
             .catch(reject)

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

@@ -0,0 +1,33 @@
+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";
+    // BluefinX error
+    MetaAgErrorCode[MetaAgErrorCode["BLUEFINX_TRANSACTION_NOT_FOUND"] = 1200] = "BLUEFINX_TRANSACTION_NOT_FOUND";
+    MetaAgErrorCode[MetaAgErrorCode["BLUEFINX_TRANSACTION_NOT_APPROVED"] = 1201] = "BLUEFINX_TRANSACTION_NOT_APPROVED";
+    MetaAgErrorCode[MetaAgErrorCode["BLUEFINX_TRANSACTION_DIGEST_NOT_FOUND"] = 1202] = "BLUEFINX_TRANSACTION_DIGEST_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);
+        }
+    }
+}

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

@@ -3,10 +3,11 @@ import { coinWithBalance, Transaction, } from "@mysten/sui/transactions";
 import { normalizeStructTag, toBase64 } from "@mysten/sui/utils";
 import { SUI_ADDRESS_ZERO } from "../../constants/sui";
 import { EProvider, isAggregatorProvider, isSwapAPIProvider, } from "../../types/metaAg";
-import { assert } from "../../utils/condition";
+import { isSystemAddress } from "../../utils/sui";
 import { SuiClientUtils } from "../../utils/SuiClientUtils";
 import { getExpectedReturn } from "../swap/buildTx";
 import { metaSettle, simulateAggregator, simulateBluefinX, timeout, } from "./common";
+import { MetaAgError, MetaAgErrorCode } from "./error";
 import { BluefinLegacyProvider } from "./providers/bluefin7kLegacy";
 import { BluefinXProvider } from "./providers/bluefinx";
 import { OkxProvider, simulateOKXSwap } from "./providers/okx";
@@ -43,7 +44,7 @@ export class MetaAg {
         if (p)
             return p;
         const providerOptions = this.options.providers[provider];
-        assert(!!providerOptions, `Provider not found: ${provider}`);
+        MetaAgError.assert(!!providerOptions, `Provider not found: ${provider}`, MetaAgErrorCode.PROVIDER_NOT_FOUND, { provider });
         switch (provider) {
             case EProvider.BLUEFIN7K_LEGACY:
                 this.providers[EProvider.BLUEFIN7K_LEGACY] = new BluefinLegacyProvider(providerOptions, this.options, this.client);
@@ -71,7 +72,7 @@ export class MetaAg {
                 this.providers[EProvider.ASTRO] = new AstroProvider(providerOptions);
                 break;
             default:
-                throw new Error(`Provider not supported: ${provider}`);
+                throw new MetaAgError(`Provider not supported: ${provider}`, MetaAgErrorCode.PROVIDER_NOT_SUPPORTED, { provider });
         }
         return this.providers[provider];
     }
@@ -86,7 +87,7 @@ export class MetaAg {
                 case EProvider.OKX:
                     return simulateOKXSwap(quote, this.inspector, simulation, this.options);
                 default:
-                    throw new Error(`Provider not supported: ${provider.kind}`);
+                    throw new MetaAgError(`Provider not supported: ${provider.kind}`, MetaAgErrorCode.PROVIDER_NOT_SUPPORTED, { provider: provider.kind });
             }
         }
         catch (error) {
@@ -174,8 +175,9 @@ 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}`);
+        MetaAgError.assert(!!provider, `Provider not found: ${options.quote.provider}`, MetaAgErrorCode.PROVIDER_NOT_FOUND, { provider: options.quote.provider });
+        MetaAgError.assert(isAggregatorProvider(provider), `Provider does not support swap: ${provider.kind}, use fastSwap instead`, MetaAgErrorCode.PROVIDER_NOT_SUPPORT_SWAP, { provider: provider.kind });
+        MetaAgError.assert(!isSystemAddress(options.signer), "Invalid signer address", MetaAgErrorCode.INVALID_SIGNER_ADDRESS, { signer: options.signer });
         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);
@@ -187,6 +189,7 @@ export class MetaAg {
      * @returns - txDigest of the transaction
      */
     async fastSwap(options, getTransactionBlockParams) {
+        MetaAgError.assert(!isSystemAddress(options.signer), "Invalid signer address", MetaAgErrorCode.INVALID_SIGNER_ADDRESS, { signer: options.signer });
         const provider = await this._getProvider(options.quote.provider);
         if (isAggregatorProvider(provider)) {
             return this._fastSwap(options, getTransactionBlockParams);
@@ -198,7 +201,7 @@ export class MetaAg {
             });
         }
         else {
-            throw new Error(`Provider not supported: ${provider.kind}`);
+            throw new MetaAgError(`Provider not supported: ${provider.kind}`, MetaAgErrorCode.PROVIDER_NOT_SUPPORTED, { provider: provider.kind });
         }
     }
     /**

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

@@ -2,7 +2,7 @@ import { buildSwapPTBFromQuote, getQuote, } from "@naviprotocol/astros-aggregato
 import { v4 } from "uuid";
 import { _7K_PARTNER_ADDRESS } from "../../../constants/_7k";
 import { EProvider, } from "../../../types/metaAg";
-import { assert } from "../../../utils/condition";
+import { MetaAgError, MetaAgErrorCode } from "../error";
 export class AstroProvider {
     options;
     kind = EProvider.ASTRO;
@@ -33,7 +33,7 @@ export class AstroProvider {
         };
     }
     async swap({ signer, quote, coinIn, tx }) {
-        assert(quote.provider === EProvider.ASTRO, "Invalid quote");
+        MetaAgError.assert(quote.provider === EProvider.ASTRO, "Invalid quote", MetaAgErrorCode.INVALID_QUOTE, { quote, expectedProvider: EProvider.ASTRO });
         const coin = await buildSwapPTBFromQuote(signer, tx, 0, coinIn, quote.quote);
         return coin;
     }

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

@@ -1,8 +1,8 @@
-import { getQuote, buildTx, Config, } from "@bluefin-exchange/bluefin7k-aggregator-sdk";
+import { buildTx, Config, getQuote, } from "@bluefin-exchange/bluefin7k-aggregator-sdk";
 import { v4 } from "uuid";
 import { _7K_PARTNER_ADDRESS } from "../../../constants/_7k";
 import { EProvider, } from "../../../types/metaAg";
-import { assert } from "../../../utils/condition";
+import { MetaAgError, MetaAgErrorCode } from "../error";
 export class Bluefin7kProvider {
     options;
     metaOptions;
@@ -12,11 +12,6 @@ export class Bluefin7kProvider {
         this.metaOptions = metaOptions;
         if (options.apiKey)
             Config.setApiKey(options.apiKey);
-        if (options.api &&
-            "setApi" in Config &&
-            typeof Config.setApi === "function") {
-            Config.setApi(options.api);
-        }
         Config.setSuiClient(client);
     }
     async quote(quoteOptions) {
@@ -28,7 +23,7 @@ export class Bluefin7kProvider {
             excludedPools: this.options.excludedPools,
             targetPools: this.options.targetPools,
         });
-        assert(!!quote, "No quote found");
+        MetaAgError.assert(!!quote, "No quote found", MetaAgErrorCode.QUOTE_NOT_FOUND, { provider: this.kind });
         return {
             id: v4(),
             provider: EProvider.BLUEFIN7K,
@@ -41,7 +36,7 @@ export class Bluefin7kProvider {
         };
     }
     async swap({ quote, signer, tx, coinIn }) {
-        assert(quote.provider === EProvider.BLUEFIN7K, "Invalid quote");
+        MetaAgError.assert(quote.provider === EProvider.BLUEFIN7K, "Invalid quote", MetaAgErrorCode.INVALID_QUOTE, { quote, expectedProvider: EProvider.BLUEFIN7K });
         const { coinOut } = await buildTx({
             quoteResponse: quote.quote,
             accountAddress: signer,

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

@@ -3,9 +3,9 @@ import { v4 } from "uuid";
 import { Config } from "../../../config";
 import { _7K_PARTNER_ADDRESS } from "../../../constants/_7k";
 import { EProvider, } from "../../../types/metaAg";
-import { assert } from "../../../utils/condition";
 import { buildTxV2 } from "../../swap/buildTxV2";
 import { getQuote } from "../../swap/getQuote";
+import { MetaAgError, MetaAgErrorCode } from "../error";
 const WORMHOLE_STATE_ID = "0xaeab97f96cf9877fee2883315d459552b2b921edc16d7ceac6eab944dd88919c";
 const PYTH_STATE_ID = "0x1f9310238ee9298fb703c3419030b35b22bb1cc37113e3bb5007c99aec79e5b8";
 export class BluefinLegacyProvider {
@@ -47,7 +47,7 @@ export class BluefinLegacyProvider {
         };
     }
     async swap({ quote, signer, tx, coinIn }) {
-        assert(quote.provider === EProvider.BLUEFIN7K_LEGACY, "Invalid quote");
+        MetaAgError.assert(quote.provider === EProvider.BLUEFIN7K_LEGACY, "Invalid quote", MetaAgErrorCode.INVALID_QUOTE, { quote, expectedProvider: EProvider.BLUEFIN7K_LEGACY });
         const { coinOut } = await buildTxV2({
             quoteResponse: quote.quote,
             accountAddress: signer,

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

@@ -6,10 +6,10 @@ import { _7K_PARTNER_ADDRESS } from "../../../constants/_7k";
 import { executeBluefinTx } from "../../../libs/protocols/bluefinx/client";
 import { BluefinXTx } from "../../../types/aggregator";
 import { EProvider, } from "../../../types/metaAg";
-import { assert } from "../../../utils/condition";
 import { buildTxV2Int } from "../../swap/buildTxV2";
 import { getQuote } from "../../swap/getQuote";
 import { metaSettle } from "../common";
+import { MetaAgError, MetaAgErrorCode } from "../error";
 const SUPPORT_COINS = [
     "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
     "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
@@ -52,7 +52,7 @@ export class BluefinXProvider {
             SUPPORT_COINS.includes(options.coinTypeOut));
     }
     async fastSwap(options) {
-        assert(options.quote.provider === this.kind, "Invalid BluefinX quote");
+        MetaAgError.assert(options.quote.provider === this.kind, "Invalid BluefinX quote", MetaAgErrorCode.INVALID_QUOTE, { quote: options.quote, expectedProvider: this.kind });
         const quote = options.quote.quote;
         const tx = new Transaction();
         const { tx: bluefinTx } = await buildTxV2Int({
@@ -74,11 +74,11 @@ export class BluefinXProvider {
                 tx.transferObjects([coinOut], options.signer);
             }
         });
-        assert(bluefinTx instanceof BluefinXTx, "BluefinX transaction not found");
+        MetaAgError.assert(bluefinTx instanceof BluefinXTx, "BluefinX transaction not found", MetaAgErrorCode.BLUEFINX_TRANSACTION_NOT_FOUND, {});
         const { signature } = await options.signTransaction(bluefinTx.txBytes);
         const res = await executeBluefinTx(bluefinTx, signature);
-        assert(res.approved, "BluefinX transaction not approved");
-        assert(res.txDigest, "BluefinX transaction digest not found");
+        MetaAgError.assert(res.approved, "BluefinX transaction not approved", MetaAgErrorCode.BLUEFINX_TRANSACTION_NOT_APPROVED, {});
+        MetaAgError.assert(res.txDigest, "BluefinX transaction digest not found", MetaAgErrorCode.BLUEFINX_TRANSACTION_DIGEST_NOT_FOUND, {});
         return res.txDigest;
     }
 }

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

@@ -2,7 +2,7 @@ import { AggregatorClient, Env } from "@cetusprotocol/aggregator-sdk";
 import { v4 } from "uuid";
 import { _7K_PARTNER_ADDRESS } from "../../../constants/_7k";
 import { EProvider, } from "../../../types/metaAg";
-import { assert } from "../../../utils/condition";
+import { MetaAgError, MetaAgErrorCode } from "../error";
 export class CetusProvider {
     options;
     kind = EProvider.CETUS;
@@ -32,7 +32,7 @@ export class CetusProvider {
             depth: this.options.depth,
             liquidityChanges: this.options.liquidityChanges,
         });
-        assert(!!quote, "No quote found");
+        MetaAgError.assert(!!quote, "No quote found", MetaAgErrorCode.QUOTE_NOT_FOUND, { provider: this.kind });
         return {
             id: v4(),
             provider: EProvider.CETUS,
@@ -45,7 +45,7 @@ export class CetusProvider {
         };
     }
     async swap(options) {
-        assert(options.quote.provider === EProvider.CETUS, "Expect Cetus quote");
+        MetaAgError.assert(options.quote.provider === EProvider.CETUS, "Expect Cetus quote", MetaAgErrorCode.INVALID_QUOTE, { quote: options.quote, expectedProvider: EProvider.CETUS });
         const coinOut = await this.cetusClient.routerSwap({
             inputCoin: options.coinIn,
             router: options.quote.quote,

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

@@ -2,7 +2,7 @@ import { AggregatorQuoter, Commission, CommissionType, TradeBuilder, } from "@fl
 import { v4 } from "uuid";
 import { _7K_PARTNER_ADDRESS } from "../../../constants/_7k";
 import { EProvider, } from "../../../types/metaAg";
-import { assert } from "../../../utils/condition";
+import { MetaAgError, MetaAgErrorCode } from "../error";
 export class FlowxProvider {
     options;
     client;
@@ -36,7 +36,7 @@ export class FlowxProvider {
         };
     }
     async swap(options) {
-        assert(options.quote.provider === EProvider.FLOWX, "Invalid quote");
+        MetaAgError.assert(options.quote.provider === EProvider.FLOWX, "Invalid quote", MetaAgErrorCode.INVALID_QUOTE, { quote: options.quote, expectedProvider: EProvider.FLOWX });
         const builder = new TradeBuilder("mainnet", options.quote.quote.routes);
         builder.sender(options.signer);
         builder.slippage(10000 * 100);

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

@@ -3,10 +3,11 @@ import { normalizeStructTag, normalizeSuiAddress, toBase64, } from "@mysten/sui/
 import { v4 } from "uuid";
 import { SUI_TYPE } from "../../../constants/tokens";
 import { EProvider, } from "../../../types/metaAg";
-import { assert } from "../../../utils/condition";
+import { isSystemAddress } from "../../../utils/sui";
 import { metaSettle, simulateSwapTx } from "../common";
+import { MetaAgError, MetaAgErrorCode } from "../error";
 const API = "https://web3.okx.com";
-const SWAP_PATH = "/api/v5/dex/aggregator/swap";
+const SWAP_PATH = "/api/v6/dex/aggregator/swap";
 const CHAIN_ID = "784";
 const NORMALIZED_SUI_TYPE = normalizeStructTag(SUI_TYPE);
 export class OkxProvider {
@@ -20,14 +21,14 @@ export class OkxProvider {
         this.client = client;
     }
     async quote({ amountIn, coinTypeIn, coinTypeOut, signer, }) {
-        if (!signer)
+        if (!signer || isSystemAddress(signer))
             return null;
         const request = {
-            chainId: CHAIN_ID,
+            chainIndex: CHAIN_ID,
             amount: amountIn,
             fromTokenAddress: coinTypeIn === NORMALIZED_SUI_TYPE ? SUI_TYPE : coinTypeIn,
             toTokenAddress: coinTypeOut === NORMALIZED_SUI_TYPE ? SUI_TYPE : coinTypeOut,
-            slippage: (this.metaOptions.slippageBps / 10000).toString(),
+            slippagePercent: (this.metaOptions.slippageBps / 100).toString(),
             userWalletAddress: signer,
         };
         const queryString = "?" + new URLSearchParams(request).toString();
@@ -36,7 +37,7 @@ export class OkxProvider {
             headers: await getHeaders(this.options, "GET", SWAP_PATH, queryString),
         });
         const quote = (await response.json());
-        assert(quote.code === "0" && quote.data.length > 0, "No quote found");
+        MetaAgError.assert(quote.code === "0" && quote.data.length > 0, "No quote found", MetaAgErrorCode.QUOTE_NOT_FOUND, { provider: this.kind });
         return {
             id: v4(),
             provider: this.kind,
@@ -50,7 +51,7 @@ export class OkxProvider {
     }
     async fastSwap(options) {
         const { quote, signer, signTransaction } = options;
-        assert(quote.provider === EProvider.OKX, "Invalid quote");
+        MetaAgError.assert(quote.provider === EProvider.OKX, "Invalid quote", MetaAgErrorCode.INVALID_QUOTE, { quote, expectedProvider: EProvider.OKX });
         const { tx, coin } = buildTx({ quote, signer });
         tx.add(metaSettle(quote, coin, this.metaOptions.slippageBps, this.metaOptions.tipBps, this.metaOptions.partner, this.metaOptions.partnerCommissionBps));
         tx.transferObjects([coin], signer);
@@ -76,7 +77,7 @@ async function generateHmacSha256(message, secretKey) {
         if (typeof btoa !== "undefined") {
             return btoa(binary);
         }
-        throw new Error("Base64 encoder not available in this environment");
+        throw new MetaAgError("Base64 encoder not available in this environment");
     };
     if (typeof globalThis !== "undefined" && globalThis.crypto?.subtle) {
         const key = await globalThis.crypto.subtle.importKey("raw", encoder.encode(secretKey), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
@@ -89,7 +90,7 @@ async function generateHmacSha256(message, secretKey) {
 async function getHeaders(options, method, requestPath, queryString = "") {
     const { apiKey, secretKey, apiPassphrase, projectId } = options;
     if (!apiKey || !secretKey || !apiPassphrase || !projectId) {
-        throw new Error("Missing required environment variables");
+        throw new MetaAgError("Missing required environment variables");
     }
     const timestamp = new Date().toISOString();
     const stringToSign = timestamp + method + requestPath + queryString;
@@ -110,7 +111,7 @@ const replaceFinalizeCommand = (tx, packageId) => {
         cmd.MoveCall.module === "router" &&
         cmd.MoveCall.function === "finalize");
     const cmd = builder.commands[i];
-    assert(cmd.MoveCall, "OKX: Finalize command not found");
+    MetaAgError.assert(cmd.MoveCall, "OKX: Finalize command not found", MetaAgErrorCode.OKX_FINALIZE_COMMAND_NOT_FOUND, { packageId });
     builder.replaceCommand(i, Commands.MoveCall({
         package: packageId,
         module: "router",
@@ -127,7 +128,7 @@ const replaceFinalizeCommand = (tx, packageId) => {
 };
 const buildTx = (options) => {
     const { quote, signer } = options;
-    assert(quote.provider === EProvider.OKX, "Invalid quote");
+    MetaAgError.assert(quote.provider === EProvider.OKX, "Invalid quote", MetaAgErrorCode.INVALID_QUOTE, { quote, expectedProvider: EProvider.OKX });
     const tx = Transaction.from(quote.quote.tx.data);
     tx.setSenderIfNotSet(signer);
     const { tx: tx2, coin } = replaceFinalizeCommand(tx, quote.quote.tx.to);