New MEV Blocker Docs

docs/mevblocker/README.mdx

@@ -1,45 +1,37 @@
 # Overview
 
-**MEV Blocker is the #1 leading MEV-protection RPC solution by transaction volume and rebates. A product developed and stewarded by CoW DAO, Beaver Builder and Gnosis DAO.**
+## MEV Blocker is the #1 leading MEV-protection RPC solution by transaction volume and rebates.
 
-MEV Blocker is built to:
+![MEV Blocker](/img/mevblocker/concept1-1200x630.png)  
 
-* Protect users from frontrunning & sandwich attacks
-* Give users a rebate from backrunning opportunities created by the their trades
-* Provide fast trade settlement
+### MEV Blocker is Built to:
 
-![The Best Protection Under the Sun](/img/mevblocker/mevblocker_tagline.png)
+* Protect users from frontrunning & sandwich attacks (MEV Attacks)
+*  Give users/integrators a rebate from backrunning opportunities created by the their flow
+*  Provide the fastest inclusion time
 
-MEV Blocker's order flow auction protects user transactions from frontrunning and sandwich attacks — the worst types of MEV — by sending transactions to a private mempool of trusted searchers. These searchers then capture any backrunning opportunities left by user transactions and give up to 90% of their value back to the users. 
+### Key Advantages
 
-## MEV Blocker Offers Important Advantages to Users
+The key advantages that MEV Blocker offers in comparison to other RPCs are the following
 
-* **MEV Protection**: Transactions sent to the public mempool are subject to all sorts of MEV attacks including [frontrunning](https://blog.cow.fi/what-is-frontrunning-b2641ad7af21) and [sandwich attacks](https://blog.cow.fi/what-is-a-sandwich-attack-and-how-can-you-protect-yourself-b101c9a9b9b3). MEV bots are responsible for [millions of dollars of value lost each week](https://eigenphi.io/mev/ethereum/sandwich). By using MEV Blocker's private pool, all transactions are de-facto protected from harmful MEV.
+* **Inclusion time →** MEV Blocker is the fastest RPC across the market due to it's innovative Builder fee mechanism.
+* **Backrun Rebates →**  MEV Blocker offers the highest rebates among RPCs thanks to its robust OFA and its decentralised Searcher network, which is why it gets the highest rebates in comparison to other RPCs
+* **Transparent →** All our data  is public within a 30 second delay.
+* **Customizable →** MEV Blocker offers five different RPC endpoints that users/integrators can choose from based on their individual needs.
+* **Permissionless →** All endpoints, and features are fully permissionless, no gate keeping.  MEV Blocker is built by experts to be user-friendly, easy to set up, and free for users to integrate.
 
-* **MEV Rebates**: Searchers connected to MEV Blocker bid for the right to backrun user transactions using "append-only" bundles. 90% of these bids are paid as a rebate to the transaction originator (the user). The remaining 10% incentivizes builders and validators to quickly include the bundle in the remaining PBS auction. Rebates are a great way to ensure no value leaks through the supply chain and users re-capture value they left on the table. These rebates can also be an extremely powerful way for wallets or dApp solvers to capture value and generate extra revenue. If you are interested in learning the mechanics behind the MEV Blocker rebates, check out the MEV Blocker order flow auction explainer page.
+### MEV Blocker Beats the Competition
 
-* **Faster Inclusion Than Traditional RPCs**: Instead of waiting on the public Ethereum mempool, transactions sent through MEV Blocker get forwarded directly to all major builders, resulting in a faster inclusion rate. 
+Check out our RPC Benchmark Comparison study to see how MEV Blocker performs across speed, backruns, and success metrics.
 
-* **Multiple Endpoints**: MEV Blocker offers five different RPC endpoints that users can choose from based on their individual needs. 
+![Guide](/img/mevblocker/mevblocker_comparison.png)
 
-![Endpoints](/img/mevblocker/Endpoints_protection.png)
+### [Comparison Study](/mevblocker/rpc-performance)
 
-* **Transparency**: A [Dune Dashboard](https://dune.com/cowprotocol/mev-blocker) allows anyone to check the transactions submitted through the MEV Blocker RPC. Users can follow their transactions in detail, see all searcher bids, and calculate the overall revenue they have received from MEV Blocker rebates.
+### Supported Chains
 
-## MEV Blocker Beats the Competition
-
-* **Low Latency and Fast Inclusion Time**: With a strong builder network, MEV Blocker acts as a builder aggregator that forwards transactions directly to all major builders. Over 90% of transactions are processed in the next block, typically within 12 seconds.
-
-* **Superior Rebates**: Thanks to its robust searcher competition, MEV Blocker has been able to generate more than 10x  the backrunning rebates of any other RPC solution — which is great news for users. 
-
-* **Simple and Free to Integrate**: MEV Blocker is built by experts to be user-friendly, easy to set up, and free for users to integrate.
-
-## Growing List of Partners
-
-Wallets that have integrated MEV Blocker include **Uniswap Wallet, Rabby Wallet, Crypto.com Defi Wallet, Ambire Wallet, Keepkey Wallet.**
-
-MEV Blocker is trusted by more than 30 prominent Ethereum projects including **Balancer, Safe, ShapeShift, Paraswap, VirtuSwap, Karpatkey, Swarm, Castle, Aura, Oasis.app, Eigenphi, and many more.**
+Ethereum: All features are supported on Ethereum.
 
-## Supported Chains
+import DocCardList from '@theme/DocCardList';
 
-Ethereum: All features are supported on Ethereum.
+<DocCardList />

docs/mevblocker/builders/README.mdx

@@ -1,3 +1,39 @@
 # Builders
 
 Builders receiving MEV blocker transactions should adhere to certain rules and also pay a fee to MEV blocker. The proceeds of the fee are used to support MEV blocker technical development and drive continuous growth in users' adoption. 
+
+To connect to MEV Blocker and start receiving private order flow, builders must meet the following basic requirements:
+
+- **Build ≥1% of mainnet blocks consistently**  
+  You must have built at least 1% of Ethereum mainnet blocks *per week* during the past month.  
+  We reserve the right to disconnect builders who drop significantly below this threshold.
+
+- **Post a 10 ETH bond**  
+  A refundable security deposit is required to join the network.  
+  It is held in the MEV Blocker contract and covers potential penalties or late fees.
+
+- **Support for core features**  
+  Builders must implement:
+  - **Refund bundles**
+  - **`replacementUuid` (or `uuid`)** for updateable bundles
+  - **Tx hash dropping** (to support dynamic bundle resolution)
+
+- **Maintain ethical execution**  
+  Builders must refrain from any behavior that harms MEV Blocker users, including but not limited to:
+  - Frontrunning or sandwiching  
+  - Sharing or leaking transaction/state data  
+  - Selectively including transactions or manipulating refund outcomes
+
+- **No shadow identities or fee evasion**  
+  Builders must not attempt to bypass the fee mechanism by operating "shadow builders" or other manipulative schemes.
+
+- **Reach out to get started**  
+  Final onboarding and access to flow are coordinated via the MEV Blocker Telegram group.
+
+---
+
+This is a high-level summary — each requirement is explained in detail in the sections that follow.
+
+import DocCardList from '@theme/DocCardList';
+
+<DocCardList />

docs/mevblocker/builders/_category_.json

@@ -1,5 +1,5 @@
 {
-    "position": 2,
+    "position": 4,
     "label": "Builders",
     "collapsible": true,
     "collapsed": true

docs/mevblocker/builders/optimal_bidding.md

@@ -0,0 +1,81 @@
+---
+sidebar_position: 3
+---
+
+# Optimal Bidding
+
+## Bidding Strategy for MEV Blocker-Connected Builders
+
+To effectively compete in the block builder market, a builder connected to MEV Blocker must understand how to account for the MEV Blocker fee when setting bids. This guide outlines how to incorporate that cost into your bidding strategy under various flow scenarios.
+
+### Setup & Assumptions
+
+We simplify the environment to make the strategy intuitive — the conclusions still hold in expectation beyond these assumptions.
+
+- Public Mempool Flow: 1 ETH per block (always available to all builders)
+- Private Flow:  
+  - With 50% probability, a block contains a MEV Blocker tx worth 1 ETH  
+  - With 50% probability, a block contains a Private RPC tx worth 1 ETH
+- Builders:
+  - Builders A & B are connected to MEV Blocker and other Private RPC
+  - Builder C is only connected to the public mempool
+- MEV Blocker Cost: 0.1 ETH per block won — fixed fee regardless of block content
+- Private RPC Cost: 90% of transaction value, paid only if a Private RPC tx is included
+
+No other MEV is assumed, and builders are not subsidizing their bids.
+
+### The Key Principle
+
+If you are connected to MEV Blocker, you must adjust your bid for each block you win by subtracting 0.1 ETH, regardless of which transactions are in that block. This is because the MEV Blocker fee is charged per block won, not per transaction included. To remain competitive and avoid losses, you must lower your bid to reflect this fixed cost.
+
+###  Optimal Bidding by Scenario
+Let’s walk through what your bid should look like depending on the transactions present in the block.
+
+#### Scenario 1: Public mempool + MEV Blocker + Private RPC transactions
+
+- Total Value: 1 + 1 + 1 = 3 ETH
+- MEV Blocker Fee: 0.1 ETH
+- Private RPC Fee: 0.9 ETH (90% of 1 ETH)
+- Adjusted Bid: 3 - 0.1 - 0.9 = 2 ETH
+
+You win over builders without private flow (who can only bid 1 ETH).
+
+#### Scenario 2: Public mempool + MEV Blocker Transactions
+
+- Total Value: 1 + 1 = 2 ETH
+- MEV Blocker Fee: 0.1 ETH
+- Adjusted Bid: 2 - 0.1 = 1.9 ETH
+
+Still beats the public-only builder who bids up to 1 ETH.
+
+#### Scenario 3: Public mempool + Private RPC Transactions
+
+- Total Value: 1 + 1 = 2 ETH
+- MEV Blocker Fee: 0.1 ETH (paid even if no MEV Blocker tx)
+- Private RPC Fee: 0.9 ETH
+- Adjusted Bid: 2 - 0.1 - 0.9 = 1 ETH
+
+Your access to Private RPC gives you edge despite the MEV Blocker fee.
+
+#### Scenario 4: Public mempool Only transactions
+
+- Total Value: 1 ETH
+- MEV Blocker Fee: 0.1 ETH
+- Adjusted Bid: 1 - 0.1 = 0.9 ETH
+
+Public-only builders can bid up to 1 ETH — you’ll lose these blocks in rare cases, but MEV Blocker’s fee is carefully calibrated to ensure this happens infrequently.
+
+#### Summary
+
+| Scenario                        | Value in Block | Builder Cost        | Optimal Bid | Outcome                     |
+|---------------------------------|----------------|----------------------|-------------|-----------------------------|
+| MEV Blocker + Private RPC + Pub | 3 ETH          | 0.1 + 0.9 ETH        | 2.0 ETH     | You win                     |
+| MEV Blocker + Public            | 2 ETH          | 0.1 ETH              | 1.9 ETH     | You win                     |
+| Private RPC + Public            | 2 ETH          | 0.1 + 0.9 ETH        | 1.0 ETH     | You win                     |
+| Public only                     | 1 ETH          | 0.1 ETH              | 0.9 ETH     | You lose (non-connected wins) |
+
+## Conclusion
+
+Always factor the 0.1 ETH MEV Blocker fee into your bid — even if the block has no MEV Blocker txs.
+
+You’re never at a net loss in expectation when following this strategy correctly. You're simply shifting value from validators to MEV Blocker as the builder.

docs/mevblocker/concepts/MEV/MEV.md

@@ -0,0 +1,33 @@
+---
+sidebar_position: 3
+---
+
+MEV is a controversial topic within any chain. MEV Blocker’s goal is to diminish all the MEV that hurts or goes against the users, while maximizing all the MEV that can work to the advantage of the user. 
+
+## **Without MEV Blocker**
+
+Ethereum’s default mempool is a wild west where MEV bots (aka searchers) can exploit transactions of unsuspecting traders (aka your users) taking their money bit by bit over time
+
+![image.png](/img/mevblocker/mevblocker_1.png)
+
+1. The wallet submits user-initiated txs to the public mempool.
+2. Anyone can view mempool txs. Builders select them based on fees and value.
+3. MEV bots exploit mempool transactions for profit, targeting slippage exploitation.
+4. MEV bots create bundles and submit them to builders with a bribe to enforce the order.
+5. Builders assemble the most valuable bundles to create the most profitable block for validators.
+6. Validators choose the most valuable block from builders to maximize earnings. Once selected, all txs (user, MEV, bribes) are executed onchain.
+
+## **With MEV Blocker**
+
+The structured mempool incentivizes searchers to bundle transactions for builders so they’re included in the next block without frontrunning or sandwiching traders (by giving searchers a cut of backrun opportunities)
+
+![image.png](/img/mevblocker/mevblocker_2.png)
+
+1. The wallet submits user-initiated txs to MEV Blocker’s virtual mempool.
+2. Builders must pay a subscription fee to access MEV Blocker's tx flow.
+3. Connected builders can access MEV Blocker flow and select txs based on fees and value.
+4. MEV Blocker shares txs with searchers via backrun bundles, returning 90% to the user.
+5. MEV bots create bundles and submit them to builders with a bribe to enforce the order.
+6. Builders assemble the most valuable bundles to create the most profitable block for validators.
+7. Validators choose the most valuable block from builders to maximize earnings. Once selected, all txs (user, MEV, bribes) are executed onchain.
+8. MEV Blocker shares 50% of the subscription fee from builders with wallet flow originators.

docs/mevblocker/concepts/MEV/_category_.json

@@ -0,0 +1,4 @@
+{
+    "position": 3,
+    "label": "MEV"
+}

docs/mevblocker/concepts/README.mdx

@@ -0,0 +1,14 @@
+---
+sidebar_position: 1
+---
+# Concepts
+
+MEV Blocker's order flow auction protects user transactions from frontrunning and sandwich attacks — the worst types of MEV — by sending transactions to a private mempool of trusted searchers. These searchers then capture any backrunning opportunities left by user transactions and give up to 90% of their value back to the users.
+
+- **MEV Protection**: Public mempool transactions are vulnerable to MEV attacks like frontrunning and sandwich attacks, causing millions in weekly losses. MEV Blocker's private pool protects you from these type of attacks.
+- **MEV Rebates**: MEV Blocker lets searchers bid to backrun transactions, returning 90% as user rebates and using 10% to reward builders and validators, reclaiming value and enabling wallet and dApp revenue.
+- **Faster Transaction Inclusion**: MEV Blocker bypasses the public Ethereum mempool, forwarding transactions directly to major builders for quicker inclusion.
+
+import DocCardList from '@theme/DocCardList';
+
+<DocCardList />

docs/mevblocker/concepts/_category_.json

@@ -2,8 +2,5 @@
     "position": 1,
     "label": "Concepts",
     "collapsible": true,
-    "collapsed": true,
-    "link": {
-        "type": "generated-index"
-    }
+    "collapsed": true
 }

docs/mevblocker/concepts/gas_rebates.md

@@ -0,0 +1,24 @@
+---
+sidebar_position: 2
+---
+
+# Gas Rebates
+
+## **Introduction to Ethereum Gas Fees**
+
+All Ethereum transaction require a gas fee to get included onchain. This gas fee can be broken down into two categories: 
+
+- **Base Fee**: A required network fee that automatically adjusts based on network demand for blockspace. The baseFee ensures that if transactions pay such fee, they are processed and included in a block.
+- **Priority Fee**: An optional additional payment for builders to include your transaction faster than others. The priorityFee allows builders to tip make a more valuable block and hence, gives you a higher chance of fast inclusion in a block.
+
+## **How MEV Blocker Recovers Priority Fees**
+
+MEV blocker is the only RPC that has a permissionless Order Flow Auction for which both searchers and builders are bound to public rules. To this date, MEV Blocker processes around 10% of dailty Etherem transcations, and 
+
+MEV Blocker currently protects and routes over 20% of all Ethereum mainnet transactions daily. It maintains strong relationships with top block builders — the entities responsible for selecting and packaging transactions into Ethereum blocks.
+
+Through our wide-reaching network and direct integration with the transaction path, MEV Blocker is able to recover part of the Priority Fee that would otherwise be lost — all without introducing delays or compromising transaction speed.
+
+As Ethereum evolves under the Proposer-Builder Separation (PBS) model, where validators (proposers) and block builders have distinct roles, gas pricing dynamics are shifting. While this opens the door for a more transparent and efficient fee market, users still often overspend to secure inclusion.
+
+MEV Blocker steps in to bridge that gap — helping users recapture the excess between what they paid and what was actually needed, effectively unlocking refunds from the inefficiencies of the current gas fee system.