Skip to content

Commit 066e55f

Browse files
authored
Update mev-share.mdx (#547)
Updated for grammar.
1 parent cf24d9d commit 066e55f

File tree

1 file changed

+16
-14
lines changed

1 file changed

+16
-14
lines changed

docs/flashbots-protect/mev-share.mdx

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import ProtectButton from '@site/src/components/ProtectButton';
1010

1111
MEV-Share enables users to reclaim up to 90% of the MEV generated by their transactions, the rest of which is paid to searchers and builders. By default, transactions from Protect users are directed to the Flashbots [MEV-Share Node](/flashbots-mev-share/introduction), which facilitates this return. Users are automatically connected to the [Stable](/flashbots-protect/mev-share#stable-configuration) configuration, a setting continuously optimized by Flashbots to balance efficient execution and protection against harmful MEV. This document provides a guide on the mechanism and various configurations of MEV-Share.
1212

13-
Advanced users can exert more control over their transactions and preferences through the advanced panel or by manually configuring their Protect RPC request.
13+
Advanced users can customize their transactions and preferences through the advanced panel or by manually configuring their Protect RPC request.
1414

1515
<ProtectButton />
1616

@@ -21,7 +21,7 @@ Advanced users can exert more control over their transactions and preferences th
2121
The Stable configuration is the default configuration for Protect RPC. No query parameters are specified to use it.
2222

2323
```url
24-
https://rpc.flashbots.net
24+
https://rpc.flashbots.net/fast
2525
```
2626

2727
Currently, this configuration shares the following information:
@@ -30,7 +30,7 @@ Currently, this configuration shares the following information:
3030
- `default_logs` Partial logs (the pool id and the fact that a swap was made) for curve, balancer, and uniswapV2/V3-style trades
3131
- Transactions are only forwarded to the Flashbots block builder
3232

33-
This may change over time as we gather more data and fine-tune the configuration to maximize benefits.
33+
This may change as the configuration is tuned to maximize benefits.
3434

3535
### Max Privacy
3636

@@ -50,15 +50,15 @@ To use Protect with the maximum kickback, set _all_ hints in your Protect RPC UR
5050
https://rpc.flashbots.net?hint=calldata&hint=contract_address&hint=function_selector&hint=logs&hint=hash
5151
```
5252

53-
This configuration provides searchers with comprehensive details about your transaction, giving them better chance to identify more MEV opportunities and to return more MEV kickback to you.
53+
This configuration provides searchers with comprehensive details about your transaction, giving them a better chance to identify more MEV opportunities and return MEV refunds.
5454

5555
## Examples
5656

5757
Here are some examples of configurations that you might choose, depending on your goals.
5858

5959
| <div style={{width:"180px"}}>Goal</div> | Flashbots Protect RPC URL |
6060
| --- | --- |
61-
| Stable | `https://rpc.flashbots.net` |
61+
| Stable | `https://rpc.flashbots.net/fast` |
6262
| Max Privacy | `https://rpc.flashbots.net?hint=hash` |
6363
| Max Kickback | `https://rpc.flashbots.net/?hint=calldata&hint=contract_address&hint=function_selector&hint=logs&hint=hash` |
6464
| Add Builders (share with other builders for faster inclusion) | `https://rpc.flashbots.net?builder=flashbots&builder=XYZ` |
@@ -70,7 +70,7 @@ The Protect RPC uses query parameters within the URL to convey your preferences.
7070

7171
### Hints
7272

73-
To customize your hint setup, use the hint parameter to control the visibility of your transaction data to searchers. If no hints are provided, the default [Stable](/flashbots-protect/mev-share#stable-configuration) hint configuration will be used. If you specify one or more hints, any hint that is _not_ included will be disabled.
73+
To customize your hint setup, use the hint parameter to control the visibility of your transaction data to searchers. The default [Stable](/flashbots-protect/mev-share#stable-configuration) hint configuration will be used if no hints are provided. If you specify one or more hints, any hint that is _not_ included will be disabled.
7474

7575
<HintsTable />
7676

@@ -80,11 +80,11 @@ Here is an example:
8080
https://rpc.flashbots.net?hint=calldata&hint=logs&hint=hash
8181
```
8282

83-
This configuration shares the calldata, logs, and hash of your transaction with searchers. It does not share the contract address or function selector.
83+
This configuration shares calldata, logs, and transaction hash with searchers. It does not share the contract address or function selector.
8484

8585
### Builders
8686

87-
To designate the builders who will receive your transactions, use the `builder` parameter. This parameter can be repeated multiple times to include multiple builders. The builders listed below are currently supported.
87+
Designate which builders will receive your transaction with the `builder` parameter. This parameter can be repeated multiple times to include different builders. The builders listed below are currently supported.
8888

8989
Note that all transactions are shared with the Flashbots block builder, even if it is not explicitly specified.
9090

@@ -96,22 +96,24 @@ It's important to understand that while adding more builders can increase your t
9696
https://rpc.flashbots.net?builder=ABC&builder=XYZ
9797
```
9898

99-
This configuration sends your transaction to the ABC block builder and the XYZ block builder, as well as the Flashbots block builder.
99+
This configuration sends your transaction to ABC block builder, XYZ block builder, and Flashbots block builder.
100100

101101
### Refunds
102102

103-
You can tailor your refund settings using the refund parameter. This determines the distribution of the searcher's payment among different addresses if your transaction is bundled. If not specified, the transaction originator (tx.origin) will by default receive 90% of the searcher's payment.
103+
You can tailor your refund settings using the refund parameter. This determines the distribution of the searcher's payment among different addresses for bundled transactions. If not specified, the transaction originator (tx.origin) will by default receive 90% of the searcher's payment.
104104

105-
The refund parameter contains two colon-separated values: an address for the refund and the percentage of the searcher's payment to be refunded. To distribute the payment across multiple addresses, append a new refund parameter for each.
105+
The refund parameter contains two colon-separated values: an address for the refund and the percentage of the searcher's payment to be refunded. To distribute the payment across multiple addresses, append a new refund parameter for each address.
106106

107107
Here is an example of a refund parameter that sends 10% of the searcher's payment to the address `userAddr`:
108108

109-
```url
109+
```URL
110110
https://rpc.flashbots.net?refund=userAddr:10
111111
```
112112

113-
All percentages in the refund parameters must total less than 100. The remaining percentage, inferred from 100 - total refund percentages, is the payment to the validator. Note that keeping a larger percentage of the refund may result in longer inclusion times, because it reduces the payment to the validator.
113+
The sum of all refund percentages must be less than 100. The remaining percentage, inferred from 100 - total refund percentages, is the payment to the validator.
114+
115+
**Note**: Keeping a larger percentage of the refund may result in longer block inclusion times as it reduces the payment to the validator.
114116

115117
### Priority fee
116118

117-
When sending private transaction to rpc endpoint you should set priority fee (tips) to be strictly greater than zero. Transactions with 0 priority fee will not be shared with block builders and included on chain, unless they are bundled by a searcher via MEV-Share.
119+
When sending a private transaction to an RPC endpoint, the priority fee (tips) should be greater than zero. A transaction with a 0 priority fee will not be shared with block builders and will only be included on-chain if a searcher bundles them via MEV-Share.

0 commit comments

Comments
 (0)