From cf86731d043a1978655de80ca46be4941d2000f3 Mon Sep 17 00:00:00 2001 From: Diego Date: Fri, 13 Nov 2026 14:33:30 +0100 Subject: [PATCH 1/3] Document zero fee for correlated assets --- docs/cow-protocol/reference/core/auctions/schema.md | 2 +- docs/governance/fees/fees.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/cow-protocol/reference/core/auctions/schema.md b/docs/cow-protocol/reference/core/auctions/schema.md index 3d14cc29b..16ccbafbb 100644 --- a/docs/cow-protocol/reference/core/auctions/schema.md +++ b/docs/cow-protocol/reference/core/auctions/schema.md @@ -119,7 +119,7 @@ An example Fill-or-Kill user limit buy order that sells 1000 [COW](https://ether } ``` -The above entry should be interpreted as follows. It is a Fill-or-Kill order since the flag `partiallyFillable` is set to `false`. Moreover, it is a sell order since its `kind` is set to `sell`. Finally, this is a `limit` order, meaning that it has a zero-signed fee, which implies that the solver is free to choose an appropriate fee to cover its execution cost. This means that, if executed, the user will send a total of 1000000000000000000000 COW atoms to the settlement contract, and the user has signed for a minimum of 284138335 USDC atoms (`fullBuyAmount`). The order also carries a 2 bps volume fee, which the driver will deduct from the buy side once the trade settles. Since the order has not been partially filled, `sellAmount` still equals `fullSellAmount`, but `buyAmount` is scaled up from `fullBuyAmount` to net out that fee: `buyAmount` = `fullBuyAmount` / (1 - 0.0002) = 284138335 / 0.9998 ≈ 284195174.03, rounded down to 284195174. Solvers can then route on `sellAmount`/`buyAmount` while ignoring fees entirely, and once the driver charges its 2 bps cut of the 284195174 USDC bought (≈56839 USDC atoms), the user is left with exactly the signed minimum of 284138335 USDC atoms — so the original limit is never violated. This is the usual case in practice: on most chains essentially every order carries some volume-based protocol or partner fee, so `buyAmount`/`sellAmount` differ from `fullBuyAmount`/`fullSellAmount` even without any partial fill; the two only coincide when there is no such fee, which is rare. +The above entry should be interpreted as follows. It is a Fill-or-Kill order since the flag `partiallyFillable` is set to `false`. Moreover, it is a sell order since its `kind` is set to `sell`. Finally, this is a `limit` order, meaning that it has a zero-signed fee, which implies that the solver is free to choose an appropriate fee to cover its execution cost. This means that, if executed, the user will send a total of 1000000000000000000000 COW atoms to the settlement contract, and the user has signed for a minimum of 284138335 USDC atoms (`fullBuyAmount`). The order also carries a 2 bps volume fee, which the driver will deduct from the buy side once the trade settles. Since the order has not been partially filled, `sellAmount` still equals `fullSellAmount`, but `buyAmount` is scaled up from `fullBuyAmount` to net out that fee: `buyAmount` = `fullBuyAmount` / (1 - 0.0002) = 284138335 / 0.9998 ≈ 284195174.03, rounded down to 284195174. Solvers can then route on `sellAmount`/`buyAmount` while ignoring fees entirely, and once the driver charges its 2 bps cut of the 284195174 USDC bought (≈56839 USDC atoms), the user is left with exactly the signed minimum of 284138335 USDC atoms — so the original limit is never violated. This is the usual case in practice: on most chains, orders between uncorrelated tokens carry a volume-based protocol fee and many orders carry a partner fee, so `buyAmount`/`sellAmount` differ from `fullBuyAmount`/`fullSellAmount` even without any partial fill; the two only coincide when there is no such fee, e.g. for an order between correlated tokens (which are not charged a protocol volume fee) without a partner fee. ### `deadline` diff --git a/docs/governance/fees/fees.md b/docs/governance/fees/fees.md index 8ef1aae2f..4e6bb156a 100644 --- a/docs/governance/fees/fees.md +++ b/docs/governance/fees/fees.md @@ -34,15 +34,15 @@ The purpose of this page is to let users know which fee models are active at any > **Definition:** A tiered fee based on the total volume of the order, adjusted by asset type > -> **Eligible orders:** all orders +> **Eligible orders:** all orders, except orders between correlated assets (e.g. stablecoin to stablecoin), which are currently not charged a volume fee > > **Fee structure:** > - **Standard Assets:** 2 basis points (bps) -> - **Correlated Assets (Stables/RWAs):** 0.3 basis points (bps) -> +> - **Correlated Assets (Stables/RWAs):** 0 basis points (bps) +> > **Fee calculation:** > - **Standard**: Volume * 0.0002 -> - **Correlated:** Volume * 0.00003 +> - **Correlated:** no fee :::note From 7b9d8e4060169e8cf642495ffbf04831c06f9141 Mon Sep 17 00:00:00 2001 From: Diego Date: Fri, 13 Nov 2026 17:26:50 +0100 Subject: [PATCH 2/3] Clarification on volume fee description as recommended by legal --- docs/governance/fees/fees.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/governance/fees/fees.md b/docs/governance/fees/fees.md index 4e6bb156a..d9f9f734c 100644 --- a/docs/governance/fees/fees.md +++ b/docs/governance/fees/fees.md @@ -30,7 +30,7 @@ The purpose of this page is to let users know which fee models are active at any > > **Fee calculation:** quote improvement \* 0.5 **OR** volume \* 0.0098 [whichever number is lower] -### Volume Fee +### Protocol volume Fee > **Definition:** A tiered fee based on the total volume of the order, adjusted by asset type > @@ -42,7 +42,7 @@ The purpose of this page is to let users know which fee models are active at any > > **Fee calculation:** > - **Standard**: Volume * 0.0002 -> - **Correlated:** no fee +> - **Correlated:** no protocol volume fee :::note From bd3105492a81df5712598139611239ef3b185094 Mon Sep 17 00:00:00 2001 From: Diego Date: Fri, 13 Nov 2026 17:30:16 +0100 Subject: [PATCH 3/3] Fix capitalization --- docs/governance/fees/fees.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/governance/fees/fees.md b/docs/governance/fees/fees.md index d9f9f734c..21591e6f2 100644 --- a/docs/governance/fees/fees.md +++ b/docs/governance/fees/fees.md @@ -30,7 +30,7 @@ The purpose of this page is to let users know which fee models are active at any > > **Fee calculation:** quote improvement \* 0.5 **OR** volume \* 0.0098 [whichever number is lower] -### Protocol volume Fee +### Protocol volume fee > **Definition:** A tiered fee based on the total volume of the order, adjusted by asset type >