genius-intents 0.18.2 → 0.19.0

package/dist/protocols/algebra/algebra.types.d.ts

@@ -0,0 +1,83 @@
+import type { Address, Hex, PublicClient } from 'viem';
+import type { ChainIdEnum } from '../../types/enums';
+export declare enum AlgebraDexTagEnum {
+    BLACKHOLE = "blackhole"
+}
+export type AlgebraDeployment = {
+    tag: AlgebraDexTagEnum;
+    /** Factory that owns poolByPair/customPoolByPair/compute* */
+    factory: Address;
+    /** Quoter V2 (Algebra) used for off-chain quoting */
+    quoterV2: Address;
+    /** Swap Router capable of exactInput/exactInputSingle for Algebra paths */
+    router: Address;
+    /** Canonical/default pool deployer (factory.poolDeployer()) if you want to pin it;
+     *  optional because we can read it from the factory at runtime. */
+    defaultDeployer?: Address;
+    /** Optional set of custom deployers that may have created custom pools
+     *  (Blackhole publishes several). 20-byte addresses.
+     */
+    customDeployers?: Address[];
+};
+export type AlgebraDeploymentsByChain = Partial<Record<ChainIdEnum, AlgebraDeployment[]>>;
+export type AlgebraPriceOverrideParams = {
+    amountOutMin?: string;
+    pair?: Address;
+    deployer?: Address;
+};
+export type AlgebraResolveDeployerForPairParams = {
+    client: PublicClient;
+    deployments: AlgebraDeployment[];
+    pair: Address;
+    tokenA: Address;
+    tokenB: Address;
+};
+export type AlgebraResolveDeployerForPairResponse = {
+    deploymentIndex: number;
+    deployer: Address;
+} | undefined;
+export type AlgebraFoundPool = {
+    /** Pool address that actually exists (non-zero, has code) */
+    pool: Address;
+    /** Which deployer created this pool (required by QuoterV2 and path building) */
+    deployer: Address;
+    /** Which deployment entry produced this pool */
+    deploymentIndex: number;
+    /** 0 for default, 1 for custom (purely informational) */
+    kind: 'default' | 'custom';
+};
+export type AlgebraQuoteCandidate = {
+    deploymentIndex: number;
+    pool: Address;
+    deployer: Address;
+    tokenIn: Address;
+    tokenOut: Address;
+};
+export type AlgebraPriceProtocolResponse = {
+    /** "<TAG>:<router>:<factory>:<chainId>" */
+    deploymentKey: string;
+    /** Deployment assets */
+    router: Address;
+    factory: Address;
+    /** Chosen pool/deployer */
+    pool: Address;
+    deployer: Address;
+    /** Quote analytics (from QuoterV2) */
+    expectedAmountOut: string;
+    sqrtPriceX96After?: string;
+    initializedTicksCrossed?: number;
+    gasEstimate?: string;
+    /** Path bytes we would use for exactInput (single-hop here) */
+    path: Hex;
+};
+export type AlgebraQuoteProtocolResponse = AlgebraPriceProtocolResponse & {
+    /** Which router method we encoded (e.g., "SwapRouter.exactInput") */
+    functionSelector: string;
+};
+export type AlgebraConfig = {
+    /** viem chain configs keyed by ChainIdEnum (same shape you use elsewhere) */
+    algebraChainConfigs: Record<number, unknown>;
+    /** extra deployments to merge in */
+    algebraExtraDeployments?: AlgebraDeploymentsByChain;
+};
+//# sourceMappingURL=algebra.types.d.ts.map

package/dist/protocols/algebra/algebra.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"algebra.types.d.ts","sourceRoot":"","sources":["../../../src/protocols/algebra/algebra.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,oBAAY,iBAAiB;IAC3B,SAAS,cAAc;CACxB;AAGD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,iBAAiB,CAAC;IAEvB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IAEjB,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;IAElB,2EAA2E;IAC3E,MAAM,EAAE,OAAO,CAAC;IAEhB;uEACmE;IACnE,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC;AAE1F,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAC7C;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC9C,SAAS,CAAC;AAGd,MAAM,MAAM,gBAAgB,GAAG;IAC7B,6DAA6D;IAC7D,IAAI,EAAE,OAAO,CAAC;IACd,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAGF,MAAM,MAAM,4BAA4B,GAAG;IACzC,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IAEtB,wBAAwB;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IAEjB,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAElB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+DAA+D;IAC/D,IAAI,EAAE,GAAG,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,4BAA4B,GAAG;IACxE,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAGF,MAAM,MAAM,aAAa,GAAG;IAC1B,6EAA6E;IAC7E,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,oCAAoC;IACpC,uBAAuB,CAAC,EAAE,yBAAyB,CAAC;CACrD,CAAC"}

package/dist/protocols/algebra/algebra.types.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlgebraDexTagEnum = void 0;
+// ---- DEX tag (we only wire Blackhole for now) ----
+var AlgebraDexTagEnum;
+(function (AlgebraDexTagEnum) {
+    AlgebraDexTagEnum["BLACKHOLE"] = "blackhole";
+})(AlgebraDexTagEnum || (exports.AlgebraDexTagEnum = AlgebraDexTagEnum = {}));
+//# sourceMappingURL=algebra.types.js.map

package/dist/protocols/algebra/algebra.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"algebra.types.js","sourceRoot":"","sources":["../../../src/protocols/algebra/algebra.types.ts"],"names":[],"mappings":";;;AAGA,qDAAqD;AACrD,IAAY,iBAEX;AAFD,WAAY,iBAAiB;IAC3B,4CAAuB,CAAA;AACzB,CAAC,EAFW,iBAAiB,iCAAjB,iBAAiB,QAE5B"}

package/dist/protocols/algebra/index.d.ts

@@ -0,0 +1,3 @@
+export { AlgebraService } from './algebra.service';
+export * from './algebra.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/protocols/algebra/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/protocols/algebra/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,cAAc,iBAAiB,CAAC"}

package/dist/protocols/algebra/index.js

@@ -0,0 +1,21 @@
+"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 __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.AlgebraService = void 0;
+var algebra_service_1 = require("./algebra.service");
+Object.defineProperty(exports, "AlgebraService", { enumerable: true, get: function () { return algebra_service_1.AlgebraService; } });
+__exportStar(require("./algebra.types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/protocols/algebra/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/protocols/algebra/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AACvB,kDAAgC"}

package/dist/protocols/okx/okx.service.d.ts

@@ -1,5 +1,5 @@
 import { Connection } from '@solana/web3.js';
-import { OKXConfig, OKXCredentials, OkxEvmQuoteToExecutionPayloadParams, OkxPriceRequestBody, OkxPriceResponse, OkxQuoteRequestBody, OkxQuoteResponse, OkxSignatureParams, OkxSignatureResponse, OkxSolanaQuoteResponse, OkxSolanaQuoteToExecutionPayloadParams } from './okx.types';
+import { OKXConfig, OKXCredentials, OkxEvmQuoteToExecutionPayloadParams, OkxPriceRequestBody, OkxPriceResponse, OkxQuoteRequestBody, OkxSignatureParams, OkxSignatureResponse, OkxSolanaQuoteToExecutionPayloadParams } from './okx.types';
 import { EvmQuoteExecutionPayload, SvmQuoteExecutionPayload } from '../../types/quote-execution-payload';
 import { PriceResponse, RawProtocolPriceResponse } from '../../types/price-response';
 import { IIntentProtocol } from '../../interfaces/intent-protocol';
@@ -107,9 +107,7 @@ export declare class OkxService implements IIntentProtocol {
      * @throws {SdkError} If the API returns an invalid response.
      * @throws {SdkError} If there's an error fetching the quote.
      */
-    fetchQuote(params: IntentQuoteParams): Promise<QuoteResponse & {
-        protocolResponse: OkxQuoteResponse | OkxSolanaQuoteResponse;
-    }>;
+    fetchQuote(params: IntentQuoteParams): Promise<QuoteResponse>;
     protected okxEvmQuoteResponseToExecutionPayload(params: OkxEvmQuoteToExecutionPayloadParams): EvmQuoteExecutionPayload;
     protected okxSolanaQuoteResponseToExecutionPayload(params: OkxSolanaQuoteToExecutionPayloadParams): Promise<SvmQuoteExecutionPayload>;
     private _estimateTransactionSize;
@@ -129,10 +127,13 @@ export declare class OkxService implements IIntentProtocol {
      * @returns {OkxQuoteRequestBody} The transformed parameters ready for the OKX API.
      */
     protected quoteParamsToRequestBody(params: IntentQuoteParams): OkxQuoteRequestBody;
-    protected determineSolanaSlippageParameters(slippage: number): {
-        autoSlippage: boolean;
-        maxAutoSlippage: number;
-        slippage: number;
+    protected determineSolanaSlippageParameters(slippage: number, opts?: {
+        autoSlippage?: boolean;
+        maxAutoSlippagePercent?: number | string;
+    }): {
+        slippagePercent: string;
+        autoSlippage?: boolean;
+        maxAutoSlippagePercent?: string;
     };
     /**
      * Calculates the HMAC-SHA256 signature required for authenticating requests to the OKX API.

package/dist/protocols/okx/okx.service.d.ts.map

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

package/dist/protocols/okx/okx.service.js

@@ -47,7 +47,6 @@ const logger_1 = require("../../utils/logger");
 const constants_1 = require("../../utils/constants");
 const is_native_1 = require("../../utils/is-native");
 const throw_error_1 = require("../../utils/throw-error");
-const create_error_message_1 = require("../../utils/create-error-message");
 const check_vm_1 = require("../../utils/check-vm");
 let logger;
 /**
@@ -103,15 +102,15 @@ class OkxService {
         /**
          * The endpoint for price quote requests.
          */
-        this.priceEndpoint = '/api/v5/dex/aggregator/quote';
+        this.priceEndpoint = '/api/v6/dex/aggregator/quote';
         /**
          * The endpoint for transaction quote requests.
          */
-        this.quoteEndpoint = '/api/v5/dex/aggregator/swap';
+        this.quoteEndpoint = '/api/v6/dex/aggregator/swap';
         /**
          * The endpoint for Solana quote requests.
          */
-        this.solanaQuoteEndpoint = '/api/v5/dex/aggregator/swap-instruction';
+        this.solanaQuoteEndpoint = '/api/v6/dex/aggregator/swap-instruction';
         /**
          * The chain ID used by OKX for solana
          */
@@ -169,8 +168,11 @@ class OkxService {
      */
     async fetchPrice(params) {
         this.validatePriceParams(params);
-        const requestBody = this.priceParamsToRequestBody(params);
-        logger.debug('Generated OKX price request body', requestBody);
+        const requestBody = this.priceParamsToRequestBody({
+            ...params,
+            swapMode: 'exactIn',
+        });
+        logger.debug('Generated OKX v6 price request body', requestBody);
         try {
             const priceUrlParams = new URLSearchParams(requestBody);
             const { signature, timestamp } = this.calculateSignature({
@@ -178,34 +180,42 @@ class OkxService {
                 requestPath: `${this.priceEndpoint}?${priceUrlParams}`,
             });
             const url = `${this.baseUrl}${this.priceEndpoint}?${priceUrlParams.toString()}`;
-            logger.debug(`Making request to OKX API: ${url}`);
-            const headers = {};
-            headers['OK-ACCESS-KEY'] = this.okxCredentials.apiKey || '';
-            headers['OK-ACCESS-SIGN'] = signature;
-            headers['OK-ACCESS-TIMESTAMP'] = timestamp;
-            headers['OK-ACCESS-PASSPHRASE'] = this.okxCredentials.passphrase || '';
-            headers['OK-ACCESS-PROJECT'] = this.okxCredentials.projectId || '';
+            logger.debug(`Making request to OKX v6 quote API: ${url}`);
+            const headers = {
+                ['OK-ACCESS-KEY']: this.okxCredentials.apiKey || '',
+                ['OK-ACCESS-SIGN']: signature,
+                ['OK-ACCESS-TIMESTAMP']: timestamp,
+                ['OK-ACCESS-PASSPHRASE']: this.okxCredentials.passphrase || '',
+                ['OK-ACCESS-PROJECT']: this.okxCredentials.projectId || '',
+            };
             const response = await axios_1.default.get(url, { headers });
             const okxPriceResponse = response.data;
             if (!okxPriceResponse ||
                 !okxPriceResponse.data ||
                 okxPriceResponse.data.length === 0 ||
-                !okxPriceResponse?.data?.[0]?.toTokenAmount) {
-                logger.error('Invalid response received from OKX API', undefined, {
+                (!okxPriceResponse?.data?.[0]?.toTokenAmount &&
+                    !okxPriceResponse?.data?.[0]?.fromTokenAmount)) {
+                logger.error('Invalid response received from OKX v6 API', undefined, {
                     okxPriceResponse,
                 });
-                throw (0, throw_error_1.sdkError)(enums_1.SdkErrorEnum.PRICE_NOT_FOUND, 'Invalid response received from OKX API');
+                throw (0, throw_error_1.sdkError)(enums_1.SdkErrorEnum.PRICE_NOT_FOUND, 'Invalid response received from OKX v6 API');
             }
-            logger.debug('Successfully received price info from OKX', {
-                amountOut: okxPriceResponse.data[0].toTokenAmount,
-                gasEstimate: okxPriceResponse.data[0].estimateGasFee,
+            const item = okxPriceResponse.data[0];
+            // For exactIn: amountIn is params.amountIn, amountOut is response.toTokenAmount
+            // For exactOut: amountOut is response.toTokenAmount (≈ requested), amountIn is response.fromTokenAmount
+            const amountOut = typeof item.toTokenAmount === 'string' ? item.toTokenAmount : '';
+            const computedAmountIn = params.amountIn;
+            logger.debug('Successfully received price info from OKX v6', {
+                swapMode: 'exactIn',
+                amountIn: computedAmountIn,
+                amountOut,
+                gasEstimate: item.estimateGasFee,
             });
-            const amountOut = okxPriceResponse.data[0].toTokenAmount;
             if (!amountOut) {
-                logger.error('No output amount received from OKX', undefined, {
+                logger.error('No output amount received from OKX v6', undefined, {
                     okxPriceResponse,
                 });
-                throw (0, throw_error_1.sdkError)(enums_1.SdkErrorEnum.PRICE_NOT_FOUND, 'No output amount received from OKX');
+                throw (0, throw_error_1.sdkError)(enums_1.SdkErrorEnum.PRICE_NOT_FOUND, 'No output amount received from OKX v6');
             }
             return {
                 protocol: this.protocol,
@@ -213,16 +223,16 @@ class OkxService {
                 networkOut: params.networkOut,
                 tokenIn: params.tokenIn,
                 tokenOut: params.tokenOut,
-                amountIn: params.amountIn,
-                amountOut: amountOut ?? '',
-                estimatedGas: okxPriceResponse?.data?.[0].estimateGasFee,
+                amountIn: computedAmountIn,
+                amountOut,
+                estimatedGas: item.estimateGasFee,
                 protocolResponse: okxPriceResponse,
                 slippage: params.slippage,
             };
         }
-        catch (error) {
-            const formattedError = (0, create_error_message_1.createErrorMessage)(error, this.protocol);
-            throw (0, throw_error_1.sdkError)(enums_1.SdkErrorEnum.PRICE_NOT_FOUND, formattedError);
+        catch (err) {
+            const errorMessage = err?.message ?? String(err);
+            throw (0, throw_error_1.sdkError)(enums_1.SdkErrorEnum.PRICE_NOT_FOUND, errorMessage);
         }
     }
     /**
@@ -244,12 +254,15 @@ class OkxService {
     async fetchQuote(params) {
         logger.info(`Fetching swap quote for address: ${params.from}`);
         this.validatePriceParams(params);
-        let { from, receiver, tokenIn, tokenOut, amountIn, networkIn, networkOut } = params;
-        const requestBody = this.quoteParamsToRequestBody(params);
-        logger.debug('Generated OKX quote request body', requestBody);
+        const { from, receiver, tokenIn, tokenOut, amountIn, networkIn, networkOut } = params;
+        const requestBody = this.quoteParamsToRequestBody({
+            ...params,
+            swapMode: 'exactIn',
+        });
+        logger.debug('Generated OKX v6 quote request body', requestBody);
         const quoteEndpoint = (0, check_vm_1.isSolanaNetwork)(networkIn)
-            ? this.solanaQuoteEndpoint
-            : this.quoteEndpoint;
+            ? this.solanaQuoteEndpoint // /api/v6/dex/aggregator/swap-instruction
+            : this.quoteEndpoint; // /api/v6/dex/aggregator/swap
         try {
             const quoteUrlParams = new URLSearchParams(requestBody);
             const { signature, timestamp } = this.calculateSignature({
@@ -257,21 +270,25 @@ class OkxService {
                 requestPath: `${quoteEndpoint}?${quoteUrlParams}`,
             });
             const url = `${this.baseUrl}${quoteEndpoint}?${quoteUrlParams.toString()}`;
-            logger.debug(`Making request to OKX quote API: ${url}`);
-            const headers = {};
-            headers['OK-ACCESS-KEY'] = this.okxCredentials.apiKey || '';
-            headers['OK-ACCESS-SIGN'] = signature;
-            headers['OK-ACCESS-TIMESTAMP'] = timestamp;
-            headers['OK-ACCESS-PASSPHRASE'] = this.okxCredentials.passphrase || '';
-            headers['OK-ACCESS-PROJECT'] = this.okxCredentials.projectId || '';
+            logger.debug(`Making request to OKX v6 swap API: ${url}`);
+            const headers = {
+                ['OK-ACCESS-KEY']: this.okxCredentials.apiKey || '',
+                ['OK-ACCESS-SIGN']: signature,
+                ['OK-ACCESS-TIMESTAMP']: timestamp,
+                ['OK-ACCESS-PASSPHRASE']: this.okxCredentials.passphrase || '',
+                ['OK-ACCESS-PROJECT']: this.okxCredentials.projectId || '',
+            };
             const response = await axios_1.default.get(url, { headers });
-            const isEvm = (0, check_vm_1.isEVMNetwork)(networkIn);
             const okxQuoteResponse = response.data;
-            if (!okxQuoteResponse ||
-                !(Array.isArray(okxQuoteResponse.data) &&
-                    okxQuoteResponse.data.length > 0)) {
-                throw (0, throw_error_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, okxQuoteResponse?.msg ?? `No quote returned from OKX`);
+            const isEvm = (0, check_vm_1.isEVMNetwork)(networkIn);
+            // Basic shape validation
+            const isValidEvm = Array.isArray(okxQuoteResponse.data) &&
+                okxQuoteResponse.data.length > 0;
+            const isValidSol = !!okxQuoteResponse?.data?.instructionLists;
+            if (!okxQuoteResponse || (isEvm && !isValidEvm) || (!isEvm && !isValidSol)) {
+                throw (0, throw_error_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, okxQuoteResponse?.msg ?? `No quote returned from OKX v6`);
             }
+            // Build execution payload
             const executionPayload = isEvm
                 ? this.okxEvmQuoteResponseToExecutionPayload({
                     tokenIn,
@@ -283,79 +300,30 @@ class OkxService {
                     from,
                     response: okxQuoteResponse,
                 });
-            logger.debug('Successfully received quote info from OKX');
-            let amountOut = undefined;
+            logger.debug('Successfully received quote info from OKX v6');
+            // --- AmountOut resolution ---
+            let amountOut;
             if (isEvm) {
-                // Additional processing for EVM networks
-                if (Array.isArray(okxQuoteResponse.data)) {
-                    amountOut =
-                        okxQuoteResponse.data[0] &&
-                            okxQuoteResponse.data[0].routerResult &&
-                            typeof okxQuoteResponse.data[0].routerResult.toTokenAmount === 'string'
-                            ? okxQuoteResponse.data[0].routerResult.toTokenAmount
-                            : undefined;
-                }
-                else if (typeof okxQuoteResponse.data === 'object' &&
-                    okxQuoteResponse.data !== null &&
-                    'routerResult' in okxQuoteResponse.data &&
-                    okxQuoteResponse.data.routerResult &&
-                    typeof okxQuoteResponse.data
-                        .routerResult?.toTokenAmount === 'string') {
-                    amountOut = okxQuoteResponse.data
-                        .routerResult.toTokenAmount;
-                }
-                else {
-                    throw (0, throw_error_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, 'No valid routerResult.toTokenAmount found in OKX response');
+                const d = okxQuoteResponse.data;
+                amountOut =
+                    d?.[0]?.routerResult?.toTokenAmount && typeof d[0].routerResult.toTokenAmount === 'string'
+                        ? d[0].routerResult.toTokenAmount
+                        : undefined;
+                if (!amountOut) {
+                    throw (0, throw_error_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, 'No valid routerResult.toTokenAmount found in OKX v6 response');
                 }
             }
             else {
-                // Have to fetch the price if we are on solana to determine the amount out
-                const quoteEndpoint = this.quoteEndpoint;
-                const quoteUrlParams = new URLSearchParams({
-                    ...requestBody,
-                    chainId: Number(this.solanaChainId),
-                });
-                const { signature, timestamp } = this.calculateSignature({
-                    method: 'GET',
-                    requestPath: `${quoteEndpoint}?${quoteUrlParams}`,
-                });
-                const url = `${this.baseUrl}${quoteEndpoint}?${quoteUrlParams.toString()}`;
-                logger.debug(`Making request to OKX quote API: ${url}`);
-                const response = await axios_1.default.get(url, {
-                    headers: {
-                        // eslint-disable-next-line @typescript-eslint/naming-convention
-                        'OK-ACCESS-KEY': this.okxCredentials.apiKey,
-                        // eslint-disable-next-line @typescript-eslint/naming-convention
-                        'OK-ACCESS-SIGN': signature,
-                        // eslint-disable-next-line @typescript-eslint/naming-convention
-                        'OK-ACCESS-TIMESTAMP': timestamp,
-                        // eslint-disable-next-line @typescript-eslint/naming-convention
-                        'OK-ACCESS-PASSPHRASE': this.okxCredentials.passphrase,
-                        // eslint-disable-next-line @typescript-eslint/naming-convention
-                        'OK-ACCESS-PROJECT': this.okxCredentials.projectId,
-                    },
-                });
-                if (Array.isArray(response.data.data)) {
-                    amountOut =
-                        response.data.data &&
-                            Array.isArray(response.data.data) &&
-                            response.data.data[0] &&
-                            response.data.data[0].routerResult &&
-                            typeof response.data.data[0].routerResult.toTokenAmount === 'string'
-                            ? response.data.data[0].routerResult.toTokenAmount
-                            : undefined;
-                }
-                else if (typeof response.data.data === 'object' &&
-                    response.data.data !== null &&
-                    'routerResult' in response.data.data &&
-                    response.data.data.routerResult &&
-                    typeof response.data.data.routerResult
-                        ?.toTokenAmount === 'string') {
-                    amountOut = response.data.data
-                        .routerResult.toTokenAmount;
-                }
-                else {
-                    throw (0, throw_error_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, 'No valid routerResult.toTokenAmount found in OKX response');
+                // v6 Solana /swap-instruction now returns routerResult & toTokenAmount directly in the same payload
+                const sol = okxQuoteResponse;
+                const direct = sol?.data?.toTokenAmount;
+                const viaRouter = sol?.data?.routerResult?.toTokenAmount;
+                amountOut =
+                    (typeof direct === 'string' && direct) ||
+                        (typeof viaRouter === 'string' && viaRouter) ||
+                        undefined;
+                if (!amountOut) {
+                    throw (0, throw_error_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, 'No valid toTokenAmount found in OKX v6 Solana swap-instruction response');
                 }
             }
             const executionPayloadKey = (0, check_vm_1.isEVMNetwork)(params.networkIn)
@@ -366,7 +334,7 @@ class OkxService {
                 tokenIn,
                 tokenOut,
                 amountIn,
-                amountOut: amountOut ?? '',
+                amountOut,
                 from,
                 receiver: receiver || from,
                 [executionPayloadKey]: executionPayload,
@@ -377,8 +345,7 @@ class OkxService {
             };
         }
         catch (error) {
-            const formattedError = (0, create_error_message_1.createErrorMessage)(error, this.protocol);
-            throw (0, throw_error_1.sdkError)(enums_1.SdkErrorEnum.QUOTE_NOT_FOUND, formattedError);
+            throw error;
         }
     }
     okxEvmQuoteResponseToExecutionPayload(params) {
@@ -577,14 +544,36 @@ class OkxService {
      */
     priceParamsToRequestBody(params) {
         const { tokenIn, tokenOut, amountIn, networkIn } = params;
-        logger.debug('Converting price params to OKX request body', { params });
+        const isEvm = (0, check_vm_1.isEVMNetwork)(networkIn);
+        const networkNativeAddress = isEvm ? constants_1.NATIVE_ADDRESS : constants_1.NATIVE_SOL;
+        const fromTokenAddress = (0, is_native_1.isNative)(tokenIn) ? networkNativeAddress : (0, address_1.formatAddress)(tokenIn);
+        const toTokenAddress = (0, is_native_1.isNative)(tokenOut) ? networkNativeAddress : (0, address_1.formatAddress)(tokenOut);
+        // Allow caller to optionally pass v6-only fields without breaking existing signatures.
+        const okxOpts = params || {};
+        const swapMode = 'exactIn';
+        // For exactOut, v6 expects `amount` to be the desired output amount.
+        const effectiveAmount = amountIn.toString();
         const requestBody = {
-            amount: amountIn.toString(),
-            chainId: networkIn.toString(),
-            fromTokenAddress: (0, is_native_1.isNative)(tokenIn) ? constants_1.NATIVE_ADDRESS : (0, address_1.formatAddress)(tokenIn),
-            toTokenAddress: (0, is_native_1.isNative)(tokenOut) ? constants_1.NATIVE_ADDRESS : (0, address_1.formatAddress)(tokenOut),
+            amount: effectiveAmount,
+            chainIndex: networkIn.toString(),
+            fromTokenAddress,
+            toTokenAddress,
+            swapMode, // v6
+            // Optional passthroughs (only include if defined)
+            ...(okxOpts.okxQuoteOptions?.dexIds ? { dexIds: okxOpts.okxQuoteOptions.dexIds } : {}),
+            ...(typeof okxOpts.okxQuoteOptions?.directRoute === 'boolean'
+                ? { directRoute: okxOpts.okxQuoteOptions.directRoute }
+                : {}),
+            ...(okxOpts.okxQuoteOptions?.priceImpactProtectionPercent !== undefined
+                ? {
+                    priceImpactProtectionPercent: String(okxOpts.okxQuoteOptions.priceImpactProtectionPercent),
+                }
+                : {}),
+            ...(okxOpts.okxQuoteOptions?.feePercent !== undefined
+                ? { feePercent: String(okxOpts.okxQuoteOptions.feePercent) }
+                : {}),
         };
-        logger.debug('Generated OKX request body', requestBody);
+        logger.debug('Generated OKX v6 request body', requestBody);
         return requestBody;
     }
     /**
@@ -602,34 +591,35 @@ class OkxService {
         const networkNativeAddress = isEvm ? constants_1.NATIVE_ADDRESS : constants_1.NATIVE_SOL;
         const tokenInToUse = tokenInIsNative ? networkNativeAddress : (0, address_1.formatAddress)(tokenIn);
         const tokenOutToUse = tokenOutIsNative ? networkNativeAddress : (0, address_1.formatAddress)(tokenOut);
-        const slippageParameters = this.determineSolanaSlippageParameters(params?.slippage);
-        const quoteRequestBody = {
-            amount: amountIn.toString(),
-            chainId: !isEvm ? this.solanaChainId : networkIn.toString(),
+        const effectiveSwapMode = 'exactIn';
+        // v6 requires slippagePercent (percent units, e.g. "0.5" for 0.5%)
+        const rawSlip = params.slippage ?? 0.5;
+        const slippagePercent = typeof rawSlip === 'number' ? String(rawSlip) : `${rawSlip}`;
+        // For exactOut, API expects amount to represent the desired OUTPUT amount.
+        const effectiveAmount = amountIn.toString();
+        // Base body
+        const body = {
+            amount: effectiveAmount,
+            chainIndex: isEvm ? networkIn.toString() : this.solanaChainId,
             fromTokenAddress: tokenInToUse,
             toTokenAddress: tokenOutToUse,
             userWalletAddress: (0, address_1.formatAddress)(from),
             swapReceiverAddress: (0, address_1.formatAddress)(receiver || from),
-            ...slippageParameters,
+            swapMode: effectiveSwapMode,
+            slippagePercent,
         };
-        return quoteRequestBody;
+        return body;
     }
-    determineSolanaSlippageParameters(slippage) {
-        if (slippage <= 4) {
-            return {
-                autoSlippage: true,
-                maxAutoSlippage: 0.15,
-                slippage: 0.15,
-            };
+    determineSolanaSlippageParameters(slippage, opts) {
+        const slippagePercent = String(slippage ?? 0.5);
+        const out = { slippagePercent };
+        if (typeof opts?.autoSlippage === 'boolean') {
+            out.autoSlippage = opts.autoSlippage;
         }
-        else {
-            const slippagePercentage = slippage >= 1 ? slippage / 100 : slippage;
-            return {
-                autoSlippage: true,
-                maxAutoSlippage: slippagePercentage,
-                slippage: slippagePercentage,
-            };
+        if (opts?.maxAutoSlippagePercent !== undefined) {
+            out.maxAutoSlippagePercent = String(opts.maxAutoSlippagePercent);
         }
+        return out;
     }
     /**
      * Calculates the HMAC-SHA256 signature required for authenticating requests to the OKX API.