Skip to content

Commit f64cd1d

Browse files
authored
Document build factor and MEV min bid (#538)
1 parent b6042a3 commit f64cd1d

1 file changed

Lines changed: 19 additions & 0 deletions

File tree

  • website/docs/Usage/Advanced

website/docs/Usage/Advanced/PBS.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,3 +33,22 @@ If you are running a validator client only, such as with a RocketPool "reverse h
3333
is to set `MEV_BOOST=true` in `.env`. `mev-boost.yml` and `MEV_RELAYS` are not needed and won't be used if they are
3434
set, as they are relevant only where the Consensus Layer client runs. See the [Overview](/) drawing for how these
3535
components communicate.
36+
37+
### Building locally
38+
39+
You have the option of building local blocks, when remote blocks don't pay enough for your liking. Depending on
40+
your VC (Validator Client), you may already be doing that, in fact!
41+
42+
Two parameters in `.env` control this behavior.
43+
44+
`MEV_MIN_BID`, set to an ETH value, e.g. `0.003`. Unless a remote block pays more than this, you build locally.
45+
46+
`MEV_BUILD_FACTOR`, set to a percentage cutoff point. Several VCs default to `90`, which means "unless remote
47+
pays at least 10% more, build locally". `100` has a special meaning in Eth Docker and means "always build
48+
remote". The in-protocol value for this is `18446744073709551615`, which Eth Docker sets "under the hood"
49+
when it sees `100`.
50+
51+
Since the Fusaka hard fork in December 2025, local block building may require large upload bandwidth, up to
52+
200 Mbit/s. Restricting the number of blobs to include when building locally would resolve this, but that
53+
functionality is not yet present as of February 2026. If your upload bandwidth is constrained,
54+
`MEV_BUILD_FACTOR=100` can make sense.

0 commit comments

Comments
 (0)