@cowprotocol/sdk-trading 1.0.4 → 1.1.1

package/README.md

@@ -850,3 +850,137 @@ if (currentAllowance < requiredAmount) {
   console.log('Sufficient allowance already exists')
 }
 ```
+
+## Custom Contract Addresses
+
+For advanced use cases such as testing, custom deployments, or chains where CoW Protocol contracts are deployed at non-standard addresses, you can override the contract addresses used by the SDK.
+
+Both parameters accept an `AddressPerChain` object (`Record<SupportedChainId, Address>`), so they apply per-chain and persist across all operations when set in `traderParams`.
+
+### settlementContractOverride / ethFlowContractOverride
+
+Overrides the address of the CoW Protocol Settlement contract. This affects:
+- Order domain signing (EIP-712 `verifyingContract`)
+- On-chain order cancellation via `onChainCancelOrder`
+- Pre-sign transactions via `getPreSignTransaction`
+
+```typescript
+import { SupportedChainId, OrderKind, TradeParameters, TradingSdk, COW_PROTOCOL_SETTLEMENT_CONTRACT_ADDRESS, ETH_FLOW_ADDRESSES } from '@cowprotocol/cow-sdk'
+import { ViemAdapter } from '@cowprotocol/sdk-viem-adapter'
+import { createPublicClient, http, privateKeyToAccount } from 'viem'
+import { sepolia } from 'viem/chains'
+
+const adapter = new ViemAdapter({
+  provider: createPublicClient({
+    chain: sepolia,
+    transport: http('YOUR_RPC_URL')
+  }),
+  signer: privateKeyToAccount('YOUR_PRIVATE_KEY' as `0x${string}`)
+})
+
+const sdk = new TradingSdk({
+  chainId: SupportedChainId.SEPOLIA,
+  appCode: '<YOUR_APP_CODE>',
+  // Override the settlement contract address for MAINNET
+  settlementContractOverride: {
+    ...COW_PROTOCOL_SETTLEMENT_CONTRACT_ADDRESS,
+    [SupportedChainId.MAINNET]: '0x<custom_settlement_contract>',
+  } as AddressPerChain,
+  // Override the eth-flow contract address for GNOSIS_CHAIN
+  ethFlowContractOverride: {
+    ...ETH_FLOW_ADDRESSES,
+    [SupportedChainId.GNOSIS_CHAIN]: '0x<custom_eth_flow_contract>',
+  } as AddressPerChain,
+}, {}, adapter)
+
+const parameters: TradeParameters = {
+  kind: OrderKind.BUY,
+  sellToken: '0xfff9976782d46cc05630d1f6ebab18b2324d6b14',
+  sellTokenDecimals: 18,
+  buyToken: '0x0625afb445c3b6b7b929342a04a22599fd5dbb59',
+  buyTokenDecimals: 18,
+  amount: '120000000000000000',
+}
+
+const { quoteResults, postSwapOrderFromQuote } = await sdk.getQuote(parameters)
+const orderId = await postSwapOrderFromQuote()
+
+console.log('Order created, id: ', orderId)
+```
+
+You can also pass `settlementContractOverride` / `ethFlowContractOverride` per-call to override only for that operation:
+
+```typescript
+const { quoteResults, postSwapOrderFromQuote } = await sdk.getQuote({
+  ...parameters,
+  settlementContractOverride: {
+    [SupportedChainId.MAINNET]: '0x<custom_settlement_contract>',
+  } as AddressPerChain,
+})
+
+// or
+
+const { orderId } = await sdk.postSwapOrder({
+  ...parameters,
+  settlementContractOverride: {
+    [SupportedChainId.MAINNET]: '0x<custom_settlement_contract>',
+  } as AddressPerChain,
+})
+```
+
+## Custom Order-Book API Endpoint
+
+By default the SDK uses the public CoW Protocol API endpoints. You can point the SDK at a custom or self-hosted order-book by creating an `OrderBookApi` instance with custom `baseUrls` and passing it as the `orderBookApi` option.
+
+This is useful for:
+- Running a local order-book node during development
+- Using a private/dedicated API deployment
+- Connecting to a forked or testnet environment with a custom backend
+
+```typescript
+import { SupportedChainId, TradingSdk, OrderKind, TradeParameters } from '@cowprotocol/sdk-trading'
+import { OrderBookApi } from '@cowprotocol/sdk-order-book'
+import { AddressPerChain } from '@cowprotocol/sdk-config'
+import { ViemAdapter } from '@cowprotocol/sdk-viem-adapter'
+import { createPublicClient, http, privateKeyToAccount } from 'viem'
+import { mainnet } from 'viem/chains'
+
+const adapter = new ViemAdapter({
+  provider: createPublicClient({ chain: mainnet, transport: http('YOUR_RPC_URL') }),
+  signer: privateKeyToAccount('YOUR_PRIVATE_KEY' as `0x${string}`),
+})
+
+// 1. Create an OrderBookApi instance with custom base URLs
+const orderBookApi = new OrderBookApi({
+  chainId: SupportedChainId.MAINNET,
+  // Provide a base URL for each chain you intend to use
+  baseUrls: {
+    // ...
+    [SupportedChainId.MAINNET]: 'https://your-custom-orderbook.example.com/mainnet',
+  },
+})
+
+// 2. Pass it to TradingSdk via the options object
+const sdk = new TradingSdk(
+  {
+    chainId: SupportedChainId.MAINNET,
+    appCode: '<YOUR_APP_CODE>',
+  },
+  {
+    orderBookApi, // All order-book requests will go to your custom endpoint
+  },
+  adapter,
+)
+
+const parameters: TradeParameters = {
+  kind: OrderKind.SELL,
+  sellToken: '0xfff9976782d46cc05630d1f6ebab18b2324d6b14',
+  sellTokenDecimals: 18,
+  buyToken: '0x0625afb445c3b6b7b929342a04a22599fd5dbb59',
+  buyTokenDecimals: 18,
+  amount: '100000000000000000',
+}
+
+const { orderId } = await sdk.postSwapOrder(parameters)
+console.log('Order created via custom endpoint, id:', orderId)
+```

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import { cowAppDataLatestScheme, AppDataParams, LatestAppDataDocVersion } from '@cowprotocol/sdk-app-data';
 import { OrderKind, OrderParameters, TokenAmount, SigningScheme, OrderQuoteRequest, QuoteAmountsAndCosts, OrderQuoteResponse, AppData, AppDataHash, Signature, OrderBookApi, EnrichedOrder } from '@cowprotocol/sdk-order-book';
-import { AccountAddress, AbstractSigner, Provider, SignerLike, Signer, AbstractProviderAdapter, EthFlowContract } from '@cowprotocol/sdk-common';
+import { AccountAddress, AbstractSigner, Provider, SignerLike, Signer, AbstractProviderAdapter, Address, EthFlowContract } from '@cowprotocol/sdk-common';
 import { UnsignedOrder, ORDER_PRIMARY_TYPE } from '@cowprotocol/sdk-order-signing';
-import { CowEnv, SupportedChainId } from '@cowprotocol/sdk-config';
+import { CowEnv, AddressPerChain, SupportedChainId, ProtocolOptions } from '@cowprotocol/sdk-config';
 
 /**
  * EIP-712 typed data domain.
@@ -46,6 +46,14 @@ interface TradeBaseParameters {
  */
 interface TradeOptionalParameters {
     env?: CowEnv;
+    /**
+     * Custom address of settlement contract
+     */
+    settlementContractOverride?: Partial<AddressPerChain>;
+    /**
+     * Custom address of sell native token contract
+     */
+    ethFlowContractOverride?: Partial<AddressPerChain>;
     partiallyFillable?: OrderParameters['partiallyFillable'];
     /**
      * Slippage in basis points.
@@ -69,6 +77,8 @@ interface TraderParameters {
     appCode: cowAppDataLatestScheme.AppCode;
     signer?: SignerLike;
     env?: CowEnv;
+    settlementContractOverride?: Partial<AddressPerChain>;
+    ethFlowContractOverride?: Partial<AddressPerChain>;
 }
 type QuoterParameters = Omit<TraderParameters, 'signer'> & {
     account: AccountAddress;
@@ -262,7 +272,7 @@ declare function getQuoteWithSigner(swapParameters: SwapParameters, advancedSett
 
 declare function postSellNativeCurrencyOrder(orderBookApi: OrderBookApi, appData: Pick<TradingAppDataInfo, 'fullAppData' | 'appDataKeccak256'>, _params: LimitTradeParametersFromQuote, additionalParams?: PostTradeAdditionalParams, paramSigner?: SignerLike): Promise<OrderPostingResult>;
 
-declare function getPreSignTransaction(signer: Signer, chainId: SupportedChainId, orderId: string): Promise<TradingTransactionParams>;
+declare function getPreSignTransaction(signer: Signer, chainId: SupportedChainId, orderId: string, options?: ProtocolOptions): Promise<TradingTransactionParams>;
 
 type WithPartialTraderParams<T> = T & Partial<TraderParameters>;
 /**
@@ -371,6 +381,7 @@ declare class TradingSdk {
     getCowProtocolAllowance(params: WithPartialTraderParams<{
         tokenAddress: string;
         owner: string;
+        vaultRelayerAddress?: Address;
     }>): Promise<bigint>;
     /**
      * Approves the CoW Protocol Vault Relayer to spend a specified amount of an ERC-20 token.
@@ -394,6 +405,7 @@ declare class TradingSdk {
     approveCowProtocol(params: WithPartialTraderParams<{
         tokenAddress: string;
         amount: bigint;
+        vaultRelayerAddress?: Address;
     }>): Promise<string>;
     private resolveOrderBookApi;
     private mergeParams;
@@ -409,7 +421,7 @@ declare function getEthFlowTransaction(appDataKeccak256: string, _params: LimitT
     transaction: TradingTransactionParams;
     orderToSign: UnsignedOrder;
 }>;
-declare function getEthFlowContract(signer: Signer, chainId: SupportedChainId, env?: CowEnv): EthFlowContract;
+declare function getEthFlowContract(signer: Signer, chainId: SupportedChainId, options?: ProtocolOptions): EthFlowContract;
 
 interface OrderToSignParams {
     chainId: SupportedChainId;
@@ -455,7 +467,7 @@ declare function buildAppData({ slippageBps, appCode, orderClass: orderClassName
 declare function generateAppDataFromDoc(doc: AppDataRootSchema): Promise<Pick<TradingAppDataInfo, 'fullAppData' | 'appDataKeccak256'>>;
 declare function mergeAppDataDoc(_doc: LatestAppDataDocVersion, appDataOverride: AppDataParams): Promise<TradingAppDataInfo>;
 
-declare function calculateUniqueOrderId(chainId: SupportedChainId, order: UnsignedOrder, checkEthFlowOrderExists?: EthFlowOrderExistsCallback, env?: CowEnv): Promise<string>;
+declare function calculateUniqueOrderId(chainId: SupportedChainId, order: UnsignedOrder, checkEthFlowOrderExists?: EthFlowOrderExistsCallback, options?: ProtocolOptions): Promise<string>;
 
 declare function getPartnerFeeBps(partnerFee: cowAppDataLatestScheme.PartnerFee | undefined): number | undefined;
 

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { cowAppDataLatestScheme, AppDataParams, LatestAppDataDocVersion } from '@cowprotocol/sdk-app-data';
 import { OrderKind, OrderParameters, TokenAmount, SigningScheme, OrderQuoteRequest, QuoteAmountsAndCosts, OrderQuoteResponse, AppData, AppDataHash, Signature, OrderBookApi, EnrichedOrder } from '@cowprotocol/sdk-order-book';
-import { AccountAddress, AbstractSigner, Provider, SignerLike, Signer, AbstractProviderAdapter, EthFlowContract } from '@cowprotocol/sdk-common';
+import { AccountAddress, AbstractSigner, Provider, SignerLike, Signer, AbstractProviderAdapter, Address, EthFlowContract } from '@cowprotocol/sdk-common';
 import { UnsignedOrder, ORDER_PRIMARY_TYPE } from '@cowprotocol/sdk-order-signing';
-import { CowEnv, SupportedChainId } from '@cowprotocol/sdk-config';
+import { CowEnv, AddressPerChain, SupportedChainId, ProtocolOptions } from '@cowprotocol/sdk-config';
 
 /**
  * EIP-712 typed data domain.
@@ -46,6 +46,14 @@ interface TradeBaseParameters {
  */
 interface TradeOptionalParameters {
     env?: CowEnv;
+    /**
+     * Custom address of settlement contract
+     */
+    settlementContractOverride?: Partial<AddressPerChain>;
+    /**
+     * Custom address of sell native token contract
+     */
+    ethFlowContractOverride?: Partial<AddressPerChain>;
     partiallyFillable?: OrderParameters['partiallyFillable'];
     /**
      * Slippage in basis points.
@@ -69,6 +77,8 @@ interface TraderParameters {
     appCode: cowAppDataLatestScheme.AppCode;
     signer?: SignerLike;
     env?: CowEnv;
+    settlementContractOverride?: Partial<AddressPerChain>;
+    ethFlowContractOverride?: Partial<AddressPerChain>;
 }
 type QuoterParameters = Omit<TraderParameters, 'signer'> & {
     account: AccountAddress;
@@ -262,7 +272,7 @@ declare function getQuoteWithSigner(swapParameters: SwapParameters, advancedSett
 
 declare function postSellNativeCurrencyOrder(orderBookApi: OrderBookApi, appData: Pick<TradingAppDataInfo, 'fullAppData' | 'appDataKeccak256'>, _params: LimitTradeParametersFromQuote, additionalParams?: PostTradeAdditionalParams, paramSigner?: SignerLike): Promise<OrderPostingResult>;
 
-declare function getPreSignTransaction(signer: Signer, chainId: SupportedChainId, orderId: string): Promise<TradingTransactionParams>;
+declare function getPreSignTransaction(signer: Signer, chainId: SupportedChainId, orderId: string, options?: ProtocolOptions): Promise<TradingTransactionParams>;
 
 type WithPartialTraderParams<T> = T & Partial<TraderParameters>;
 /**
@@ -371,6 +381,7 @@ declare class TradingSdk {
     getCowProtocolAllowance(params: WithPartialTraderParams<{
         tokenAddress: string;
         owner: string;
+        vaultRelayerAddress?: Address;
     }>): Promise<bigint>;
     /**
      * Approves the CoW Protocol Vault Relayer to spend a specified amount of an ERC-20 token.
@@ -394,6 +405,7 @@ declare class TradingSdk {
     approveCowProtocol(params: WithPartialTraderParams<{
         tokenAddress: string;
         amount: bigint;
+        vaultRelayerAddress?: Address;
     }>): Promise<string>;
     private resolveOrderBookApi;
     private mergeParams;
@@ -409,7 +421,7 @@ declare function getEthFlowTransaction(appDataKeccak256: string, _params: LimitT
     transaction: TradingTransactionParams;
     orderToSign: UnsignedOrder;
 }>;
-declare function getEthFlowContract(signer: Signer, chainId: SupportedChainId, env?: CowEnv): EthFlowContract;
+declare function getEthFlowContract(signer: Signer, chainId: SupportedChainId, options?: ProtocolOptions): EthFlowContract;
 
 interface OrderToSignParams {
     chainId: SupportedChainId;
@@ -455,7 +467,7 @@ declare function buildAppData({ slippageBps, appCode, orderClass: orderClassName
 declare function generateAppDataFromDoc(doc: AppDataRootSchema): Promise<Pick<TradingAppDataInfo, 'fullAppData' | 'appDataKeccak256'>>;
 declare function mergeAppDataDoc(_doc: LatestAppDataDocVersion, appDataOverride: AppDataParams): Promise<TradingAppDataInfo>;
 
-declare function calculateUniqueOrderId(chainId: SupportedChainId, order: UnsignedOrder, checkEthFlowOrderExists?: EthFlowOrderExistsCallback, env?: CowEnv): Promise<string>;
+declare function calculateUniqueOrderId(chainId: SupportedChainId, order: UnsignedOrder, checkEthFlowOrderExists?: EthFlowOrderExistsCallback, options?: ProtocolOptions): Promise<string>;
 
 declare function getPartnerFeeBps(partnerFee: cowAppDataLatestScheme.PartnerFee | undefined): number | undefined;
 

package/dist/index.js

@@ -203,7 +203,8 @@ var import_sdk_order_book3 = require("@cowprotocol/sdk-order-book");
 // src/calculateUniqueOrderId.ts
 var import_sdk_order_signing = require("@cowprotocol/sdk-order-signing");
 var import_sdk_config2 = require("@cowprotocol/sdk-config");
-async function calculateUniqueOrderId(chainId, order, checkEthFlowOrderExists, env) {
+async function calculateUniqueOrderId(chainId, order, checkEthFlowOrderExists, options) {
+  const { env, ethFlowContractOverride } = options ?? {};
   const { orderDigest, orderId } = await import_sdk_order_signing.OrderSigningUtils.generateOrderId(
     chainId,
     {
@@ -212,15 +213,21 @@ async function calculateUniqueOrderId(chainId, order, checkEthFlowOrderExists, e
       sellToken: import_sdk_config2.WRAPPED_NATIVE_CURRENCIES[chainId].address
     },
     {
-      owner: env === "staging" ? import_sdk_config2.BARN_ETH_FLOW_ADDRESSES[chainId] : import_sdk_config2.ETH_FLOW_ADDRESSES[chainId]
-    }
+      owner: ethFlowContractOverride?.[chainId] ?? (env === "staging" ? import_sdk_config2.BARN_ETH_FLOW_ADDRESSES[chainId] : import_sdk_config2.ETH_FLOW_ADDRESSES[chainId])
+    },
+    options
   );
   if (checkEthFlowOrderExists && await checkEthFlowOrderExists(orderId, orderDigest)) {
     console.error("ETH FLOW", "[calculateUniqueOrderId] \u274C Collision detected: " + orderId, {
       sellAmount: order.sellAmount,
       fee: order.feeAmount
     });
-    return calculateUniqueOrderId(chainId, adjustAmounts(order), checkEthFlowOrderExists);
+    return calculateUniqueOrderId(
+      chainId,
+      adjustAmounts(order),
+      checkEthFlowOrderExists,
+      options
+    );
   }
   return orderId;
 }
@@ -312,7 +319,12 @@ async function getEthFlowTransaction(appDataKeccak256, _params, chainId, additio
     slippageBps
   };
   const { quoteId } = params;
-  const contract = getEthFlowContract(signer, chainId, params.env);
+  const protocolOptions = {
+    env: params.env,
+    settlementContractOverride: params.settlementContractOverride,
+    ethFlowContractOverride: params.ethFlowContractOverride
+  };
+  const contract = getEthFlowContract(signer, chainId, protocolOptions);
   const orderToSign = getOrderToSign(
     {
       chainId,
@@ -323,7 +335,7 @@ async function getEthFlowTransaction(appDataKeccak256, _params, chainId, additio
     params,
     appDataKeccak256
   );
-  const orderId = await calculateUniqueOrderId(chainId, orderToSign, checkEthFlowOrderExists, params.env);
+  const orderId = await calculateUniqueOrderId(chainId, orderToSign, checkEthFlowOrderExists, protocolOptions);
   const ethOrderParams = {
     buyToken: orderToSign.buyToken,
     receiver: orderToSign.receiver,
@@ -353,8 +365,9 @@ async function getEthFlowTransaction(appDataKeccak256, _params, chainId, additio
     }
   };
 }
-function getEthFlowContract(signer, chainId, env) {
-  const address = env === "staging" ? import_sdk_config4.BARN_ETH_FLOW_ADDRESSES[chainId] : import_sdk_config4.ETH_FLOW_ADDRESSES[chainId];
+function getEthFlowContract(signer, chainId, options) {
+  const { env, ethFlowContractOverride } = options ?? {};
+  const address = ethFlowContractOverride?.[chainId] ?? (env === "staging" ? import_sdk_config4.BARN_ETH_FLOW_ADDRESSES[chainId] : import_sdk_config4.ETH_FLOW_ADDRESSES[chainId]);
   return import_sdk_common.ContractFactory.createEthFlowContract(address, signer);
 }
 
@@ -365,7 +378,11 @@ async function postSellNativeCurrencyOrder(orderBookApi, appData, _params, addit
   const { appDataKeccak256, fullAppData } = appData;
   const { orderId, transaction, orderToSign } = await getEthFlowTransaction(
     appDataKeccak256,
-    _params,
+    {
+      ..._params,
+      env: _params.env ?? orderBookApi.context.env,
+      ethFlowContractOverride: _params.ethFlowContractOverride
+    },
     orderBookApi.context.chainId,
     additionalParams,
     signer
@@ -408,6 +425,8 @@ async function postCoWProtocolTrade(orderBookApi, appData, params, additionalPar
   }
   const { quoteId = null, owner } = params;
   const { appDataKeccak256, fullAppData } = appData;
+  const env = params.env ?? orderBookApi.context.env;
+  const settlementContractOverride = params.settlementContractOverride;
   const chainId = orderBookApi.context.chainId;
   const from = owner || await signer.getAddress();
   const orderToSign = getOrderToSign(
@@ -429,7 +448,12 @@ async function postCoWProtocolTrade(orderBookApi, appData, params, additionalPar
           signingScheme: _signingScheme
         };
       }
-      const signingResult = await import_sdk_order_signing2.OrderSigningUtils.signOrder(orderToSign, chainId, signer);
+      const signingResult = await import_sdk_order_signing2.OrderSigningUtils.signOrder(
+        orderToSign,
+        chainId,
+        signer,
+        { env, settlementContractOverride }
+      );
       if (isEip1271) {
         return {
           signature: import_sdk_order_signing2.OrderSigningUtils.getEip1271Signature(orderToSign, signingResult.signature),
@@ -466,9 +490,14 @@ var import_deepmerge = __toESM(require("deepmerge"));
 // ../sdk/package.json
 var package_default = {
   name: "@cowprotocol/cow-sdk",
-  version: "8.0.0",
+  version: "8.0.2",
   license: "(MIT OR Apache-2.0)",
   description: "CoW Protocol SDK - get quote, configure your order, and trade",
+  repository: {
+    type: "git",
+    url: "https://github.com/cowprotocol/cow-sdk.git",
+    directory: "packages/sdk"
+  },
   main: "./dist/index.js",
   module: "./dist/index.mjs",
   types: "./dist/index.d.ts",
@@ -542,11 +571,6 @@ var package_default = {
     "typescript",
     "subgraph"
   ],
-  repository: {
-    type: "git",
-    url: "https://github.com/cowprotocol/cow-sdk.git",
-    directory: "packages/sdk"
-  },
   bugs: {
     url: "https://github.com/cowprotocol/cow-sdk/issues"
   },
@@ -618,8 +642,8 @@ var EIP712DomainTypes = [
   { name: "chainId", type: "uint256" },
   { name: "verifyingContract", type: "address" }
 ];
-async function getOrderTypedData(chainId, orderToSign) {
-  const domain = await import_sdk_order_signing3.OrderSigningUtils.getDomain(chainId);
+async function getOrderTypedData(chainId, orderToSign, options) {
+  const domain = await import_sdk_order_signing3.OrderSigningUtils.getDomain(chainId, options);
   return {
     domain,
     primaryType: import_sdk_order_signing3.ORDER_PRIMARY_TYPE,
@@ -871,6 +895,8 @@ async function getQuote(_tradeParameters, trader, advancedSettings, _orderBookAp
   const { quote, orderBookApi, tradeParameters, slippageBps, suggestedSlippageBps, appDataInfo, isEthFlow } = await getQuoteRaw(_tradeParameters, trader, advancedSettings, _orderBookApi);
   const { partnerFee } = tradeParameters;
   const { chainId, account: from } = trader;
+  const env = _tradeParameters.env ?? trader.env;
+  const settlementContractOverride = _tradeParameters.settlementContractOverride ?? trader.settlementContractOverride;
   const amountsAndCosts = (0, import_sdk_order_book7.getQuoteAmountsAndCosts)({
     orderParams: quote.quote,
     slippagePercentBps: slippageBps,
@@ -888,7 +914,7 @@ async function getQuote(_tradeParameters, trader, advancedSettings, _orderBookAp
     swapParamsToLimitOrderParams(tradeParameters, quote),
     appDataInfo.appDataKeccak256
   );
-  const orderTypedData = await getOrderTypedData(chainId, orderToSign);
+  const orderTypedData = await getOrderTypedData(chainId, orderToSign, { env, settlementContractOverride });
   return {
     result: {
       tradeParameters,
@@ -908,7 +934,8 @@ async function getTrader(swapParameters) {
   return {
     chainId: swapParameters.chainId,
     appCode: swapParameters.appCode,
-    account
+    account,
+    settlementContractOverride: swapParameters.settlementContractOverride
   };
 }
 async function getQuoteWithSigner(swapParameters, advancedSettings, orderBookApi) {
@@ -1013,13 +1040,17 @@ async function postLimitOrder(_params, advancedSettings, _orderBookApi) {
 // src/getSettlementContract.ts
 var import_sdk_common13 = require("@cowprotocol/sdk-common");
 var import_sdk_config5 = require("@cowprotocol/sdk-config");
-function getSettlementContract(chainId, signer) {
-  return import_sdk_common13.ContractFactory.createSettlementContract(import_sdk_config5.COW_PROTOCOL_SETTLEMENT_CONTRACT_ADDRESS[chainId], signer);
+function getSettlementContract(chainId, signer, options) {
+  const { env, settlementContractOverride } = options ?? {};
+  return import_sdk_common13.ContractFactory.createSettlementContract(
+    settlementContractOverride?.[chainId] ?? (env === "staging" ? import_sdk_config5.COW_PROTOCOL_SETTLEMENT_CONTRACT_ADDRESS_STAGING[chainId] : import_sdk_config5.COW_PROTOCOL_SETTLEMENT_CONTRACT_ADDRESS[chainId]),
+    signer
+  );
 }
 
 // src/getPreSignTransaction.ts
-async function getPreSignTransaction(signer, chainId, orderId) {
-  const contract = getSettlementContract(chainId, signer);
+async function getPreSignTransaction(signer, chainId, orderId, options) {
+  const contract = getSettlementContract(chainId, signer, options);
   const preSignatureCall = contract.interface.encodeFunctionData("setPreSignature", [orderId, true]);
   const gas = await contract.estimateGas.setPreSignature?.(orderId, true).catch(() => GAS_LIMIT_DEFAULT) || GAS_LIMIT_DEFAULT;
   return {
@@ -1128,7 +1159,11 @@ var TradingSdk = class {
     return this;
   }
   async getQuote(params, advancedSettings) {
-    const quoteResults = await getQuoteWithSigner(this.mergeParams(params), advancedSettings, this.options.orderBookApi);
+    const quoteResults = await getQuoteWithSigner(
+      this.mergeParams(params),
+      advancedSettings,
+      this.resolveOrderBookApi(params)
+    );
     return {
       quoteResults: quoteResults.result,
       postSwapOrderFromQuote: async (advancedSettings2, signingStepManager) => {
@@ -1197,19 +1232,21 @@ var TradingSdk = class {
       chainId: quoterParams.chainId,
       appCode: quoterParams.appCode,
       env: quoterParams.env,
-      account: quoterParams.owner
+      account: quoterParams.owner,
+      settlementContractOverride: quoterParams.settlementContractOverride,
+      ethFlowContractOverride: quoterParams.ethFlowContractOverride
     };
-    const result = await getQuote(quoterParams, trader, advancedSettings, this.options.orderBookApi);
+    const result = await getQuote(quoterParams, trader, advancedSettings, this.resolveOrderBookApi(params));
     return result.result;
   }
   async getQuoteResults(params, advancedSettings) {
-    return getQuoteWithSigner(this.mergeParams(params), advancedSettings, this.options.orderBookApi);
+    return getQuoteWithSigner(this.mergeParams(params), advancedSettings, this.resolveOrderBookApi(params));
   }
   async postSwapOrder(params, advancedSettings) {
-    return postSwapOrder(this.mergeParams(params), advancedSettings, this.options.orderBookApi);
+    return postSwapOrder(this.mergeParams(params), advancedSettings, this.resolveOrderBookApi(params));
   }
   async postLimitOrder(params, advancedSettings) {
-    return postLimitOrder(this.mergeParams(params), advancedSettings, this.options.orderBookApi);
+    return postLimitOrder(this.mergeParams(params), advancedSettings, this.resolveOrderBookApi(params));
   }
   /**
    * Posts a sell order for native currency (e.g., ETH) using the EthFlow contract.
@@ -1234,7 +1271,11 @@ var TradingSdk = class {
    * ```
    */
   async postSellNativeCurrencyOrder(params, advancedSettings) {
-    const quoteResults = await getQuoteWithSigner(this.mergeParams(params), advancedSettings, this.options.orderBookApi);
+    const quoteResults = await getQuoteWithSigner(
+      this.mergeParams(params),
+      advancedSettings,
+      this.resolveOrderBookApi(params)
+    );
     const { tradeParameters, quoteResponse } = quoteResults.result;
     return postSellNativeCurrencyOrder(
       quoteResults.orderBookApi,
@@ -1249,9 +1290,12 @@ var TradingSdk = class {
     );
   }
   async getPreSignTransaction(params) {
-    const traderParams = this.mergeParams(params);
-    const signer = resolveSigner(traderParams.signer);
-    return getPreSignTransaction(signer, traderParams.chainId, params.orderUid);
+    const { chainId, env, settlementContractOverride, orderUid, signer: signerLike } = this.mergeParams(params);
+    const signer = resolveSigner(signerLike);
+    return getPreSignTransaction(signer, chainId, orderUid, {
+      env,
+      settlementContractOverride
+    });
   }
   async getOrder(params) {
     const orderBookApi = this.resolveOrderBookApi(params);
@@ -1259,13 +1303,13 @@ var TradingSdk = class {
   }
   async offChainCancelOrder(params) {
     const orderBookApi = this.resolveOrderBookApi(params);
-    const signer = resolveSigner(params.signer);
+    const { env, chainId, settlementContractOverride, signer: signerLike } = this.mergeParams(params);
+    const signer = resolveSigner(signerLike);
     const { orderUid } = params;
-    const chainId = params.chainId || this.traderParams.chainId;
-    if (!chainId) {
-      throw new Error("Chain ID is missing in offChainCancelOrder() call");
-    }
-    const orderCancellationSigning = await import_sdk_order_signing4.OrderSigningUtils.signOrderCancellations([orderUid], chainId, signer);
+    const orderCancellationSigning = await import_sdk_order_signing4.OrderSigningUtils.signOrderCancellations([orderUid], chainId, signer, {
+      env,
+      settlementContractOverride
+    });
     await orderBookApi.sendSignedOrderCancellations({
       ...orderCancellationSigning,
       orderUids: [orderUid]
@@ -1273,14 +1317,11 @@ var TradingSdk = class {
     return true;
   }
   async onChainCancelOrder(params, _order) {
-    const chainId = params.chainId || this.traderParams.chainId;
-    if (!chainId) {
-      throw new Error("Chain ID is missing in offChainCancelOrder() call");
-    }
+    const { env, chainId, settlementContractOverride, ethFlowContractOverride } = this.mergeParams(params);
     const order = _order ?? await this.getOrder(params);
     const isEthFlowOrder = !!order.onchainOrderData;
     const signer = params.signer ? (0, import_sdk_common14.getGlobalAdapter)().createSigner(params.signer) : (0, import_sdk_common14.getGlobalAdapter)().signer;
-    const { transaction } = await (isEthFlowOrder ? getEthFlowCancellation(getEthFlowContract(signer, chainId, params.env ?? this.traderParams.env), order) : getSettlementCancellation(getSettlementContract(chainId, signer), order));
+    const { transaction } = await (isEthFlowOrder ? getEthFlowCancellation(getEthFlowContract(signer, chainId, { env, ethFlowContractOverride }), order) : getSettlementCancellation(getSettlementContract(chainId, signer, { env, settlementContractOverride }), order));
     const txReceipt = await signer.sendTransaction(transaction);
     return txReceipt.hash;
   }
@@ -1303,12 +1344,9 @@ var TradingSdk = class {
    * ```
    */
   async getCowProtocolAllowance(params) {
-    const chainId = params.chainId || this.traderParams.chainId;
-    if (!chainId) {
-      throw new Error("Chain ID is missing in getCowProtocolAllowance() call");
-    }
+    const { env, chainId } = this.mergeParams(params);
     const adapter = (0, import_sdk_common14.getGlobalAdapter)();
-    const vaultRelayerAddress = import_sdk_config6.COW_PROTOCOL_VAULT_RELAYER_ADDRESS[chainId];
+    const vaultRelayerAddress = params.vaultRelayerAddress ?? (env === "staging" ? import_sdk_config6.COW_PROTOCOL_VAULT_RELAYER_ADDRESS_STAGING[chainId] : import_sdk_config6.COW_PROTOCOL_VAULT_RELAYER_ADDRESS[chainId]);
     return await adapter.readContract({
       address: params.tokenAddress,
       abi: import_sdk_common14.ERC20_ALLOWANCE_ABI,
@@ -1336,13 +1374,10 @@ var TradingSdk = class {
    * ```
    */
   async approveCowProtocol(params) {
-    const chainId = params.chainId || this.traderParams.chainId;
-    if (!chainId) {
-      throw new Error("Chain ID is missing in approveCowProtocol() call");
-    }
+    const { env, chainId, signer: signerLike } = this.mergeParams(params);
     const adapter = (0, import_sdk_common14.getGlobalAdapter)();
-    const signer = resolveSigner(params.signer);
-    const vaultRelayerAddress = import_sdk_config6.COW_PROTOCOL_VAULT_RELAYER_ADDRESS[chainId];
+    const signer = resolveSigner(signerLike);
+    const vaultRelayerAddress = params.vaultRelayerAddress ?? (env === "staging" ? import_sdk_config6.COW_PROTOCOL_VAULT_RELAYER_ADDRESS_STAGING[chainId] : import_sdk_config6.COW_PROTOCOL_VAULT_RELAYER_ADDRESS[chainId]);
     const txParams = {
       to: params.tokenAddress,
       data: adapter.utils.encodeFunction(import_sdk_common14.ERC20_APPROVE_ABI, "approve", [
@@ -1355,19 +1390,22 @@ var TradingSdk = class {
   }
   resolveOrderBookApi(params) {
     const chainId = params.chainId ?? this.traderParams.chainId;
-    const env = params.env ?? this.traderParams.env ?? "prod";
+    const env = params.env ?? this.traderParams.env ?? this.options.orderBookApi?.context?.env ?? "prod";
     if (!chainId) {
       throw new Error("Chain ID is missing in getOrder() call");
     }
-    return resolveOrderBookApi(chainId, env);
+    return resolveOrderBookApi(chainId, env, this.options.orderBookApi);
   }
   mergeParams(params) {
-    const { chainId, signer, appCode, env } = params;
+    const { chainId, signer, appCode, env, settlementContractOverride, ethFlowContractOverride } = params;
+    const orderBookContext = this.options.orderBookApi?.context;
     const traderParams = {
-      chainId: chainId || this.traderParams.chainId,
-      signer: signer || this.traderParams.signer || (0, import_sdk_common14.getGlobalAdapter)().signer,
-      appCode: appCode || this.traderParams.appCode,
-      env: env || this.traderParams.env
+      chainId: chainId ?? this.traderParams.chainId ?? orderBookContext?.chainId,
+      signer: signer ?? this.traderParams.signer ?? (0, import_sdk_common14.getGlobalAdapter)().signer,
+      appCode: appCode ?? this.traderParams.appCode,
+      env: env ?? this.traderParams.env ?? orderBookContext?.env,
+      settlementContractOverride: settlementContractOverride ?? this.traderParams.settlementContractOverride,
+      ethFlowContractOverride: ethFlowContractOverride ?? this.traderParams.ethFlowContractOverride
     };
     assertTraderParams(traderParams);
     return {
@@ -1380,9 +1418,11 @@ var TradingSdk = class {
    * Used by quote-only operations that don't need signing capability.
    */
   mergeQuoterParams(params) {
-    const chainId = params.chainId || this.traderParams.chainId;
-    const appCode = params.appCode || this.traderParams.appCode;
-    const env = params.env || this.traderParams.env || "prod";
+    const chainId = params.chainId ?? this.traderParams.chainId;
+    const appCode = params.appCode ?? this.traderParams.appCode;
+    const env = params.env ?? this.traderParams.env ?? this.options.orderBookApi?.context?.env ?? "prod";
+    const settlementContractOverride = params.settlementContractOverride ?? this.traderParams.settlementContractOverride;
+    const ethFlowContractOverride = params.ethFlowContractOverride ?? this.traderParams.ethFlowContractOverride;
     if (!chainId) {
       throw new Error("Missing quoter parameters: chainId");
     }
@@ -1393,7 +1433,9 @@ var TradingSdk = class {
       ...params,
       chainId,
       appCode,
-      env
+      env,
+      settlementContractOverride,
+      ethFlowContractOverride
     };
   }
 };

package/dist/index.mjs

@@ -154,7 +154,8 @@ import {
   MAX_VALID_TO_EPOCH,
   WRAPPED_NATIVE_CURRENCIES
 } from "@cowprotocol/sdk-config";
-async function calculateUniqueOrderId(chainId, order, checkEthFlowOrderExists, env) {
+async function calculateUniqueOrderId(chainId, order, checkEthFlowOrderExists, options) {
+  const { env, ethFlowContractOverride } = options ?? {};
   const { orderDigest, orderId } = await OrderSigningUtils.generateOrderId(
     chainId,
     {
@@ -163,15 +164,21 @@ async function calculateUniqueOrderId(chainId, order, checkEthFlowOrderExists, e
       sellToken: WRAPPED_NATIVE_CURRENCIES[chainId].address
     },
     {
-      owner: env === "staging" ? BARN_ETH_FLOW_ADDRESSES[chainId] : ETH_FLOW_ADDRESSES[chainId]
-    }
+      owner: ethFlowContractOverride?.[chainId] ?? (env === "staging" ? BARN_ETH_FLOW_ADDRESSES[chainId] : ETH_FLOW_ADDRESSES[chainId])
+    },
+    options
   );
   if (checkEthFlowOrderExists && await checkEthFlowOrderExists(orderId, orderDigest)) {
     console.error("ETH FLOW", "[calculateUniqueOrderId] \u274C Collision detected: " + orderId, {
       sellAmount: order.sellAmount,
       fee: order.feeAmount
     });
-    return calculateUniqueOrderId(chainId, adjustAmounts(order), checkEthFlowOrderExists);
+    return calculateUniqueOrderId(
+      chainId,
+      adjustAmounts(order),
+      checkEthFlowOrderExists,
+      options
+    );
   }
   return orderId;
 }
@@ -181,7 +188,10 @@ function adjustAmounts(order) {
 }
 
 // src/getEthFlowTransaction.ts
-import { BARN_ETH_FLOW_ADDRESSES as BARN_ETH_FLOW_ADDRESSES2, ETH_FLOW_ADDRESSES as ETH_FLOW_ADDRESSES2 } from "@cowprotocol/sdk-config";
+import {
+  BARN_ETH_FLOW_ADDRESSES as BARN_ETH_FLOW_ADDRESSES2,
+  ETH_FLOW_ADDRESSES as ETH_FLOW_ADDRESSES2
+} from "@cowprotocol/sdk-config";
 
 // src/utils/misc.ts
 import { ETH_ADDRESS, WRAPPED_NATIVE_CURRENCIES as WRAPPED_NATIVE_CURRENCIES2 } from "@cowprotocol/sdk-config";
@@ -266,7 +276,12 @@ async function getEthFlowTransaction(appDataKeccak256, _params, chainId, additio
     slippageBps
   };
   const { quoteId } = params;
-  const contract = getEthFlowContract(signer, chainId, params.env);
+  const protocolOptions = {
+    env: params.env,
+    settlementContractOverride: params.settlementContractOverride,
+    ethFlowContractOverride: params.ethFlowContractOverride
+  };
+  const contract = getEthFlowContract(signer, chainId, protocolOptions);
   const orderToSign = getOrderToSign(
     {
       chainId,
@@ -277,7 +292,7 @@ async function getEthFlowTransaction(appDataKeccak256, _params, chainId, additio
     params,
     appDataKeccak256
   );
-  const orderId = await calculateUniqueOrderId(chainId, orderToSign, checkEthFlowOrderExists, params.env);
+  const orderId = await calculateUniqueOrderId(chainId, orderToSign, checkEthFlowOrderExists, protocolOptions);
   const ethOrderParams = {
     buyToken: orderToSign.buyToken,
     receiver: orderToSign.receiver,
@@ -307,8 +322,9 @@ async function getEthFlowTransaction(appDataKeccak256, _params, chainId, additio
     }
   };
 }
-function getEthFlowContract(signer, chainId, env) {
-  const address = env === "staging" ? BARN_ETH_FLOW_ADDRESSES2[chainId] : ETH_FLOW_ADDRESSES2[chainId];
+function getEthFlowContract(signer, chainId, options) {
+  const { env, ethFlowContractOverride } = options ?? {};
+  const address = ethFlowContractOverride?.[chainId] ?? (env === "staging" ? BARN_ETH_FLOW_ADDRESSES2[chainId] : ETH_FLOW_ADDRESSES2[chainId]);
   return ContractFactory.createEthFlowContract(address, signer);
 }
 
@@ -319,7 +335,11 @@ async function postSellNativeCurrencyOrder(orderBookApi, appData, _params, addit
   const { appDataKeccak256, fullAppData } = appData;
   const { orderId, transaction, orderToSign } = await getEthFlowTransaction(
     appDataKeccak256,
-    _params,
+    {
+      ..._params,
+      env: _params.env ?? orderBookApi.context.env,
+      ethFlowContractOverride: _params.ethFlowContractOverride
+    },
     orderBookApi.context.chainId,
     additionalParams,
     signer
@@ -362,6 +382,8 @@ async function postCoWProtocolTrade(orderBookApi, appData, params, additionalPar
   }
   const { quoteId = null, owner } = params;
   const { appDataKeccak256, fullAppData } = appData;
+  const env = params.env ?? orderBookApi.context.env;
+  const settlementContractOverride = params.settlementContractOverride;
   const chainId = orderBookApi.context.chainId;
   const from = owner || await signer.getAddress();
   const orderToSign = getOrderToSign(
@@ -383,7 +405,12 @@ async function postCoWProtocolTrade(orderBookApi, appData, params, additionalPar
           signingScheme: _signingScheme
         };
       }
-      const signingResult = await OrderSigningUtils2.signOrder(orderToSign, chainId, signer);
+      const signingResult = await OrderSigningUtils2.signOrder(
+        orderToSign,
+        chainId,
+        signer,
+        { env, settlementContractOverride }
+      );
       if (isEip1271) {
         return {
           signature: OrderSigningUtils2.getEip1271Signature(orderToSign, signingResult.signature),
@@ -430,9 +457,14 @@ import deepmerge from "deepmerge";
 // ../sdk/package.json
 var package_default = {
   name: "@cowprotocol/cow-sdk",
-  version: "8.0.0",
+  version: "8.0.2",
   license: "(MIT OR Apache-2.0)",
   description: "CoW Protocol SDK - get quote, configure your order, and trade",
+  repository: {
+    type: "git",
+    url: "https://github.com/cowprotocol/cow-sdk.git",
+    directory: "packages/sdk"
+  },
   main: "./dist/index.js",
   module: "./dist/index.mjs",
   types: "./dist/index.d.ts",
@@ -506,11 +538,6 @@ var package_default = {
     "typescript",
     "subgraph"
   ],
-  repository: {
-    type: "git",
-    url: "https://github.com/cowprotocol/cow-sdk.git",
-    directory: "packages/sdk"
-  },
   bugs: {
     url: "https://github.com/cowprotocol/cow-sdk/issues"
   },
@@ -582,8 +609,8 @@ var EIP712DomainTypes = [
   { name: "chainId", type: "uint256" },
   { name: "verifyingContract", type: "address" }
 ];
-async function getOrderTypedData(chainId, orderToSign) {
-  const domain = await OrderSigningUtils3.getDomain(chainId);
+async function getOrderTypedData(chainId, orderToSign, options) {
+  const domain = await OrderSigningUtils3.getDomain(chainId, options);
   return {
     domain,
     primaryType: ORDER_PRIMARY_TYPE,
@@ -835,6 +862,8 @@ async function getQuote(_tradeParameters, trader, advancedSettings, _orderBookAp
   const { quote, orderBookApi, tradeParameters, slippageBps, suggestedSlippageBps, appDataInfo, isEthFlow } = await getQuoteRaw(_tradeParameters, trader, advancedSettings, _orderBookApi);
   const { partnerFee } = tradeParameters;
   const { chainId, account: from } = trader;
+  const env = _tradeParameters.env ?? trader.env;
+  const settlementContractOverride = _tradeParameters.settlementContractOverride ?? trader.settlementContractOverride;
   const amountsAndCosts = getQuoteAmountsAndCosts4({
     orderParams: quote.quote,
     slippagePercentBps: slippageBps,
@@ -852,7 +881,7 @@ async function getQuote(_tradeParameters, trader, advancedSettings, _orderBookAp
     swapParamsToLimitOrderParams(tradeParameters, quote),
     appDataInfo.appDataKeccak256
   );
-  const orderTypedData = await getOrderTypedData(chainId, orderToSign);
+  const orderTypedData = await getOrderTypedData(chainId, orderToSign, { env, settlementContractOverride });
   return {
     result: {
       tradeParameters,
@@ -872,7 +901,8 @@ async function getTrader(swapParameters) {
   return {
     chainId: swapParameters.chainId,
     appCode: swapParameters.appCode,
-    account
+    account,
+    settlementContractOverride: swapParameters.settlementContractOverride
   };
 }
 async function getQuoteWithSigner(swapParameters, advancedSettings, orderBookApi) {
@@ -976,14 +1006,21 @@ async function postLimitOrder(_params, advancedSettings, _orderBookApi) {
 
 // src/getSettlementContract.ts
 import { ContractFactory as ContractFactory2 } from "@cowprotocol/sdk-common";
-import { COW_PROTOCOL_SETTLEMENT_CONTRACT_ADDRESS } from "@cowprotocol/sdk-config";
-function getSettlementContract(chainId, signer) {
-  return ContractFactory2.createSettlementContract(COW_PROTOCOL_SETTLEMENT_CONTRACT_ADDRESS[chainId], signer);
+import {
+  COW_PROTOCOL_SETTLEMENT_CONTRACT_ADDRESS,
+  COW_PROTOCOL_SETTLEMENT_CONTRACT_ADDRESS_STAGING
+} from "@cowprotocol/sdk-config";
+function getSettlementContract(chainId, signer, options) {
+  const { env, settlementContractOverride } = options ?? {};
+  return ContractFactory2.createSettlementContract(
+    settlementContractOverride?.[chainId] ?? (env === "staging" ? COW_PROTOCOL_SETTLEMENT_CONTRACT_ADDRESS_STAGING[chainId] : COW_PROTOCOL_SETTLEMENT_CONTRACT_ADDRESS[chainId]),
+    signer
+  );
 }
 
 // src/getPreSignTransaction.ts
-async function getPreSignTransaction(signer, chainId, orderId) {
-  const contract = getSettlementContract(chainId, signer);
+async function getPreSignTransaction(signer, chainId, orderId, options) {
+  const contract = getSettlementContract(chainId, signer, options);
   const preSignatureCall = contract.interface.encodeFunctionData("setPreSignature", [orderId, true]);
   const gas = await contract.estimateGas.setPreSignature?.(orderId, true).catch(() => GAS_LIMIT_DEFAULT) || GAS_LIMIT_DEFAULT;
   return {
@@ -1073,7 +1110,10 @@ function resolveOrderBookApi(chainId, env, existingOrderBookApi) {
 }
 
 // src/tradingSdk.ts
-import { COW_PROTOCOL_VAULT_RELAYER_ADDRESS } from "@cowprotocol/sdk-config";
+import {
+  COW_PROTOCOL_VAULT_RELAYER_ADDRESS,
+  COW_PROTOCOL_VAULT_RELAYER_ADDRESS_STAGING
+} from "@cowprotocol/sdk-config";
 var TradingSdk = class {
   constructor(traderParams = {}, options = {}, adapter) {
     this.traderParams = traderParams;
@@ -1098,7 +1138,11 @@ var TradingSdk = class {
     return this;
   }
   async getQuote(params, advancedSettings) {
-    const quoteResults = await getQuoteWithSigner(this.mergeParams(params), advancedSettings, this.options.orderBookApi);
+    const quoteResults = await getQuoteWithSigner(
+      this.mergeParams(params),
+      advancedSettings,
+      this.resolveOrderBookApi(params)
+    );
     return {
       quoteResults: quoteResults.result,
       postSwapOrderFromQuote: async (advancedSettings2, signingStepManager) => {
@@ -1167,19 +1211,21 @@ var TradingSdk = class {
       chainId: quoterParams.chainId,
       appCode: quoterParams.appCode,
       env: quoterParams.env,
-      account: quoterParams.owner
+      account: quoterParams.owner,
+      settlementContractOverride: quoterParams.settlementContractOverride,
+      ethFlowContractOverride: quoterParams.ethFlowContractOverride
     };
-    const result = await getQuote(quoterParams, trader, advancedSettings, this.options.orderBookApi);
+    const result = await getQuote(quoterParams, trader, advancedSettings, this.resolveOrderBookApi(params));
     return result.result;
   }
   async getQuoteResults(params, advancedSettings) {
-    return getQuoteWithSigner(this.mergeParams(params), advancedSettings, this.options.orderBookApi);
+    return getQuoteWithSigner(this.mergeParams(params), advancedSettings, this.resolveOrderBookApi(params));
   }
   async postSwapOrder(params, advancedSettings) {
-    return postSwapOrder(this.mergeParams(params), advancedSettings, this.options.orderBookApi);
+    return postSwapOrder(this.mergeParams(params), advancedSettings, this.resolveOrderBookApi(params));
   }
   async postLimitOrder(params, advancedSettings) {
-    return postLimitOrder(this.mergeParams(params), advancedSettings, this.options.orderBookApi);
+    return postLimitOrder(this.mergeParams(params), advancedSettings, this.resolveOrderBookApi(params));
   }
   /**
    * Posts a sell order for native currency (e.g., ETH) using the EthFlow contract.
@@ -1204,7 +1250,11 @@ var TradingSdk = class {
    * ```
    */
   async postSellNativeCurrencyOrder(params, advancedSettings) {
-    const quoteResults = await getQuoteWithSigner(this.mergeParams(params), advancedSettings, this.options.orderBookApi);
+    const quoteResults = await getQuoteWithSigner(
+      this.mergeParams(params),
+      advancedSettings,
+      this.resolveOrderBookApi(params)
+    );
     const { tradeParameters, quoteResponse } = quoteResults.result;
     return postSellNativeCurrencyOrder(
       quoteResults.orderBookApi,
@@ -1219,9 +1269,12 @@ var TradingSdk = class {
     );
   }
   async getPreSignTransaction(params) {
-    const traderParams = this.mergeParams(params);
-    const signer = resolveSigner(traderParams.signer);
-    return getPreSignTransaction(signer, traderParams.chainId, params.orderUid);
+    const { chainId, env, settlementContractOverride, orderUid, signer: signerLike } = this.mergeParams(params);
+    const signer = resolveSigner(signerLike);
+    return getPreSignTransaction(signer, chainId, orderUid, {
+      env,
+      settlementContractOverride
+    });
   }
   async getOrder(params) {
     const orderBookApi = this.resolveOrderBookApi(params);
@@ -1229,13 +1282,13 @@ var TradingSdk = class {
   }
   async offChainCancelOrder(params) {
     const orderBookApi = this.resolveOrderBookApi(params);
-    const signer = resolveSigner(params.signer);
+    const { env, chainId, settlementContractOverride, signer: signerLike } = this.mergeParams(params);
+    const signer = resolveSigner(signerLike);
     const { orderUid } = params;
-    const chainId = params.chainId || this.traderParams.chainId;
-    if (!chainId) {
-      throw new Error("Chain ID is missing in offChainCancelOrder() call");
-    }
-    const orderCancellationSigning = await OrderSigningUtils4.signOrderCancellations([orderUid], chainId, signer);
+    const orderCancellationSigning = await OrderSigningUtils4.signOrderCancellations([orderUid], chainId, signer, {
+      env,
+      settlementContractOverride
+    });
     await orderBookApi.sendSignedOrderCancellations({
       ...orderCancellationSigning,
       orderUids: [orderUid]
@@ -1243,14 +1296,11 @@ var TradingSdk = class {
     return true;
   }
   async onChainCancelOrder(params, _order) {
-    const chainId = params.chainId || this.traderParams.chainId;
-    if (!chainId) {
-      throw new Error("Chain ID is missing in offChainCancelOrder() call");
-    }
+    const { env, chainId, settlementContractOverride, ethFlowContractOverride } = this.mergeParams(params);
     const order = _order ?? await this.getOrder(params);
     const isEthFlowOrder = !!order.onchainOrderData;
     const signer = params.signer ? getGlobalAdapter6().createSigner(params.signer) : getGlobalAdapter6().signer;
-    const { transaction } = await (isEthFlowOrder ? getEthFlowCancellation(getEthFlowContract(signer, chainId, params.env ?? this.traderParams.env), order) : getSettlementCancellation(getSettlementContract(chainId, signer), order));
+    const { transaction } = await (isEthFlowOrder ? getEthFlowCancellation(getEthFlowContract(signer, chainId, { env, ethFlowContractOverride }), order) : getSettlementCancellation(getSettlementContract(chainId, signer, { env, settlementContractOverride }), order));
     const txReceipt = await signer.sendTransaction(transaction);
     return txReceipt.hash;
   }
@@ -1273,12 +1323,9 @@ var TradingSdk = class {
    * ```
    */
   async getCowProtocolAllowance(params) {
-    const chainId = params.chainId || this.traderParams.chainId;
-    if (!chainId) {
-      throw new Error("Chain ID is missing in getCowProtocolAllowance() call");
-    }
+    const { env, chainId } = this.mergeParams(params);
     const adapter = getGlobalAdapter6();
-    const vaultRelayerAddress = COW_PROTOCOL_VAULT_RELAYER_ADDRESS[chainId];
+    const vaultRelayerAddress = params.vaultRelayerAddress ?? (env === "staging" ? COW_PROTOCOL_VAULT_RELAYER_ADDRESS_STAGING[chainId] : COW_PROTOCOL_VAULT_RELAYER_ADDRESS[chainId]);
     return await adapter.readContract({
       address: params.tokenAddress,
       abi: ERC20_ALLOWANCE_ABI,
@@ -1306,13 +1353,10 @@ var TradingSdk = class {
    * ```
    */
   async approveCowProtocol(params) {
-    const chainId = params.chainId || this.traderParams.chainId;
-    if (!chainId) {
-      throw new Error("Chain ID is missing in approveCowProtocol() call");
-    }
+    const { env, chainId, signer: signerLike } = this.mergeParams(params);
     const adapter = getGlobalAdapter6();
-    const signer = resolveSigner(params.signer);
-    const vaultRelayerAddress = COW_PROTOCOL_VAULT_RELAYER_ADDRESS[chainId];
+    const signer = resolveSigner(signerLike);
+    const vaultRelayerAddress = params.vaultRelayerAddress ?? (env === "staging" ? COW_PROTOCOL_VAULT_RELAYER_ADDRESS_STAGING[chainId] : COW_PROTOCOL_VAULT_RELAYER_ADDRESS[chainId]);
     const txParams = {
       to: params.tokenAddress,
       data: adapter.utils.encodeFunction(ERC20_APPROVE_ABI, "approve", [
@@ -1325,19 +1369,22 @@ var TradingSdk = class {
   }
   resolveOrderBookApi(params) {
     const chainId = params.chainId ?? this.traderParams.chainId;
-    const env = params.env ?? this.traderParams.env ?? "prod";
+    const env = params.env ?? this.traderParams.env ?? this.options.orderBookApi?.context?.env ?? "prod";
     if (!chainId) {
       throw new Error("Chain ID is missing in getOrder() call");
     }
-    return resolveOrderBookApi(chainId, env);
+    return resolveOrderBookApi(chainId, env, this.options.orderBookApi);
   }
   mergeParams(params) {
-    const { chainId, signer, appCode, env } = params;
+    const { chainId, signer, appCode, env, settlementContractOverride, ethFlowContractOverride } = params;
+    const orderBookContext = this.options.orderBookApi?.context;
     const traderParams = {
-      chainId: chainId || this.traderParams.chainId,
-      signer: signer || this.traderParams.signer || getGlobalAdapter6().signer,
-      appCode: appCode || this.traderParams.appCode,
-      env: env || this.traderParams.env
+      chainId: chainId ?? this.traderParams.chainId ?? orderBookContext?.chainId,
+      signer: signer ?? this.traderParams.signer ?? getGlobalAdapter6().signer,
+      appCode: appCode ?? this.traderParams.appCode,
+      env: env ?? this.traderParams.env ?? orderBookContext?.env,
+      settlementContractOverride: settlementContractOverride ?? this.traderParams.settlementContractOverride,
+      ethFlowContractOverride: ethFlowContractOverride ?? this.traderParams.ethFlowContractOverride
     };
     assertTraderParams(traderParams);
     return {
@@ -1350,9 +1397,11 @@ var TradingSdk = class {
    * Used by quote-only operations that don't need signing capability.
    */
   mergeQuoterParams(params) {
-    const chainId = params.chainId || this.traderParams.chainId;
-    const appCode = params.appCode || this.traderParams.appCode;
-    const env = params.env || this.traderParams.env || "prod";
+    const chainId = params.chainId ?? this.traderParams.chainId;
+    const appCode = params.appCode ?? this.traderParams.appCode;
+    const env = params.env ?? this.traderParams.env ?? this.options.orderBookApi?.context?.env ?? "prod";
+    const settlementContractOverride = params.settlementContractOverride ?? this.traderParams.settlementContractOverride;
+    const ethFlowContractOverride = params.ethFlowContractOverride ?? this.traderParams.ethFlowContractOverride;
     if (!chainId) {
       throw new Error("Missing quoter parameters: chainId");
     }
@@ -1363,7 +1412,9 @@ var TradingSdk = class {
       ...params,
       chainId,
       appCode,
-      env
+      env,
+      settlementContractOverride,
+      ethFlowContractOverride
     };
   }
 };

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@cowprotocol/sdk-trading",
-  "version": "1.0.4",
+  "version": "1.1.1",
   "description": "CowProtocol trading",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cowprotocol/cow-sdk.git",
+    "directory": "packages/trading"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -29,18 +34,18 @@
     "ts-jest": "^29.0.0",
     "tsx": "^4.19.4",
     "@cow-sdk/typescript-config": "0.0.0-beta.0",
-    "@cowprotocol/sdk-ethers-v5-adapter": "0.3.11",
-    "@cowprotocol/sdk-ethers-v6-adapter": "0.3.11",
-    "@cowprotocol/sdk-viem-adapter": "0.3.11"
+    "@cowprotocol/sdk-ethers-v5-adapter": "0.3.13",
+    "@cowprotocol/sdk-ethers-v6-adapter": "0.3.13",
+    "@cowprotocol/sdk-viem-adapter": "0.3.13"
   },
   "dependencies": {
     "deepmerge": "^4.3.1",
-    "@cowprotocol/sdk-common": "0.7.1",
-    "@cowprotocol/sdk-config": "1.0.0",
-    "@cowprotocol/sdk-app-data": "4.6.8",
-    "@cowprotocol/sdk-order-book": "2.0.0",
-    "@cowprotocol/sdk-order-signing": "0.1.38",
-    "@cowprotocol/sdk-contracts-ts": "2.0.0"
+    "@cowprotocol/sdk-common": "0.8.1",
+    "@cowprotocol/sdk-app-data": "4.6.10",
+    "@cowprotocol/sdk-config": "1.1.1",
+    "@cowprotocol/sdk-order-signing": "0.2.1",
+    "@cowprotocol/sdk-order-book": "2.0.2",
+    "@cowprotocol/sdk-contracts-ts": "2.1.1"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts",