Update solvers.md

[pretf00d]

Changed language per Odran's instructions.

Description

Changes

• ...
• ...

Summary by CodeRabbit

• Documentation
  • Updated Solvers introduction clarifying their role as independent, bonded participants competing for settlement solutions.
  • Refined solver selection criteria and compensation mechanisms based on batch surplus optimization.
  • Enhanced explanation of token movement and settlement process.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview	Jun 1, 2026 3:25pm

[coderabbitai]

📝 Walkthrough

Walkthrough

Documentation rewrite of the Solvers introduction clarifies that solvers are independent bonded participants competing to generate the greatest surplus for user intents. The "How Solvers Work" section explains ERC-20 approval delegation through the vault relayer and settlement contract verification, with emphasis that solvers do not receive direct token approvals.

Changes

Solvers Documentation Clarification

Layer / File(s)	Summary
Solvers overview and operational mechanics docs/cow-protocol/concepts/introduction/solvers.md	Solvers overview redefined as independent bonded participants selected by greatest surplus generation, with updated compensation framing around COW-token rewards. "How Solvers Work" section rephrased to emphasize vault relayer approval delegation and settlement contract verification, clarifying that transfers flow through protocol contracts rather than directly to solvers.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 A settlement solver's tale,
With bonds and surplus they set sail,
Through vault relayers, approvals flow,
With COW rewards to help them grow! 🪙✨

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (1 warning, 1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The pull request description is largely incomplete, with only a vague reference to 'Odran's instructions' and empty template placeholders; no detailed explanation of changes or context is provided.	Fill in the Description section explaining why the language changes were needed, and add a detailed Changes list documenting the specific modifications made to the documentation.
Title check	❓ Inconclusive	The title is vague and overly generic, using a non-descriptive term that does not convey meaningful information about the specific changes made to the solvers documentation.	Revise the title to be more specific about the changes, such as 'Clarify solver role and compensation in solvers.md' or 'Reword solver participation and settlement reward descriptions'.

✅ Passed checks (3 passed)

Check name	Status	Explanation
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.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch pretf00d-patch-5

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

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/concepts/introduction/solvers.md`:
- Line 11: The intro paragraph contains a duplicated dangling fragment "`through
an`" that leaves the sentence incomplete; remove the trailing fragment and
either end the previous sentence after "users" or complete it to a single
coherent clause (e.g., "Solvers are bonded third parties that execute trades on
behalf of users through an off-chain relayer.") Update the sentence in
docs/cow-protocol/concepts/introduction/solvers.md to remove the broken fragment
and ensure the paragraph reads as one complete statement.

🪄 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: 7863c15e-fbd0-43f0-b7ce-10e3562c44cd

📥 Commits

Reviewing files that changed from the base of the PR and between 978e255 and 1af36e3.

📒 Files selected for processing (1)

• docs/cow-protocol/concepts/introduction/solvers.md

[coderabbitai]

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Fix incomplete duplicated sentence in intro paragraph.

Line 11 ends with a dangling fragment (...through an) after already defining solvers in the previous sentence. This currently reads as a broken sentence in published docs.

✍️ Proposed edit

-Solvers are independent, bonded participants that compete to construct valid settlement solutions for user-signed intents through CoW Protocol’s [intent-based delegated execution model](intents). Solvers are bonded third parties that execute trades on behalf of users through an  
+Solvers are independent, bonded participants that compete to construct valid settlement solutions for user-signed intents through CoW Protocol’s [intent-based delegated execution model](intents).

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	Solvers are independent, bonded participants that compete to construct valid settlement solutions for user-signed intents through CoW Protocol’s [intent-based delegated execution model](intents). Solvers are bonded third parties that execute trades on behalf of users through an
	Solvers are independent, bonded participants that compete to construct valid settlement solutions for user-signed intents through CoW Protocol's [intent-based delegated execution model](intents).

🤖 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/concepts/introduction/solvers.md` at line 11, The intro
paragraph contains a duplicated dangling fragment "`through an`" that leaves the
sentence incomplete; remove the trailing fragment and either end the previous
sentence after "users" or complete it to a single coherent clause (e.g.,
"Solvers are bonded third parties that execute trades on behalf of users through
an off-chain relayer.") Update the sentence in
docs/cow-protocol/concepts/introduction/solvers.md to remove the broken fragment
and ensure the paragraph reads as one complete statement.