Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/cow-protocol/reference/contracts/core/README.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -44,9 +44,9 @@ Take care when [signing](../core/signing-schemes), ensuring that the `EIP-712` d

| **Contracts** | **Address / Chains** |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [`GPv2Settlement`](core/settlement)<br />Upgradeable: No ❎<br />[GitHub](https://github.com/cowprotocol/contracts/blob/main/src/contracts/GPv2Settlement.sol) | `0x9008D19f58AAbD9eD0D60971565AA8510560ab41`<br />{explorerLinks(["Arbitrum One","Avalanche","Base","BNB","Ethereum","Gnosis","Ink","Linea","Optimism","Plasma","Polygon","Sepolia",], "0x9008D19f58AAbD9eD0D60971565AA8510560ab41", {separator: <br />})} |
| [`GPv2AllowListAuthentication`](core/allowlist)<br />Upgradeable: Yes ⚠️<br />[GitHub](https://github.com/cowprotocol/contracts/blob/main/src/contracts/GPv2AllowListAuthentication.sol) | `0x2c4c28DDBdAc9C5E7055b4C863b72eA0149D8aFE`<br />{explorerLinks(["Arbitrum One","Avalanche","Base","BNB","Ethereum","Gnosis","Ink","Linea","Optimism","Plasma","Polygon","Sepolia",], "0x2c4c28DDBdAc9C5E7055b4C863b72eA0149D8aFE", {separator: <br />})} |
| [`GPv2VaultRelayer`](core/vault-relayer)<br />Upgradeable: No ❎<br />[GitHub](https://github.com/cowprotocol/contracts/blob/main/src/contracts/GPv2VaultRelayer.sol) | `0xC92E8bdf79f0507f65a392b0ab4667716BFE0110`<br />{explorerLinks(["Arbitrum One","Avalanche","Base","BNB","Ethereum","Gnosis","Ink","Linea","Optimism","Plasma","Polygon","Sepolia",], "0xC92E8bdf79f0507f65a392b0ab4667716BFE0110", {separator: <br />})} |
| [`GPv2Settlement`](core/settlement)<br />Upgradeable: No ❎<br />[GitHub](https://github.com/cowprotocol/contracts/blob/main/src/contracts/GPv2Settlement.sol) | `0x9008D19f58AAbD9eD0D60971565AA8510560ab41`<br />{explorerLinks(["Arbitrum One","Avalanche","Base","BNB","Ethereum","Gnosis","Ink","Linea","Optimism","Plasma","Polygon","Robinhood","Sepolia",], "0x9008D19f58AAbD9eD0D60971565AA8510560ab41", {separator: <br />})} |
| [`GPv2AllowListAuthentication`](core/allowlist)<br />Upgradeable: Yes ⚠️<br />[GitHub](https://github.com/cowprotocol/contracts/blob/main/src/contracts/GPv2AllowListAuthentication.sol) | `0x2c4c28DDBdAc9C5E7055b4C863b72eA0149D8aFE`<br />{explorerLinks(["Arbitrum One","Avalanche","Base","BNB","Ethereum","Gnosis","Ink","Linea","Optimism","Plasma","Polygon","Robinhood","Sepolia",], "0x2c4c28DDBdAc9C5E7055b4C863b72eA0149D8aFE", {separator: <br />})} |
| [`GPv2VaultRelayer`](core/vault-relayer)<br />Upgradeable: No ❎<br />[GitHub](https://github.com/cowprotocol/contracts/blob/main/src/contracts/GPv2VaultRelayer.sol) | `0xC92E8bdf79f0507f65a392b0ab4667716BFE0110`<br />{explorerLinks(["Arbitrum One","Avalanche","Base","BNB","Ethereum","Gnosis","Ink","Linea","Optimism","Plasma","Polygon","Robinhood","Sepolia",], "0xC92E8bdf79f0507f65a392b0ab4667716BFE0110", {separator: <br />})} |

<details close>
<summary>Upgradeable allow-list</summary>
Expand Down
6 changes: 4 additions & 2 deletions docs/cow-protocol/reference/contracts/periphery/README.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ Peripheral contracts are those that are not necessary for CoW Protocol to functi

| Environment | Address | Networks |
| ------------------------ | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Production (all chains) | `0xbA3cB449bD2B4ADddBc894D8697F5170800EAdeC` | {explorerLinks(["Ethereum","Gnosis","Arbitrum One","Base","Avalanche","Polygon","BNB","Linea","Plasma","Ink","Sepolia"], "0xbA3cB449bD2B4ADddBc894D8697F5170800EAdeC")} |
| Staging (all chains) | `0x04501b9b1D52e67f6862d157E00D13419D2D6E95` | {explorerLinks(["Ethereum","Gnosis","Arbitrum One","Base","Avalanche","Polygon","BNB","Linea","Plasma","Ink","Sepolia"], "0x04501b9b1D52e67f6862d157E00D13419D2D6E95")} |
| Production (all chains) | `0xbA3cB449bD2B4ADddBc894D8697F5170800EAdeC` | {explorerLinks(["Ethereum","Gnosis","Arbitrum One","Base","Avalanche","Polygon","BNB","Linea","Plasma","Ink","Robinhood","Sepolia"], "0xbA3cB449bD2B4ADddBc894D8697F5170800EAdeC")} |
| Staging (all chains) | `0x04501b9b1D52e67f6862d157E00D13419D2D6E95` | {explorerLinks(["Ethereum","Gnosis","Arbitrum One","Base","Avalanche","Polygon","BNB","Linea","Plasma","Ink","Robinhood","Sepolia"], "0x04501b9b1D52e67f6862d157E00D13419D2D6E95")} |

:::warning

Expand Down Expand Up @@ -52,6 +52,7 @@ You should not assume that the HooksTrampoline contract address will remain fixe
"Optimism",
"Plasma",
"Polygon",
"Robinhood",
"Sepolia",
], "0x60Bf78233f48eC42eE3F101b9a05eC7878728006")}

Expand All @@ -77,6 +78,7 @@ You should not assume that the HooksTrampoline contract address will remain fixe
"Linea",
"Plasma",
"Polygon",
"Robinhood",
"Sepolia",
], "0xfdaFc9d1902f4e0b84f65F49f244b32b31013b74")}

Expand Down
2 changes: 2 additions & 0 deletions docs/cow-protocol/reference/core/auctions/bonding_pools.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,8 @@ Vouching contracts:
- [BNB](https://bscscan.com/address/0xAAA4De096D02AE21729aA31D967E148D4e3Ae501)
- [Linea](https://lineascan.build/address/0xAAA4De096D02AE21729aA31D967E148D4e3Ae501)
- [Plasma](https://plasmascan.to/address/0xAAA4De096D02AE21729aA31D967E148D4e3Ae501#code)
- [Ink](https://explorer.inkonchain.com/address/0xAAA4De096D02AE21729aA31D967E148D4e3Ae501)
- [Robinhood](https://robin.etherscan.io/address/0xAAA4De096D02AE21729aA31D967E148D4e3Ae501)

The `Vouch` method receives a list as an argument and can vouch for multiple submission addresses in a single transaction. The transaction must contain: the submission address for the solver, the bonding pool that is vouching for the solver, and the rewards address that the solver would like to use to receive their [rewards](/cow-protocol/reference/core/auctions/rewards).

Expand Down
13 changes: 11 additions & 2 deletions docs/cow-protocol/reference/core/auctions/competition_rules.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,13 +61,14 @@ The deadline for solutions depends on the network and is set as a specific numbe
- Mainnet: 1 block
- Gnosis chain: 3 blocks
- Arbitrum: 11 blocks
- Base: 4 blocks
- Base: 13 blocks
- Avalanche: 8 blocks
- Polygon: 8 blocks
- BNB: 5 blocks
- BNB: 7 blocks
- Linea: 4 blocks
- Plasma: 5 blocks
- Ink: 5 blocks
- Robinhood: 23 blocks
<!-- Blocks defined here https://github.com/cowprotocol/infrastructure/blob/staging/services/autopilot/config/index.ts#L21 -->

:::
Expand Down Expand Up @@ -157,6 +158,14 @@ At CoW DAO's discretion, systematic violation of these rules may lead to penaliz

</details>

<details>
<summary>Robinhood chain baseline protocols and tokens</summary>

- **Protocols**: Uniswap v3
- **Base tokens**: [`WETH`](https://robin.etherscan.io/token/0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73), [`USDG`](https://robin.etherscan.io/token/0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168)

</details>

More details about how a certificate of an EBBO violation is computed, and what are the steps taken in case such a violation occurs can be found in [this](ebbo-rules) section.

- Inflation of the score ([CIP-11](https://snapshot.org/#/cow.eth/proposal/0x16d8c681d52b24f1ccd854084e07a99fce6a7af1e25fd21ddae6534b411df870)). Using tokens for the sole purpose of inflating the score of a solution or maximizing the reward is forbidden (e.g., by creating fake tokens, or wash-trading with real tokens).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,10 +16,11 @@ The penalty cap for fast-path orders is currently set to zero, so an unfilled fa
- Mainnet: 1 block
- Gnosis chain: 1 block
- Arbitrum: 8 blocks
- Base: 1 block
- Base: 10 blocks
- Avalanche: 2 blocks
- Polygon: 2 blocks
- BNB: 5 blocks
- Linea: 1 block
- Plasma: 2 blocks
- Ink: 2 blocks
- Robinhood: 20 blocks
3 changes: 2 additions & 1 deletion docs/cow-protocol/reference/core/auctions/rewards.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ The performance reward is capped from above and below using the function $$\text
The upper cap $$c_u$$ is equal to a chain-specific fraction $$\beta$$ of the protocol fee (excluding partner fees) that the protocol earned from the trades in all solutions successfully executed on-chain by the solver in that auction. $$\beta$$ is determined by the following values:

- Ethereum mainnet, Arbitrum, Base chain, and BNB: $$\beta = 50\%$$
- Gnosis Chain, Avalanche, Polygon, Linea, Ink, and Plasma: $$\beta = 100\%$$
- Gnosis Chain, Avalanche, Polygon, Linea, Ink, Plasma, and Robinhood: $$\beta = 100\%$$

The parameter $$\beta$$, which naturally corresponds to a revenue-sharing parameter between protocol and solvers, is set to 50% by default. The core team has a mandate to change this parameter for individual networks, if needed, to a value in the interval [50%, 100%], given that the network has a total revenue less than 5% of the total protocol revenue.

Expand Down Expand Up @@ -78,6 +78,7 @@ The fraction $$\phi_o$$ depends on the chain and on whether the two tokens trade
- Linea: $$2 \;\textrm{bps}$$
- Ink: $$1 \;\textrm{bps}$$
- Plasma: $$1 \;\textrm{bps}$$
- Robinhood: $$1 \;\textrm{bps}$$

These caps are chosen such that solvers settle their winning solutions with a high probability, given estimates of price movements during the window of exclusivity, i.e., the time between the moment a solver is notified that it won and the deadline by which the auction has to be settled. The core team has a mandate to change the penalty cap per order within the interval [0 bps, 10 bps], if needed, to tune the trade-off between competitive prices and fast execution. Any change to the penalty cap is announced to solvers in advance and reflected in this documentation.

Expand Down
2 changes: 2 additions & 0 deletions docs/cow-protocol/reference/core/signing_schemes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,7 @@ For convenience, the domain separator is exposed as a public view function in th
"Linea",
"Plasma",
"Polygon",
"Robinhood",
"Sepolia",
], "0x9008D19f58AAbD9eD0D60971565AA8510560ab41", {separator: <br />, urlTrailing: "#readContract#F2"})}

Expand Down Expand Up @@ -136,6 +137,7 @@ For convenience, we also deployed a small helper contract that makes it easy to
- Linea N/A
- Plasma N/A
- Ink N/A
- Robinhood N/A
- {explorerLinks("Sepolia", "0x59Ffd6c1823F212D49887230f155A35451FdDbfa", {urlTrailing: "#readContract#F1"})}

## Supported schemes
Expand Down
1 change: 1 addition & 0 deletions docs/cow-protocol/tutorials/cow-swap/custom-links.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,7 @@ Native and wrapped tokens per chain:
- Linea: [`WETH`](https://lineascan.build/token/0xe5D7C2a44FfDDf6b295A15c148167daaAf5Cf34f) - wrapped `ETH`
- Plasma: [`WXPL`](https://plasmascan.to/token/0x6100E367285b01F48D07953803A2d8dCA5D19873) - wrapped `XPL`
- Ink: [`WETH`](https://explorer.inkonchain.com/token/0x4200000000000000000000000000000000000006) - wrapped `ETH`
- Robinhood: [`WETH`](https://robin.etherscan.io/token/0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73) - wrapped `ETH`
- Sepolia: [`WETH`](https://sepolia.etherscan.io/address/0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14) - wrapped `ETH`

:::
2 changes: 2 additions & 0 deletions docs/cow-protocol/tutorials/solvers/local_test.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,5 +66,7 @@ Once the above are set up and running, one can then start testing their solver e
| <https://api.cow.fi/plasma/api> | Plasma | Production |
| <https://barn.api.cow.fi/ink/api> | Ink | Staging |
| <https://api.cow.fi/ink/api> | Ink | Production |
| <https://barn.api.cow.fi/robinhood/api> | Robinhood | Staging |
| <https://api.cow.fi/robinhood/api> | Robinhood | Production |
| <https://barn.api.cow.fi/sepolia/api> | Sepolia | Staging |
| <https://api.cow.fi/sepolia/api> | Sepolia | Production |
2 changes: 2 additions & 0 deletions docs/governance/token.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ At the core of CoW Protocol lies the COW token, which serves as a governance tok
| Linea | N/A |
| Plasma | N/A |
| Ink | N/A |
| Robinhood | N/A |

[^bridgedTokens]:
These contracts were not developed nor deployed by CoW DAO, however, they are the bridged versions of the canonical token from Ethereum, using the official bridges.
Expand All @@ -44,6 +45,7 @@ At the core of CoW Protocol lies the COW token, which serves as a governance tok
| Linea | N/A |
| Plasma | N/A |
| Ink | N/A |
| Robinhood | N/A |

## Supply & Inflation Schedule

Expand Down
1 change: 1 addition & 0 deletions src/components/contract-addresses/index.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ export const explorerByChain = {
"Plasma": "https://plasmascan.to",
"Optimism": "https://optimistic.etherscan.io",
"Ink": "https://explorer.inkonchain.com",
"Robinhood": "https://robin.etherscan.io",
} as const;

export type ChainName = keyof typeof explorerByChain;
Expand Down
Loading