@cowprotocol/sdk-trading 0.2.6-beta.0 → 0.3.0

package/README.md

@@ -44,9 +44,20 @@ Main functions:
 - `postLimitOrder` - Create a limit order.
 - `getQuote` - Fetch a quote for a swap order.
 
+Order Management:
+
+- `getOrder` - Retrieve order details by UID.
+- `offChainCancelOrder` - Cancel an order off-chain (soft cancel, free and fast).
+- `onChainCancelOrder` - Cancel an order on-chain (hard cancel, requires gas).
+
+Token Approval:
+
+- `getCowProtocolAllowance` - Check current token allowance for CoW Protocol.
+- `approveCowProtocol` - Approve CoW Protocol to spend tokens.
+
 Special cases:
 
-- 'setTraderParams' - In case if you work with different chains and need to switch between them in runtime.
+- `setTraderParams` - In case if you work with different chains and need to switch between them in runtime.
 - `postSellNativeCurrencyOrder` - Sell blockchain native tokens (e.g., ETH on Ethereum).
 - `getPreSignTransaction` - Sign an order using a smart contract wallet.
 
@@ -75,6 +86,7 @@ const adapter = new ViemAdapter({
     chain: sepolia,
     transport: http('YOUR_RPC_URL')
   }),
+  // You also can set `walletClient` instead of `signer` using `useWalletClient` from wagmi
   signer: privateKeyToAccount('YOUR_PRIVATE_KEY' as `0x${string}`)
 })
 
@@ -104,63 +116,6 @@ const orderId = await sdk.postSwapOrder(parameters)
 console.log('Order created, id: ', orderId)
 ```
 
-### Usage with Umbrella SDK
-
-```typescript
-import { CowSdk, SupportedChainId, OrderKind, TradeParameters } 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}`)
-})
-
-// Initialize the unified SDK
-const sdk = new CowSdk({
-  chainId: SupportedChainId.SEPOLIA,
-  adapter,
-  tradingOptions: {
-    traderParams: {
-      appCode: 'YOUR_APP_CODE',
-    },
-    options: {
-      chainId: SupportedChainId.SEPOLIA,
-    },
-  },
-})
-
-// Define trade parameters
-const parameters: TradeParameters = {
-  kind: OrderKind.BUY,
-  sellToken: '0xfff9976782d46cc05630d1f6ebab18b2324d6b14',
-  sellTokenDecimals: 18,
-  buyToken: '0x0625afb445c3b6b7b929342a04a22599fd5dbb59',
-  buyTokenDecimals: 18,
-  amount: '120000000000000000',
-}
-
-// Post the order
-const orderId = await sdk.trading.postSwapOrder(parameters)
-console.log('Order created, id: ', orderId)
-
-// Or you can just initialize the SDK and import the trading class in another file:
-// you don't necessarily need to use the trading from inside of CowSdk:
-//...
-const sdk = new CowSdk({
-  chainId: SupportedChainId.SEPOLIA,
-  adapter,
-})
-// Other file:
-import { TradingSdk } from '@cowprotocol/cow-sdk'
-// parameters without passing the adapter. the adapter will be controlled by the umbrella
-const trading = new TradingSdk(...)
-```
-
 ### Options
 
 For detailed information about trading steps you can enable the SDK logging:
@@ -176,6 +131,7 @@ const adapter = new ViemAdapter({
     chain: sepolia,
     transport: http('YOUR_RPC_URL')
   }),
+  // You also can set `walletClient` instead of `signer` using `useWalletClient` from wagmi
   signer: privateKeyToAccount('YOUR_PRIVATE_KEY' as `0x${string}`)
 })
 
@@ -224,6 +180,7 @@ const adapter = new ViemAdapter({
     chain: sepolia,
     transport: http('YOUR_RPC_URL')
   }),
+  // You also can set `walletClient` instead of `signer` using `useWalletClient` from wagmi
   signer: privateKeyToAccount('YOUR_PRIVATE_KEY' as `0x${string}`)
 })
 
@@ -281,6 +238,7 @@ const adapter = new ViemAdapter({
     chain: sepolia,
     transport: http('YOUR_RPC_URL')
   }),
+  // You also can set `walletClient` instead of `signer` using `useWalletClient` from wagmi
   signer: privateKeyToAccount('YOUR_PRIVATE_KEY' as `0x${string}`)
 })
 
@@ -334,6 +292,7 @@ const adapter = new ViemAdapter({
     chain: sepolia,
     transport: http('YOUR_RPC_URL')
   }),
+  // You also can set `walletClient` instead of `signer` using `useWalletClient` from wagmi
   signer: privateKeyToAccount('YOUR_PRIVATE_KEY' as `0x${string}`)
 })
 
@@ -693,3 +652,199 @@ console.log('Order created, id: ', orderId)
 #### Limit order
 
 Same as for the swap order but without the `quoteRequest` parameter.
+
+## Order Management
+
+The SDK provides methods to manage existing orders, including retrieving order details and canceling orders.
+
+### getOrder
+
+Fetches details about an existing order by its UID.
+
+**Parameters:**
+- `orderUid` - The unique identifier of the order
+- `chainId` - (Optional) Chain ID, uses trader params if not provided
+
+**Returns:** `Promise<EnrichedOrder>` - Full order details including status, amounts, and metadata
+
+#### Example
+
+```typescript
+import { TradingSdk } from '@cowprotocol/sdk-trading'
+
+const sdk = new TradingSdk({
+  chainId: SupportedChainId.MAINNET,
+  appCode: '<YOUR_APP_CODE>',
+}, {}, adapter)
+
+const orderUid = '0xd64389693b6cf89ad6c140a113b10df08073e5ef3063d05a02f3f42e1a42f0ad...'
+
+const order = await sdk.getOrder({ orderUid })
+
+console.log('Order status:', order.status)
+console.log('Sell amount:', order.sellAmount)
+console.log('Buy amount:', order.buyAmount)
+```
+
+### offChainCancelOrder
+
+Cancels an order off-chain by sending a signed cancellation request to the order book API. This is a "soft cancel" that is faster and doesn't require gas, but requires order book support.
+
+**Parameters:**
+- `orderUid` - The unique identifier of the order to cancel
+- `chainId` - (Optional) Chain ID, uses trader params if not provided
+- `signer` - (Optional) Custom signer, uses trader params signer if not provided
+
+**Returns:** `Promise<boolean>` - True if cancellation was successful
+
+#### Example
+
+```typescript
+import { TradingSdk } from '@cowprotocol/sdk-trading'
+
+const sdk = new TradingSdk({
+  chainId: SupportedChainId.MAINNET,
+  appCode: '<YOUR_APP_CODE>',
+}, {}, adapter)
+
+const orderUid = '0xd64389693b6cf89ad6c140a113b10df08073e5ef3063d05a02f3f42e1a42f0ad...'
+
+const success = await sdk.offChainCancelOrder({ orderUid })
+
+if (success) {
+  console.log('Order cancelled successfully (off-chain)')
+}
+```
+
+### onChainCancelOrder
+
+Cancels an order on-chain by sending a transaction to invalidate it. This is a "hard cancel" that requires gas but guarantees cancellation. Automatically detects whether to use the Settlement contract or EthFlow contract based on order type.
+
+**Parameters:**
+- `orderUid` - The unique identifier of the order to cancel
+- `chainId` - (Optional) Chain ID, uses trader params if not provided
+- `signer` - (Optional) Custom signer, uses trader params signer if not provided
+
+**Returns:** `Promise<string>` - Transaction hash of the cancellation
+
+#### Example
+
+```typescript
+import { TradingSdk } from '@cowprotocol/sdk-trading'
+
+const sdk = new TradingSdk({
+  chainId: SupportedChainId.MAINNET,
+  appCode: '<YOUR_APP_CODE>',
+}, {}, adapter)
+
+const orderUid = '0xd64389693b6cf89ad6c140a113b10df08073e5ef3063d05a02f3f42e1a42f0ad...'
+
+const txHash = await sdk.onChainCancelOrder({ orderUid })
+
+console.log('Cancellation transaction:', txHash)
+```
+
+## Token Approval
+
+Before trading ERC-20 tokens, you need to approve the CoW Protocol to spend them. The SDK provides methods to check and manage token approvals.
+
+### getCowProtocolAllowance
+
+Checks the current allowance for the CoW Protocol Vault Relayer to spend an ERC-20 token.
+
+**Parameters:**
+- `tokenAddress` - The ERC-20 token contract address
+- `owner` - The address of the token owner
+- `chainId` - (Optional) Chain ID, uses trader params if not provided
+
+**Returns:** `Promise<bigint>` - Current allowance amount
+
+#### Example
+
+```typescript
+import { TradingSdk } from '@cowprotocol/sdk-trading'
+
+const sdk = new TradingSdk({
+  chainId: SupportedChainId.MAINNET,
+  appCode: '<YOUR_APP_CODE>',
+}, {}, adapter)
+
+const tokenAddress = '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' // USDC
+const owner = '0x...' // Your wallet address
+
+const allowance = await sdk.getCowProtocolAllowance({
+  tokenAddress,
+  owner,
+})
+
+console.log('Current allowance:', allowance.toString())
+```
+
+### approveCowProtocol
+
+Approves the CoW Protocol Vault Relayer to spend a specified amount of an ERC-20 token. This creates an on-chain approval transaction.
+
+**Parameters:**
+- `tokenAddress` - The ERC-20 token contract address
+- `amount` - The amount to approve (as bigint)
+- `chainId` - (Optional) Chain ID, uses trader params if not provided
+- `signer` - (Optional) Custom signer, uses trader params signer if not provided
+
+**Returns:** `Promise<string>` - Transaction hash of the approval
+
+#### Example
+
+```typescript
+import { TradingSdk } from '@cowprotocol/sdk-trading'
+import { parseUnits } from 'viem' // or ethers
+
+const sdk = new TradingSdk({
+  chainId: SupportedChainId.MAINNET,
+  appCode: '<YOUR_APP_CODE>',
+}, {}, adapter)
+
+const tokenAddress = '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' // USDC
+const amount = parseUnits('1000', 6) // 1000 USDC (6 decimals)
+
+const txHash = await sdk.approveCowProtocol({
+  tokenAddress,
+  amount,
+})
+
+console.log('Approval transaction:', txHash)
+```
+
+#### Smart Approval Flow
+
+It's recommended to check the current allowance before approving to avoid unnecessary transactions:
+
+```typescript
+import { TradingSdk } from '@cowprotocol/sdk-trading'
+import { parseUnits } from 'viem'
+
+const sdk = new TradingSdk({
+  chainId: SupportedChainId.MAINNET,
+  appCode: '<YOUR_APP_CODE>',
+}, {}, adapter)
+
+const tokenAddress = '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' // USDC
+const owner = '0x...' // Your wallet address
+const requiredAmount = parseUnits('1000', 6) // 1000 USDC
+
+// Check current allowance
+const currentAllowance = await sdk.getCowProtocolAllowance({
+  tokenAddress,
+  owner,
+})
+
+// Only approve if needed
+if (currentAllowance < requiredAmount) {
+  const txHash = await sdk.approveCowProtocol({
+    tokenAddress,
+    amount: requiredAmount,
+  })
+  console.log('Approval transaction:', txHash)
+} else {
+  console.log('Sufficient allowance already exists')
+}
+```

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { cowAppDataLatestScheme, AppDataParams, LatestAppDataDocVersion } from '@cowprotocol/sdk-app-data';
-import { OrderKind, OrderParameters, TokenAmount, SigningScheme, OrderQuoteRequest, QuoteAmountsAndCosts, OrderQuoteResponse, AppData, AppDataHash, Signature, OrderBookApi } from '@cowprotocol/sdk-order-book';
+import { OrderKind, OrderParameters, TokenAmount, SigningScheme, OrderQuoteRequest, QuoteAmountsAndCosts, OrderQuoteResponse, AppData, AppDataHash, Signature, OrderBookApi, EnrichedOrder } from '@cowprotocol/sdk-order-book';
 import { AccountAddress, SignerLike, AbstractSigner, Signer, AbstractProviderAdapter, EthFlowContract } from '@cowprotocol/sdk-common';
 import { UnsignedOrder } from '@cowprotocol/sdk-order-signing';
 import { CowEnv, SupportedChainId } from '@cowprotocol/sdk-config';
@@ -69,6 +69,16 @@ interface TraderParameters {
 type QuoterParameters = Omit<TraderParameters, 'signer'> & {
     account: AccountAddress;
 };
+interface SlippageToleranceResponse {
+    slippageBps: number | null;
+}
+interface SlippageToleranceRequest {
+    chainId: SupportedChainId;
+    sellToken: OrderParameters['sellToken'];
+    buyToken: OrderParameters['buyToken'];
+    sellAmount?: bigint;
+    buyAmount?: bigint;
+}
 /**
  * Trade type, assets, amounts, and optional parameters.
  */
@@ -108,6 +118,10 @@ interface SwapAdvancedSettings {
     appData?: AppDataParams;
     additionalParams?: PostTradeAdditionalParams;
     quoteSigner?: SignerLike;
+    /**
+     * An optional callback to use custom logic for slippage suggestion
+     */
+    getSlippageSuggestion?(request: SlippageToleranceRequest): Promise<SlippageToleranceResponse>;
 }
 interface LimitOrderAdvancedSettings {
     appData?: AppDataParams;
@@ -234,14 +248,15 @@ 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, account: string, orderId: string): Promise<TradingTransactionParams>;
+declare function getPreSignTransaction(signer: Signer, chainId: SupportedChainId, orderId: string): Promise<TradingTransactionParams>;
 
 type WithPartialTraderParams<T> = T & Partial<TraderParameters>;
+type OrderTraderParams = WithPartialTraderParams<{
+    orderUid: string;
+}>;
 interface TradingSdkOptions {
     enableLogging: boolean;
     orderBookApi: OrderBookApi;
-    utmContent?: string;
-    disableUtm?: boolean;
 }
 declare class TradingSdk {
     traderParams: Partial<TraderParameters>;
@@ -275,10 +290,56 @@ declare class TradingSdk {
      * ```
      */
     postSellNativeCurrencyOrder(params: WithPartialTraderParams<TradeParameters>, advancedSettings?: SwapAdvancedSettings): Promise<ReturnType<typeof postSellNativeCurrencyOrder>>;
-    getPreSignTransaction(params: WithPartialTraderParams<{
-        orderId: string;
-        account: string;
-    }>): ReturnType<typeof getPreSignTransaction>;
+    getPreSignTransaction(params: OrderTraderParams): ReturnType<typeof getPreSignTransaction>;
+    getOrder(params: OrderTraderParams): Promise<EnrichedOrder>;
+    offChainCancelOrder(params: OrderTraderParams): Promise<boolean>;
+    onChainCancelOrder(params: OrderTraderParams, _order?: EnrichedOrder): Promise<string>;
+    /**
+     * Checks the current allowance for the CoW Protocol Vault Relayer to spend an ERC-20 token.
+     *
+     * @param params - Parameters including token address and owner address
+     * @returns Promise resolving to the current allowance amount as a bigint
+     *
+     * @example
+     * ```typescript
+     * const params = {
+     *   tokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
+     *   owner: '0x123...',
+     *   chainId: 1,
+     * }
+     *
+     * const allowance = await sdk.getCowProtocolAllowance(params)
+     * console.log('Current allowance:', allowance.toString())
+     * ```
+     */
+    getCowProtocolAllowance(params: WithPartialTraderParams<{
+        tokenAddress: string;
+        owner: string;
+    }>): Promise<bigint>;
+    /**
+     * Approves the CoW Protocol Vault Relayer to spend a specified amount of an ERC-20 token.
+     * This method creates an on-chain approval transaction.
+     *
+     * @param params - Parameters including token address and amount to approve
+     * @returns Promise resolving to the transaction hash of the approval transaction
+     *
+     * @example
+     * ```typescript
+     * const params = {
+     *   tokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
+     *   amount: '1000000000', // 1000 USDC (6 decimals)
+     *   chainId: 1,
+     * }
+     *
+     * const txHash = await sdk.approveCowProtocol(params)
+     * console.log('Approval transaction:', txHash)
+     * ```
+     */
+    approveCowProtocol(params: WithPartialTraderParams<{
+        tokenAddress: string;
+        amount: bigint;
+    }>): Promise<string>;
+    private resolveOrderBookApi;
     private mergeParams;
 }
 
@@ -335,4 +396,4 @@ declare function getTradeParametersAfterQuote({ quoteParameters, sellToken, }: {
     sellToken: string;
 }): TradeParameters;
 
-export { type AppDataRootSchema, type BuildAppDataParams, type EthFlowOrderExistsCallback, type LimitOrderAdvancedSettings, type LimitOrderParameters, type LimitTradeParameters, type LimitTradeParametersFromQuote, ORDER_PRIMARY_TYPE, type OrderPostingResult, type OrderTypedData, type PostTradeAdditionalParams, type QuoteAndPost, type QuoteResults, type QuoteResultsSerialized, type QuoteResultsWithSigner, type QuoterParameters, type SigningStepManager, type SwapAdvancedSettings, type SwapParameters, type TradeBaseParameters, type TradeOptionalParameters, type TradeParameters, type TraderParameters, type TradingAppDataInfo, TradingSdk, type TradingSdkOptions, type TradingTransactionParams, type WithPartialTraderParams, buildAppData, calculateUniqueOrderId, generateAppDataFromDoc, getEthFlowContract, getEthFlowTransaction, getOrderToSign, getPartnerFeeBps, getPreSignTransaction, getQuote, getQuoteWithSigner, getTradeParametersAfterQuote, mapQuoteAmountsAndCosts, mergeAppDataDoc, postCoWProtocolTrade, postLimitOrder, postSellNativeCurrencyOrder, postSwapOrder, postSwapOrderFromQuote, suggestSlippageBps, swapParamsToLimitOrderParams };
+export { type AppDataRootSchema, type BuildAppDataParams, type EthFlowOrderExistsCallback, type LimitOrderAdvancedSettings, type LimitOrderParameters, type LimitTradeParameters, type LimitTradeParametersFromQuote, ORDER_PRIMARY_TYPE, type OrderPostingResult, type OrderTraderParams, type OrderTypedData, type PostTradeAdditionalParams, type QuoteAndPost, type QuoteResults, type QuoteResultsSerialized, type QuoteResultsWithSigner, type QuoterParameters, type SigningStepManager, type SlippageToleranceRequest, type SlippageToleranceResponse, type SwapAdvancedSettings, type SwapParameters, type TradeBaseParameters, type TradeOptionalParameters, type TradeParameters, type TraderParameters, type TradingAppDataInfo, TradingSdk, type TradingSdkOptions, type TradingTransactionParams, type WithPartialTraderParams, buildAppData, calculateUniqueOrderId, generateAppDataFromDoc, getEthFlowContract, getEthFlowTransaction, getOrderToSign, getPartnerFeeBps, getPreSignTransaction, getQuote, getQuoteWithSigner, getTradeParametersAfterQuote, mapQuoteAmountsAndCosts, mergeAppDataDoc, postCoWProtocolTrade, postLimitOrder, postSellNativeCurrencyOrder, postSwapOrder, postSwapOrderFromQuote, suggestSlippageBps, swapParamsToLimitOrderParams };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { cowAppDataLatestScheme, AppDataParams, LatestAppDataDocVersion } from '@cowprotocol/sdk-app-data';
-import { OrderKind, OrderParameters, TokenAmount, SigningScheme, OrderQuoteRequest, QuoteAmountsAndCosts, OrderQuoteResponse, AppData, AppDataHash, Signature, OrderBookApi } from '@cowprotocol/sdk-order-book';
+import { OrderKind, OrderParameters, TokenAmount, SigningScheme, OrderQuoteRequest, QuoteAmountsAndCosts, OrderQuoteResponse, AppData, AppDataHash, Signature, OrderBookApi, EnrichedOrder } from '@cowprotocol/sdk-order-book';
 import { AccountAddress, SignerLike, AbstractSigner, Signer, AbstractProviderAdapter, EthFlowContract } from '@cowprotocol/sdk-common';
 import { UnsignedOrder } from '@cowprotocol/sdk-order-signing';
 import { CowEnv, SupportedChainId } from '@cowprotocol/sdk-config';
@@ -69,6 +69,16 @@ interface TraderParameters {
 type QuoterParameters = Omit<TraderParameters, 'signer'> & {
     account: AccountAddress;
 };
+interface SlippageToleranceResponse {
+    slippageBps: number | null;
+}
+interface SlippageToleranceRequest {
+    chainId: SupportedChainId;
+    sellToken: OrderParameters['sellToken'];
+    buyToken: OrderParameters['buyToken'];
+    sellAmount?: bigint;
+    buyAmount?: bigint;
+}
 /**
  * Trade type, assets, amounts, and optional parameters.
  */
@@ -108,6 +118,10 @@ interface SwapAdvancedSettings {
     appData?: AppDataParams;
     additionalParams?: PostTradeAdditionalParams;
     quoteSigner?: SignerLike;
+    /**
+     * An optional callback to use custom logic for slippage suggestion
+     */
+    getSlippageSuggestion?(request: SlippageToleranceRequest): Promise<SlippageToleranceResponse>;
 }
 interface LimitOrderAdvancedSettings {
     appData?: AppDataParams;
@@ -234,14 +248,15 @@ 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, account: string, orderId: string): Promise<TradingTransactionParams>;
+declare function getPreSignTransaction(signer: Signer, chainId: SupportedChainId, orderId: string): Promise<TradingTransactionParams>;
 
 type WithPartialTraderParams<T> = T & Partial<TraderParameters>;
+type OrderTraderParams = WithPartialTraderParams<{
+    orderUid: string;
+}>;
 interface TradingSdkOptions {
     enableLogging: boolean;
     orderBookApi: OrderBookApi;
-    utmContent?: string;
-    disableUtm?: boolean;
 }
 declare class TradingSdk {
     traderParams: Partial<TraderParameters>;
@@ -275,10 +290,56 @@ declare class TradingSdk {
      * ```
      */
     postSellNativeCurrencyOrder(params: WithPartialTraderParams<TradeParameters>, advancedSettings?: SwapAdvancedSettings): Promise<ReturnType<typeof postSellNativeCurrencyOrder>>;
-    getPreSignTransaction(params: WithPartialTraderParams<{
-        orderId: string;
-        account: string;
-    }>): ReturnType<typeof getPreSignTransaction>;
+    getPreSignTransaction(params: OrderTraderParams): ReturnType<typeof getPreSignTransaction>;
+    getOrder(params: OrderTraderParams): Promise<EnrichedOrder>;
+    offChainCancelOrder(params: OrderTraderParams): Promise<boolean>;
+    onChainCancelOrder(params: OrderTraderParams, _order?: EnrichedOrder): Promise<string>;
+    /**
+     * Checks the current allowance for the CoW Protocol Vault Relayer to spend an ERC-20 token.
+     *
+     * @param params - Parameters including token address and owner address
+     * @returns Promise resolving to the current allowance amount as a bigint
+     *
+     * @example
+     * ```typescript
+     * const params = {
+     *   tokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
+     *   owner: '0x123...',
+     *   chainId: 1,
+     * }
+     *
+     * const allowance = await sdk.getCowProtocolAllowance(params)
+     * console.log('Current allowance:', allowance.toString())
+     * ```
+     */
+    getCowProtocolAllowance(params: WithPartialTraderParams<{
+        tokenAddress: string;
+        owner: string;
+    }>): Promise<bigint>;
+    /**
+     * Approves the CoW Protocol Vault Relayer to spend a specified amount of an ERC-20 token.
+     * This method creates an on-chain approval transaction.
+     *
+     * @param params - Parameters including token address and amount to approve
+     * @returns Promise resolving to the transaction hash of the approval transaction
+     *
+     * @example
+     * ```typescript
+     * const params = {
+     *   tokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
+     *   amount: '1000000000', // 1000 USDC (6 decimals)
+     *   chainId: 1,
+     * }
+     *
+     * const txHash = await sdk.approveCowProtocol(params)
+     * console.log('Approval transaction:', txHash)
+     * ```
+     */
+    approveCowProtocol(params: WithPartialTraderParams<{
+        tokenAddress: string;
+        amount: bigint;
+    }>): Promise<string>;
+    private resolveOrderBookApi;
     private mergeParams;
 }
 
@@ -335,4 +396,4 @@ declare function getTradeParametersAfterQuote({ quoteParameters, sellToken, }: {
     sellToken: string;
 }): TradeParameters;
 
-export { type AppDataRootSchema, type BuildAppDataParams, type EthFlowOrderExistsCallback, type LimitOrderAdvancedSettings, type LimitOrderParameters, type LimitTradeParameters, type LimitTradeParametersFromQuote, ORDER_PRIMARY_TYPE, type OrderPostingResult, type OrderTypedData, type PostTradeAdditionalParams, type QuoteAndPost, type QuoteResults, type QuoteResultsSerialized, type QuoteResultsWithSigner, type QuoterParameters, type SigningStepManager, type SwapAdvancedSettings, type SwapParameters, type TradeBaseParameters, type TradeOptionalParameters, type TradeParameters, type TraderParameters, type TradingAppDataInfo, TradingSdk, type TradingSdkOptions, type TradingTransactionParams, type WithPartialTraderParams, buildAppData, calculateUniqueOrderId, generateAppDataFromDoc, getEthFlowContract, getEthFlowTransaction, getOrderToSign, getPartnerFeeBps, getPreSignTransaction, getQuote, getQuoteWithSigner, getTradeParametersAfterQuote, mapQuoteAmountsAndCosts, mergeAppDataDoc, postCoWProtocolTrade, postLimitOrder, postSellNativeCurrencyOrder, postSwapOrder, postSwapOrderFromQuote, suggestSlippageBps, swapParamsToLimitOrderParams };
+export { type AppDataRootSchema, type BuildAppDataParams, type EthFlowOrderExistsCallback, type LimitOrderAdvancedSettings, type LimitOrderParameters, type LimitTradeParameters, type LimitTradeParametersFromQuote, ORDER_PRIMARY_TYPE, type OrderPostingResult, type OrderTraderParams, type OrderTypedData, type PostTradeAdditionalParams, type QuoteAndPost, type QuoteResults, type QuoteResultsSerialized, type QuoteResultsWithSigner, type QuoterParameters, type SigningStepManager, type SlippageToleranceRequest, type SlippageToleranceResponse, type SwapAdvancedSettings, type SwapParameters, type TradeBaseParameters, type TradeOptionalParameters, type TradeParameters, type TraderParameters, type TradingAppDataInfo, TradingSdk, type TradingSdkOptions, type TradingTransactionParams, type WithPartialTraderParams, buildAppData, calculateUniqueOrderId, generateAppDataFromDoc, getEthFlowContract, getEthFlowTransaction, getOrderToSign, getPartnerFeeBps, getPreSignTransaction, getQuote, getQuoteWithSigner, getTradeParametersAfterQuote, mapQuoteAmountsAndCosts, mergeAppDataDoc, postCoWProtocolTrade, postLimitOrder, postSellNativeCurrencyOrder, postSwapOrder, postSwapOrderFromQuote, suggestSlippageBps, swapParamsToLimitOrderParams };