wip docs

Author: aditya520

images/express_relay/after_express.jpg

@@ -1,10 +1,12 @@
+import {Tabs} from "nextra/components"
 import AddressTable from "../../components/AddressTable";
 
 Express Relay is currently deployed on the following networks:
 
-## Mainnets
+<Tabs items={['Mainnet', 'Testnet']}>
 
-You can access the Auction Server via the following endpoint: https://pyth-express-relay-mainnet.asymmetric.re/
+<Tabs.Tab>
+Auction Server endpoint: https://pyth-express-relay-mainnet.asymmetric.re/
 
 ### Mode
 
@@ -46,6 +48,7 @@ You can access the Auction Server via the following endpoint: https://pyth-expre
 
 This list contains the addresses of the commonly used assets present in opportunities on the Mode network:
 
+
 <AddressTable
   explorer={"https://explorer.mode.network/address/$ADDRESS"}
   entries={[
@@ -62,9 +65,9 @@ This list contains the addresses of the commonly used assets present in opportun
   ]}
 />
 
-## Testnets
-
-You can access the Auction Server via the following endpoint: https://per-staging.dourolabs.app/
+</Tabs.Tab>
+<Tabs.Tab>
+Auction Server endpoint: https://per-staging.dourolabs.app/
 
 ### Optimism Sepolia
 
@@ -106,6 +109,7 @@ You can access the Auction Server via the following endpoint: https://per-stagin
 
 This list contains the addresses of the commonly used assets present in opportunities on the Optimism Sepolia network:
 
+
 <AddressTable
   explorer={"https://optimism-sepolia.blockscout.com/address/$ADDRESS"}
   entries={[
@@ -131,3 +135,6 @@ This list contains the addresses of the commonly used assets present in opportun
     },
   ]}
 />
+
+</Tabs.Tab>
+</Tabs>

images/express_relay/after_searcher.jpg

@@ -1,30 +1,28 @@
 # How Express Relay Works
 
-Express Relay allows protocols to eliminate maximal extractable value (MEV).
+Express Relay allows protocols to eliminate [Maximal Extractable Value](https://www.ledger.com/academy/glossary/maximal-extractable-value-mev) (MEV).
 Many protocols generate MEV on a regular basis.
 For example, borrow-lending protocols provide bonuses to searchers for liquidating undercollateralized loans.
 Searchers compete for these bonuses by tipping the chain's miners or validators.
-The validators capture most of the value of the liquidation bonus via these tips, so the liquidation bonus is in essence a transfer of wealth from the protocol's users to the validators.
+The validators capture most of the value of the liquidation bonus via these tips, so the liquidation bonus is a transfer of wealth from the protocol's users to the validators in the form of tips.
 
-Express Relay solves the problem of MEV by providing protocol developers with an auction primitive that they can use to prioritize access to valuable protocol operations.
+Express Relay solves the problem of MEV by providing protocol developers with an [auction](./how-express-relay-works/auction.mdx) primitive that they can use to prioritize access to valuable protocol operations.
 Developers specify a set of operations in their protocol that must be accessed through Express Relay.
 Searchers then participate in an off-chain auction to access these operations.
-Their bids in the auction are used to determine the priority of their transactions, i.e., the order in which their transactions will be executed.
-The winners' transactions are forwarded to the blockchain, which both pays their bid and executes the operation.
-The profits of the auction are then split between the integrated protocol and other participants in Express Relay.
+Their bids in the auction are used to determine the order in which their transactions will be executed.
+The winners' transactions are forwarded to the Express Relay smart contract. As part of the transaction, searchers must pay their specified bid. 
+The auction profits are then split between the integrated protocol and other participants in Express Relay.
 
-![](images/express_relay/express_relay_schematic.svg)
+![](images/express_relay/before_express.jpg)
+![](images/express_relay/after_express.jpg)
 
-FIXME: update this diagram with the designers' version
 
 The diagram above shows how Express Relay changes the MEV landscape for a liquidation.
-In the status quo (left), Searchers tip miners in order to guarantee that their liquidation transaction lands on-chain, and their transaction directly interacts with the protocol exposing the liquidation opportunity.
-With Express Relay (right), Searchers submit bids for their transaction to the Express Relay auction.
-After the auction, the winning bids are relayed to the blockchain, where the transactions are processed by the Express Relay smart contract before being forwarded on to the integrated protocol.
+In the status quo (above), Searchers tip miners to guarantee that their liquidation transaction lands on-chain and that their transaction directly interacts with the protocol, exposing the liquidation opportunity.
+With Express Relay (down), Searchers submit bids for their transaction to the Express Relay auction.
+After the auction, the winning bids are relayed to the blockchain, where the Express Relay smart contract processes the transactions before being forwarded on to the integrated protocol.
 The Express Relay contract collects payment from the Searchers and forwards a share of the revenue back to the integrated protocol.
 
-FIXME: I think the diagram is wrong (specifically the liquidation bonus going back to express relay)
-
 ## Which protocols can use Express Relay?
 
 Any protocol with valuable operations can use Express Relay.

images/express_relay/before_express.jpg

@@ -37,14 +37,16 @@ The `OpportunityAdapter` contract uses the [Permit2](https://github.com/Uniswap/
 
 Once on-chain opportunities arise, searchers can be notified of their existence via the opportunity server. Like the auction server, this is an off-chain piece of the Express Relay stack that is run by an infrastructure partner designated by the DAO. The opportunity server presents opportunities to searchers in a way that abstracts away bespoke integration work for the searcher: instead of worrying about crafting calldata specific to every new liquidation interface, searchers now view liquidation opportunities in terms of tokens they need to sell (debt they repay) in exchange for tokens they buy (collateral they liquidate). This simplified interface unifies different liquidation schemas and allows searchers to easily plug into more protocols.
 
-In addition to learning about present opportunities, searchers can also query the opportunity server for data around historical opportunities.
+In addition to learning about present opportunities, searchers can also query the opportunity server for data about historical opportunities.
 
--(TODO) Diagram of searchers before and after ExpressRelay
--before: searcher connects to every new protocol bespokely.  similarly, protocols have to court and incentivize individual searchers. maybe a messy looking bipartite graph with O(NM) edges
--after: searcher connects once to ExpressRelay, then gets access to opportunities of all integrated protocols. similarly, protocol connects once to ExpressRelay, then gets access to DeFi services of all integrated searchers. a cleaner looking graph with ER in the middle as a hub for both protocols and searchers.
+![](images/express_relay/before_searcher.jpg)
+![](images/express_relay/after_searcher.jpg)
 
-## Opportunity monitor
+-Before The searcher connects to every new bespoke protocol. Similarly, protocols have to court and incentivize individual searchers. Maybe a messy-looking bipartite graph with O(NM) edges
+-After Searcher connects once to ExpressRelay, then gets access to opportunities of all integrated protocols. Similarly, the protocol connects once to Express Relay and then gets access to DeFi services for all integrated searchers. A cleaner-looking graph with ER in the middle as a hub for both protocols and searchers.
+
+## Opportunity Monitor
 
 Many integrated protocols with Express Relay build out an opportunity monitor script to query executable opportunities on their protocol and expose them to searchers. This allows them to tap into all Express Relay-integrated searchers, who do not need to do any additional integration work beyond having access to the relevant tokens to execute opportunities on the protocol.
 
-In terms of existing infrastructure, the opportunity monitor script is most analogous to a protocol's liquidation scripts/bots. Typically, many lending protocols build liquidation bot libraries that they share publicly in hopes of encouraging adoption by liquidators. With minor modifications, these scripts can serve as the opportunity monitor that enables all Express Relay-integrated searchers to participate in this protocol's liquidations.
+In terms of existing infrastructure, the opportunity monitor script is most analogous to a protocol's liquidation scripts/bots. Typically, many lending protocols build liquidation bot libraries that they share publicly in hopes of encouraging adoption by liquidators. With minor modifications, these scripts can serve as the opportunity monitor that enables all Express Relay-integrated searchers to participate in this protocol's liquidations.