Skip to content

feat: back to cow.fi#615

Merged
alfetopito merged 2 commits intomainfrom
feat/back-to-cow.fi
Apr 15, 2026
Merged

feat: back to cow.fi#615
alfetopito merged 2 commits intomainfrom
feat/back-to-cow.fi

Conversation

@alfetopito
Copy link
Copy Markdown
Contributor

@alfetopito alfetopito commented Apr 15, 2026

Description

Simply revert back the changes, nothing else

Summary by CodeRabbit

  • Documentation
    • Updated documentation links across all guides and tutorials to point to new domain endpoints
    • Updated API base URLs and endpoint references for all networks
    • Updated email contact addresses and external resource links throughout documentation
    • Updated verification and reference links to maintain continuity

@alfetopito alfetopito requested a review from a team as a code owner April 15, 2026 19:36
@alfetopito alfetopito self-assigned this Apr 15, 2026
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 15, 2026

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Apr 15, 2026 7:38pm

Request Review

@alfetopito alfetopito requested a review from a team April 15, 2026 19:36
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Apr 15, 2026

📝 Walkthrough

Walkthrough

This pull request systematically updates all external domain references throughout the documentation from *.cow.finance to *.cow.fi, affecting API endpoints, forum links, blog references, explorer links, and configuration files across 51 files.

Changes

Cohort / File(s) Summary
Root & Meta Documentation
CONTRIBUTING.md, docs/README.md, docs/llms.md
Updated domain references from cow.finance to cow.fi for forum links, product URLs, and LLM file endpoints.
Core Protocol: Concepts & Benefits
docs/cow-protocol/concepts/benefits/mev-protection.md, docs/cow-protocol/concepts/how-it-works/flow-of-an-order.md, docs/cow-protocol/concepts/how-it-works/how-intents-are-formed.mdx
Updated blog and API documentation links from blog.cow.finance, api.cow.finance, and docs.cow.finance to their .cow.fi equivalents.
Core Protocol: Order Types
docs/cow-protocol/concepts/order-types/...
Migrated all external links in cow-hooks, limit-orders, milkman-orders, programmatic-orders, and twap-orders documentation from *.cow.finance to *.cow.fi domains.
Core Protocol: References (Auctions & Intents)
docs/cow-protocol/reference/core/auctions/..., docs/cow-protocol/reference/core/intents/app_data.mdx
Updated API documentation and forum links from api.cow.finance, forum.cow.finance, and docs.cow.finance to api.cow.fi, forum.cow.fi, and docs.cow.fi.
Integration & API Documentation
docs/cow-protocol/integrate/api.mdx, docs/cow-protocol/integrate/sdk.mdx, docs/cow-protocol/integrate/widget.mdx
Updated all API endpoints and widget configurator URLs from api.cow.finance, widget.cow.finance to api.cow.fi, widget.cow.fi.
Tutorials: CoW Swap
docs/cow-protocol/tutorials/cow-swap/...
Updated swap interface URLs, Safe app integration parameters, and support email addresses from swap.cow.finance to swap.cow.fi and bd@cow.finance to bd@cow.fi across all CoW Swap tutorials.
Tutorials: CoW Explorer
docs/cow-protocol/tutorials/cow-explorer/...
Migrated all explorer links from explorer.cow.finance to explorer.cow.fi for address, order, and batch auction examples.
Tutorials: Solvers & Other
docs/cow-protocol/tutorials/solvers/..., docs/cow-protocol/tutorials/arbitrate/README.mdx, docs/cow-protocol/tutorials/building.mdx, docs/cow-protocol/tutorials/hook-dapp/hook-dapp.md, docs/cow-protocol/tutorials/swap-in-safe-app/README.mdx, docs/cow-protocol/tutorials/widget/widget.md, docs/cow-amm/tutorials/cow-amm-deployer.md, docs/cow-protocol/tutorials/cow-amm-deployer.mdx
Updated documentation and API endpoint references from docs.cow.finance, api.cow.finance, barn.api.cow.finance, blog.cow.finance, learn.cow.finance, and explorer.cow.finance to their .cow.fi counterparts.
Governance Documentation
docs/governance/..., docs/cow-protocol/affiliate-program/faq.md
Updated forum, grant program, and multisig documentation links from forum.cow.finance, grants.cow.finance to forum.cow.fi, grants.cow.fi, and adjusted support email from info@cow.finance to info@cow.fi.
Site Configuration
docusaurus.config.ts, vercel.json
Updated site URL metadata and redirect destinations from docs.cow.finance, forum.cow.finance, cow.finance, learn.cow.finance to their docs.cow.fi, forum.cow.fi, cow.fi, learn.cow.fi equivalents.

Poem

🐰 A migration most fine, from old domains to new,
Each link and each endpoint gets a fresh .fi view,
Fifty files hopping along without a fuss,
The protocol's addresses now point to us!
🌟

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~18 minutes

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Description check ❓ Inconclusive The description is minimal but contextually appropriate for a revert PR. It directly states the purpose (revert changes) but lacks detailed information about what was reverted and why. Consider adding context about which previous changes are being reverted and the reason for the revert to improve clarity for future reviewers.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title 'feat: back to cow.fi' clearly summarizes the main objective of the PR, which is to revert changes and restore the project to use cow.fi domain.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/back-to-cow.fi

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
Copy Markdown
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: 5

🧹 Nitpick comments (1)
docs/cow-protocol/reference/core/auctions/schema.md (1)

11-11: Use descriptive link labels instead of “here”.

Line 11, Line 167, and Line 177 use generic anchor text, which hurts scanability and triggers MD059.

Suggested wording update
-The api spec and schema can be found [here](https://docs.cow.fi/cow-protocol/reference/apis/solver).
+The API spec and schema can be found in the [Solver API reference](https://docs.cow.fi/cow-protocol/reference/apis/solver).

-- `order`: in case of a "fulfillment" trade, the `uid` of the order is provided here as a string. In case it is a just-in-time liquidity order, the specifications of the order are explicitly given as a dictionary; more details can be found [here](https://docs.cow.fi/cow-protocol/reference/apis/solver).
+- `order`: in case of a "fulfillment" trade, the `uid` of the order is provided here as a string. In case it is a just-in-time liquidity order, the specifications of the order are explicitly given as a dictionary; more details can be found in the [Solver API reference](https://docs.cow.fi/cow-protocol/reference/apis/solver).

-- Depending on the "kind", the rest of the keys are different, and the details and specifications of those can be found [here](https://docs.cow.fi/cow-protocol/reference/apis/solver).
+- Depending on the "kind", the rest of the keys are different, and details are documented in the [Solver API reference](https://docs.cow.fi/cow-protocol/reference/apis/solver).

Also applies to: 167-167, 177-177

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/cow-protocol/reference/core/auctions/schema.md` at line 11, Replace the
generic link text "here" with a descriptive label for accessibility and MD059
compliance: locate the Markdown links that point to
https://docs.cow.fi/cow-protocol/reference/apis/solver (currently written as
[here](...)) and change the anchor text to a meaningful phrase such as "COW
Protocol solver API spec and schema" (or similar descriptive wording) wherever
it appears in this file (including the three occurrences flagged), keeping the
same URL and updating any other identical "here" links to consistent,
descriptive labels.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@CONTRIBUTING.md`:
- Line 18: Remove the unused link reference "[CoW Protocol Forums]" from the
document or add a corresponding inline reference where intended; specifically
delete the line containing "[CoW Protocol Forums]: https://forum.cow.fi" (or
replace it by adding a textual reference like [CoW Protocol Forums] in the
relevant section) so the link reference definition is either used or removed to
avoid dead/unused references.

In `@docs/cow-protocol/tutorials/cow-amm-deployer.mdx`:
- Line 6: The Safe App deep link in the CoW AMM Deployer description uses the
wrong EIP-3770 chain short name (`chain=et`) so the Safe won't open Ethereum
Mainnet; update the URL in the CoW AMM Deployer sentence (the href containing
"https://app.safe.global/share/safe-app?appUrl=https%3A%2F%2Fdeploy-cow-amm.bleu.fi&chain=et")
to use `chain=eth` instead of `chain=et` so the link selects Ethereum Mainnet
correctly.

In `@docs/cow-protocol/tutorials/solvers/evaluate.md`:
- Line 10: The documentation link to the solver auction/rewards page is broken
(the URL
"https://docs.cow.fi/off-chain-services/in-depth-solver-specification/solver-auction-and-rewards"
in docs/cow-protocol/tutorials/solvers/evaluate.md); update that URL to the
correct page (for example replace it with
"https://docs.cow.fi/cow-protocol/reference/core/auctions/rewards" or
"https://docs.cow.fi/cow-protocol/reference/core/auctions/competition-rules") so
the "notify" endpoint paragraph points to the valid solver auction and rewards
documentation.

In `@docs/cow-protocol/tutorials/solvers/local_test.md`:
- Line 26: Update the example command to use the correct argument formats for
the flags: change the --native-price-estimators entry to the required
Driver|name|url form (e.g., include the "Driver" prefix, the estimator name, and
its URL) and change the --drivers entry to the required name|url|address|value
form (include the solver name, its URL, on-chain address, and value); ensure
both flags use those exact pipe-separated fields so the command will parse at
runtime.

In `@docs/cow-protocol/tutorials/solvers/onboard.md`:
- Line 126: Replace the generic "here" link text at the two occurrences pointing
to https://docs.cow.fi/cow-protocol/reference/core/auctions/rewards and
https://docs.cow.fi/cow-protocol/reference/core/auctions/accounting with
descriptive link text (e.g., "how we calculate and distribute rewards" and "the
accounting process for auctions" respectively) so the markdown headings satisfy
MD059 and improve readability; update both instances (the rewards link and the
accounting link) in docs/cow-protocol/tutorials/solvers/onboard.md.

---

Nitpick comments:
In `@docs/cow-protocol/reference/core/auctions/schema.md`:
- Line 11: Replace the generic link text "here" with a descriptive label for
accessibility and MD059 compliance: locate the Markdown links that point to
https://docs.cow.fi/cow-protocol/reference/apis/solver (currently written as
[here](...)) and change the anchor text to a meaningful phrase such as "COW
Protocol solver API spec and schema" (or similar descriptive wording) wherever
it appears in this file (including the three occurrences flagged), keeping the
same URL and updating any other identical "here" links to consistent,
descriptive labels.
🪄 Autofix (Beta)

✅ Autofix completed


ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5c2be69c-3845-46e0-b42b-8a1915538b87

📥 Commits

Reviewing files that changed from the base of the PR and between bd0aada and 177421b.

📒 Files selected for processing (52)
  • CONTRIBUTING.md
  • docs/README.md
  • docs/cow-amm/tutorials/cow-amm-deployer.md
  • docs/cow-protocol/affiliate-program/faq.md
  • docs/cow-protocol/concepts/benefits/mev-protection.md
  • docs/cow-protocol/concepts/how-it-works/flow-of-an-order.md
  • docs/cow-protocol/concepts/how-it-works/how-intents-are-formed.mdx
  • docs/cow-protocol/concepts/order-types/cow-hooks.mdx
  • docs/cow-protocol/concepts/order-types/limit-orders.md
  • docs/cow-protocol/concepts/order-types/milkman-orders.md
  • docs/cow-protocol/concepts/order-types/programmatic-orders.md
  • docs/cow-protocol/concepts/order-types/twap-orders.md
  • docs/cow-protocol/integrate/api.mdx
  • docs/cow-protocol/integrate/sdk.mdx
  • docs/cow-protocol/integrate/widget.mdx
  • docs/cow-protocol/reference/core/auctions/accounting.md
  • docs/cow-protocol/reference/core/auctions/bonding_pools.md
  • docs/cow-protocol/reference/core/auctions/rewards.md
  • docs/cow-protocol/reference/core/auctions/schema.md
  • docs/cow-protocol/reference/core/intents/app_data.mdx
  • docs/cow-protocol/tutorials/arbitrate/README.mdx
  • docs/cow-protocol/tutorials/building.mdx
  • docs/cow-protocol/tutorials/cow-amm-deployer.mdx
  • docs/cow-protocol/tutorials/cow-explorer/README.mdx
  • docs/cow-protocol/tutorials/cow-explorer/address.md
  • docs/cow-protocol/tutorials/cow-explorer/batch_auction.md
  • docs/cow-protocol/tutorials/cow-explorer/order.md
  • docs/cow-protocol/tutorials/cow-swap/README.mdx
  • docs/cow-protocol/tutorials/cow-swap/custom-links.md
  • docs/cow-protocol/tutorials/cow-swap/flash-loans.mdx
  • docs/cow-protocol/tutorials/cow-swap/native.mdx
  • docs/cow-protocol/tutorials/cow-swap/swap-and-bridge.mdx
  • docs/cow-protocol/tutorials/cow-swap/swap.mdx
  • docs/cow-protocol/tutorials/cow-swap/twap.mdx
  • docs/cow-protocol/tutorials/hook-dapp/hook-dapp.md
  • docs/cow-protocol/tutorials/solvers/evaluate.md
  • docs/cow-protocol/tutorials/solvers/flashloans_support.md
  • docs/cow-protocol/tutorials/solvers/local_test.md
  • docs/cow-protocol/tutorials/solvers/onboard.md
  • docs/cow-protocol/tutorials/solvers/test.md
  • docs/cow-protocol/tutorials/swap-in-safe-app/README.mdx
  • docs/cow-protocol/tutorials/widget/widget.md
  • docs/governance/README.mdx
  • docs/governance/fees/partner-fee.md
  • docs/governance/grants/how-to-apply.md
  • docs/governance/grants/program-structure.md
  • docs/governance/multisigs.mdx
  • docs/governance/process/README.mdx
  • docs/governance/token.md
  • docs/llms.md
  • docusaurus.config.ts
  • vercel.json

Comment thread CONTRIBUTING.md

[CoW Protocol Discord]: https://discord.gg/cowprotocol
[CoW Protocol Forums]: https://forum.cow.finance
[CoW Protocol Forums]: https://forum.cow.fi
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.

⚠️ Potential issue | 🟡 Minor

Remove unused link reference definition.

The [CoW Protocol Forums] link reference is defined but never used in the document. Consider either removing the definition or adding a reference to it in the text.

🧹 Proposed fix to remove unused reference
-[CoW Protocol Forums]: https://forum.cow.fi

Alternatively, if you intend to use this reference, add it to the relevant sections in the document.

📝 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
[CoW Protocol Forums]: https://forum.cow.fi
🧰 Tools
🪛 markdownlint-cli2 (0.22.0)

[warning] 18-18: Link and image reference definitions should be needed
Unused link or image reference definition: "cow protocol forums"

(MD053, link-image-reference-definitions)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@CONTRIBUTING.md` at line 18, Remove the unused link reference "[CoW Protocol
Forums]" from the document or add a corresponding inline reference where
intended; specifically delete the line containing "[CoW Protocol Forums]:
https://forum.cow.fi" (or replace it by adding a textual reference like [CoW
Protocol Forums] in the relevant section) so the link reference definition is
either used or removed to avoid dead/unused references.


# CoW AMM Deployer
The [CoW AMM Deployer](https://app.safe.global/share/safe-app?appUrl=https%3A%2F%2Fdeploy-cow-amm.bleu.fi&chain=et) is a user-friendly Safe App that simplifies the process of deploying and managing [CoW AMMs](https://cow.finance/cow-amm) (Automated Market Makers) from Safe wallets. It enables users without programming skills to take advantage of the benefits of CoW AMM.
The [CoW AMM Deployer](https://app.safe.global/share/safe-app?appUrl=https%3A%2F%2Fdeploy-cow-amm.bleu.fi&chain=et) is a user-friendly Safe App that simplifies the process of deploying and managing [CoW AMMs](https://cow.fi/cow-amm) (Automated Market Makers) from Safe wallets. It enables users without programming skills to take advantage of the benefits of CoW AMM.
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.

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🌐 Web query:

For Safe app deep links on app.safe.global/share/safe-app, what are the valid values for the chainquery parameter? Ischain=etvalid, or should Ethereum bechain=eth?

💡 Result:

The valid values for the chain query parameter in Safe app deep links on app.safe.global/share/safe-app are EIP-3770 short names (chain prefixes) as defined in Safe's configuration and SDK. For Ethereum Mainnet (chainId 1), it is chain=eth. There is no evidence of chain=et being valid; it does not appear in Safe's supported networks list or EIP-3770 mappings. Ethereum uses eth consistently. Examples from Safe's protocol-kit EIP-3770 config: - Ethereum Mainnet (1): eth - Optimism (10): oeth - Polygon (137): matic - BSC (56): bsc Safe supports 25+ networks via these short names for deep linking to specific Safe Apps on particular chains. The deep link format likely follows patterns like https://app.safe.global/share/safe-app?appUrl=...&chain=eth to open a specific app on the specified chain.

Citations:


Fix Safe app link query: chain=et should be chain=eth.

Safe app deep links use EIP-3770 chain short names, and Ethereum Mainnet is eth, not et. This link won't select the correct network.

🔧 Suggested fix
-The [CoW AMM Deployer](https://app.safe.global/share/safe-app?appUrl=https%3A%2F%2Fdeploy-cow-amm.bleu.fi&chain=et) is a user-friendly Safe App that simplifies the process of deploying and managing [CoW AMMs](https://cow.fi/cow-amm) (Automated Market Makers) from Safe wallets. It enables users without programming skills to take advantage of the benefits of CoW AMM. 
+The [CoW AMM Deployer](https://app.safe.global/share/safe-app?appUrl=https%3A%2F%2Fdeploy-cow-amm.bleu.fi&chain=eth) is a user-friendly Safe App that simplifies the process of deploying and managing [CoW AMMs](https://cow.fi/cow-amm) (Automated Market Makers) from Safe wallets. It enables users without programming skills to take advantage of the benefits of CoW AMM. 
📝 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
The [CoW AMM Deployer](https://app.safe.global/share/safe-app?appUrl=https%3A%2F%2Fdeploy-cow-amm.bleu.fi&chain=et) is a user-friendly Safe App that simplifies the process of deploying and managing [CoW AMMs](https://cow.fi/cow-amm) (Automated Market Makers) from Safe wallets. It enables users without programming skills to take advantage of the benefits of CoW AMM.
The [CoW AMM Deployer](https://app.safe.global/share/safe-app?appUrl=https%3A%2F%2Fdeploy-cow-amm.bleu.fi&chain=eth) is a user-friendly Safe App that simplifies the process of deploying and managing [CoW AMMs](https://cow.fi/cow-amm) (Automated Market Makers) from Safe wallets. It enables users without programming skills to take advantage of the benefits of CoW AMM.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/cow-protocol/tutorials/cow-amm-deployer.mdx` at line 6, The Safe App
deep link in the CoW AMM Deployer description uses the wrong EIP-3770 chain
short name (`chain=et`) so the Safe won't open Ethereum Mainnet; update the URL
in the CoW AMM Deployer sentence (the href containing
"https://app.safe.global/share/safe-app?appUrl=https%3A%2F%2Fdeploy-cow-amm.bleu.fi&chain=et")
to use `chain=eth` instead of `chain=et` so the link selects Ethereum Mainnet
correctly.

## Getting notified about the ranking

A very useful functionality provided by the driver is the "notify" endpoint, which notifies all solvers participating in an auction about the ranking, once the bidding has closed, i.e., once all solutions have been submitted and have been ranked. (To find out about how solutions are ranked, see [this](https://docs.cow.finance/off-chain-services/in-depth-solver-specification/solver-auction-and-rewards) section).
A very useful functionality provided by the driver is the "notify" endpoint, which notifies all solvers participating in an auction about the ranking, once the bidding has closed, i.e., once all solutions have been submitted and have been ranked. (To find out about how solutions are ranked, see [this](https://docs.cow.fi/off-chain-services/in-depth-solver-specification/solver-auction-and-rewards) section).
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.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Description: Verify the updated documentation URL is accessible

# Test: Check if the new URL returns a successful response
curl -I -L --max-time 10 "https://docs.cow.fi/off-chain-services/in-depth-solver-specification/solver-auction-and-rewards" 2>&1 | head -n 1

Repository: cowprotocol/docs

Length of output: 139


🏁 Script executed:

# Read the actual file line 10 to see what the comment is referencing
cat -n docs/cow-protocol/tutorials/solvers/evaluate.md | sed -n '8,12p'

Repository: cowprotocol/docs

Length of output: 619


🏁 Script executed:

# Run a better curl command to check HTTP response without progress bar
curl -s -o /dev/null -w "HTTP Status: %{http_code}\n" -L "https://docs.cow.fi/off-chain-services/in-depth-solver-specification/solver-auction-and-rewards"

Repository: cowprotocol/docs

Length of output: 76


🏁 Script executed:

# Check if the old domain (docs.cow.finance) works with the same path
curl -s -o /dev/null -w "HTTP Status: %{http_code}\n" -L "https://docs.cow.finance/off-chain-services/in-depth-solver-specification/solver-auction-and-rewards"

Repository: cowprotocol/docs

Length of output: 76


🏁 Script executed:

# Search the docs repository for references to "solver-auction" to find the correct path
rg "solver-auction" docs/ -i --type markdown -A 2 -B 2

Repository: cowprotocol/docs

Length of output: 824


🏁 Script executed:

# Find files related to solver documentation
fd "solver" docs/ -i --type f | head -20

Repository: cowprotocol/docs

Length of output: 328


🏁 Script executed:

# List the structure of the off-chain-services directory
find docs/cow-protocol/off-chain-services -type f -name "*.md" 2>/dev/null | head -20

Repository: cowprotocol/docs

Length of output: 42


🏁 Script executed:

# Search for any reference to "in-depth" or "specification" in the docs
rg "specification|auction" docs/ -i --type markdown | grep -i solver | head -10

Repository: cowprotocol/docs

Length of output: 1772


🏁 Script executed:

# List top-level directories in docs/cow-protocol
ls -la docs/cow-protocol/ | grep "^d"

Repository: cowprotocol/docs

Length of output: 464


🏁 Script executed:

# Check the reference directory for solver-related docs
find docs/cow-protocol/reference -type f -name "*.md*" | xargs ls -la

Repository: cowprotocol/docs

Length of output: 3692


🏁 Script executed:

# Search for "solver" in reference directory
rg "solver" docs/cow-protocol/reference -i -l

Repository: cowprotocol/docs

Length of output: 1309


🏁 Script executed:

# Check what's in the solver.mdx file
cat docs/cow-protocol/reference/apis/solver.mdx

Repository: cowprotocol/docs

Length of output: 289


🏁 Script executed:

# Check the auctions README
cat docs/cow-protocol/reference/core/auctions/README.mdx

Repository: cowprotocol/docs

Length of output: 863


🏁 Script executed:

# Search git history to see if this path ever existed or what the original link was
git log --all --full-history --source -- "*off-chain-services*" 2>/dev/null | head -20

Repository: cowprotocol/docs

Length of output: 665


🏁 Script executed:

# Check if there's a sidebar or routing file that might show the doc structure
find docs -name "sidebars*" -o -name "docusaurus*" -o -name "*config*" | head -10

Repository: cowprotocol/docs

Length of output: 42


🏁 Script executed:

# Search for content about "solver" in auction-related files
rg -i "solver.*auction|auction.*solver" docs/cow-protocol/reference/core/auctions/ -A 3

Repository: cowprotocol/docs

Length of output: 20585


🏁 Script executed:

# Look for links in the evaluate.md file to see if there are other working links we can compare
cat -n docs/cow-protocol/tutorials/solvers/evaluate.md | head -40

Repository: cowprotocol/docs

Length of output: 1231


Fix broken documentation link.

The URL https://docs.cow.fi/off-chain-services/in-depth-solver-specification/solver-auction-and-rewards returns a 404 error and the path does not exist in the documentation structure. Update the link to point to the correct documentation page covering solver auction and rewards, which should be something like https://docs.cow.fi/cow-protocol/reference/core/auctions/rewards or https://docs.cow.fi/cow-protocol/reference/core/auctions/competition-rules.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/cow-protocol/tutorials/solvers/evaluate.md` at line 10, The
documentation link to the solver auction/rewards page is broken (the URL
"https://docs.cow.fi/off-chain-services/in-depth-solver-specification/solver-auction-and-rewards"
in docs/cow-protocol/tutorials/solvers/evaluate.md); update that URL to the
correct page (for example replace it with
"https://docs.cow.fi/cow-protocol/reference/core/auctions/rewards" or
"https://docs.cow.fi/cow-protocol/reference/core/auctions/competition-rules") so
the "notify" endpoint paragraph points to the valid solver auction and rewards
documentation.


```
cargo run --bin autopilot -- --native-price-estimators "baseline|http://driver/baseline" --skip-event-sync true --node-url $NODE_URL --shadow https://api.cow.finance/mainnet --drivers "mysolver1|http://localhost:11088/mysolver1"
cargo run --bin autopilot -- --native-price-estimators "baseline|http://driver/baseline" --skip-event-sync true --node-url $NODE_URL --shadow https://api.cow.fi/mainnet --drivers "mysolver1|http://localhost:11088/mysolver1"
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.

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "Checking --native-price-estimators examples:"
rg -n --type=md --type=mdx -- '--native-price-estimators\s+"[^"]+"' -C2

echo
echo "Checking --drivers examples:"
rg -n --type=md --type=mdx -- '--drivers\s+"[^"]+"' -C2

Repository: cowprotocol/docs

Length of output: 149


🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "=== File structure check ==="
find docs/cow-protocol/tutorials/solvers -name "*local_test*" -type f

echo
echo "=== Checking file at lines around 26 ==="
if [ -f docs/cow-protocol/tutorials/solvers/local_test.md ]; then
  sed -n '20,35p' docs/cow-protocol/tutorials/solvers/local_test.md
fi

echo
echo "=== Searching for --native-price-estimators examples (all markdown) ==="
rg -n -- '--native-price-estimators' docs/

echo
echo "=== Searching for --drivers examples (all markdown) ==="
rg -n -- '--drivers' docs/

Repository: cowprotocol/docs

Length of output: 1656


Fix autopilot argument formats in the command example.

Line 26 uses incorrect formats for both --native-price-estimators and --drivers. The command will fail at runtime if users follow this example.

Required fix
-    cargo run --bin autopilot -- --native-price-estimators "baseline|http://driver/baseline" --skip-event-sync true --node-url $NODE_URL --shadow https://api.cow.fi/mainnet --drivers "mysolver1|http://localhost:11088/mysolver1"
+    cargo run --bin autopilot -- --native-price-estimators "Driver|baseline|http://driver/baseline" --skip-event-sync true --node-url $NODE_URL --shadow https://api.cow.fi/mainnet --drivers "mysolver1|http://localhost:11088|0x0000000000000000000000000000000000000000|0"

--native-price-estimators requires the format Driver|name|url and --drivers requires name|url|address|value.

📝 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
cargo run --bin autopilot -- --native-price-estimators "baseline|http://driver/baseline" --skip-event-sync true --node-url $NODE_URL --shadow https://api.cow.fi/mainnet --drivers "mysolver1|http://localhost:11088/mysolver1"
cargo run --bin autopilot -- --native-price-estimators "Driver|baseline|http://driver/baseline" --skip-event-sync true --node-url $NODE_URL --shadow https://api.cow.fi/mainnet --drivers "mysolver1|http://localhost:11088|0x0000000000000000000000000000000000000000|0"
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/cow-protocol/tutorials/solvers/local_test.md` at line 26, Update the
example command to use the correct argument formats for the flags: change the
--native-price-estimators entry to the required Driver|name|url form (e.g.,
include the "Driver" prefix, the estimator name, and its URL) and change the
--drivers entry to the required name|url|address|value form (include the solver
name, its URL, on-chain address, and value); ensure both flags use those exact
pipe-separated fields so the command will parse at runtime.

We advise using a single rewards address that is available on all networks.

[You can find more information about how we calculate and distribute rewards here.](https://docs.cow.finance/cow-protocol/reference/core/auctions/rewards). The accounting process is documented in detail [here](https://docs.cow.finance/cow-protocol/reference/core/auctions/accounting).
[You can find more information about how we calculate and distribute rewards here.](https://docs.cow.fi/cow-protocol/reference/core/auctions/rewards). The accounting process is documented in detail [here](https://docs.cow.fi/cow-protocol/reference/core/auctions/accounting).
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.

⚠️ Potential issue | 🟡 Minor

Use descriptive link text to satisfy markdownlint (MD059).
These two links still use generic “here”, which weakens readability and fails lint.

📝 Suggested fix
-[You can find more information about how we calculate and distribute rewards here.](https://docs.cow.fi/cow-protocol/reference/core/auctions/rewards). The accounting process is documented in detail [here](https://docs.cow.fi/cow-protocol/reference/core/auctions/accounting).
+[How weekly rewards are calculated and distributed](https://docs.cow.fi/cow-protocol/reference/core/auctions/rewards). The [accounting process documentation](https://docs.cow.fi/cow-protocol/reference/core/auctions/accounting) provides full details.
@@
-Besides the solving competition, there is also a quoting competition. More information about the quoting competition can be found [here](https://docs.cow.fi/cow-protocol/reference/core/auctions/rewards#price-estimation-competition-rewards-cips-27-57-72).
+Besides the solving competition, there is also a quoting competition. See [quoting competition rewards](https://docs.cow.fi/cow-protocol/reference/core/auctions/rewards#price-estimation-competition-rewards-cips-27-57-72) for details.

Also applies to: 138-138

🧰 Tools
🪛 markdownlint-cli2 (0.22.0)

[warning] 126-126: Link text should be descriptive

(MD059, descriptive-link-text)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/cow-protocol/tutorials/solvers/onboard.md` at line 126, Replace the
generic "here" link text at the two occurrences pointing to
https://docs.cow.fi/cow-protocol/reference/core/auctions/rewards and
https://docs.cow.fi/cow-protocol/reference/core/auctions/accounting with
descriptive link text (e.g., "how we calculate and distribute rewards" and "the
accounting process for auctions" respectively) so the markdown headings satisfy
MD059 and improve readability; update both instances (the rewards link and the
accounting link) in docs/cow-protocol/tutorials/solvers/onboard.md.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Apr 15, 2026

Note

Autofix is a beta feature. Expect some limitations and changes as we gather feedback and continue to improve it.

Generating fixes for 5 unresolved review comments...

This may take a few minutes. The auto-fix coding agent will autonomously read files and make edits.

@alfetopito alfetopito merged commit 172d154 into main Apr 15, 2026
5 checks passed
@alfetopito alfetopito deleted the feat/back-to-cow.fi branch April 15, 2026 20:00
@github-actions github-actions bot locked and limited conversation to collaborators Apr 15, 2026
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.

3 participants