CoW Protocol Solver Rewards

Data aggregation pipeline for computing and distributing weekly solver reimbursements and COW token rewards across multiple EVM networks.

CoW Protocol Solver Rewards automates the weekly accounting process that reimburses solvers for execution costs and distributes COW token rewards across Ethereum, Gnosis Chain, Arbitrum, Base, and other supported networks.

The pipeline fetches on-chain data from Dune Analytics and the CoW Protocol orderbook database, computes per-solver payouts based on batch performance, quote accuracy, and slippage, then posts multi-send transactions to a Gnosis Safe for execution.

Quickstart

Install dependencies, configure credentials, and generate your first payout file in minutes.

Configuration

Set up environment variables for Dune, the orderbook DB, Ethereum nodes, and the payout Safe.

Reward Mechanism

Understand how batch rewards, quote rewards, slippage, and service fees are calculated.

Generating Payouts

Run the transfer file script for any accounting period, with or without auto-posting to Safe.

How it works

1. Fetch on-chain data

   The pipeline queries Dune Analytics for block intervals, slippage data, and network-level metrics, and queries the CoW Protocol analytics database for per-solver batch and quote reward data.

2. Compute payouts

   Solver rewards are calculated from primary batch rewards (COW + native token), quote rewards (COW), protocol fees, partner fees, and slippage adjustments. Solvers with net-negative payouts are recorded as overdrafts.

3. Generate transfer files or post transactions

   Results are either written to CSV files for manual review and upload to the Safe app, or encoded as multi-send transactions and posted directly to the Gnosis Safe from the proposer account.

4. Validate and execute

   The team reviews the proposed transaction against the Dune dashboard, then executes the multi-send to distribute COW token and native token payments to all eligible solvers.

Supported networks

The pipeline supports 10 EVM networks with per-network reward and payment configurations:

Ethereum Mainnet

Primary network for COW token rewards and WETH reimbursements.

Gnosis Chain

xDAI-based network with adjusted quote reward caps.

Arbitrum One

L2 network with lower minimum transfer thresholds.

Base

Coinbase L2 with ETH-based native token payments.

Avalanche

AVAX native token with wrapped ETH exchange rates.

+ 5 more

Polygon, BNB, Linea, Plasma, and Ink.

Key concepts

Accounting periods

Weekly 7-day intervals that define the scope of each payout run.

Slippage accounting

Per-settlement token imbalance evaluation used to adjust solver reimbursements.

Overdrafts

On-chain tracking of solvers whose net payout is negative.

Safe multisend

Batch transaction encoding and posting via Gnosis Safe.