Skip to content

Conversation

@bram-vdberg
Copy link
Contributor

@bram-vdberg bram-vdberg commented Dec 3, 2025

Description

This PR updates the documentation reference to bonding pools to include all networks CoW Protocol is currently active on.

Changes

  • Add missing networks
  • Minor language changes

Summary by CodeRabbit

  • Documentation
    • Clarified bonding pool description and timeline — reduced pool size now progresses over the course of the following year.
    • Minor wording and grammar improvements for clarity (e.g., "yield-bearing", "vouched for").
    • Expanded canonical vouching contracts list to include Avalanche, Polygon, Lens, BNB, and Linea.

✏️ Tip: You can customize this high-level summary in your review settings.

@bram-vdberg bram-vdberg requested a review from fhenneke December 3, 2025 09:52
@bram-vdberg bram-vdberg requested a review from a team as a code owner December 3, 2025 09:52
@vercel
Copy link

vercel bot commented Dec 3, 2025

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

Project Deployment Preview Updated (UTC)
docs Ready Ready Preview Dec 11, 2025 6:36am

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Dec 3, 2025

Walkthrough

Documentation for bonding pools updated: clarified deposit phrasing, extended the reduced-bonding-pool size progression to "over the course of the following year," adjusted wording to "a solver with a reduced bonding pool," and added Vouching contracts entries for Avalanche, Polygon, Lens, BNB, and Linea.

Changes

Cohort / File(s) Summary
Documentation update
docs/cow-protocol/reference/core/auctions/bonding_pools.md
Replace "yield bearing" with "yield-bearing"; expand timeline wording to "over the course of the following year"; change "the solver" → "a solver with a reduced bonding pool"; add Vouching contracts: Avalanche, Polygon, Lens, BNB, Linea; correct Lens URL formatting.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

  • Simple documentation wording and list additions.
  • Attention points:
    • Verify Lens URL renders correctly.
    • Confirm "over the course of the following year" aligns with project style and terminology.

Poem

🐰 I hop through lines and tidy prose,

New chains listed where the footpath goes,
Timelines smoothed and commas neat,
Bonding pools now step by step, complete —
A cheerful nibble, docs feel sweet.

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately reflects the main change: updating documentation reference for bonding pools, which aligns with the substantive changes including network additions and language refinements.
Description check ✅ Passed The description follows the template with required sections (Description and Changes), clearly explaining the purpose and listing specific changes, though the changelog items use checkboxes without completion marks.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch Update-Bonding-Pools

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 6d0cdec and 6b7c1b9.

📒 Files selected for processing (1)
  • docs/cow-protocol/reference/core/auctions/bonding_pools.md (2 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/cow-protocol/reference/core/auctions/bonding_pools.md

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 and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between db62143 and d33d693.

📒 Files selected for processing (1)
  • docs/cow-protocol/reference/core/auctions/bonding_pools.md (2 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/cow-protocol/reference/core/auctions/bonding_pools.md

[grammar] ~13-~13: Use a hyphen to join words.
Context: ...lver needs to deposit $50,000 in (yield bearing) stable coins or ETH, and 500,00...

(QB_NEW_EN_HYPHEN)


[grammar] ~13-~13: Use a hyphen to join words.
Context: ... year all the way to $100,000 in (yield bearing) stable coins or ETH, and 1,000,...

(QB_NEW_EN_HYPHEN)

🔇 Additional comments (2)
docs/cow-protocol/reference/core/auctions/bonding_pools.md (2)

15-15: Grammar improvement is well-applied.

The change from "the solver with a reduced bonding pool" to "a solver with a reduced bonding pool" reads more naturally and is grammatically sound.


13-15: Documentation updates enhance clarity and network coverage.

The narrative clarification specifying that reduced bonding pools are built "over the course of the following year" provides better expectation setting. The expansion to five additional networks (Avalanche, Polygon, Lens, BNB, Linea) appropriately reflects CoW Protocol's expanded deployment footprint.

Also applies to: 25-29

Copy link
Contributor

@fhenneke fhenneke left a comment

Choose a reason for hiding this comment

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

LGTM

The AI comments make sense to me, so you can include their suggestions.

bram-vdberg and others added 2 commits December 3, 2025 11:52
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Assuming that the core team approves the creation of a reduced bonding pool, the first step for setting up a reduced bonding pool is to deploy a Gnosis safe on Mainnet that has only one signer (the CoW DAO Solver Payouts safe, that is, eth:0xA03be496e67Ec29bC62F01a428683D7F9c204930). After this is done and has been confirmed by the CoW DAO team, the solver needs to deposit \$50,000 in (yield-bearing) stable coins or ETH, and 500,000 COW tokens to the newly created safe, and gradually build the pool's size over the course of the following year all the way to \$100,000 in (yield-bearing) stable coins or ETH, and 1,000,000 COW tokens.

We stress that the reduced bonding pool setup is just an arrangement within the CoW DAO bonding pool; meaning that the solver with a reduced bonding pool is still formally vouched under the CoW DAO bonding pool.
We stress that the reduced bonding pool setup is just an arrangement within the CoW DAO bonding pool; meaning that a solver with a reduced bonding pool is still formally vouched under the CoW DAO bonding pool.
Copy link
Contributor

Choose a reason for hiding this comment

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

pool is still formally vouched --> pool is still formally vouched for

Copy link
Contributor

@pretf00d pretf00d left a comment

Choose a reason for hiding this comment

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

one small correction

@harisang harisang merged commit cf28cd4 into main Dec 11, 2025
6 checks passed
@harisang harisang deleted the Update-Bonding-Pools branch December 11, 2025 08:41
@github-actions github-actions bot locked and limited conversation to collaborators Dec 11, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants