WIP-searcher-guide-refactor

Author: aditya520

pages/express-relay/integrate-as-searcher.mdx

@@ -186,7 +186,7 @@ The code snippet below demonstrates how to submit a bid using the `Typescript` S
 ```typescript {4} copy
 const handleOpporunity = async (opportunity: Opportunity) => {
     ...
-    const bid = await client.signBid(opportunity, {amount, nonce, deadline},privateKey)
+    const bid = await client.signBid(opportunity, {amount, nonce, deadline}, privateKey)
     await client.submitBid(bid)
 }
 ```

pages/express-relay/integrate-as-searcher/custom-contract.mdx

@@ -2,10 +2,10 @@ import { Callout } from "nextra/components";
 
 # Custom Searcher Contract
 
-Searchers can use their in-house custom contracts to execute the opportunities provided by the auction server.
-In this case they need to construct the bids based on the opportunity details.
+Searchers can use their in-house custom contracts to execute the opportunities Express Relay provides.
+In this case, they must construct the bids based on the opportunity details.
 
-Check the following example of a custom contract that executes liquidation transactions:
+Refer to the following example of a custom contract that executes liquidation transactions:
 
 ```solidity copy
 ...
@@ -35,6 +35,5 @@ function callLiquidation(Opportunity memory opp){
 ```
 
 <Callout type="info" emoji="ℹ️">
-  Make sure to approve the `opp.contract` for the necessary amount of
-  `sell_tokens`.
+Make sure to allow the [Express Relay contract](../contract-addresses.mdx) to call the relevant methods in your custom contract.
 </Callout>

pages/express-relay/integrate-as-searcher/opportunity-adapter.mdx

@@ -1,8 +1,8 @@
 import { Steps } from "nextra/components";
 
-# Prepare assets for OpportunityAdapter
+# Prepare assets for Opportunity Adapter
 
-The `OpportunityAdapter` is a utility contract that can be used for easier integration with express relay while maintaining maximum security.
+The [`OpportunityAdapter`](https://github.com/pyth-network/per/blob/main/contracts/src/opportunity-adapter/OpportunityAdapter.sol) is a utility contract that can be used for easier integration with Express Relay while maintaining maximum security.
 In this integration, searchers use the [`Permit2`](https://github.com/Uniswap/permit2/) contract for safe asset management (`ERC20` tokens and Wrapped ETH) and the adapter contract to transfer bids, execute the opportunity, and ensure the assets are transferred correctly.
 Using the `OpportunityAdapter` means that a searcher does not need to deploy their own custom contract for inventory management and routing to the protocol contracts where liquidation takes place.
 
@@ -11,9 +11,11 @@ In order to use `OpportunityAdapter`, you need to prepare your assets via the fo
 <Steps>
 ### Transfer tokens to your wallet
 
-You will need to own all the tokens you expect to provide as `sell_tokens` for different opportunities.
-You will also need to approve `WETH`, as the `OpportunityAdapter` will pay your bids by deducting the bid amounts from your wallet's `WETH` balance. You can find the `WETH` contract address on the [contract address page](../contract-addresses).
-You can use the following command to deposit native ETH to `WETH`:
+Searchers are expected to own all the tokens that they expect to provide as `sell_tokens` for different opportunities.
+They will also need to approve `WETH`, as the `OpportunityAdapter` will pay the bids by deducting the bid amounts from their wallet's `WETH` balance. 
+
+You can find the `WETH` contract address on the [contract address page](../contract-addresses).
+Refer to the following command to deposit native ETH to `WETH`:
 
 ```bash copy
 cast send \
@@ -25,7 +27,10 @@ $WETH_ADDRESS \
 
 ### Approve your assets to Permit2
 
-Approve your tokens, including `WETH`, to the `Permit2` contract `0x000000000022D473030F116dDEE9F6B43aC78BA3`. This step allows the searcher to approve token spending with off-chain signatures.
+Approve your tokens, including `WETH`, to the `Permit2` contract `0x000000000022D473030F116dDEE9F6B43aC78BA3`. 
+This step enables token spending with off-chain signatures.
+
+Refer to the following command to approve a token to `Permit2`:
 
 ```bash copy
 cast send \