@cowprotocol/sdk-trading-solana 0.5.1 → 0.7.0

package/dist/index.d.mts

@@ -84,6 +84,8 @@ interface SolanaQuoteParameters {
     partiallyFillable?: boolean;
     /** Order lifetime from now, in seconds. Defaults to 30 minutes. */
     validForSeconds?: number;
+    /** Slippage tolerance to sign, in basis points. Defaults to the one the quote reports. */
+    slippageBps?: number;
     /** Token program owning `sellMint`'s accounts (classic SPL Token vs Token-2022). Defaults to the
      * classic SPL Token program — pass `TOKEN_2022_PROGRAM_ID` explicitly for Token-2022 mints, since the
      * associated token account address differs by program. */

package/dist/index.d.ts

@@ -84,6 +84,8 @@ interface SolanaQuoteParameters {
     partiallyFillable?: boolean;
     /** Order lifetime from now, in seconds. Defaults to 30 minutes. */
     validForSeconds?: number;
+    /** Slippage tolerance to sign, in basis points. Defaults to the one the quote reports. */
+    slippageBps?: number;
     /** Token program owning `sellMint`'s accounts (classic SPL Token vs Token-2022). Defaults to the
      * classic SPL Token program — pass `TOKEN_2022_PROGRAM_ID` explicitly for Token-2022 mints, since the
      * associated token account address differs by program. */

package/dist/index.js

@@ -226,6 +226,7 @@ var ZERO_APP_DATA = new Uint8Array(32);
 var jupiterApi = new JupiterAPI();
 async function getSolanaQuote(params, options = {}) {
   const {
+    slippageBps: slippageBpsOverride,
     ownerAddress,
     receiverAddress,
     sellTokenDecimals,
@@ -240,6 +241,9 @@ async function getSolanaQuote(params, options = {}) {
   if (!Number.isFinite(validForSeconds) || validForSeconds <= 0) {
     throw new Error("validForSeconds must be a finite number greater than zero");
   }
+  if (slippageBpsOverride !== void 0 && (!Number.isFinite(slippageBpsOverride) || slippageBpsOverride < 0)) {
+    throw new Error("slippageBps must be a finite number greater than or equal to zero");
+  }
   const owner = new import_web35.PublicKey(ownerAddress);
   const receiver = new import_web35.PublicKey(receiverAddress);
   const requestedSellMint = new import_web35.PublicKey(params.sellTokenAddress);
@@ -255,6 +259,7 @@ async function getSolanaQuote(params, options = {}) {
     amount: amount.toString(),
     swapMode: kind === import_sdk_order_book2.OrderKind.SELL ? "ExactIn" : "ExactOut"
   });
+  const signedSlippageBps = slippageBpsOverride ?? jupiterOrder.slippageBps;
   const validTo = Math.floor(Date.now() / 1e3) + validForSeconds;
   const orderParams = {
     sellToken: sellTokenAddress,
@@ -275,7 +280,7 @@ async function getSolanaQuote(params, options = {}) {
   };
   const amountsAndCosts = (0, import_sdk_order_book2.getQuoteAmountsAndCosts)({
     orderParams,
-    slippagePercentBps: jupiterOrder.slippageBps,
+    slippagePercentBps: signedSlippageBps,
     // TODO: implement fees
     partnerFeeBps: 0,
     protocolFeeBps: 0
@@ -314,6 +319,7 @@ async function getSolanaQuote(params, options = {}) {
     verified: false
   };
   const tradeParameters = {
+    ...slippageBpsOverride !== void 0 ? { slippageBps: slippageBpsOverride } : void 0,
     kind,
     owner: owner.toBase58(),
     // The mint the caller asked for, not the substituted one: callers compare the returned parameters
@@ -331,6 +337,8 @@ async function getSolanaQuote(params, options = {}) {
   const quoteResults = {
     quoteResponse,
     amountsAndCosts,
+    // What the quote provider suggested, never the caller's own `slippageBps`: consumers read this as a
+    // recommendation and would otherwise be handed their own input back as advice.
     suggestedSlippageBps: jupiterOrder.slippageBps,
     tradeParameters,
     orderToSign: {},

package/dist/index.mjs

@@ -187,6 +187,7 @@ var ZERO_APP_DATA = new Uint8Array(32);
 var jupiterApi = new JupiterAPI();
 async function getSolanaQuote(params, options = {}) {
   const {
+    slippageBps: slippageBpsOverride,
     ownerAddress,
     receiverAddress,
     sellTokenDecimals,
@@ -201,6 +202,9 @@ async function getSolanaQuote(params, options = {}) {
   if (!Number.isFinite(validForSeconds) || validForSeconds <= 0) {
     throw new Error("validForSeconds must be a finite number greater than zero");
   }
+  if (slippageBpsOverride !== void 0 && (!Number.isFinite(slippageBpsOverride) || slippageBpsOverride < 0)) {
+    throw new Error("slippageBps must be a finite number greater than or equal to zero");
+  }
   const owner = new PublicKey5(ownerAddress);
   const receiver = new PublicKey5(receiverAddress);
   const requestedSellMint = new PublicKey5(params.sellTokenAddress);
@@ -216,6 +220,7 @@ async function getSolanaQuote(params, options = {}) {
     amount: amount.toString(),
     swapMode: kind === OrderKind2.SELL ? "ExactIn" : "ExactOut"
   });
+  const signedSlippageBps = slippageBpsOverride ?? jupiterOrder.slippageBps;
   const validTo = Math.floor(Date.now() / 1e3) + validForSeconds;
   const orderParams = {
     sellToken: sellTokenAddress,
@@ -236,7 +241,7 @@ async function getSolanaQuote(params, options = {}) {
   };
   const amountsAndCosts = getQuoteAmountsAndCosts({
     orderParams,
-    slippagePercentBps: jupiterOrder.slippageBps,
+    slippagePercentBps: signedSlippageBps,
     // TODO: implement fees
     partnerFeeBps: 0,
     protocolFeeBps: 0
@@ -275,6 +280,7 @@ async function getSolanaQuote(params, options = {}) {
     verified: false
   };
   const tradeParameters = {
+    ...slippageBpsOverride !== void 0 ? { slippageBps: slippageBpsOverride } : void 0,
     kind,
     owner: owner.toBase58(),
     // The mint the caller asked for, not the substituted one: callers compare the returned parameters
@@ -292,6 +298,8 @@ async function getSolanaQuote(params, options = {}) {
   const quoteResults = {
     quoteResponse,
     amountsAndCosts,
+    // What the quote provider suggested, never the caller's own `slippageBps`: consumers read this as a
+    // recommendation and would otherwise be handed their own input back as advice.
     suggestedSlippageBps: jupiterOrder.slippageBps,
     tradeParameters,
     orderToSign: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cowprotocol/sdk-trading-solana",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "CowProtocol Solana trading: Jupiter-sourced quotes and on-chain CreateOrder posting against the Solana settlement program",
   "repository": {
     "type": "git",
@@ -38,8 +38,8 @@
   },
   "dependencies": {
     "@cowprotocol/sdk-config": "2.6.0",
-    "@cowprotocol/sdk-order-book": "4.0.4",
-    "@cowprotocol/sdk-trading": "2.4.2",
+    "@cowprotocol/sdk-order-book": "4.0.5",
+    "@cowprotocol/sdk-trading": "2.5.0",
     "@solana/spl-token": "0.4.14",
     "@solana/web3.js": "1.98.4"
   },