@cowprotocol/cow-sdk 7.0.5-beta.0 → 7.0.5

package/README.md

@@ -2,269 +2,265 @@
   <img width="400" src="https://github.com/cowprotocol/cow-sdk/raw/main/docs/images/CoW.png" />
 </p>
 
-# CoW SDK - Umbrella Package
+# CoW SDK
 
-The **CoW SDK Umbrella Package** is the comprehensive entry point for developers who want to access all CoW Protocol functionalities in a single, unified package. This is the recommended way to interact with CoW Protocol as it provides seamless integration across all SDK modules.
+## 📚 [Docs website](https://docs.cow.fi/)
 
-## 🎯 **Why Use the Umbrella Package?**
+## Test coverage
 
-- **All-in-One Solution** - Single installation gives you access to all CoW Protocol features
-- **Unified API** - Access all modules through one `CowSdk` instance or import them individually
-- **Simplified Setup** - Adapter configuration is handled once and shared across all modules
-- **Future-Proof** - Automatically includes new features and modules as they're added
+| Statements                                                                                 | Branches                                                                       | Functions                                                                                | Lines                                                                            |
+| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| ![Statements](https://img.shields.io/badge/statements-94.77%25-brightgreen.svg?style=flat) | ![Branches](https://img.shields.io/badge/branches-76.78%25-red.svg?style=flat) | ![Functions](https://img.shields.io/badge/functions-97.43%25-brightgreen.svg?style=flat) | ![Lines](https://img.shields.io/badge/lines-97.67%25-brightgreen.svg?style=flat) |
 
-## 📚 **Documentation Hub**
 
-This package serves as the **main entry point** for all CoW Protocol SDK documentation. Each individual package has its own detailed documentation, but everything starts here.
+## 🌐 **Supported Networks**
 
-### 📂 **SDK Structure**
+The SDK supports all CoW Protocol enabled networks:
 
-```
-├── @cowprotocol/cow-sdk (Umbrella - All packages included) 🏠
-│
-├── Provider Adapters
-│   ├── @cowprotocol/sdk-ethers-v5-adapter
-│   ├── @cowprotocol/sdk-ethers-v6-adapter
-│   └── @cowprotocol/sdk-viem-adapter
-│
-├── Core Utilities
-│   ├── @cowprotocol/sdk-common
-│   ├── @cowprotocol/sdk-config
-│   └── @cowprotocol/sdk-contracts-ts
-│
-├── Protocol Components
-│   ├── @cowprotocol/sdk-order-signing
-│   ├── @cowprotocol/sdk-order-book
-│   ├── @cowprotocol/sdk-app-data
-│   ├── @cowprotocol/sdk-trading
-│   ├── @cowprotocol/sdk-composable
-│   ├── @cowprotocol/sdk-cow-shed
-│   ├── @cowprotocol/sdk-subgraph
-│   └── @cowprotocol/sdk-bridging
-│
-└── Additional Packages
-    └── @cowprotocol/app-data
-```
+- **Ethereum** (1) - `SupportedChainId.MAINNET`
+- **Gnosis Chain** (100) - `SupportedChainId.GNOSIS_CHAIN`
+- **Arbitrum One** (42161) - `SupportedChainId.ARBITRUM_ONE`
+- **Base** (8453) - `SupportedChainId.BASE`
+- **Polygon** (137) - `SupportedChainId.POLYGON`
+- **Avalanche** (43114) - `SupportedChainId.AVALANCHE`
+- **Lens** (232) - `SupportedChainId.LENS`
+- **BNB** (56) - `SupportedChainId.BNB`
+- **Sepolia** (11155111) - `SupportedChainId.SEPOLIA` (Testnet)
+
+## 🔗 **Related Resources**
+
+- **[CoW Protocol Documentation](https://docs.cow.fi/)**
+- **[API Reference](https://api.cow.fi/docs/)**
+- **[CoW Protocol Website](https://cow.fi/)**
+- **[Examples Repository](https://github.com/cowprotocol/cow-sdk/tree/main/examples)**
+- **Issues**: [GitHub Issues](https://github.com/cowprotocol/cow-sdk/issues)
+- **Discord**: [CoW Protocol Discord](https://discord.com/invite/cowprotocol)
+- **Documentation**: [docs.cow.fi](https://docs.cow.fi/)
+
+## Getting Started
+
+### Usage Examples
+
+**React Examples:**
+- [React (viem)](https://github.com/cowprotocol/cow-sdk/tree/main/examples/react/viem)
+- [React (wagmi)](https://github.com/cowprotocol/cow-sdk/tree/main/examples/react/wagmi)
+- [React (ethers v6)](https://github.com/cowprotocol/cow-sdk/tree/main/examples/react/ethers6)
+- [React (ethers v5)](https://github.com/cowprotocol/cow-sdk/tree/main/examples/react/ethers5)
 
-## 🚀 **Getting Started**
+**Node.js Examples:**
+- [Node.js (viem)](https://github.com/cowprotocol/cow-sdk/blob/main/examples/nodejs/viem/src/index.ts)
+- [Node.js (ethers v6)](https://github.com/cowprotocol/cow-sdk/blob/main/examples/nodejs/ethers6/src/index.ts)
+- [Node.js (ethers v5)](https://github.com/cowprotocol/cow-sdk/blob/main/examples/nodejs/ethers5/src/index.ts)
 
 ### Installation
 
 ```bash
-npm install @cowprotocol/cow-sdk
-# or
 pnpm add @cowprotocol/cow-sdk
-# or
-yarn add @cowprotocol/cow-sdk
 ```
 
-You'll also need one of the adapter packages:
-
 ```bash
-# Choose one based on your Web3 library preference
-npm install @cowprotocol/sdk-ethers-v6-adapter
-npm install @cowprotocol/sdk-ethers-v5-adapter
-npm install @cowprotocol/sdk-viem-adapter
+yarn add @cowprotocol/cow-sdk
 ```
 
-## 💡 **Usage Patterns**
+## CoW SDK
 
-The umbrella package offers three flexible usage patterns:
+Using CoW Protocol, you can perform swaps, limit orders, TWAP orders, and many other operations.
+The `@cowprotocol/cow-sdk` provides tools at different abstraction levels, allowing you to conveniently implement basic scenarios while maintaining the flexibility to control all possible cases.
 
-### 1. **Unified CowSdk Instance** (Recommended)
+> In most cases, you will only need to use the **[Trading SDK](https://github.com/cowprotocol/cow-sdk/tree/main/packages/trading/README.md)**
 
-Access all modules through a single SDK instance:
+## SDK Components
 
-```typescript
-import {
-  CowSdk,
-  TradingSdk,
-  OrderBookApi,
-  OrderSigningUtils,
-  setGlobalAdapter,
-  SupportedChainId
-} from '@cowprotocol/cow-sdk'
-import { ViemAdapter } from '@cowprotocol/sdk-viem-adapter'
-import { createPublicClient, http, privateKeyToAccount } from 'viem'
-import { sepolia } from 'viem/chains'
+### Core
+- **[`TradingSdk`](https://github.com/cowprotocol/cow-sdk/tree/main/packages/trading/README.md)** - Main tool for swap and limit orders with built-in quote fetching, order signing, and posting
+- **[`OrderSigningUtils`](https://github.com/cowprotocol/cow-sdk/tree/main/packages/order-signing/README.md)** - Utilities for signing orders and cancellations using cryptographic algorithms
+- **[`OrderBookApi`](https://github.com/cowprotocol/cow-sdk/tree/main/packages/order-book/README.md)** - Provides the ability to retrieve orders and trades from the CoW Protocol order book, as well as add and cancel them
+- **[`MetadataApi`](https://github.com/cowprotocol/cow-sdk/tree/main/packages/app-data/README.md)** - API for accessing order metadata and additional information
 
-// Create and configure adapter
-// There are EthersV5Adapter and EthersV6Adapter as well
-// @cowprotocol/sdk-ethers-v5-adapter, @cowprotocol/sdk-ethers-v6-adapter
-const adapter = new ViemAdapter({
-  provider: createPublicClient({
-    chain: sepolia,
-    transport: http('YOUR_RPC_URL')
-  }),
-  signer: privateKeyToAccount('YOUR_PRIVATE_KEY' as `0x${string}`)
-})
+### Advanced
+- **[`BridgingSdk`](https://github.com/cowprotocol/cow-sdk/tree/main/packages/bridging/README.md)** - Cross-chain token transfers and bridging functionality
+- **[`ConditionalOrder`](https://github.com/cowprotocol/cow-sdk/tree/main/packages/composable/README.md)** - SDK for Programmatic Orders such as TWAP ([Read more](https://docs.cow.fi/cow-protocol/concepts/order-types/programmatic-orders))
+- **[`CowShedSdk`](https://github.com/cowprotocol/cow-sdk/tree/main/packages/cow-shed/README.md)** - Account abstraction that leverages EOA with smart contract capabilities
 
-// Initialize the unified SDK
-const sdk = new CowSdk({
-  chainId: SupportedChainId.SEPOLIA,
-  adapter,
-  tradingOptions: {
-    traderParams: {
-      appCode: 'YOUR_APP_CODE',
-      ...
-    },
-    ...
-  },
-})
+## v6 → v7 Migration Guide
+The versions are 99% backward compatible. The only difference is that in v7 you need to set an adapter corresponding to the library you use: `Viem`, `Ethers6`, or `Ethers5`.
 
-// Use all modules seamlessly
-const orderId = await sdk.trading.postSwapOrder(parameters)
-const orders = await sdk.orderBook.getOrders({ owner: address })
-const totals = await sdk.subgraph?.getTotals()
-const signature = await sdk.orderSigning.signOrder(order, chainId, signer)
-```
+**Before (v6):**
+```typescript
+import { SupportedChainId, TradingSdk, MetadataApi, OrderBookApi } from '@cowprotocol/cow-sdk'
 
-### 2. **Direct Module Import** (Simplified)
+const options = {}
 
-Import modules directly from the umbrella package without the unified instance:
+const sdk = new TradingSdk({
+  chainId: SupportedChainId.SEPOLIA,
+  appCode: 'YOUR_APP_CODE',
+}, options)
+```
 
+**After (v7):**
 ```typescript
-import { TradingSdk, OrderBookApi, SupportedChainId, OrderKind, TradeParameters } from '@cowprotocol/cow-sdk'
+import { SupportedChainId, OrderKind, TradeParameters, TradingSdk } from '@cowprotocol/cow-sdk'
 import { ViemAdapter } from '@cowprotocol/sdk-viem-adapter'
 import { createPublicClient, http, privateKeyToAccount } from 'viem'
 import { sepolia } from 'viem/chains'
 
-// Create and configure adapter
-// There are EthersV5Adapter and EthersV6Adapter as well
-// @cowprotocol/sdk-ethers-v5-adapter, @cowprotocol/sdk-ethers-v6-adapter
+// NEW: Instantiate and set adapter
 const adapter = new ViemAdapter({
   provider: createPublicClient({
     chain: sepolia,
     transport: http('YOUR_RPC_URL')
   }),
+  // You can also set `walletClient` instead of `signer` using `useWalletClient` from wagmi
   signer: privateKeyToAccount('YOUR_PRIVATE_KEY' as `0x${string}`)
 })
 
-// Use modules individually - adapter configuration is handled automatically
-const trading = new TradingSdk({ appCode: 'YOUR_APP_CODE' }, { chainId: SupportedChainId.SEPOLIA }, adapter)
+const options = {}
+
+const sdk = new TradingSdk({
+  chainId: SupportedChainId.SEPOLIA,
+  appCode: 'YOUR_APP_CODE',
+}, options, adapter)
+```
+
+Most other packages (e.g., `MetadataApi` or `BridgingSdk`) have a parameter to set an adapter.
+You can also set an adapter using `setGlobalAdapter`:
+
+```typescript
+import { setGlobalAdapter, CowShedSdk } from '@cowprotocol/cow-sdk'
+
+const adapter = {...}
 
-const orderBook = new OrderBookApi({ chainId: SupportedChainId.SEPOLIA })
+// Set global adapter
+setGlobalAdapter(adapter)
 
-// All modules work together seamlessly
-const orderId = await trading.postSwapOrder(parameters)
-const orders = await orderBook.getOrders({ owner: address })
+const cowShedSdk = new CowShedSdk()
 ```
 
-### 3. **Global Adapter Configuration**
+You will likely also need to bind the SDK to your app's account state.
+When the account or network changes in the app/wallet, it should be updated in the SDK as well.
+Here's an example for `WAGMI` (see `examples/react/wagmi`):
+
+```typescript
+import { useAccount, usePublicClient, useWalletClient } from 'wagmi'
+import { useEffect, useState } from 'react'
+import { ViemAdapter, ViemAdapterOptions } from '@cowprotocol/sdk-viem-adapter'
+import { tradingSdk } from '../cowSdk.ts'
+import { setGlobalAdapter } from '@cowprotocol/cow-sdk'
+
+export function useBindCoWSdkToWagmi(): boolean {
+  const { chainId } = useAccount()
+  const { data: walletClient } = useWalletClient()
+  const publicClient = usePublicClient()
+
+  const [isSdkReady, setIsSdkReady] = useState(false)
+
+  /**
+   * Sync Trading SDK with wagmi account state (chainId and signer)
+   */
+  useEffect(() => {
+    if (!walletClient || !chainId) return
+
+    setGlobalAdapter(
+      new ViemAdapter({
+        provider: publicClient,
+        walletClient,
+      } as unknown as ViemAdapterOptions),
+    )
+
+    tradingSdk.setTraderParams({ chainId })
+
+    setIsSdkReady(true)
+  }, [publicClient, walletClient, chainId])
+
+  return isSdkReady
+}
+
+```
 
-Set up the adapter once and use modules without explicit adapter passing:
+## Basic Use Case
+This example demonstrates the main use case of creating a swap and shows how to:
+- Get a quote
+- Verify amounts
+- Adjust swap parameters
+- Sign and post an order
 
 ```typescript
-import { TradingSdk, OrderBookApi, OrderSigningUtils, setGlobalAdapter, SupportedChainId } from '@cowprotocol/cow-sdk'
+import { SupportedChainId, OrderKind, TradeParameters, TradingSdk } from '@cowprotocol/cow-sdk'
 import { ViemAdapter } from '@cowprotocol/sdk-viem-adapter'
 import { createPublicClient, http, privateKeyToAccount } from 'viem'
 import { sepolia } from 'viem/chains'
 
-// Create and configure adapter
-// There are EthersV5Adapter and EthersV6Adapter as well
+// EthersV5Adapter and EthersV6Adapter are also available
 // @cowprotocol/sdk-ethers-v5-adapter, @cowprotocol/sdk-ethers-v6-adapter
 const adapter = new ViemAdapter({
   provider: createPublicClient({
     chain: sepolia,
     transport: http('YOUR_RPC_URL')
   }),
+  // You can also set `walletClient` instead of `signer` using `useWalletClient` from wagmi
   signer: privateKeyToAccount('YOUR_PRIVATE_KEY' as `0x${string}`)
 })
 
-setGlobalAdapter(adapter)
-
-// Now use modules without passing adapter each time
-const trading = new TradingSdk({ appCode: 'YOUR_APP_CODE' }, { chainId: SupportedChainId.SEPOLIA })
-
-const orderBook = new OrderBookApi({ chainId: SupportedChainId.SEPOLIA })
-
-// Use OrderSigningUtils directly - no need to instantiate
-// const orderSigning = OrderSigningUtils  // or simply use OrderSigningUtils.signOrder(...)
-```
-
-## 🧩 **Available Modules**
-
-All modules are accessible through the umbrella package:
-
-> **📖 Documentation**: All links below point to the official documentation at [docs.cow.fi](https://docs.cow.fi). For source code, visit the [GitHub repository](https://github.com/cowprotocol/cow-sdk).
-
-### **Trading**
-
-```typescript
-import { TradingSdk } from '@cowprotocol/cow-sdk'
-```
-
-Create and manage orders, get quotes, handle swaps and limit orders.
-[📖 Trading Documentation](https://docs.cow.fi/cow-protocol/reference/sdks/protocol-components/sdk-trading)
-
-### **Order Book**
-
-```typescript
-import { OrderBookApi } from '@cowprotocol/cow-sdk'
-```
-
-Interact with CoW Protocol's order book API for order management.
-[📖 Order Book Documentation](https://docs.cow.fi/cow-protocol/reference/sdks/protocol-components/sdk-order-book)
-
-### **Order Signing**
+const sdk = new TradingSdk({
+  chainId: SupportedChainId.SEPOLIA,
+  appCode: 'YOUR_APP_CODE',
+}, {}, adapter)
+
+const parameters: TradeParameters = {
+  kind: OrderKind.SELL,
+  sellToken: '0xfff9976782d46cc05630d1f6ebab18b2324d6b14',
+  sellTokenDecimals: 18,
+  buyToken: '0x0625afb445c3b6b7b929342a04a22599fd5dbb59',
+  buyTokenDecimals: 18,
+  amount: '120000000000000',
+}
 
-```typescript
-import { OrderSigningUtils } from '@cowprotocol/cow-sdk'
-```
+// Get quote
+const { quoteResults, postSwapOrderFromQuote } = await sdk.getQuote(parameters)
 
-Handle EIP-712 order signing and cancellations.
-[📖 Order Signing Documentation](https://docs.cow.fi/cow-protocol/reference/sdks/protocol-components/sdk-order-signing)
+const buyAmount = quoteResults.amountsAndCosts.afterSlippage.buyAmount
 
-### **App Data**
+// Verify amount
+if (confirm(`You will receive at least: ${buyAmount}. Proceed?`)) {
+  // Sign and post order
+  const orderId = await postSwapOrderFromQuote()
 
-```typescript
-import { MetadataApi } from '@cowprotocol/cow-sdk'
+  console.log('Order created, ID:', orderId)
+}
 ```
 
-Manage order metadata and application-specific data.
-[📖 App Data Documentation](https://docs.cow.fi/cow-protocol/reference/sdks/app-data)
+This example demonstrates the simplest way to trade on CoW Protocol.
 
-### **Subgraph**
+For more advanced use cases, you can use additional parameters such as `receiver`, `partiallyFillable`, `validTo`, and others.
+Refer to the [Trading SDK documentation](https://github.com/cowprotocol/cow-sdk/tree/main/packages/trading/README.md) for comprehensive details.
 
-```typescript
-import { SubgraphApi } from '@cowprotocol/cow-sdk'
-```
 
-Access CoW Protocol analytics and historical data.
-[📖 Subgraph Documentation](https://docs.cow.fi/cow-protocol/reference/sdks/protocol-components/sdk-subgraph)
+## Adapters
 
-### **Contracts**
-
-```typescript
-import { ContractsTs } from '@cowprotocol/cow-sdk'
-```
+The CoW SDK supports multiple blockchain adapters to work with different Web3 libraries. You need to install and configure one of the following adapters:
 
-TypeScript contract interfaces for CoW Protocol smart contracts.
-[📖 Contracts Documentation](https://docs.cow.fi/cow-protocol/reference/sdks/core-utilities/sdk-contracts-ts)
+### Available Adapters
 
-### **Composable CoW**
+- **EthersV6Adapter** - For ethers.js v6
+- **EthersV5Adapter** - For ethers.js v5
+- **ViemAdapter** - For viem
 
-```typescript
-import { ConditionalOrderFactory, Multiplexer } from '@cowprotocol/cow-sdk'
-```
+### Installation
 
-Advanced conditional and programmable orders.
-[📖 Composable Documentation](https://docs.cow.fi/cow-protocol/reference/sdks/protocol-components/sdk-composable)
+```bash
+# For ethers v6
+pnpm add @cowprotocol/sdk-ethers-v6-adapter ethers
 
-### **CoW Shed**
+# For ethers v5
+pnpm add @cowprotocol/sdk-ethers-v5-adapter ethers@^5.7.0
 
-```typescript
-import { CowShedSdk } from '@cowprotocol/cow-sdk'
+# For viem
+pnpm add @cowprotocol/sdk-viem-adapter viem
 ```
 
-Batch transaction and intent management utilities.
-[📖 CoW Shed Documentation](https://docs.cow.fi/cow-protocol/reference/sdks/protocol-components/sdk-cow-shed)
-
-## ⚙️ **Adapter Support**
-
-The umbrella package works with all supported blockchain adapters:
+### Adapter Setup Examples
 
-### **Ethers v6**
+#### EthersV6Adapter
 
 ```typescript
 import { EthersV6Adapter } from '@cowprotocol/sdk-ethers-v6-adapter'
@@ -275,7 +271,7 @@ const wallet = new Wallet('YOUR_PRIVATE_KEY', provider)
 const adapter = new EthersV6Adapter({ provider, signer: wallet })
 ```
 
-### **Ethers v5**
+#### EthersV5Adapter
 
 ```typescript
 import { EthersV5Adapter } from '@cowprotocol/sdk-ethers-v5-adapter'
@@ -286,87 +282,75 @@ const wallet = new ethers.Wallet('YOUR_PRIVATE_KEY', provider)
 const adapter = new EthersV5Adapter({ provider, signer: wallet })
 ```
 
-### **Viem**
+#### ViemAdapter
 
 ```typescript
 import { ViemAdapter } from '@cowprotocol/sdk-viem-adapter'
-import { http, createWalletClient, privateKeyToAccount } from 'viem'
+import { http, createPublicClient, privateKeyToAccount } from 'viem'
 import { sepolia } from 'viem/chains'
 
 const account = privateKeyToAccount('YOUR_PRIVATE_KEY' as `0x${string}`)
 const transport = http('YOUR_RPC_URL')
-const adapter = new ViemAdapter({ chain: sepolia, transport, account })
+const provider = createPublicClient({ chain: sepolia, transport })
+
+// You can also set `walletClient` instead of `signer` using `useWalletClient` from wagmi
+const adapter = new ViemAdapter({ provider, signer: account })
 ```
 
-## 🌐 **Supported Networks**
+## Low-Level SDK Usage Example
 
-The SDK supports all CoW Protocol enabled networks:
+This example demonstrates low-level API usage with a practical scenario:
+exchanging `0.4 GNO` for `WETH` on the Gnosis Chain network.
 
-- **Ethereum** (1) - `SupportedChainId.MAINNET`
-- **Gnosis Chain** (100) - `SupportedChainId.GNOSIS_CHAIN`
-- **Arbitrum One** (42161) - `SupportedChainId.ARBITRUM_ONE`
-- **Base** (8453) - `SupportedChainId.BASE`
-- **Polygon** (137) - `SupportedChainId.POLYGON`
-- **Avalanche** (43114) - `SupportedChainId.AVALANCHE`
-- **Sepolia** (11155111) - `SupportedChainId.SEPOLIA` (Testnet)
+We will perform the following operations:
 
-## 📝 **Quick Example: Complete Trading Flow**
+1. Get a quote
+2. Sign the order
+3. Send the order to the order book
+4. Get the data of the created order
+5. Get trades for the order
+6. Cancel the order (signing + sending)
 
 ```typescript
-import { CowSdk, SupportedChainId, OrderKind, TradeParameters } from '@cowprotocol/cow-sdk'
+import { OrderBookApi, OrderSigningUtils, SupportedChainId, OrderKind } from '@cowprotocol/cow-sdk'
 import { EthersV6Adapter } from '@cowprotocol/sdk-ethers-v6-adapter'
 import { JsonRpcProvider, Wallet } from 'ethers'
 
-async function main() {
-  // Setup
-  const provider = new JsonRpcProvider('YOUR_RPC_URL')
-  const wallet = new Wallet('YOUR_PRIVATE_KEY', provider)
-  const adapter = new EthersV6Adapter({ provider, signer: wallet })
-
-  const sdk = new CowSdk({
-    chainId: SupportedChainId.SEPOLIA,
-    adapter,
-    tradingOptions: {
-      traderParams: { appCode: 'MY_APP' },
-    },
-  })
+const account = 'YOUR_WALLET_ADDRESS'
+const chainId = 100 // Gnosis Chain
+const provider = new JsonRpcProvider('YOUR_RPC_URL')
+const wallet = new Wallet('YOUR_PRIVATE_KEY', provider)
+const adapter = new EthersV6Adapter({ provider, signer: wallet })
 
-  // Define trade
-  const tradeParams: TradeParameters = {
-    kind: OrderKind.SELL,
-    sellToken: '0xfff9976782d46cc05630d1f6ebab18b2324d6b14', // WETH
-    sellTokenDecimals: 18,
-    buyToken: '0x0625afb445c3b6b7b929342a04a22599fd5dbb59', // GNO
-    buyTokenDecimals: 18,
-    amount: '100000000000000000', // 0.1 WETH
-  }
-
-  // Execute trade
-  const orderId = await sdk.trading.postSwapOrder(tradeParams)
-  console.log('Order created:', orderId)
-
-  // Monitor order
-  const order = await sdk.orderBook.getOrder(orderId)
-  console.log('Order status:', order.status)
-
-  // Get historical data
-  const stats = await sdk.subgraph?.getTotals()
-  console.log('Protocol stats:', stats)
+const quoteRequest = {
+  sellToken: '0x6a023ccd1ff6f2045c3309768ead9e68f978f6e1', // WETH on Gnosis Chain
+  buyToken: '0x9c58bacc331c9aa871afd802db6379a98e80cedb', // GNO on Gnosis Chain
+  from: account,
+  receiver: account,
+  sellAmountBeforeFee: (0.4 * 10 ** 18).toString(), // 0.4 WETH
+  kind: OrderKind.SELL,
 }
 
-main().catch(console.error)
-```
+const orderBookApi = new OrderBookApi({ chainId: SupportedChainId.GNOSIS_CHAIN })
 
-## 🔗 **Related Resources**
+async function main() {
+  const { quote } = await orderBookApi.getQuote(quoteRequest)
 
-- **[CoW Protocol Documentation](https://docs.cow.fi/)**
-- **[API Reference](https://api.cow.fi/docs/)**
-- **[CoW Protocol Website](https://cow.fi/)**
-- **[Examples Repository](https://github.com/cowprotocol/cow-sdk/tree/main/examples)**
-- **Issues**: [GitHub Issues](https://github.com/cowprotocol/cow-sdk/issues)
-- **Discord**: [CoW Protocol Discord](https://discord.com/invite/cowprotocol)
-- **Documentation**: [docs.cow.fi](https://docs.cow.fi/)
+  const orderSigningResult = await OrderSigningUtils.signOrder(quote, chainId, adapter)
+
+  const orderId = await orderBookApi.sendOrder({ ...quote, ...orderSigningResult })
+
+  const order = await orderBookApi.getOrder(orderId)
+
+  const trades = await orderBookApi.getTrades({ orderId })
 
----
+  const orderCancellationSigningResult = await OrderSigningUtils.signOrderCancellations([orderId], chainId, adapter)
 
-> **💡 Tip**: Start with the umbrella package and the unified `CowSdk` instance for the best developer experience. You can always optimize later by using individual modules if needed.
+  const cancellationResult = await orderBookApi.sendSignedOrderCancellations({
+    ...orderCancellationSigningResult,
+    orderUids: [orderId],
+  })
+
+  console.log('Results:', { orderId, order, trades, orderCancellationSigningResult, cancellationResult })
+}
+```