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	Jul 2, 2026 12:26pm

[coderabbitai]

Warning

Review limit reached

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

Next review available in: 56 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: 22c30fc2-649c-4403-96d0-4b1777cea9da

📥 Commits

Reviewing files that changed from the base of the PR and between 1af36e3 and 28ea9a8.

📒 Files selected for processing (1)

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

📝 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.}

[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