Skip to content

remove CoW AMM Docs#643

Open
fleupold wants to merge 2 commits into
mainfrom
remove-cow-amm-docs
Open

remove CoW AMM Docs#643
fleupold wants to merge 2 commits into
mainfrom
remove-cow-amm-docs

Conversation

@fleupold

@fleupold fleupold commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

Description

Removes the CoW AMM section and all mentions of CoW AMM as it's being discontinued. The part in the mechanism description is replaced with the more abstract concept of surplus capturing JIT orders which may still be relevant in the future

Changes

  • Remove CoW AMM section
  • Remove all mentions of CoW AMM product line
  • Rewrite problem statement and other mechanism mentions with "surplus capturing hit orders"

Summary by CodeRabbit

  • Documentation
    • Updated documentation and site metadata to present CoW Protocol as CoW DAO’s primary product.
    • Removed CoW AMM overview, concept, tutorial, and onboarding content.
    • Replaced CoW AMM terminology in auction and solver documentation with surplus-capturing JIT liquidity terminology.
    • Updated AI documentation guidance to reference CoW Protocol and Governance.

@fleupold
fleupold requested a review from a team as a code owner July 14, 2026 08:08
@vercel

vercel Bot commented Jul 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Jul 14, 2026 8:22am

Request Review

@coderabbitai

coderabbitai Bot commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@fleupold, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 47 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f53ac497-1762-46ab-85ac-8e22f678c612

📥 Commits

Reviewing files that changed from the base of the PR and between 311958b and ed0d164.

📒 Files selected for processing (2)
  • docs/cow-protocol/reference/core/auctions/rewards.md
  • docs/cow-protocol/reference/core/auctions/schema.md
📝 Walkthrough

Walkthrough

CoW AMM documentation and navigation entries are removed, while product descriptions and references now focus on CoW Protocol. Auction documentation replaces CoW AMM order terminology with surplus-capturing JIT orders.

Changes

CoW AMM documentation retirement

Layer / File(s) Summary
CoW AMM documentation and navigation removal
docs/cow-amm/**, docs/cow-protocol/tutorials/cow-amm-deployer.mdx
Removes CoW AMM overview, concept, tutorial, category, and deployer documentation.
Documentation and site references
docs/README.md, docs/cow-protocol/tutorials/solvers/onboard.md, docs/llms.md, docusaurus.config.ts
Reframes CoW DAO documentation around CoW Protocol and removes CoW AMM references from onboarding, LLM guidance, and metadata.

Auction terminology

Layer / File(s) Summary
Surplus-capturing JIT order model
docs/cow-protocol/reference/core/auctions/the_problem.md, docs/cow-protocol/reference/core/auctions/schema.md
Defines surplus-capturing JIT orders, their pricing and validity, and updates the related schema description and scoring terminology.
Solver strategy guidance
docs/cow-protocol/reference/core/auctions/rewards.md
Updates batching guidance to reference surplus-capturing JIT liquidity instead of CoW AMM liquidity.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Suggested reviewers: alfetopito

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly matches the main change: removing CoW AMM documentation.
Description check ✅ Passed It includes the required Description and Changes sections and summarizes the removal and mechanism rewrite.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch remove-cow-amm-docs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/cow-protocol/reference/core/auctions/the_problem.md`:
- Line 69: Update the validity comparison in the paragraph following the
JIT-order discussion to avoid claiming that all sell and buy orders become
invalid after execution. Clarify that user orders may remain valid when unfilled
or partially filled, while JIT orders remain available as long as their
underlying liquidity source and authorization stay active.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 49ecadd6-3dcf-44e6-8376-dc532febca49

📥 Commits

Reviewing files that changed from the base of the PR and between 653b2ae and 311958b.

⛔ Files ignored due to path filters (2)
  • static/img/cowammdeployer/create-amm.png is excluded by !**/*.png
  • static/img/cowammdeployer/manager.png is excluded by !**/*.png
📒 Files selected for processing (16)
  • docs/README.md
  • docs/cow-amm/README.mdx
  • docs/cow-amm/_category_.json
  • docs/cow-amm/concepts/_category_.json
  • docs/cow-amm/concepts/how-cow-amms-work.md
  • docs/cow-amm/concepts/the-problem-of-lvr.md
  • docs/cow-amm/tutorials/_category_.json
  • docs/cow-amm/tutorials/cow-amm-deployer.md
  • docs/cow-amm/tutorials/cow-amm-for-solvers.md
  • docs/cow-protocol/reference/core/auctions/rewards.md
  • docs/cow-protocol/reference/core/auctions/schema.md
  • docs/cow-protocol/reference/core/auctions/the_problem.md
  • docs/cow-protocol/tutorials/cow-amm-deployer.mdx
  • docs/cow-protocol/tutorials/solvers/onboard.md
  • docs/llms.md
  • docusaurus.config.ts
💤 Files with no reviewable changes (10)
  • docs/cow-protocol/tutorials/cow-amm-deployer.mdx
  • docs/cow-amm/README.mdx
  • docs/cow-amm/tutorials/category.json
  • docs/cow-amm/concepts/category.json
  • docs/cow-amm/concepts/how-cow-amms-work.md
  • docs/cow-amm/concepts/the-problem-of-lvr.md
  • docs/cow-amm/tutorials/cow-amm-deployer.md
  • docs/cow-amm/category.json
  • docs/cow-amm/tutorials/cow-amm-for-solvers.md
  • docs/cow-protocol/tutorials/solvers/onboard.md

$$ \pi = X / (Y-y)$$

Finally, unlike sell and buy orders that are not valid anymore once executed, CoW AMM orders are always present. That is, as soon as a CoW AMM pool is created, a CoW AMM order for that pool is valid in all subsequent auctions.
Finally, unlike sell and buy orders that are no longer valid once executed, these JIT orders are always present. That is, as long as the underlying liquidity source exists, a corresponding order is valid in all subsequent auctions.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Correct the user-order validity comparison.

This contradicts Lines 44 and 60: unfilled fill-or-kill orders can remain valid, and partially fillable orders can persist across auctions. Clarify that JIT orders remain available while their source and authorization remain active, rather than implying all sell and buy orders become invalid after execution.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/cow-protocol/reference/core/auctions/the_problem.md` at line 69, Update
the validity comparison in the paragraph following the JIT-order discussion to
avoid claiming that all sell and buy orders become invalid after execution.
Clarify that user orders may remain valid when unfilled or partially filled,
while JIT orders remain available as long as their underlying liquidity source
and authorization stay active.

@linear-code

linear-code Bot commented Jul 15, 2026

Copy link
Copy Markdown

BE-99

MAR-1

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant