From d0a176882c10d39cbf41662247cefeb3e1c89a64 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Emanuel=20Tesa=C5=99?= Date: Tue, 14 Oct 2025 09:31:21 +0200 Subject: [PATCH 1/4] Add warning message --- docs/oev-searchers/index.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/oev-searchers/index.md b/docs/oev-searchers/index.md index 4d380b89..c3aa1e3a 100644 --- a/docs/oev-searchers/index.md +++ b/docs/oev-searchers/index.md @@ -75,6 +75,12 @@ searchers. ## How do auctions work? +::: info ⚠️ Warning + +At the moment, we're working on the major updates to the OEV mechanism and as part of that there is no OEV Network nor OEV Auctioneer. In the meantime, we're working with partnered searchers to continue with seamless OEV recapture for our dApps. Note, that there is no change to how our data works and [MEV with Signed APIs](in-depth/mev-with-signed-apis.md) works as before. + +::: + Api3 uses a combination of the [OEV Network](#oev-network) and the [OEV Auctioneer](#oev-auctioneer) to power the OEV auctions in a secure and transparent way. From 6ac56306563a933374f4fc103a9515158cee39d9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Emanuel=20Tesa=C5=99?= Date: Tue, 14 Oct 2025 09:35:18 +0200 Subject: [PATCH 2/4] Review --- docs/oev-searchers/index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/oev-searchers/index.md b/docs/oev-searchers/index.md index c3aa1e3a..a1c90454 100644 --- a/docs/oev-searchers/index.md +++ b/docs/oev-searchers/index.md @@ -77,7 +77,9 @@ searchers. ::: info ⚠️ Warning -At the moment, we're working on the major updates to the OEV mechanism and as part of that there is no OEV Network nor OEV Auctioneer. In the meantime, we're working with partnered searchers to continue with seamless OEV recapture for our dApps. Note, that there is no change to how our data works and [MEV with Signed APIs](in-depth/mev-with-signed-apis.md) works as before. +At the moment, we're working on major updates to the OEV mechanism. As part of this transition, there is currently no public OEV Network and OEV Auctioneer. In the meantime, we're working with partnered searchers to continue seamless OEV recapture for our partnered dApps. These changes are transitional and will allow us to feature a more efficient OEV platform. + +Note that there is no change to how our data works, and [MEV with Signed APIs](in-depth/mev-with-signed-apis.md) works as before. ::: From dddbb58c14c89949818d585d20ea616cfe3537df Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Emanuel=20Tesa=C5=99?= Date: Tue, 14 Oct 2025 09:47:05 +0200 Subject: [PATCH 3/4] Add the alert on every OEV page --- .../in-depth/data-feeds/index.md | 8 + docs/oev-searchers/in-depth/index.md | 8 + docs/oev-searchers/in-depth/oev-auctioneer.md | 8 + .../in-depth/oev-network/index.md | 59 +- .../in-depth/oev-network/oev-network.svg | 742 ------------------ docs/oev-searchers/in-depth/oev-searching.md | 8 + 6 files changed, 39 insertions(+), 794 deletions(-) delete mode 100644 docs/oev-searchers/in-depth/oev-network/oev-network.svg diff --git a/docs/oev-searchers/in-depth/data-feeds/index.md b/docs/oev-searchers/in-depth/data-feeds/index.md index 15008d99..17d4363b 100644 --- a/docs/oev-searchers/in-depth/data-feeds/index.md +++ b/docs/oev-searchers/in-depth/data-feeds/index.md @@ -110,6 +110,14 @@ not updated for a particular amount time. ## OEV updates +::: info ⚠️ Warning + +At the moment, we're working on major updates to the OEV mechanism. As part of this transition, there is currently no public OEV Network and OEV Auctioneer. In the meantime, we're working with partnered searchers to continue seamless OEV recapture for our partnered dApps. These changes are transitional and will allow us to feature a more efficient OEV platform. + +Note that there is no change to how our data works, and [MEV with Signed APIs](in-depth/mev-with-signed-apis.md) works as before. + +::: + After a dAPI is updated, the changed value is reflected across all protocols that use the particular dAPI. We call these "base feed updates" to differentiate them from the OEV updates, which are dApp-specific. These are made by the diff --git a/docs/oev-searchers/in-depth/index.md b/docs/oev-searchers/in-depth/index.md index 5114c264..019da2ad 100644 --- a/docs/oev-searchers/in-depth/index.md +++ b/docs/oev-searchers/in-depth/index.md @@ -8,6 +8,14 @@ outline: deep # Getting started +::: info ⚠️ Warning + +At the moment, we're working on major updates to the OEV mechanism. As part of this transition, there is currently no public OEV Network and OEV Auctioneer. In the meantime, we're working with partnered searchers to continue seamless OEV recapture for our partnered dApps. These changes are transitional and will allow us to feature a more efficient OEV platform. + +Note that there is no change to how our data works, and [MEV with Signed APIs](in-depth/mev-with-signed-apis.md) works as before. + +::: + This is a good starting place for searchers. It includes the list of good dApp candidates for searching, details how OEV auctions work and explains basic OEV searching strategy to simplify the onboarding of existing MEV searchers to OEV. diff --git a/docs/oev-searchers/in-depth/oev-auctioneer.md b/docs/oev-searchers/in-depth/oev-auctioneer.md index 045cc12d..c1cb01d5 100644 --- a/docs/oev-searchers/in-depth/oev-auctioneer.md +++ b/docs/oev-searchers/in-depth/oev-auctioneer.md @@ -8,6 +8,14 @@ outline: deep # OEV Auctioneer +::: info ⚠️ Warning + +At the moment, we're working on major updates to the OEV mechanism. As part of this transition, there is currently no public OEV Network and OEV Auctioneer. In the meantime, we're working with partnered searchers to continue seamless OEV recapture for our partnered dApps. These changes are transitional and will allow us to feature a more efficient OEV platform. + +Note that there is no change to how our data works, and [MEV with Signed APIs](in-depth/mev-with-signed-apis.md) works as before. + +::: + OEV Auctioneer is the off-chain system managed by the Api3 DAO to process auctions hosted on the OEV network. The honesty of OEV Auctioneer can be verified on-chain because the logic is based solely on the diff --git a/docs/oev-searchers/in-depth/oev-network/index.md b/docs/oev-searchers/in-depth/oev-network/index.md index a5ec0068..a922b7ce 100644 --- a/docs/oev-searchers/in-depth/oev-network/index.md +++ b/docs/oev-searchers/in-depth/oev-network/index.md @@ -8,7 +8,13 @@ outline: deep # OEV Network -![OEV Network image](./oev-network.svg) +::: info ⚠️ Warning + +At the moment, we're working on major updates to the OEV mechanism. As part of this transition, there is currently no public OEV Network and OEV Auctioneer. In the meantime, we're working with partnered searchers to continue seamless OEV recapture for our partnered dApps. These changes are transitional and will allow us to feature a more efficient OEV platform. + +Note that there is no change to how our data works, and [MEV with Signed APIs](in-depth/mev-with-signed-apis.md) works as before. + +::: The OEV Network operates as a standard Arbitrum Nitro L2 optimistic-rollup. The system ensures transparency and allows verification of the auction process. It allows searchers to place bids for the exclusive opportunity to @@ -29,48 +35,6 @@ To participate in auctions, searchers need to have a sufficient amount of ETH bridged to the OEV network and interact with the [OevAuctionHouse](#oevauctionhouse) contract. -## Using the OEV Network - -The OEV Network can be added as a custom network to any EVM compatible wallet. - -| Details | Value | -| ------------------ | ------------------------------ | -| Network | OEV Network | -| Chain ID | 4913 | -| RPC URL (HTTP) | https://oev.rpc.api3.org/http | -| RPC URL (WS) | https://oev.rpc.api3.org/ws | -| Symbol | ETH | -| Block Explorer URL | https://oev.explorer.api3.org/ | -| Bridge URL | https://oev.bridge.api3.org/ | - -## Properties - -Here are some of the key properties of the OEV Network: - -1. Block time - Under high load, the block time of the network can be as fast as - 250ms. Note that the OEV Network only produces blocks when there are - transactions. -2. Gas fees - The gas fees are paid in ETH, and because the network is an - optimistic L2 rollup, the gas fees are low and get cheaper with the increased number of transactions. -3. Using Anytrust - By using AnyTrust DAC, the OEV Network achieves further cost - reduction. - -See [Arbitrum Nitro details](https://docs.caldera.xyz/rollup-engine/about/nitro#benefits) and -[AnyTrust details](https://docs.caldera.xyz/rollup-engine/about/nitro#anytrust) for more -information. - -## Bridging ETH - -Use the [OEV Network bridge](https://oev.bridge.api3.org/) to bridge your ETH to -the OEV Network. Bridging is only possible from ETH mainnet. - -![OEV Network bridge](./oev-bridge.png) - -Clicking on `Transfer Tokens` will automatically add the OEV Network to your -Metamask wallet. To bridge, confirm the transaction in your wallet and wait for -confirmation. After the transaction is confirmed, you should see your ETH on the -OEV Network. - ## Api3ServerV1 The implementation of the audited Api3ServerV1 contract is publicly available @@ -274,12 +238,3 @@ how to use these functions, we need to understand how [OEV Auctioneer](/oev-searchers/in-depth/oev-auctioneer) works. Refer to the [Expediting a bid](/oev-searchers/in-depth/oev-searching#expediting-a-bid) section for more details. - -## Deployed contracts - -These are the relevant contracts deployed on the OEV Network: - -| Contract name | Address | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------ | -| Api3ServerV1 | [0x709944a48cAf83535e43471680fDA4905FB3920a](https://oev.explorer.api3.org/address/0x709944a48cAf83535e43471680fDA4905FB3920a) | -| OevAuctionHouse | [0x34f13A5C0AD750d212267bcBc230c87AEFD35CC5](https://oev.explorer.api3.org/address/0x34f13A5C0AD750d212267bcBc230c87AEFD35CC5) | diff --git a/docs/oev-searchers/in-depth/oev-network/oev-network.svg b/docs/oev-searchers/in-depth/oev-network/oev-network.svg deleted file mode 100644 index e6e52830..00000000 --- a/docs/oev-searchers/in-depth/oev-network/oev-network.svg +++ /dev/null @@ -1,742 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/docs/oev-searchers/in-depth/oev-searching.md b/docs/oev-searchers/in-depth/oev-searching.md index ca9cc405..855a8d08 100644 --- a/docs/oev-searchers/in-depth/oev-searching.md +++ b/docs/oev-searchers/in-depth/oev-searching.md @@ -8,6 +8,14 @@ outline: deep # OEV searching +::: info ⚠️ Warning + +At the moment, we're working on major updates to the OEV mechanism. As part of this transition, there is currently no public OEV Network and OEV Auctioneer. In the meantime, we're working with partnered searchers to continue seamless OEV recapture for our partnered dApps. These changes are transitional and will allow us to feature a more efficient OEV platform. + +Note that there is no change to how our data works, and [MEV with Signed APIs](in-depth/mev-with-signed-apis.md) works as before. + +::: + We assume that a searcher has an existing MEV bot and is familiar with the OEV Network and OEV Auctioneer. Let's glue these concepts together and detail the steps to start OEV searching. From 628c9a780a0ddd46f4775b35ad9e9cbb52e7bfa8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Emanuel=20Tesa=C5=99?= Date: Tue, 14 Oct 2025 09:49:44 +0200 Subject: [PATCH 4/4] Change to warning --- docs/oev-searchers/in-depth/data-feeds/index.md | 2 +- docs/oev-searchers/in-depth/index.md | 2 +- docs/oev-searchers/in-depth/oev-auctioneer.md | 2 +- docs/oev-searchers/in-depth/oev-network/index.md | 2 +- docs/oev-searchers/in-depth/oev-searching.md | 2 +- docs/oev-searchers/index.md | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/oev-searchers/in-depth/data-feeds/index.md b/docs/oev-searchers/in-depth/data-feeds/index.md index 17d4363b..c9fba1eb 100644 --- a/docs/oev-searchers/in-depth/data-feeds/index.md +++ b/docs/oev-searchers/in-depth/data-feeds/index.md @@ -110,7 +110,7 @@ not updated for a particular amount time. ## OEV updates -::: info ⚠️ Warning +::: warning ⚠️ Warning At the moment, we're working on major updates to the OEV mechanism. As part of this transition, there is currently no public OEV Network and OEV Auctioneer. In the meantime, we're working with partnered searchers to continue seamless OEV recapture for our partnered dApps. These changes are transitional and will allow us to feature a more efficient OEV platform. diff --git a/docs/oev-searchers/in-depth/index.md b/docs/oev-searchers/in-depth/index.md index 019da2ad..0abe7408 100644 --- a/docs/oev-searchers/in-depth/index.md +++ b/docs/oev-searchers/in-depth/index.md @@ -8,7 +8,7 @@ outline: deep # Getting started -::: info ⚠️ Warning +::: warning ⚠️ Warning At the moment, we're working on major updates to the OEV mechanism. As part of this transition, there is currently no public OEV Network and OEV Auctioneer. In the meantime, we're working with partnered searchers to continue seamless OEV recapture for our partnered dApps. These changes are transitional and will allow us to feature a more efficient OEV platform. diff --git a/docs/oev-searchers/in-depth/oev-auctioneer.md b/docs/oev-searchers/in-depth/oev-auctioneer.md index c1cb01d5..4c0894c8 100644 --- a/docs/oev-searchers/in-depth/oev-auctioneer.md +++ b/docs/oev-searchers/in-depth/oev-auctioneer.md @@ -8,7 +8,7 @@ outline: deep # OEV Auctioneer -::: info ⚠️ Warning +::: warning ⚠️ Warning At the moment, we're working on major updates to the OEV mechanism. As part of this transition, there is currently no public OEV Network and OEV Auctioneer. In the meantime, we're working with partnered searchers to continue seamless OEV recapture for our partnered dApps. These changes are transitional and will allow us to feature a more efficient OEV platform. diff --git a/docs/oev-searchers/in-depth/oev-network/index.md b/docs/oev-searchers/in-depth/oev-network/index.md index a922b7ce..9fd8d989 100644 --- a/docs/oev-searchers/in-depth/oev-network/index.md +++ b/docs/oev-searchers/in-depth/oev-network/index.md @@ -8,7 +8,7 @@ outline: deep # OEV Network -::: info ⚠️ Warning +::: warning ⚠️ Warning At the moment, we're working on major updates to the OEV mechanism. As part of this transition, there is currently no public OEV Network and OEV Auctioneer. In the meantime, we're working with partnered searchers to continue seamless OEV recapture for our partnered dApps. These changes are transitional and will allow us to feature a more efficient OEV platform. diff --git a/docs/oev-searchers/in-depth/oev-searching.md b/docs/oev-searchers/in-depth/oev-searching.md index 855a8d08..e799ed04 100644 --- a/docs/oev-searchers/in-depth/oev-searching.md +++ b/docs/oev-searchers/in-depth/oev-searching.md @@ -8,7 +8,7 @@ outline: deep # OEV searching -::: info ⚠️ Warning +::: warning ⚠️ Warning At the moment, we're working on major updates to the OEV mechanism. As part of this transition, there is currently no public OEV Network and OEV Auctioneer. In the meantime, we're working with partnered searchers to continue seamless OEV recapture for our partnered dApps. These changes are transitional and will allow us to feature a more efficient OEV platform. diff --git a/docs/oev-searchers/index.md b/docs/oev-searchers/index.md index a1c90454..51ea9bc7 100644 --- a/docs/oev-searchers/index.md +++ b/docs/oev-searchers/index.md @@ -75,7 +75,7 @@ searchers. ## How do auctions work? -::: info ⚠️ Warning +::: warning ⚠️ Warning At the moment, we're working on major updates to the OEV mechanism. As part of this transition, there is currently no public OEV Network and OEV Auctioneer. In the meantime, we're working with partnered searchers to continue seamless OEV recapture for our partnered dApps. These changes are transitional and will allow us to feature a more efficient OEV platform.