From 9eeb3552aa19ed780b72ba7a83c4bc6b73df23bb Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 23 Mar 2026 09:19:29 +0000 Subject: [PATCH] Audit and fix frontmatter metadata across 79 documentation pages Generated-By: mintlify-agent --- bff/development/creating-services.mdx | 1 + bff/services/api.mdx | 2 +- changelog.mdx | 2 +- composable-cow/introduction.mdx | 2 +- cow-amm.mdx | 3 ++- cow-amm/explanation/how-cow-amms-work.mdx | 1 + cow-amm/explanation/the-problem-of-lvr.mdx | 3 ++- cow-amm/tutorials/cow-amm-for-solvers.mdx | 1 + cow-protocol/explanation/architecture/autopilot.mdx | 1 + cow-protocol/explanation/architecture/driver.mdx | 2 +- cow-protocol/explanation/architecture/solver-engine.mdx | 2 +- cow-protocol/explanation/benefits/trade-any-intent.mdx | 2 +- cow-protocol/explanation/fee-model.mdx | 2 +- cow-protocol/explanation/flash-loans/integrators.mdx | 3 ++- .../explanation/how-it-works/coincidence-of-wants.mdx | 2 +- cow-protocol/explanation/how-it-works/flow-of-an-order.mdx | 2 +- .../explanation/how-it-works/how-intents-are-formed.mdx | 2 +- .../explanation/introduction/fair-combinatorial-auction.mdx | 3 ++- cow-protocol/explanation/introduction/intents.mdx | 2 +- cow-protocol/explanation/order-types/cow-hooks.mdx | 2 +- cow-protocol/explanation/order-types/liquidations.mdx | 2 +- .../explanation/order-types/pay-debt-flash-loans.mdx | 3 ++- cow-protocol/explanation/order-types/programmatic-orders.mdx | 2 +- cow-protocol/explanation/order-types/twap-orders.mdx | 2 +- cow-protocol/howto/cow-explorer.mdx | 2 +- cow-protocol/howto/integrate/api.mdx | 2 +- cow-protocol/howto/integrate/sdk.mdx | 2 +- cow-protocol/howto/solvers/fee-computation.mdx | 1 + cow-protocol/howto/solvers/flashloans_support.mdx | 1 + cow-protocol/howto/solvers/onboard.mdx | 2 ++ cow-protocol/howto/solvers/routes_integration.mdx | 2 ++ cow-protocol/overview.mdx | 2 +- cow-protocol/reference/contracts/core/allowlist.mdx | 2 +- cow-protocol/reference/contracts/core/settlement.mdx | 2 +- cow-protocol/reference/contracts/core/vault-relayer.mdx | 2 +- .../reference/contracts/periphery/composable-cow.mdx | 2 +- cow-protocol/reference/contracts/programmatic/twap.mdx | 2 +- cow-protocol/reference/core/auctions.mdx | 2 +- cow-protocol/reference/core/auctions/accounting.mdx | 3 ++- cow-protocol/reference/core/auctions/competition-rules.mdx | 2 +- cow-protocol/reference/core/auctions/ebbo-rules.mdx | 2 +- cow-protocol/reference/core/auctions/rewards.mdx | 2 +- cow-protocol/reference/core/auctions/the-problem.mdx | 3 ++- cow-protocol/reference/core/definitions.mdx | 1 + cow-protocol/reference/core/intents/hooks.mdx | 2 +- cow-protocol/reference/core/signing-schemes.mdx | 2 +- cow-protocol/reference/core/tokens.mdx | 2 +- cow-protocol/reference/sdks/cow-sdk.mdx | 1 + cow-protocol/tutorials/cow-amm-deployer.mdx | 5 +++-- cow-protocol/tutorials/cow-explorer/address.mdx | 2 +- cow-protocol/tutorials/cow-explorer/batch-auction.mdx | 2 +- cow-protocol/tutorials/cow-explorer/order.mdx | 2 +- cow-protocol/tutorials/solvers/local_test.mdx | 3 ++- cow-protocol/tutorials/token-approvals.mdx | 1 + cow-py/api/contracts.mdx | 2 +- cow-py/api/subgraph.mdx | 2 +- cow-py/installation.mdx | 2 +- cow-sdk/guides/erc1271-signing.mdx | 1 + cow-swap/features.mdx | 2 +- cow-swap/hooks/hook-dapp.mdx | 1 + cow-swap/reference/custom-links.mdx | 2 +- cow-swap/tutorials/dca-twap.mdx | 1 + cow-swap/tutorials/native.mdx | 2 +- cow-swap/tutorials/twap.mdx | 2 +- cow-swap/widget/overview.mdx | 2 +- cow-swap/widget/params.mdx | 2 +- governance.mdx | 1 + governance/explanation/grants/grant-types.mdx | 2 +- governance/explanation/mission.mdx | 2 +- governance/explanation/process.mdx | 1 + governance/explanation/token.mdx | 2 +- governance/reference/cip-template.mdx | 1 + governance/reference/fees.mdx | 1 + governance/reference/partner-fee.mdx | 1 + hooks-trampoline/api/errors.mdx | 2 +- mevblocker.mdx | 2 +- watch-tower/advanced/storage.mdx | 2 +- watch-tower/deployment/dappnode.mdx | 2 +- watch-tower/deployment/docker.mdx | 2 +- 79 files changed, 91 insertions(+), 61 deletions(-) diff --git a/bff/development/creating-services.mdx b/bff/development/creating-services.mdx index 6437fb6..f962d3d 100644 --- a/bff/development/creating-services.mdx +++ b/bff/development/creating-services.mdx @@ -1,5 +1,6 @@ --- title: "Creating Services and Libraries" +sidebarTitle: "Creating services" description: "Guide to scaffolding new services, applications, and libraries in the CoW Protocol BFF monorepo using NX generators" --- diff --git a/bff/services/api.mdx b/bff/services/api.mdx index 600760f..3fe3ddf 100644 --- a/bff/services/api.mdx +++ b/bff/services/api.mdx @@ -1,6 +1,6 @@ --- title: "API Service" -description: "Documentation for the BFF API service, a Fastify-based HTTP server that aggregates data from multiple sources to provide unified endpoints for trading, tokens, and balances" +description: "BFF API service reference — a Fastify-based server providing unified endpoints for CoW Protocol trading, tokens, and balances." --- # API Service diff --git a/changelog.mdx b/changelog.mdx index cd9ecf5..c244f29 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -1,6 +1,6 @@ --- title: "Changelog" -description: "Latest updates to CoW DAO documentation." +description: "Latest updates and changes to the CoW DAO documentation, including new features and migration notes." --- diff --git a/composable-cow/introduction.mdx b/composable-cow/introduction.mdx index 6cf9bc0..987534d 100644 --- a/composable-cow/introduction.mdx +++ b/composable-cow/introduction.mdx @@ -1,6 +1,6 @@ --- title: "Introduction" -description: "ComposableCoW is the contract that implements programmatic orders on CoW Protocol — orders that execute automatically when predefined on-chain conditions are satisfied." +description: "ComposableCoW implements programmatic orders on CoW Protocol — automated trading when on-chain conditions are met." --- # Introduction to ComposableCoW diff --git a/cow-amm.mdx b/cow-amm.mdx index a2e0eb0..a8abee1 100644 --- a/cow-amm.mdx +++ b/cow-amm.mdx @@ -1,6 +1,7 @@ --- title: "CoW AMM: The First MEV-capturing AMM" -description: "CoW AMM protects LPs from LVR so they can provide liquidity with less risk and more return. CoW AMM achieves close to 5% more in TVL compared to reference pools, protects millions from LVR, and has captured over $100,000 in surplus for LPs to date." +sidebarTitle: "CoW AMM" +description: "CoW AMM protects liquidity providers from LVR (loss-versus-rebalancing), delivering more return with less risk than traditional AMMs." hidden: true --- diff --git a/cow-amm/explanation/how-cow-amms-work.mdx b/cow-amm/explanation/how-cow-amms-work.mdx index ed3ad70..061ac16 100644 --- a/cow-amm/explanation/how-cow-amms-work.mdx +++ b/cow-amm/explanation/how-cow-amms-work.mdx @@ -1,5 +1,6 @@ --- title: "How CoW AMMs Work" +description: "How CoW AMM uses the Function-Maximizing AMM mechanism to batch trades at uniform clearing prices, eliminating LVR for liquidity providers." --- ## FM-AMMs diff --git a/cow-amm/explanation/the-problem-of-lvr.mdx b/cow-amm/explanation/the-problem-of-lvr.mdx index 1645716..85d8d2c 100644 --- a/cow-amm/explanation/the-problem-of-lvr.mdx +++ b/cow-amm/explanation/the-problem-of-lvr.mdx @@ -1,6 +1,7 @@ --- title: "The Problem of LVR (Loss-versus-rebalancing)" -description: "First coined by a team of researchers from LVR is a form of arbitrage that occurs whenever an AMM has an outdated (stale) price in comparison to some other trading venue." +sidebarTitle: "The problem of LVR" +description: "Loss-versus-rebalancing (LVR) explained — how arbitrageurs exploit stale AMM prices and why CoW AMM solves this problem." --- Arbitrageurs exploit this difference by trading from the AMM to the more liquid exchange (usually a centralized exchange like Binance), correcting the arbitrage and extracting value from LPs in the process. diff --git a/cow-amm/tutorials/cow-amm-for-solvers.mdx b/cow-amm/tutorials/cow-amm-for-solvers.mdx index 4d8deb1..9c32bca 100644 --- a/cow-amm/tutorials/cow-amm-for-solvers.mdx +++ b/cow-amm/tutorials/cow-amm-for-solvers.mdx @@ -1,5 +1,6 @@ --- title: "CoW AMM Liquidity for Solvers" +description: "How solvers can interact with CoW AMM liquidity in the CoW Protocol orderbook, including custom buy/sell amounts and surplus capturing." --- ## I'm a solver. How do I use CoW AMM liquidity? diff --git a/cow-protocol/explanation/architecture/autopilot.mdx b/cow-protocol/explanation/architecture/autopilot.mdx index 79f406a..0e801f2 100644 --- a/cow-protocol/explanation/architecture/autopilot.mdx +++ b/cow-protocol/explanation/architecture/autopilot.mdx @@ -1,5 +1,6 @@ --- title: "Autopilot" +description: "The Autopilot orchestrates CoW Protocol's batch auction lifecycle, managing order collection, solver coordination, and on-chain settlement." --- ## Overview diff --git a/cow-protocol/explanation/architecture/driver.mdx b/cow-protocol/explanation/architecture/driver.mdx index aa8a1f2..7a5e8ce 100644 --- a/cow-protocol/explanation/architecture/driver.mdx +++ b/cow-protocol/explanation/architecture/driver.mdx @@ -1,6 +1,6 @@ --- title: "Driver" -description: "People interested in running a solver to participate in CoW Protocol mainly want to focus on implementing the most efficient solver engine. However, there are also many mundane tasks that may not seem like a competitive advantage but have to be done regardless." +description: "The Driver is a plug-and-play component that handles mundane tasks for CoW Protocol solver teams, from auction processing to settlement." --- ## Overview diff --git a/cow-protocol/explanation/architecture/solver-engine.mdx b/cow-protocol/explanation/architecture/solver-engine.mdx index 83678eb..56b2257 100644 --- a/cow-protocol/explanation/architecture/solver-engine.mdx +++ b/cow-protocol/explanation/architecture/solver-engine.mdx @@ -1,6 +1,6 @@ --- title: "Solver Engine" -description: "The Solver Engine implements the of the CoW Protocol batch auction. As part of the auction lifecycle, it receives a request from the containing a potentially pre-processed auction instance and returns information about which order to execute together with instructions on how to achieve the desired execution using on-chain liquidity \"interactions\"." +description: "The Solver Engine processes CoW Protocol batch auctions, determining which orders to execute and how to route them through on-chain liquidity." --- diff --git a/cow-protocol/explanation/benefits/trade-any-intent.mdx b/cow-protocol/explanation/benefits/trade-any-intent.mdx index f9670f1..ec36867 100644 --- a/cow-protocol/explanation/benefits/trade-any-intent.mdx +++ b/cow-protocol/explanation/benefits/trade-any-intent.mdx @@ -1,6 +1,6 @@ --- title: "Trade any intent" -description: "CoW Protocol allows users to express any type of trade intent on Ethereum and EVM-compatible chains, leveraging to execute the transactions through the most optimal route." +description: "CoW Protocol supports any trade intent on Ethereum — from market orders to TWAP, programmatic orders, and CoW Hooks." --- The protocol supports any order logic which includes standard market and limit orders, but also advanced order types such as [TWAP](/cow-protocol/explanation/order-types/twap-orders). Thanks to `ERC-1271`, smart contracts can also submit intents, paving the way for the [Programmatic Order Framework](/cow-protocol/explanation/order-types/programmatic-orders) and contracts like [Milkman](/cow-protocol/explanation/order-types/milkman-orders). diff --git a/cow-protocol/explanation/fee-model.mdx b/cow-protocol/explanation/fee-model.mdx index a5fdba4..438e6c8 100644 --- a/cow-protocol/explanation/fee-model.mdx +++ b/cow-protocol/explanation/fee-model.mdx @@ -1,6 +1,6 @@ --- title: "Fee Model" -description: "How fees work in CoW Protocol — from the quote response to on-chain settlement. Everything you need to understand protocol fees, network costs, partner fees, and how to retrieve fee data for accounting." +description: "How fees work in CoW Protocol — protocol fees, network costs, partner fees, and how to retrieve fee data for accounting." --- diff --git a/cow-protocol/explanation/flash-loans/integrators.mdx b/cow-protocol/explanation/flash-loans/integrators.mdx index 535ddf9..6c7bd65 100644 --- a/cow-protocol/explanation/flash-loans/integrators.mdx +++ b/cow-protocol/explanation/flash-loans/integrators.mdx @@ -1,6 +1,7 @@ --- title: "How to specify an order with flash loan" -description: "The flash loan is encoded into the 's metadata as an optional object. This information serves as a hint for the solver, but the solver ultimately can decide for a different approach in order to make the operation more optimal." +sidebarTitle: "Flash loan orders" +description: "How to encode flash loan parameters in CoW Protocol order metadata as hints for solvers to optimize execution." --- It is important to ensure that the flash loan gas overhead is added to the slippage tolerance when creating the order. diff --git a/cow-protocol/explanation/how-it-works/coincidence-of-wants.mdx b/cow-protocol/explanation/how-it-works/coincidence-of-wants.mdx index 5b39669..b991166 100644 --- a/cow-protocol/explanation/how-it-works/coincidence-of-wants.mdx +++ b/cow-protocol/explanation/how-it-works/coincidence-of-wants.mdx @@ -1,6 +1,6 @@ --- title: "Coincidence of Wants" -description: "CoW (Coincidence of Wants): An economic phenomenon where two parties - each holding the asset that the other needs - exchange assets directly in an equivalent barter." +description: "Coincidence of Wants (CoW) enables peer-to-peer swaps in CoW Protocol, saving users LP fees and reducing gas costs." --- Thanks to CoW Protocol's batching mechanism, users can make peer-to-peer swaps in cases where they're trading the same assets. diff --git a/cow-protocol/explanation/how-it-works/flow-of-an-order.mdx b/cow-protocol/explanation/how-it-works/flow-of-an-order.mdx index ebaae20..1894f8b 100644 --- a/cow-protocol/explanation/how-it-works/flow-of-an-order.mdx +++ b/cow-protocol/explanation/how-it-works/flow-of-an-order.mdx @@ -1,6 +1,6 @@ --- title: "Flow of an order" -description: "Rather than creating executable on-chain transactions, CoW Protocol users submit their orders as signed  messages. This allows to find the optimal execution path for the batch of orders before committing them on-chain." +description: "End-to-end flow of an order through CoW Protocol — from signed intent submission to solver competition and on-chain settlement." --- Let's bring all of our main concepts together by taking a look at the flow of an order through CoW Protocol. diff --git a/cow-protocol/explanation/how-it-works/how-intents-are-formed.mdx b/cow-protocol/explanation/how-it-works/how-intents-are-formed.mdx index 792ff69..0382789 100644 --- a/cow-protocol/explanation/how-it-works/how-intents-are-formed.mdx +++ b/cow-protocol/explanation/how-it-works/how-intents-are-formed.mdx @@ -1,6 +1,6 @@ --- title: "How Intents Are Formed" -description: "An intent in CoW Protocol is a signed message that represents a user's wish to trade. It doesn't execute a trade directly — instead, it delegates execution to solvers who find the optimal path." +description: "How CoW Protocol intents are formed — signed messages that delegate trade execution to solvers for optimal path finding." --- An [_intent_](/cow-protocol/explanation/introduction/intents) in CoW Protocol is a signed message that represents a user's wish to trade. It doesn't execute a trade directly — instead, it delegates execution to [solvers](/cow-protocol/explanation/introduction/solvers) who find the optimal path. diff --git a/cow-protocol/explanation/introduction/fair-combinatorial-auction.mdx b/cow-protocol/explanation/introduction/fair-combinatorial-auction.mdx index d59774c..130171d 100644 --- a/cow-protocol/explanation/introduction/fair-combinatorial-auction.mdx +++ b/cow-protocol/explanation/introduction/fair-combinatorial-auction.mdx @@ -1,6 +1,7 @@ --- title: "Fair Combinatorial Batch Auction" -description: "CoW Protocol collects and aggregates intents off-chain and auctions them off to solvers. The auction is a Fair Combinatorial Batch Auction (FCBA) because each solver can submit multiple bids. A solver can submit multiple bids on individual orders, in which case each \"bid\" represents the best price this solver can provide to an individual order. However, a solver can also submit \"batched\" bids, that is, bids on groups of orders." +sidebarTitle: "Batch auctions" +description: "How CoW Protocol's Fair Combinatorial Batch Auction (FCBA) aggregates intents and selects winning solver bids to maximize user surplus." --- The protocol filters out \`\`unfair'' batched bids, which are those delivering less to an order than some available "non-batched" bids. It then selects the combination of winning bids that maximizes the surplus received by the orders that are part of the auction (subject to some computational constraints due to the combinatorial nature of the problem). diff --git a/cow-protocol/explanation/introduction/intents.mdx b/cow-protocol/explanation/introduction/intents.mdx index 73db31f..b02a2f4 100644 --- a/cow-protocol/explanation/introduction/intents.mdx +++ b/cow-protocol/explanation/introduction/intents.mdx @@ -1,6 +1,6 @@ --- title: "Intents" -description: "Rather than placing orders by that executes directly on-chain (i.e. as happens on Uniswap or SushiSwap), CoW Protocol users place orders by that specifies parameters like the assets and amounts they would like to trade. The intent is a signed message which allows the solvers to execute a trade on behalf of the user using their specified assets and amounts." +description: "CoW Protocol uses signed intent messages instead of on-chain transactions, letting solvers find optimal execution paths on behalf of users." --- There are a number of [financial](#financial-benefits-of-intents) and [technical](#technical-benefits-of-intents) advantages to intent-based trading. diff --git a/cow-protocol/explanation/order-types/cow-hooks.mdx b/cow-protocol/explanation/order-types/cow-hooks.mdx index 6cf4839..8695bdc 100644 --- a/cow-protocol/explanation/order-types/cow-hooks.mdx +++ b/cow-protocol/explanation/order-types/cow-hooks.mdx @@ -1,6 +1,6 @@ --- title: "CoW Hooks" -description: "CoW Hooks allow users to pair any Ethereum action (or set of actions) with an order on CoW Protocol, leveraging the to execute the actions together in the sequence." +description: "CoW Hooks let you pair arbitrary Ethereum actions with CoW Protocol orders, executing pre-swap and post-swap logic atomically." --- Hooks execute the entire sequence as a single transaction. True to the CoW Protocol model, users pay gas fees in their sell token if, and only if, the sequence of transactions succeeds. Under the hood, CoW Hooks are arbitrary Ethereum "calls" that attach to an order and execute before and/or after the order. Developers and advanced traders can use code to express an intent that performs some action before a swap (pre-hooks) and after a swap (post-hooks). diff --git a/cow-protocol/explanation/order-types/liquidations.mdx b/cow-protocol/explanation/order-types/liquidations.mdx index 5575ada..4c258be 100644 --- a/cow-protocol/explanation/order-types/liquidations.mdx +++ b/cow-protocol/explanation/order-types/liquidations.mdx @@ -1,6 +1,6 @@ --- title: "Liquidations" -description: "How lending protocols can use CoW Protocol to execute liquidations with MEV protection and competitive pricing, using ERC-1271 smart orders and the settlement contract's on-chain guarantees." +description: "How lending protocols use CoW Protocol for MEV-protected liquidations with ERC-1271 smart orders and competitive pricing." --- ## The problem with traditional liquidations diff --git a/cow-protocol/explanation/order-types/pay-debt-flash-loans.mdx b/cow-protocol/explanation/order-types/pay-debt-flash-loans.mdx index f688f7c..21f7043 100644 --- a/cow-protocol/explanation/order-types/pay-debt-flash-loans.mdx +++ b/cow-protocol/explanation/order-types/pay-debt-flash-loans.mdx @@ -1,6 +1,7 @@ --- title: "Repay debt with collateral using flash loans" -description: "A key use case of flash loans is the ability to repay debt with collateral, since flash loans allow users to close or reduce their debt positions without needing upfront liquidity." +sidebarTitle: "Repay debt (flash loans)" +description: "Repay debt with collateral using CoW Protocol flash loans — close or reduce debt positions without upfront liquidity." --- Instead of requiring users to have assets readily available to repay their loans, flash loans enable them to temporarily borrow the needed funds, use those funds to repay their debt, and immediately reclaim their locked collateral. Once the collateral is received, it can be swapped or liquidated to cover the borrowed amount, ensuring the loan is repaid within the same transaction. diff --git a/cow-protocol/explanation/order-types/programmatic-orders.mdx b/cow-protocol/explanation/order-types/programmatic-orders.mdx index 9e26639..163dae0 100644 --- a/cow-protocol/explanation/order-types/programmatic-orders.mdx +++ b/cow-protocol/explanation/order-types/programmatic-orders.mdx @@ -1,6 +1,6 @@ --- title: "Programmatic orders" -description: "In addition to normal wallets, CoW Protocol also supports smart contract wallets that implement . This allows users to place orders through smart contracts with programmable parameters that execute based on certain conditions." +description: "CoW Protocol programmatic orders execute from smart contracts based on on-chain conditions like prices, balances, or time elapsed." --- We call these types of orders "programmatic orders" and we've developed a framework for creating programmatic orders, aptly named the "Programmatic Order Framework." diff --git a/cow-protocol/explanation/order-types/twap-orders.mdx b/cow-protocol/explanation/order-types/twap-orders.mdx index 397ffb7..5ceb4cb 100644 --- a/cow-protocol/explanation/order-types/twap-orders.mdx +++ b/cow-protocol/explanation/order-types/twap-orders.mdx @@ -1,6 +1,6 @@ --- title: "TWAP orders" -description: "Time-Weighted Average Price (TWAP) orders are an advanced order type available on CoW Protocol that breaks up a large order into several smaller pieces. TWAP orders are ideal for executing big trades with minimal price impact." +description: "TWAP orders on CoW Protocol split large trades into smaller parts over time, minimizing price impact and improving average execution." --- ## How TWAP Orders Work diff --git a/cow-protocol/howto/cow-explorer.mdx b/cow-protocol/howto/cow-explorer.mdx index 66aa16e..d3b95a1 100644 --- a/cow-protocol/howto/cow-explorer.mdx +++ b/cow-protocol/howto/cow-explorer.mdx @@ -1,6 +1,6 @@ --- title: "Viewing orders" -description: "As CoW Protocol utilizes an off-chain orderbook, and settles on-chain, getting a holistic view of the current state of CoW Protocol requires a combination of on-chain and off-chain data. Individually, this information is available from the following:" +description: "Use CoW Explorer to view orders, batch auctions, and trading activity on CoW Protocol by combining on-chain and off-chain data." --- * [Order book API](/cow-protocol/reference/apis/orderbook) (off-chain) diff --git a/cow-protocol/howto/integrate/api.mdx b/cow-protocol/howto/integrate/api.mdx index 84d1535..1b93f8e 100644 --- a/cow-protocol/howto/integrate/api.mdx +++ b/cow-protocol/howto/integrate/api.mdx @@ -1,6 +1,6 @@ --- title: "API Integration Guide" -description: "Step-by-step guide to integrating with the CoW Protocol orderbook API — from requesting a quote, to computing signing amounts, to creating and monitoring orders." +description: "Integrate with the CoW Protocol orderbook API — request quotes, compute signing amounts, create and monitor orders." --- import { InlineResource } from '/snippets/resource-actions.jsx' diff --git a/cow-protocol/howto/integrate/sdk.mdx b/cow-protocol/howto/integrate/sdk.mdx index fe28e38..eb0d0b0 100644 --- a/cow-protocol/howto/integrate/sdk.mdx +++ b/cow-protocol/howto/integrate/sdk.mdx @@ -1,6 +1,6 @@ --- title: "SDK Integration" -description: "The CoW SDK provides programmatic access to CoW Protocol's functionality, enabling you to build custom trading applications with full control over the user interface and trading logic." +description: "Build custom CoW Protocol trading applications with the CoW SDK — full control over UI, trading logic, and order management." hidden: true --- diff --git a/cow-protocol/howto/solvers/fee-computation.mdx b/cow-protocol/howto/solvers/fee-computation.mdx index 1061f81..e30e2a7 100644 --- a/cow-protocol/howto/solvers/fee-computation.mdx +++ b/cow-protocol/howto/solvers/fee-computation.mdx @@ -1,5 +1,6 @@ --- title: "Fee computation for limit orders" +sidebarTitle: "Fee computation" description: "Guidelines for how solvers should compute fees when executing limit orders, where users sign orders with zero fees and solvers propose fees at execution time." --- diff --git a/cow-protocol/howto/solvers/flashloans_support.mdx b/cow-protocol/howto/solvers/flashloans_support.mdx index 4906561..925a464 100644 --- a/cow-protocol/howto/solvers/flashloans_support.mdx +++ b/cow-protocol/howto/solvers/flashloans_support.mdx @@ -1,5 +1,6 @@ --- title: "How to execute flashloans orders" +sidebarTitle: "Flash loan execution" description: "This short tutorial explains how orders with flashloans hints can be executed by solvers." --- diff --git a/cow-protocol/howto/solvers/onboard.mdx b/cow-protocol/howto/solvers/onboard.mdx index 600f6f8..4269f62 100644 --- a/cow-protocol/howto/solvers/onboard.mdx +++ b/cow-protocol/howto/solvers/onboard.mdx @@ -1,5 +1,7 @@ --- title: "Joining The CoW Protocol Solver Competition" +sidebarTitle: "Solver onboarding" +description: "Step-by-step guide to onboarding as a solver in the CoW Protocol competition, from shadow testing to bonding pool setup." --- > ***NOTE:*** In order to get connected to the shadow competition, feel free to reach out to an admin of the ["CoW Swap Solvers"](https://t.me/+2Z_-DW57meA1MDlh) group on Telegram. diff --git a/cow-protocol/howto/solvers/routes_integration.mdx b/cow-protocol/howto/solvers/routes_integration.mdx index 3a8b1e4..cba0071 100644 --- a/cow-protocol/howto/solvers/routes_integration.mdx +++ b/cow-protocol/howto/solvers/routes_integration.mdx @@ -1,5 +1,7 @@ --- title: "Getting new routes integrated Into CoW Protocol" +sidebarTitle: "Routes integration" +description: "How DeFi teams can integrate new liquidity sources and trading routes into CoW Protocol's solver network for better price discovery." --- ## Overview diff --git a/cow-protocol/overview.mdx b/cow-protocol/overview.mdx index 2f5dbee..2dd5c5d 100644 --- a/cow-protocol/overview.mdx +++ b/cow-protocol/overview.mdx @@ -1,6 +1,6 @@ --- title: "What is CoW Protocol?" -description: "CoW Protocol is the most user-protective trading protocol in DeFi, using batch auctions and solver competition to deliver MEV protection, better prices, and gasless trading." +description: "CoW Protocol uses batch auctions and solver competition to deliver MEV protection, better prices, and gasless trading on Ethereum." --- What is CoW Protocol diff --git a/cow-protocol/reference/contracts/core/allowlist.mdx b/cow-protocol/reference/contracts/core/allowlist.mdx index 2546430..e28fd97 100644 --- a/cow-protocol/reference/contracts/core/allowlist.mdx +++ b/cow-protocol/reference/contracts/core/allowlist.mdx @@ -1,6 +1,6 @@ --- title: "GPv2AllowlistAuthentication" -description: "import HistoricalFact from './_gpv2.md'" +description: "GPv2AllowlistAuthentication contract reference for managing solver permissions in CoW Protocol's settlement system." --- ## Architecture diff --git a/cow-protocol/reference/contracts/core/settlement.mdx b/cow-protocol/reference/contracts/core/settlement.mdx index 53d9b7b..f822559 100644 --- a/cow-protocol/reference/contracts/core/settlement.mdx +++ b/cow-protocol/reference/contracts/core/settlement.mdx @@ -1,6 +1,6 @@ --- title: "GPv2Settlement" -description: "import HistoricalFact from './_gpv2.md'" +description: "GPv2Settlement contract reference — the core CoW Protocol contract that executes batch auction settlements on-chain." --- ## Architecture diff --git a/cow-protocol/reference/contracts/core/vault-relayer.mdx b/cow-protocol/reference/contracts/core/vault-relayer.mdx index d0e1be7..d8bc153 100644 --- a/cow-protocol/reference/contracts/core/vault-relayer.mdx +++ b/cow-protocol/reference/contracts/core/vault-relayer.mdx @@ -1,6 +1,6 @@ --- title: "GPv2VaultRelayer" -description: "import HistoricalFact from './_gpv2.md'" +description: "GPv2VaultRelayer contract reference — protects user funds from malicious solvers by managing token allowances separately." --- ## Architecture diff --git a/cow-protocol/reference/contracts/periphery/composable-cow.mdx b/cow-protocol/reference/contracts/periphery/composable-cow.mdx index d3894e3..9663217 100644 --- a/cow-protocol/reference/contracts/periphery/composable-cow.mdx +++ b/cow-protocol/reference/contracts/periphery/composable-cow.mdx @@ -1,6 +1,6 @@ --- title: "ComposableCoW" -description: "ComposableCoW is the contract that implements programmatic orders on CoW Protocol. Programmatic orders are a subset of smart contract orders. It allows one to create programmatic orders that:" +description: "ComposableCoW contract reference for creating self-expressing, self-validating programmatic orders on CoW Protocol." --- 1. Can be used to generate multiple discrete order (self-expressing) diff --git a/cow-protocol/reference/contracts/programmatic/twap.mdx b/cow-protocol/reference/contracts/programmatic/twap.mdx index 2463cb1..67e5aba 100644 --- a/cow-protocol/reference/contracts/programmatic/twap.mdx +++ b/cow-protocol/reference/contracts/programmatic/twap.mdx @@ -1,6 +1,6 @@ --- title: "TWAP" -description: "A simple (TWAP) trade may be thought of as smaller trades happening every time interval, commencing at time . Additionally, it is possible to limit a part's validity of the order to a certain of time interval ." +description: "TWAP smart contract reference for CoW Protocol — data structures, verification logic, and order creation for time-weighted trades." --- ## Data Structure diff --git a/cow-protocol/reference/core/auctions.mdx b/cow-protocol/reference/core/auctions.mdx index 17ee32f..4fac402 100644 --- a/cow-protocol/reference/core/auctions.mdx +++ b/cow-protocol/reference/core/auctions.mdx @@ -1,6 +1,6 @@ --- title: "Auction mechanism" -description: "CoW Protocol uses an implementation of the for executing trades. Within a given auction, the goal is to compute prices and traded amounts to maximize a well-defined function, subject to a fairness constraint." +description: "CoW Protocol's batch auction mechanism — how solvers compete to maximize surplus subject to fairness constraints." --- This can be formulated as a concrete optimization problem that needs to be solved, and this is where solvers come into play. Informally, a solver is an algorithm that takes as its input an auction instance and outputs a set of solutions (or bids), each corresponding to how it can best execute different combinations of orders in the batch. The solutions proposed by all solvers are then processed by the protocol, which selects (potentially multiple) winners according to a well-defined objective function. diff --git a/cow-protocol/reference/core/auctions/accounting.mdx b/cow-protocol/reference/core/auctions/accounting.mdx index 8a437b6..91bf3b4 100644 --- a/cow-protocol/reference/core/auctions/accounting.mdx +++ b/cow-protocol/reference/core/auctions/accounting.mdx @@ -1,6 +1,7 @@ --- title: "Solver competition accounting process" -description: "There is an accounting process in place for the solver competition. It is performed separately on each chain. Currently, the execution of the accounting process takes place once a week for all chains the protocol operates on, and each accounting week starts on Tuesday at midnight UTC and concludes a week later at midnight UTC. This accounting process consists of the following:" +sidebarTitle: "Accounting" +description: "Weekly accounting process for the CoW Protocol solver competition, covering rewards, protocol fees, and settlement contract balances." --- * calculation of total rewards/penalties, as specified by the [mechanism](/cow-protocol/reference/core/auctions/rewards); diff --git a/cow-protocol/reference/core/auctions/competition-rules.mdx b/cow-protocol/reference/core/auctions/competition-rules.mdx index 9b59010..01536e5 100644 --- a/cow-protocol/reference/core/auctions/competition-rules.mdx +++ b/cow-protocol/reference/core/auctions/competition-rules.mdx @@ -1,6 +1,6 @@ --- title: "Solver competition rules" -description: "All solvers participating in the solver competition must abide by certain rules. In this section, we outline all these rules. They naturally split into three classes:" +description: "Rules for CoW Protocol solver competition — smart contract, off-chain protocol, and governance-enforced requirements." --- 1. Those enforced explicitly by the [smart contract](#smart-contract) diff --git a/cow-protocol/reference/core/auctions/ebbo-rules.mdx b/cow-protocol/reference/core/auctions/ebbo-rules.mdx index afd9ba0..ad18f1b 100644 --- a/cow-protocol/reference/core/auctions/ebbo-rules.mdx +++ b/cow-protocol/reference/core/auctions/ebbo-rules.mdx @@ -1,6 +1,6 @@ --- title: "EBBO violations: details" -description: "In this section, we will elaborate on the details about what consistutes an EBBO violation, and what actions are taken by the DAO in case such a violation occurs. The content of this section is based on ." +description: "What constitutes an EBBO violation in CoW Protocol and how the DAO enforces reimbursement when solvers fail to meet best execution." --- ## Certificate of EBBO violation diff --git a/cow-protocol/reference/core/auctions/rewards.mdx b/cow-protocol/reference/core/auctions/rewards.mdx index 604f017..04a1752 100644 --- a/cow-protocol/reference/core/auctions/rewards.mdx +++ b/cow-protocol/reference/core/auctions/rewards.mdx @@ -1,6 +1,6 @@ --- title: "Solver rewards" -description: "The protocol is currently subsidizing the solver competition on all chains it operates on, by rewarding solvers on a weekly basis (currently, every Tuesday) with rewards paid in COW. Solvers are rewarded based on their performance as solvers (i.e., when participating in the standard solver competition) as specified by , , , , and . Solver rewards for participating in the price estimation competition and providing quotes that are needed for the gas estimates and limit price computations of market orders are specified in , , , and ." +description: "How CoW Protocol rewards solvers weekly in COW tokens based on competition performance and quote accuracy across all chains." --- diff --git a/cow-protocol/reference/core/auctions/the-problem.mdx b/cow-protocol/reference/core/auctions/the-problem.mdx index a23faa5..7216fb6 100644 --- a/cow-protocol/reference/core/auctions/the-problem.mdx +++ b/cow-protocol/reference/core/auctions/the-problem.mdx @@ -1,6 +1,7 @@ --- title: "What is solving? A mathematical, high-level description" -description: "At a high level, a solver is an algorithm that takes as inputs the orders that are valid for an auction, the state of the liquidity sources that the solver can access, the rules set by the protocol (including those specifying the protocol fees), and returns one or multiple solutions, where a solution selects a subset of the orders valid in an auction and specifies feasible in and out amounts for each of those orders. The solutions proposed by each solver during a given auction are the outcome of a two-step optimization problem: optimal routing and then optimal bidding." +sidebarTitle: "What is solving?" +description: "Mathematical description of the solving problem in CoW Protocol — how solvers optimize routing and bidding for batch auctions." --- In this section, we describe mathematically the different components of the "solving" problem. We discuss optimal routing and optimal bidding [in the solvers' strategy section](/cow-protocol/reference/core/auctions/rewards#solvers-strategy). diff --git a/cow-protocol/reference/core/definitions.mdx b/cow-protocol/reference/core/definitions.mdx index 884430d..f418d68 100644 --- a/cow-protocol/reference/core/definitions.mdx +++ b/cow-protocol/reference/core/definitions.mdx @@ -1,5 +1,6 @@ --- title: "Definitions" +description: "Glossary of key CoW Protocol terms including intents, orders, settlements, batches, solvers, and other core concepts." --- #### Intent diff --git a/cow-protocol/reference/core/intents/hooks.mdx b/cow-protocol/reference/core/intents/hooks.mdx index 14f236a..44d3664 100644 --- a/cow-protocol/reference/core/intents/hooks.mdx +++ b/cow-protocol/reference/core/intents/hooks.mdx @@ -1,6 +1,6 @@ --- title: "Hooks" -description: "The allows users to request the solvers to execute user-defined Ethereum calls (also known as an \"inner/internal transaction\") before and after the execution of an order in a settlement." +description: "Hooks specification for CoW Protocol — pre-hooks and post-hooks that execute user-defined Ethereum calls around order settlement." --- ## Specification diff --git a/cow-protocol/reference/core/signing-schemes.mdx b/cow-protocol/reference/core/signing-schemes.mdx index a4b6772..eac17aa 100644 --- a/cow-protocol/reference/core/signing-schemes.mdx +++ b/cow-protocol/reference/core/signing-schemes.mdx @@ -1,6 +1,6 @@ --- title: "Signing schemes" -description: "As CoW Protocol handles user's orders that were provided off-chain, the authenticity of a user's order needs to be asserted. Authenticity is asserted by the user their order. A user may be an EOA or a smart contract." +description: "CoW Protocol signing schemes for order authentication — EIP-712, EIP-1271, eth_sign, and PreSign for EOAs and smart contracts." --- ## Order digest diff --git a/cow-protocol/reference/core/tokens.mdx b/cow-protocol/reference/core/tokens.mdx index cd1cdfc..012f3a3 100644 --- a/cow-protocol/reference/core/tokens.mdx +++ b/cow-protocol/reference/core/tokens.mdx @@ -1,6 +1,6 @@ --- title: "Supported tokens" -description: "CoW Protocol supports tokens. However, not all token contracts are created equal, despite the idea of a standard interface. Some contracts introduce issues, such as fee on transfer or lockup periods, which make them unsuitable." +description: "ERC-20 token requirements for trading on CoW Protocol, including unsupported token types like fee-on-transfer and rebasing tokens." --- ## Requirements diff --git a/cow-protocol/reference/sdks/cow-sdk.mdx b/cow-protocol/reference/sdks/cow-sdk.mdx index c9f2c6f..2c94f4c 100644 --- a/cow-protocol/reference/sdks/cow-sdk.mdx +++ b/cow-protocol/reference/sdks/cow-sdk.mdx @@ -1,5 +1,6 @@ --- title: "CoW SDK" +description: "CoW Protocol TypeScript SDK for building trading applications with order management, signing, and subgraph queries." hidden: true --- diff --git a/cow-protocol/tutorials/cow-amm-deployer.mdx b/cow-protocol/tutorials/cow-amm-deployer.mdx index c1e8a83..1083263 100644 --- a/cow-protocol/tutorials/cow-amm-deployer.mdx +++ b/cow-protocol/tutorials/cow-amm-deployer.mdx @@ -1,6 +1,7 @@ --- -title: "CoW AMM Deployer" -description: "The is a user-friendly Safe App that simplifies the process of deploying and managing (Automated Market Makers) from Safe wallets. It enables users without programming skills to take advantage of the benefits of CoW AMM." +title: "Deploying a CoW AMM Using Balancer" +sidebarTitle: "CoW AMM deployer" +description: "Deploy and manage CoW AMM pools from your Safe wallet using the CoW AMM Deployer — no programming skills required." --- The app was developed by [bleu](https://github.com/bleu-fi) with sponsorship from the [CoW Grants DAO](https://grants.cow.fi/). diff --git a/cow-protocol/tutorials/cow-explorer/address.mdx b/cow-protocol/tutorials/cow-explorer/address.mdx index 6dcf44b..e1b4fb9 100644 --- a/cow-protocol/tutorials/cow-explorer/address.mdx +++ b/cow-protocol/tutorials/cow-explorer/address.mdx @@ -1,6 +1,6 @@ --- title: "By user address" -description: "A user may want to see the details of all orders that they have placed. When searching for their address, they will be presented with an overview of all orders that they have placed." +description: "Search CoW Explorer by wallet address to view all orders placed on CoW Protocol, with filtering and status information." --- For example, below the user has searched for their address [`0x2557...3af7`](https://explorer.cow.fi/gc/address/0x2557ed03e34f0141722a643589f007836a683af7) that contains multiple orders that were placed on CoW Protocol on Gnosis Chain: diff --git a/cow-protocol/tutorials/cow-explorer/batch-auction.mdx b/cow-protocol/tutorials/cow-explorer/batch-auction.mdx index 1bbe93d..5edcf79 100644 --- a/cow-protocol/tutorials/cow-explorer/batch-auction.mdx +++ b/cow-protocol/tutorials/cow-explorer/batch-auction.mdx @@ -1,6 +1,6 @@ --- title: "By batch auction" -description: "A batch auction is settled on-chain as a single transaction, and it is this transaction hash that is used to query the details of the batch auction. By simply searching for the transaction hash, the user will be presented with an overview of the batch auction." +description: "Search CoW Explorer by transaction hash to view batch auction details, including settled orders and routing graphs." --- The batch auction details page provides: diff --git a/cow-protocol/tutorials/cow-explorer/order.mdx b/cow-protocol/tutorials/cow-explorer/order.mdx index 7acfe8a..02a0a7d 100644 --- a/cow-protocol/tutorials/cow-explorer/order.mdx +++ b/cow-protocol/tutorials/cow-explorer/order.mdx @@ -1,6 +1,6 @@ --- title: "By order" -description: "A user may want to see the details of a specific order that they have placed. They can search for this order by its unique identifier, the . This identifier is returned when an order is placed and can be used to query the details of the order." +description: "Search CoW Explorer by order UID to view order details, fill status, surplus earned, and settlement information." --- diff --git a/cow-protocol/tutorials/solvers/local_test.mdx b/cow-protocol/tutorials/solvers/local_test.mdx index 3a97f5e..2fcf8db 100644 --- a/cow-protocol/tutorials/solvers/local_test.mdx +++ b/cow-protocol/tutorials/solvers/local_test.mdx @@ -1,6 +1,7 @@ --- title: "Locally testing a solver with the CoW Protocol orderflow" -description: "CoW Protocol infrastructure is a lot of services running together in herd harmony, which is a bit intimidating at the beginning. Before proceeding, it would be advisable to read the architectural overview to get a better understanding of how CoW Protocol works and its entities." +sidebarTitle: "Local solver testing" +description: "Set up a local testing environment for your CoW Protocol solver using the autopilot, driver, and solver engine components." --- In order to test a solver against CoW Protocol's orderflow, one needs to locally run the following components diff --git a/cow-protocol/tutorials/token-approvals.mdx b/cow-protocol/tutorials/token-approvals.mdx index b6169dc..aa9fc34 100644 --- a/cow-protocol/tutorials/token-approvals.mdx +++ b/cow-protocol/tutorials/token-approvals.mdx @@ -1,5 +1,6 @@ --- title: "Token Approvals & GPv2VaultRelayer" +sidebarTitle: "Token approvals" description: "How to approve tokens for trading on CoW Protocol — standard approvals, gasless approvals, and per-chain VaultRelayer addresses." --- diff --git a/cow-py/api/contracts.mdx b/cow-py/api/contracts.mdx index 2cbeb5a..0708d06 100644 --- a/cow-py/api/contracts.mdx +++ b/cow-py/api/contracts.mdx @@ -1,6 +1,6 @@ --- title: "Contracts API" -description: "Order creation, signing, and domain utilities" +description: "CoW Protocol Python SDK contracts API for order creation, signing, and domain utilities." --- ## Order diff --git a/cow-py/api/subgraph.mdx b/cow-py/api/subgraph.mdx index 078e991..cf03fa7 100644 --- a/cow-py/api/subgraph.mdx +++ b/cow-py/api/subgraph.mdx @@ -1,6 +1,6 @@ --- title: "SubgraphClient" -description: "Client for querying CoW Protocol subgraph data" +description: "SubgraphClient API reference for querying CoW Protocol trading volumes, totals, and historical data." --- The `SubgraphClient` class provides methods to query historical data from the CoW Protocol subgraph, including trading volumes, totals, and other aggregated metrics. diff --git a/cow-py/installation.mdx b/cow-py/installation.mdx index 13844ed..874a98a 100644 --- a/cow-py/installation.mdx +++ b/cow-py/installation.mdx @@ -1,6 +1,6 @@ --- title: "Installation" -description: "Learn how to install the CoW Protocol Python SDK" +description: "Install the CoW Protocol Python SDK (cow-py) with pip, including prerequisites and optional dependencies." --- ## Prerequisites diff --git a/cow-sdk/guides/erc1271-signing.mdx b/cow-sdk/guides/erc1271-signing.mdx index 925856b..e7c8467 100644 --- a/cow-sdk/guides/erc1271-signing.mdx +++ b/cow-sdk/guides/erc1271-signing.mdx @@ -1,5 +1,6 @@ --- title: "ERC-1271 Signing (Custom Contracts)" +sidebarTitle: "ERC-1271 signing" description: "How to place CoW Protocol orders from custom smart contracts using ERC-1271 off-chain signatures — for vaults, DAOs, treasuries, and any non-EOA wallet." --- diff --git a/cow-swap/features.mdx b/cow-swap/features.mdx index e7e9255..2ac53fb 100644 --- a/cow-swap/features.mdx +++ b/cow-swap/features.mdx @@ -1,6 +1,6 @@ --- title: "CoW Swap" -description: "CoW Swap is the first interface built on top of CoW Protocol and serves as a reference implementation for developers wishing to build user interfaces for CoW Protocol." +description: "CoW Swap is the primary trading interface for CoW Protocol, offering MEV protection, gasless swaps, and multiple order types." --- The interface may look very familiar to the average DeFi user, as it is originally based on the [Uniswap](https://uniswap.org) interface. This provides users with a familiar user experience, while benefiting from the unique features of CoW Protocol. diff --git a/cow-swap/hooks/hook-dapp.mdx b/cow-swap/hooks/hook-dapp.mdx index a9ade83..66466ff 100644 --- a/cow-swap/hooks/hook-dapp.mdx +++ b/cow-swap/hooks/hook-dapp.mdx @@ -1,5 +1,6 @@ --- title: "CoW Hook dApp" +description: "Build a CoW Hook dApp to let users attach custom pre-swap and post-swap Ethereum actions to their CoW Swap orders." --- ### [What are CoW Hooks?](/cow-protocol/explanation/order-types/cow-hooks) diff --git a/cow-swap/reference/custom-links.mdx b/cow-swap/reference/custom-links.mdx index 9404bb5..a8c73ab 100644 --- a/cow-swap/reference/custom-links.mdx +++ b/cow-swap/reference/custom-links.mdx @@ -1,6 +1,6 @@ --- title: "Custom Links" -description: "CoW Swap supports URL query parameters to allow anyone to create a custom link for sharing a specific trade with a friend or on social media, or for creating a custom link to a specific trade for your own use." +description: "CoW Swap URL query parameters for creating custom trade links — specify tokens, amounts, networks, and order types." --- ### Examples diff --git a/cow-swap/tutorials/dca-twap.mdx b/cow-swap/tutorials/dca-twap.mdx index c6b2d08..389ef6e 100644 --- a/cow-swap/tutorials/dca-twap.mdx +++ b/cow-swap/tutorials/dca-twap.mdx @@ -1,5 +1,6 @@ --- title: "Dollar-Cost Averaging with TWAP" +sidebarTitle: "DCA with TWAP" description: "Build a dollar-cost averaging strategy using TWAP orders to accumulate tokens over time" --- diff --git a/cow-swap/tutorials/native.mdx b/cow-swap/tutorials/native.mdx index b719305..9061edf 100644 --- a/cow-swap/tutorials/native.mdx +++ b/cow-swap/tutorials/native.mdx @@ -1,6 +1,6 @@ --- title: "Native tokens" -description: "In blockchain networks the \"native token\" - for example, Ether (ETH) on Ethereum, Arbitrum One and Base, and xDAI (xDAI) on Gnosis Chain - is the primary digital currency. It's essential for network operations, like paying transaction fees." +description: "How to trade native tokens like ETH and xDAI on CoW Swap, including wrapping, Eth-flow for selling, and gasless swaps." --- "Wrapped" tokens - for example, Wrapped Ether (WETH) & Wrapped xDAI (wxDAI) - are [`ERC-20`-compatible](https://ethereum.org/en/developers/docs/standards/tokens/%60ERC-20%60/) versions of these native tokens. diff --git a/cow-swap/tutorials/twap.mdx b/cow-swap/tutorials/twap.mdx index e1ac4ec..80bb454 100644 --- a/cow-swap/tutorials/twap.mdx +++ b/cow-swap/tutorials/twap.mdx @@ -1,6 +1,6 @@ --- title: "TWAP orders" -description: "Time-Weighted Average Price (TWAP) orders are an advanced feature of CoW Protocol, ideal for executing large trades with minimal price impact by distributing the order over a specified time." +description: "How to place TWAP orders on CoW Swap to execute large trades with minimal price impact over a specified time period." --- ## Introduction diff --git a/cow-swap/widget/overview.mdx b/cow-swap/widget/overview.mdx index 5c669bc..e4b2bde 100644 --- a/cow-swap/widget/overview.mdx +++ b/cow-swap/widget/overview.mdx @@ -1,6 +1,6 @@ --- title: "Widget Integration" -description: "The CoW Widget is the fastest way to integrate CoW Protocol's trading functionality into your application. It provides a complete, pre-built trading interface that can be embedded with just a few lines of code." +description: "Embed CoW Protocol trading in your app with the CoW Widget — a pre-built React component with full swap functionality." --- ## Overview diff --git a/cow-swap/widget/params.mdx b/cow-swap/widget/params.mdx index 01dd1a1..be9d554 100644 --- a/cow-swap/widget/params.mdx +++ b/cow-swap/widget/params.mdx @@ -1,6 +1,6 @@ --- title: "CoW Swap Widget" -description: "Integrate the power of into your product! With the widget, you can create an incredible trading interface. Specify the required pair of currencies, customize the look and much more!" +description: "Configuration reference for the CoW Swap Widget — customize token pairs, themes, fees, and trading parameters." --- Create your own widget using the configurator [https://widget.cow.fi](https://widget.cow.fi). diff --git a/governance.mdx b/governance.mdx index 2fdb162..2aa0283 100644 --- a/governance.mdx +++ b/governance.mdx @@ -1,5 +1,6 @@ --- title: "Governance" +description: "Overview of CoW DAO's governance structure, including the COW token, Snapshot voting, and the proposal process." --- > This site represents the current governance structure of CoW DAO. diff --git a/governance/explanation/grants/grant-types.mdx b/governance/explanation/grants/grant-types.mdx index 207a88d..62d9ea5 100644 --- a/governance/explanation/grants/grant-types.mdx +++ b/governance/explanation/grants/grant-types.mdx @@ -1,6 +1,6 @@ --- title: "Grant Types" -description: "The CoW Grants Program offers different types of grants to accommodate various project needs. Understanding the differences will help you choose the most appropriate structure for your proposal." +description: "CoW Grants Program grant types — milestone-based and retroactive grants, with guidance on choosing the right structure." --- ## Milestone-Based Grants diff --git a/governance/explanation/mission.mdx b/governance/explanation/mission.mdx index c282543..835d44c 100644 --- a/governance/explanation/mission.mdx +++ b/governance/explanation/mission.mdx @@ -1,6 +1,6 @@ --- title: "Mission statement" -description: "CoW DAO is an open organization of developers, market makers, and community contributors on a mission to create a fairer, more-protective financial system. CoW DAO currently supports CoW Swap and CoW Protocol – decentralized trading products that leverage order flow auctions to shield users from MEV attacks and give them more than they ask for." +description: "CoW DAO's mission to build a fairer financial system through CoW Swap and CoW Protocol, shielding users from MEV with order flow auctions." --- ## Vision diff --git a/governance/explanation/process.mdx b/governance/explanation/process.mdx index 0ffa715..c914e98 100644 --- a/governance/explanation/process.mdx +++ b/governance/explanation/process.mdx @@ -1,5 +1,6 @@ --- title: "Governance Process" +description: "How CoW DAO governance proposals move from forum discussion through Snapshot voting to on-chain execution." --- > This site represents the current governance structure of CoW DAO. diff --git a/governance/explanation/token.mdx b/governance/explanation/token.mdx index d43f91b..2f1a058 100644 --- a/governance/explanation/token.mdx +++ b/governance/explanation/token.mdx @@ -1,6 +1,6 @@ --- title: "Token" -description: "At the core of CoW Protocol lies the COW token, which serves as a governance token within the CoW Protocol ecosystem, allowing stakeholders to participate directly in the decision-making processes that guide the protocol's development and evolution. The governance framework is designed to align incentives between the protocol's users, developers, and supporters, creating a robust and community-driven governance system." +description: "The COW token is the governance token for CoW DAO, enabling stakeholders to participate in protocol decision-making and development." --- ### Contract Address diff --git a/governance/reference/cip-template.mdx b/governance/reference/cip-template.mdx index 869358a..b294c9a 100644 --- a/governance/reference/cip-template.mdx +++ b/governance/reference/cip-template.mdx @@ -1,5 +1,6 @@ --- title: "CIP Template" +description: "Template for creating CoW DAO Improvement Proposals (CIPs), including required sections and formatting guidelines." --- > 📜 This template is to be used to create any new CoW DAO Improvement Proposal. diff --git a/governance/reference/fees.mdx b/governance/reference/fees.mdx index 27b1be3..1b4da4b 100644 --- a/governance/reference/fees.mdx +++ b/governance/reference/fees.mdx @@ -1,5 +1,6 @@ --- title: "Fees" +description: "Current fee models active on CoW Protocol, including protocol fees, volume-based fees, and surplus fees for different order types." --- diff --git a/governance/reference/partner-fee.mdx b/governance/reference/partner-fee.mdx index 4f7dff0..75458cd 100644 --- a/governance/reference/partner-fee.mdx +++ b/governance/reference/partner-fee.mdx @@ -1,5 +1,6 @@ --- title: "Partner fee" +description: "How CoW Protocol partner fees are calculated, collected in WETH, and distributed to integrators via appData configuration." --- ### Partner Fee Calculation diff --git a/hooks-trampoline/api/errors.mdx b/hooks-trampoline/api/errors.mdx index 65ff352..b8d3b15 100644 --- a/hooks-trampoline/api/errors.mdx +++ b/hooks-trampoline/api/errors.mdx @@ -1,6 +1,6 @@ --- title: "Errors" -description: "Error types in the HooksTrampoline contract" +description: "Custom error types in the HooksTrampoline contract, including access control and execution failure errors." --- The HooksTrampoline contract defines custom errors for access control and execution failures. diff --git a/mevblocker.mdx b/mevblocker.mdx index 14d9964..5da034b 100644 --- a/mevblocker.mdx +++ b/mevblocker.mdx @@ -1,6 +1,6 @@ --- title: "MEV Blocker" -description: "MEV Blocker Update" +description: "MEV Blocker has been acquired — read the announcement and learn about the transition." hidden: true --- diff --git a/watch-tower/advanced/storage.mdx b/watch-tower/advanced/storage.mdx index a215ca5..d429290 100644 --- a/watch-tower/advanced/storage.mdx +++ b/watch-tower/advanced/storage.mdx @@ -1,6 +1,6 @@ --- title: "Storage Architecture" -description: "How the Watch Tower persists state using LevelDB" +description: "How the CoW Protocol Watch Tower persists state using LevelDB, including key schemas and data management." --- # Storage Architecture diff --git a/watch-tower/deployment/dappnode.mdx b/watch-tower/deployment/dappnode.mdx index bf1921e..2ffa535 100644 --- a/watch-tower/deployment/dappnode.mdx +++ b/watch-tower/deployment/dappnode.mdx @@ -1,6 +1,6 @@ --- title: "DAppNode Deployment" -description: "Deploy the CoW Protocol Watch Tower on DAppNode" +description: "Deploy the CoW Protocol Watch Tower on DAppNode for monitoring and executing programmatic orders." --- # DAppNode Deployment diff --git a/watch-tower/deployment/docker.mdx b/watch-tower/deployment/docker.mdx index d1893cc..d3e097b 100644 --- a/watch-tower/deployment/docker.mdx +++ b/watch-tower/deployment/docker.mdx @@ -1,6 +1,6 @@ --- title: "Docker Deployment" -description: "Deploy the CoW Protocol Watch Tower using Docker" +description: "Deploy the CoW Protocol Watch Tower using Docker containers for monitoring programmatic orders on-chain." --- # Docker Deployment