bleu · mintlify · Apr 1, 2026
diff --git a/cow-sdk/advanced/cross-chain-bridging.mdx b/cow-sdk/advanced/cross-chain-bridging.mdx
@@ -1,11 +1,11 @@
 ---
 title: "Cross-Chain Bridging"
 description: "Enable seamless token transfers across different blockchain networks using the CoW Protocol SDK"
 ---

 # Cross-Chain Bridging

 The CoW Protocol SDK provides seamless cross-chain token transfers through integration with multiple bridge providers. This enables you to swap tokens across different blockchain networks in a single transaction.

 ## Installation

@@ -17,6 +17,10 @@
 
 ### Initialize the BridgingSdk
 
+<Warning>
+The `CowSdk` class shown in the "With CoW SDK" tab below has been removed in v8. Use [`TradingSdk`](/cow-sdk/api/trading-sdk) or the standalone `BridgingSdk` instead. See the [quickstart guide](/cow-sdk/quickstart) for updated usage patterns.
+</Warning>
+
 <CodeGroup>
   ```typescript Standalone
   import {
@@ -339,7 +343,7 @@

 <CardGroup cols={2}>
  <Card title="Programmatic Orders" icon="code" href="/cow-sdk/advanced/programmatic-orders">
    Learn about conditional and composable orders
  </Card>

  <Card title="Hooks" icon="webhook" href="/cow-sdk/advanced/hooks">

diff --git a/cow-sdk/advanced/hooks.mdx b/cow-sdk/advanced/hooks.mdx
@@ -14,7 +14,7 @@
 - **Execute pre-order logic**: Approve tokens, wrap/unwrap assets, or setup flash loans
 - **Execute post-order logic**: Stake tokens, compound yields, or trigger other contracts
 - **Chain complex operations**: Combine multiple DeFi protocols in a single transaction
 - **Integrate with dApps**: Enable seamless integration with other protocols

 ## Hook Structure

@@ -80,6 +80,10 @@
 
 ### Using TradingSdk with Hooks
 
+<Warning>
+The `CowSdk` class shown below has been removed in v8. Use [`TradingSdk`](/cow-sdk/api/trading-sdk) instead. See the [quickstart guide](/cow-sdk/quickstart) for updated usage patterns.
+</Warning>
+
 ```typescript
 import { CowSdk } from '@cowprotocol/cow-sdk'
 import { encodeFunctionData } from 'viem'
@@ -245,7 +249,11 @@
 
 ## Complete Example
 
+<Warning>
+The `CowSdk` class shown below has been removed in v8. Use [`TradingSdk`](/cow-sdk/api/trading-sdk) instead. See the [quickstart guide](/cow-sdk/quickstart) for updated usage patterns.
+</Warning>
+
 Here's a complete example with pre and post hooks:
 
 ```typescript
 import { CowSdk, OrderKind } from '@cowprotocol/cow-sdk'
@@ -353,7 +361,7 @@

 <AccordionGroup>
  <Accordion title="Test hooks thoroughly">
    Always test your hooks on testnets before production:

    ```typescript
    // Test on Sepolia first
@@ -554,7 +562,7 @@
  </Card>

  <Card title="Hook Store" icon="store" href="/cow-swap/hooks/hook-store">
    Browse pre-built hooks or publish your own hook dApp
  </Card>

  <Card title="Hooks: Getting Started" icon="play" href="/cow-swap/hooks/getting-started">
@@ -562,7 +570,7 @@
  </Card>

  <Card title="Hook dApp Development" icon="code" href="/cow-swap/hooks/hook-dapp">
    Build custom hook dApps for the CoW Swap interface
  </Card>

  <Card title="Partner Fee" icon="coins" href="/cow-sdk/advanced/partner-fee">

diff --git a/cow-sdk/advanced/partner-fee.mdx b/cow-sdk/advanced/partner-fee.mdx
@@ -18,7 +18,7 @@

 ## Fee Types

 ### Volume-Based Fee (volumeBps)

 A fixed percentage of the order's sell or buy amount:

@@ -33,7 +33,7 @@
  Volume-based fees are capped at 100 BPS (1%) at the protocol level.
 </Info>

 ### Surplus-Based Fee (surplusBps)

 A percentage of the order's surplus (the difference between limit price and execution price):

@@ -59,6 +59,10 @@
 
 ## Configuration
 
+<Warning>
+The `CowSdk` class shown in examples below has been removed in v8. Use [`TradingSdk`](/cow-sdk/api/trading-sdk) instead. See the [quickstart guide](/cow-sdk/quickstart) for updated usage patterns.
+</Warning>
+
 ### Single Fee Structure
 
 ```typescript
@@ -73,7 +77,7 @@
  buyToken: '0xAnotherTokenAddress',
  sellAmount: '1000000000000000000',
  partnerFee: {
    volumeBps: 50, // 0.5%
    recipient: '0xPartnerAddress',
  },
 })
@@ -87,7 +91,7 @@
 const partnerFee = [
  // Primary: Take 50% of surplus, capped at 1% volume
  {
    surplusBps: 5000,
    maxVolumeBps: 100,
    recipient: '0xPartnerAddress',
  },

diff --git a/cow-sdk/advanced/programmatic-orders.mdx b/cow-sdk/advanced/programmatic-orders.mdx
@@ -5,7 +5,7 @@

 # Programmatic Orders

 The CoW Protocol Composable SDK enables sophisticated trading strategies through programmatic orders that execute automatically when specified conditions are met. The `ComposableCoW` contract implements these orders, allowing you to build advanced trading logic without constant monitoring.

 ## Installation

@@ -28,7 +28,7 @@

 ### Multiplexer

 Manages batches of programmatic orders using merkle trees:

 ```typescript
 import { Multiplexer } from '@cowprotocol/sdk-composable'
@@ -103,6 +103,10 @@
 
 ### With CoW SDK
 
+<Warning>
+The `CowSdk` class shown below has been removed in v8. Use [`TradingSdk`](/cow-sdk/api/trading-sdk) instead. See the [quickstart guide](/cow-sdk/quickstart) for updated usage patterns.
+</Warning>
+
 ```typescript
 import {
   CowSdk,
@@ -190,9 +194,9 @@

 Each part sells 100 USDC for WETH once per day. See the [TWAP Orders guide](/cow-sdk/advanced/twap-orders) for full configuration options including price protection.

 ## Merkle Tree Management

 Programmatic orders are stored in merkle trees for efficient on-chain verification:

 ```typescript
 // Create multiplexer with multiple orders
@@ -368,7 +372,7 @@

 ### Store proofs off-chain

 Generate and store merkle proofs off-chain to enable watchtowers to execute your orders:

 ```typescript
 const proofs = multiplexer.dumpProofsAndParams()
@@ -389,4 +393,4 @@
 ## Next Steps

 - **TWAP Orders**: Learn about Time-Weighted Average Price orders
 - **Hooks**: Execute custom logic with pre and post hooks
diff --git a/cow-sdk/api/adapters/ethers-v5.mdx b/cow-sdk/api/adapters/ethers-v5.mdx
@@ -1,11 +1,11 @@
 ---
 title: "Ethers v5 Adapter"
 description: "Integration between the CoW Protocol SDK and ethers.js v5"
 ---

 # Ethers v5 Adapter

 The Ethers v5 Adapter provides integration with [ethers.js v5](https://docs.ethers.org/v5/), enabling you to use all CoW Protocol SDK packages with ethers providers and signers.

 ## Installation

@@ -28,11 +28,11 @@
 ### Parameters

 <ResponseField name="provider" type="Provider | string" required>
 An ethers v5 `Provider` instance or an RPC URL string. If a string is provided, a `JsonRpcProvider` will be created automatically.
 </ResponseField>

 <ResponseField name="signer" type="Signer | string">
 An ethers v5 `Signer` instance (e.g., `Wallet`) or a private key string.
 </ResponseField>

 ## Properties
@@ -45,9 +45,9 @@
 const signerAdapter = adapter.signer
 ```

 ### utils

 Utility methods for working with ethers v5 types and contracts.

 ```typescript
 const iface = adapter.utils.createInterface(abi)
@@ -77,7 +77,7 @@

 Returns: `Promise<number>`

 ### getCode

 Returns the bytecode at a given address.

@@ -130,9 +130,9 @@

 Returns: `Promise<string>`

 ### readContract

 Reads from a contract function using callStatic.

 ```typescript
 const result = await adapter.readContract({
@@ -151,7 +151,7 @@

 Returns: `Promise<unknown>`

 ### getBlock

 Returns block information for a given block tag.

@@ -164,7 +164,7 @@

 Returns: `Promise<Block>`

 ### getContract

 Creates a contract instance.

@@ -178,7 +178,7 @@

 Returns: `GenericContract`

 ### setSigner

 Sets or updates the signer for the adapter.

@@ -189,7 +189,7 @@

 - `signer` (`Signer | string`) - New signer or private key

 ### setProvider

 Sets or updates the provider for the adapter.

@@ -213,7 +213,7 @@

 Returns: `EthersV5SignerAdapter | null`

 ### createSigner

 Creates a new signer adapter from a Signer instance or private key.

@@ -252,6 +252,10 @@
 
 ### With CoW SDK
 
+<Warning>
+The `CowSdk` class shown below has been removed in v8. Use [`TradingSdk`](/cow-sdk/api/trading-sdk) instead. See the [quickstart guide](/cow-sdk/quickstart) for updated usage patterns.
+</Warning>
+
 ```typescript
 import { CowSdk, SupportedChainId } from '@cowprotocol/cow-sdk'
 import { EthersV5Adapter } from '@cowprotocol/sdk-ethers-v5-adapter'

diff --git a/cow-sdk/api/adapters/ethers-v6.mdx b/cow-sdk/api/adapters/ethers-v6.mdx
@@ -1,13 +1,13 @@
 ---
 title: "Ethers v6 Adapter"
 description: "Integration between the CoW Protocol SDK and ethers.js v6"
 ---

 # Ethers v6 Adapter

 ## Overview

 The Ethers v6 Adapter integrates the CoW Protocol SDK with ethers.js v6, enabling usage of all SDK packages with ethers v6 providers and signers.

 ## Installation

@@ -29,13 +29,13 @@
 ```

 **Constructor Parameters:**
 - `provider`: An ethers v6 Provider instance or RPC URL string (automatically creates JsonRpcProvider)
 - `signer`: Optional ethers v6 Signer instance or private key string

 ## Core Properties

 - **signer**: Returns the EthersV6SignerAdapter instance; throws error if unavailable
 - **utils**: Utility methods for working with ethers v6 types and contracts
 - **TypedDataVersionedSigner**: EIP-712 signer with version support
 - **TypedDataV3Signer**: EIP-712 version 3 legacy signer
 - **IntChainIdTypedDataV4Signer**: EIP-712 version 4 signer with MetaMask compatibility fixes
@@ -76,6 +76,10 @@
 
 ### Integration with CoW SDK
 
+<Warning>
+The `CowSdk` class shown below has been removed in v8. Use [`TradingSdk`](/cow-sdk/api/trading-sdk) instead. See the [quickstart guide](/cow-sdk/quickstart) for updated usage patterns.
+</Warning>
+
 ```typescript
 import { CowSdk, SupportedChainId } from '@cowprotocol/cow-sdk'
 import { EthersV6Adapter } from '@cowprotocol/sdk-ethers-v6-adapter'

diff --git a/cow-sdk/api/adapters/viem.mdx b/cow-sdk/api/adapters/viem.mdx
@@ -1,11 +1,11 @@
 ---
 title: "Viem Adapter"
 description: "Integration between the CoW Protocol SDK and the Viem library"
 ---

 # Viem Adapter

 The Viem Adapter provides integration with the [viem](https://viem.sh) library, enabling you to use all CoW Protocol SDK packages with viem clients and accounts.

 ## Installation

@@ -30,15 +30,15 @@
 ### Parameters

 <ResponseField name="provider" type="PublicClient" required>
 A viem `createPublicClient` instance
 </ResponseField>

 <ResponseField name="signer" type="Account | `0x${string}`">
 A viem account from `privateKeyToAccount` or similar
 </ResponseField>

 <ResponseField name="walletClient" type="WalletClient">
 A viem WalletClient, useful with wagmi's `useWalletClient` hook
 </ResponseField>

 ## Properties
@@ -51,9 +51,9 @@
 const signerAdapter = adapter.signer
 ```

 ### utils

 Utility methods for working with viem types and contracts.

 ```typescript
 const iface = adapter.utils.createInterface(abi)
@@ -83,7 +83,7 @@

 Returns: `Promise<number>`

 ### getCode

 Returns the bytecode at a given address.

@@ -136,7 +136,7 @@

 Returns: `Promise<string>`

 ### readContract

 Reads from a contract function.

@@ -157,7 +157,7 @@

 Returns: `Promise<unknown>`

 ### getBlock

 Returns block information for a given block tag.

@@ -170,7 +170,7 @@

 Returns: `Promise<Block>`

 ### getContract

 Creates a contract instance with a compatible interface.

@@ -184,7 +184,7 @@

 Returns: `GenericContract`

 ### setSigner

 Sets or updates the signer for the adapter.

@@ -195,7 +195,7 @@

 - `signer` (`Account | PrivateKey | WalletClient`) - New signer

 ### setProvider

 Sets or updates the provider for the adapter.

@@ -219,7 +219,7 @@

 Returns: `ViemSignerAdapter | null`

 ### createSigner

 Creates a new signer adapter from an account or private key.

@@ -233,7 +233,7 @@

 ## Usage Examples

 ### With Wagmi

 ```typescript
 import { useWalletClient, usePublicClient } from 'wagmi'
@@ -270,6 +270,10 @@
 
 ### With CoW SDK
 
+<Warning>
+The `CowSdk` class shown below has been removed in v8. Use [`TradingSdk`](/cow-sdk/api/trading-sdk) instead. See the [quickstart guide](/cow-sdk/quickstart) for updated usage patterns.
+</Warning>
+
 ```typescript
 import { CowSdk, SupportedChainId } from '@cowprotocol/cow-sdk'
 import { ViemAdapter } from '@cowprotocol/sdk-viem-adapter'

diff --git a/cow-sdk/installation.mdx b/cow-sdk/installation.mdx
@@ -7,7 +7,7 @@

 ## Quick Overview

 The CoW Protocol SDK enables blockchain interaction through three adapter options. Installation involves the main package plus your chosen adapter framework.

 ## Core Installation

@@ -21,13 +21,13 @@

 You must choose one of three adapters based on your Web3 library:

 **Viem** - Modern, lightweight TypeScript library requiring viem 1.x+

 **Ethers v6** - The current ethers.js version (recommended for ethers users)

 **Ethers v5** - Legacy version; consider upgrading to v6 or using Viem

 Each adapter installation differs slightly. For Viem, you'd run:

 ```bash
 npm install @cowprotocol/sdk-viem-adapter viem
@@ -35,14 +35,14 @@

 ## Essential Dependencies

 The SDK requires `cross-fetch` (^3.x). Optional packages include `ipfs-only-hash`, `multiformats`, and `@openzeppelin/merkle-tree` for specialized features like app-data metadata and merkle operations.
 
 ## Environment Requirements
 
-Node.js 16+ is mandatory. TypeScript support includes built-in type definitions with standard `tsconfig.json` settings (moduleResolution: "node", esModuleInterop: true).
+Node.js 22+ is mandatory. TypeScript support includes built-in type definitions with standard `tsconfig.json` settings (moduleResolution: "node", esModuleInterop: true).
 
 ## Framework Integration
 
 React/Next.js users typically integrate via wagmi, while Node.js backends use direct Viem initialization with environment variables for sensitive credentials.
 
-The current SDK version is **v7.4.1**, with migration guidance available for v6 upgrades.
+The current SDK version is **v8.0.4**, with migration guidance available for prior version upgrades.
diff --git a/cow-swap/hooks/hook-dapp.mdx b/cow-swap/hooks/hook-dapp.mdx
@@ -1,5 +1,5 @@
 ---
 title: "CoW Hook dApp"
 ---

 ### [What are CoW Hooks?](/cow-protocol/explanation/order-types/cow-hooks)
@@ -13,9 +13,9 @@
 | ![Demo](/images/cow-protocol/tutorials/img/tutorials/hooks-store.png) | ![Demo](/images/cow-protocol/tutorials/img/tutorials/hooks-store-list.png) |
 | --------------------------------------------------------------------- | -------------------------------------------------------------------------- |

 **Hook dApp** - is an application that allows you to conveniently program an order to perform any action before or after a swap.

 In the CoW Swap interface you can find several hooks for different tasks. For example, you can claim GNO from Gnosis validators before your swap. You can also specify an arbitrary call to a smart contract before or after your swap using the "Build your own hooks" dApp.

 But that's not all. You can also develop your own application that will install a hook in CoW Swap! For this purpose, there is a custom application based on [iframe](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe).

@@ -23,7 +23,7 @@

 * Click "add Pre/Post-Hook Action"
 * Go to "My Custom Hooks" tab
 * Paste a URL of the hook dApp

 ![Demo](/images/cow-protocol/tutorials/img/tutorials/hooks-store-custom-hooks.png)

@@ -31,9 +31,9 @@
  CoW Hooks are still under development! But you can test it by switching "Enable hooks" toggle ON in the Swap settings.
 </Note>

 ## How to develop CoW Hook dApps

 CoW Hook dApp is a web application that communicates with CoW Swap using [post-messages](https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage). For your convenience there is a npm library [`@cowprotocol/hook-dapp-lib`](https://www.npmjs.com/package/@cowprotocol/hook-dapp-lib) which provides everything necessary to get started with your hook dApp development.

 ### Install

@@ -48,7 +48,7 @@
 It provides:

 * [`EIP-1193`](https://eips.ethereum.org/EIPS/eip-1193) provider to interact with a user wallet
 * `HookDappContext` which contains environment parameters (chainId, account, etc.) and current order parameters (sell token, validTo, etc.)

 And it expects calling following callbacks:

@@ -58,7 +58,7 @@

 ### Quick start

 Let's create a simple hook dApp that checks the COW token balance of the order creator.

 ```html
 <html>
@@ -126,7 +126,7 @@
 // context: HookDappContext
 // actions: CoWHookDappActions
 // provider: EIP-1193
 const { actions, provider } = initCoWHookDapp({
  onContext(context: HookDappContext) {},
 })
 ```
@@ -137,7 +137,7 @@

 | Parameter         | Type                          | Optional | Description                                                                                                                                                                                                                                      |
 | ----------------- | ----------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `chainId`         | `number`                      | false    | Current chainId in CoW Swap.                                                                                                                                                                                                                     |
 | `account`         | `string`                      | true     | The user's account address. If not set, the wallet is not connected yet.                                                                                                                                                                         |
 | `orderParams`     | `HookDappOrderParams \| null` | false    | The parameters for the order. If value is `null`, the order is not ready yet. See [HookDappOrderParams](https://github.com/cowprotocol/cowswap/blob/develop/libs/hook-dapp-lib/src/types.ts#L29) for more details.                               |
 | `hookToEdit`      | `CowHookDetails`              | true     | CoW Swap supports editing hooks that have been created already. If the parameter is set, then it's in edit mode. See [CowHookDetails](https://github.com/cowprotocol/cowswap/blob/develop/libs/hook-dapp-lib/src/types.ts#L18) for more details. |
@@ -170,7 +170,7 @@
     "image": "http://your-cow-hook.dapp/logo.png",
     "conditions": {
       "position": "pre",
-      "smartContractWalletSupported": false,
+      "walletCompatibility": ["EOA"],
       "supportedNetworks": [1, 100, 42161]
     }
   }
@@ -179,18 +179,18 @@

 | Parameter                        | Type                            | Description                                                                                                                                                                                                            |
 | -------------------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `id`                             | `string`                        | 64-bit hex application identifier `(keccak256(YOUR_APP_NAME))`. This value is used to match hooks in an order with the dApp that generated the hook.                                                                   |
 | `name`                           | `string`                        | The name of the Hook Dapp.                                                                                                                                                                                             |
 | `descriptionShort`               | `string`                        | A short description.                                                                                                                                                                                                   |
 | `description`                    | `string`                        | A full, detailed description of the Hook Dapp.                                                                                                                                                                         |
 | `version`                        | `string`                        | The version number of the Hook Dapp, typically following semantic versioning.                                                                                                                                          |
 | `website`                        | `string` (URL)                  | The URL link to the Hook Dapp's official website.                                                                                                                                                                      |
 | `image`                          | `string` (URL)                  | The URL link to the Hook Dapp's logo or representative image.                                                                                                                                                          |
 | `conditions.position`            | `pre \| post`                   | Specifies the execution position of the hook, `pre` or `post`. If not set, then the Hook Dapp supports both positions.                                                                                                 |
 | `conditions.walletCompatibility` | `HookDappWalletCompatibility[]` | Indicates whether the Hook Dapp supports smart contract wallets or EOAs.                                                                                                                                               |
 | `conditions.supportedNetworks`   | `array` of `integers`           | List of supported network IDs (e.g., `1` for Ethereum mainnet, `100` for Gnosis chain, `42161` for Arbitrum, `8453` for Base). If not set, then the Hook Dapp will be available for any network supported by CoW Swap. |

 ## Advanced Hook Dapps

 For more complex scenarios — such as post-hooks that need to act on received tokens (staking, bridging, depositing into DeFi protocols) — you need **CoW Shed**. CoW Shed is a deterministic smart account that holds tokens on behalf of the user and executes pre-signed operations during settlement.


diff --git a/cow-swap/hooks/hook-store.mdx b/cow-swap/hooks/hook-store.mdx
@@ -3,7 +3,7 @@
 description: "Browse, use, and publish pre-built hooks in the CoW Swap Hook Store"
 ---

 The **Hook Store** is a feature in CoW Swap that lets you extend your swaps with pre-built hooks created by third parties. Instead of manually encoding callData, you can browse a catalog of hook dApps — each with its own UI — that generate the hook data for you.

 ## Using the Hook Store

@@ -13,55 +13,55 @@
 2. Navigate to the hook controls (pre-hook or post-hook section)
 3. Click **"Add Pre/Post-Hook Action"** to open the Hook Store

 You'll see a list of available hook dApps. Each dApp provides a focused UI for a specific action — for example, claiming validator rewards or building a custom hook.

 ### Available hook dApps

 The Hook Store ships with several built-in dApps:

 | Hook dApp | Description | Networks |
 |---|---|---|
 | **Build your own hooks** | Manually enter target, callData, and gasLimit for any contract call | All |
 | **Claim GNO from validators** | Claim unclaimed GNO rewards from Gnosis Chain validators as a pre-hook | Gnosis Chain |

 <Tip>
  The list of available hook dApps varies by network. Connect to a specific network to see which hooks are available there.
 </Tip>

 ### Custom hook dApps

 You can also load any hook dApp by URL:

 1. Click **"Add Pre/Post-Hook Action"**
 2. Go to the **"My Custom Hooks"** tab
 3. Paste the URL of the hook dApp

 The dApp loads in an iframe and communicates with CoW Swap via [post-messages](https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage). CoW Swap handles fee estimation (including hook gas costs) and includes the hook in your order automatically.

 ## How hook dApps work

 Each hook dApp is a lightweight web application that:

 1. **Receives context** from CoW Swap — connected wallet, chain ID, order parameters
 2. **Presents a UI** for the user to configure the hook (e.g., select a vault, choose an amount)
 3. **Generates hook data** (target, callData, gasLimit) and sends it back to CoW Swap via the `addHook` callback

 CoW Swap then:
 - Includes the hook gas cost in the fee estimation shown to the user
 - Attaches the hook to the order's [appData](/cow-protocol/reference/core/intents/app-data)
 - Ensures solvers execute the hook as part of the settlement

 ## Publishing a hook dApp

 To make your hook dApp available in the Hook Store:

 ### 1. Build the dApp

 Create a web application using the [`@cowprotocol/hook-dapp-lib`](https://www.npmjs.com/package/@cowprotocol/hook-dapp-lib) library. See the [Hook dApp development guide](/cow-swap/hooks/hook-dapp) for the full API reference and a working example.

 ### 2. Add a manifest

 Your dApp must serve a `manifest.json` file that describes its capabilities:

 ```json
 {
@@ -75,7 +75,7 @@
     "image": "https://my-hook-dapp.example.com/logo.png",
     "conditions": {
       "position": "pre",
-      "smartContractWalletSupported": false,
+      "walletCompatibility": ["EOA"],
       "supportedNetworks": [1, 100, 42161]
     }
   }

diff --git a/cow-swap/tutorials/twap.mdx b/cow-swap/tutorials/twap.mdx
@@ -11,7 +11,7 @@

 * **Reduce price impact on large orders**: For example, buying `$1M` of ETH over 3 hours in 6 parts; the TWAP will place an order of `$166k` every `30min`, significantly reducing the price impact and allowing the market to recover.
 * **Average buy price over time**: This strategy reduces the risk of buying at a high price by averaging the prices over a selected period.
 * **Ideal for recurring or big trades**: The minimum required order size is `$1k` on Mainnet or `$5` on Gnosis Chain, Arbitrum One and Base.

 ## Placing a TWAP Order

@@ -40,7 +40,7 @@
 
 1. **Price Protection**: This is a measure to prevent your order from being executed at a price that's too far from the market price when the order was placed. Set the percentage of price protection to define the acceptable price range for your trades. For instance, a 10% price protection means that your order will not execute if the price moves unfavorably by more than 10% from the price at the time the order was made.
 
-2. **Number of Parts**: Decide how many discrete parts you want to divide your order into. This choice will determine the granularity of your TWAP strategy. For example, if you choose to split your order into 2 parts and you are selling a total of 2 WETH, each part will involve selling 1 WETH. The parts have a minimum size of `$5k` on Mainnet or `$5` on Gnosis Chain because each part will need to be executed on-chain, meaning there's a cost associated with each execution.
+2. **Number of Parts**: Decide how many discrete parts you want to divide your order into. This choice will determine the granularity of your TWAP strategy. For example, if you choose to split your order into 2 parts and you are selling a total of 2 WETH, each part will involve selling 1 WETH. The parts have a minimum size of `$1,000` on Mainnet or `$1` on other supported chains because each part will need to be executed on-chain, meaning there's a cost associated with each execution.
 
 3. **Total Duration**: Choose the total time frame over which your order should be executed. The TWAP strategy will distribute your trades evenly across this duration. Select from predefined durations like 1 hour, or set a custom duration based on your trading strategy.
 
@@ -63,7 +63,7 @@
 Check all the details of your order, including price protection and limit price. Once you have reviewed the details, sign the transaction in your Safe interface.

 <Warning>
  A user should be careful when signing approval transactions. Verify carefully that the spender address is correct (in this case TWAPContract's address).

  If in doubt about any of the above, do *not* sign the transaction. To review your approvals, you can use [https://revoke.cash/](https://revoke.cash/).
 </Warning>

diff --git a/cow-swap/widget/params.mdx b/cow-swap/widget/params.mdx
@@ -3,7 +3,7 @@
 description: "Integrate the power of  into your product! With the widget, you can create an incredible trading interface. Specify the required pair of currencies, customize the look and much more!"
 ---

 Create your own widget using the configurator [https://widget.cow.fi](https://widget.cow.fi).

 ![Demo](/images/cow-protocol/tutorials/assets/images/widget-bc5358690765bdbc5b2bc9d2a13a20b5.png)

@@ -35,7 +35,7 @@
 import { createCowSwapWidget, CowSwapWidgetParams } from '@cowprotocol/widget-lib'const widgetContainer = document.getElementById('cowswap-widget')const params: CowSwapWidgetParams = {  partnerFee: {    bps: 50, // 0.5%    recipient: '0x0000000000000000000000000000000000000000', // Fee destination address  },}createCowSwapWidget(widgetContainer, { params })
 ```

 This configuration will apply a partner fee for all networks and trade types (swaps, limit orders, TWAPs, etc.). You can use [Flexible config](#flexible-config) for having more flexibility, or [Advanced configuration](#advanced-configuration) to have even more control over the partner fee configuration parameters.

 ### Flexible config

@@ -69,7 +69,7 @@

 The recipient is the address to which the fee will be sent.

 Make sure that the fee recipient address exists on the respective network defined in the parameters. For example, if you use a Safe as a recipient and the Safe was created on Ethereum mainnet, then for Gnosis Chain you must create **another** Safe and set it as a fee recipient.

 As a fee recipient, you can specify either string or a key-value pair in the format `chainId: recipientAddress`:

@@ -120,9 +120,9 @@
 | **Ranges**         | `min ≥ 0`, `max ≤ 5000` (50 %), `min ≤ defaultValue ≤ max`, `min < max`                                                                                                                         |
 | **Defaults**       | If the user doesn’t specify a slippage, the widget falls back to `defaultValue`                                                                                                                 |
 | **Auto slippage**  | If the auto-slippage is less than or equal to `defaultValue`, the swap will use `defaultValue`                                                                                                  |
 | **ETH‑Flow floor** | When `defaultValue < 200` bps (2 %) for Ethereum Mainnet or `defaultValue < 50` (0.5 %) for other networks and the trade is *ETH‑Flow*, the widget will force the slippage to **2 %**/**0.5 %** |

 ### Example JSON (Configurator ready)

 ```
 {  "slippage": {    "1": { "min": 1, "max": 3900, "defaultValue": 3000 },    "8453": { "min": 500, "max": 5000, "defaultValue": 600 }  }}
@@ -163,13 +163,12 @@
 | `provider`                            | `EthereumProvider`     | ---                     | The Ethereum provider to be used for interacting with a wallet. To connect, for example, to Rabby Wallet or Metamask, just set `window.ethereum`. You also might like to use [https://web3modal.com](https://web3modal.com).                                                                                                                                                                 |
 | `chainId`                             | `number`               | 1                       | The blockchain ID on which the trade will take place. Supported chains: 1 (Ethereum), 100 (Gnosis Chain), 42161 (Arbitrum One), 8453 (Base), 137 (Polygon), 43114 (Avalanche), 56 (BNB), 59144 (Linea), 9745 (Plasma), 57073 (Ink), 11155111 (Sepolia). See [supported networks](/snippets/supported-networks) for the full list.                                                   |
 | `tradeType`                           | `TradeType`            | 'swap'                  | The type of trade. Can be `swap` or `limit` or `advanced`.                                                                                                                                                                                                                                                                                                                                   |
-| `env`                                 | `CowSwapWidgetEnv`     | 'prod'                  | The environment of the widget (`local` , `prod` , `dev` , `pr`). See [`COWSWAP_URLS`](https://github.com/cowprotocol/cowswap/blob/develop/libs/widget-lib/src/consts.ts) const value for urls.                                                                                                                                                                                               |
+| `baseUrl`                             | `string`               | 'https://swap.cow.fi'   | The base URL of the widget implementation. Defaults to the production environment (`https://swap.cow.fi`).                                                                                                                                                                                                                                                                                   |
 | `sell`                                | `TradeAsset`           | Same as in swap.cow\.fi | An object containing information about the sell asset. Example: `{ asset: 'WBTC', amount: 12 }` or `{ asset: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48' }`.                                                                                                                                                                                                                                |
 | `buy`                                 | `TradeAsset`           | ---                     | An object containing information about the buy asset. Example: `{ asset: 'WBTC', amount: 12 }` or `{ asset: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48' }`.                                                                                                                                                                                                                                 |
 | `theme`                               | `CowSwapTheme`         | 'light'                 | The theme of the widget (`'dark'` for dark theme or `'light'` for light theme). It is also possible to set your own colors (`CowSwapWidgetPalette`). See [Custom theme](#custom-theme) section for more details.                                                                                                                                                                             |
 | `sounds`                              | `CowSwapWidgetSounds`  | ---                     | The famous MOOO! sound can be changed to something else, just provide a link to a media file (mp3 or any other audio format supported by your browser). You can also specify a value of `null` to disable the sound.                                                                                                                                                                         |
 | `images`                              | `CowSwapWidgetImages`  | ---                     | To make your widget unique, you can replace some of the images. For example, a stub image when there are no limit orders.                                                                                                                                                                                                                                                                    |
-| `banners`                             | `CowSwapWidgetBanners` | ---                     | With this option you can control the display of some banners in the CoW Swap interface.                                                                                                                                                                                                                                                                                                      |
 | `tokenLists`                          | `string[]`             | ---                     | CoW Swap uses the [token lists standard](https://tokenlists.org), which allows flexible and decentralized management of assets for trading. Using this option you can set any token list you want. You also might want to use `customTokens` option for more flexible configuration.                                                                                                         |
 | `customTokens`                        | `TokenInfo[]`          | ---                     | In the case when you want to use tokens that are not included in the default token lists, you can add them programmatically by simply passing an array of ERC-20 tokens info. There is also `tokenLists` option to set a ready-made list of tokens.                                                                                                                                          |
 | `disableToastMessages`                | `boolean`              | false                   | CoW Swap displays a pop-up notification when certain events occur, for example: an order has been filled. You may want to handle these events yourself and disable the display of notifications in the widget, to do this you need to enable this option. See [Events handling](#events-handling) section for more details.                                                                  |
@@ -250,7 +249,7 @@
 You can change all possible widget options on the fly:
 
 ```
-import { createCowSwapWidget, CowSwapWidgetParams } from '@cowprotocol/widget-lib'const container = document.getElementById('cowswap-widget')const params: CowSwapWidgetParams = {  appCode: 'NAME-OF-YOU-APP', // Add here the name of your app. e.g. "Pig Swap"  logoUrl: 'YOUR_LOGO_URL',}const updateWidget = createCowSwapWidget(container, { params })// Update the widgetupdateWidget({  ...params,  theme: 'dark', // <- Change theme to dark  hideNetworkSelector: true, // <- Hide the network selector})
+import { createCowSwapWidget, CowSwapWidgetParams } from '@cowprotocol/widget-lib'const container = document.getElementById('cowswap-widget')const params: CowSwapWidgetParams = {  appCode: 'NAME-OF-YOU-APP', // Add here the name of your app. e.g. "Pig Swap"}const updateWidget = createCowSwapWidget(container, { params })// Update the widgetupdateWidget({  ...params,  theme: 'dark', // <- Change theme to dark  hideNetworkSelector: true, // <- Hide the network selector})
 ```
 
 ## Widget URL
@@ -279,15 +278,5 @@
 
 ![Custom image](/images/cow-protocol/tutorials/assets/images/widget-custom-img-7dbd8236292401203767488f8583d4c9.png)
 
-### Banners
 
-In some cases, you may want to hide some banners in the CoW Swap interface. To do this, you need to specify the `banners` parameter in the widget configuration.
-
-```
-import { createCowSwapWidget, CowSwapWidgetParams } from '@cowprotocol/widget-lib'const container = document.getElementById('cowswap-widget')const params: CowSwapWidgetParams = { banners: { hideSafeWebAppBanner: true } }createCowSwapWidget(container, { params })
-```
-
-This banner will be hidden:
-
-![Hidden banner](/images/cow-protocol/tutorials/assets/images/widget-hidden-banner-9eecdcc1ebbcde86d089eef5d5d7c9e1.png)