feat: Add Fusaka support for MEV-Boost relay by bharath-123 · Pull Request #745 · flashbots/mev-boost-relay

bharath-123 · 2025-07-03T07:37:31Z

📝 Summary

Fusaka support for MEV-Boost relay

Resolves: #739

This PR has been tested against rbuilder's fusaka support branch: flashbots/rbuilder#666

Note that rbuilder is not yet Fusaka compatible, so in our testing only EIP1559 txs were being sent in execution payloads from the builder. rbuilder still needs to be fulu compaitable.

This upgrade brings in two new additions:

Addition of a getPayloadV2: Introduced in Add eth/v2/builder/blinded_blocks which does not return the execution payload and blobs ethereum/builder-specs#123, we don't return a response in getPayloadV2 compared to returning the fully signed beacon block in getPayloadV1. We do this to save n/w bandwidth for the proposer. It has been implemented in: Faheel/v2 get payload bharath-123/mev-boost-relay#62. More details can be seen in the PR links.
Inferring fork version of builder payload by peeking into the raw payload for slot: Fusaka and Electra payloads are of the same structure. We need to know the fork version before parsing the payload. To do this, we try to get the slot from the raw payload. It is implemented in: fix: Parse blocks sent by builder with fork version. bharath-123/mev-boost-relay#63

✅ I have run these commands

make lint
make test-race
go mod tidy
I have seen and agree to CONTRIBUTING.md

bharath-123 · 2025-07-03T07:43:25Z

 	// Create and fire off JSON-RPC request
-	if payload.Version == spec.DataVersionElectra {
+	// TODO - bharath: Does the electra flashbots_validateBuilderSubmissionV4 work for fulu?
+	if payload.Version == spec.DataVersionElectra || payload.Version == spec.DataVersionFulu {


We need to wait for the flashbots_validateBuilderSubmissionV5 impl for Fusaka being worked on here: paradigmxyz/reth#17179

this has been merged to main in reth. Once its rebased to the fusaka-devnet-2 branch, we should be able to use it in rbuilder.

bharath-123 · 2025-07-03T07:44:02Z


 	// Log at start and end of request
-	log.Info("request initiated")
+	log.Info("getPayload request initiated")


will update this

bharath-123 · 2025-07-09T05:33:55Z

+	FuluForkVersionHolesky = "0x07017000"
+	FuluForkVersionSepolia = "0x90000075"
+	FuluForkVersionGoerli  = "0x06001020"
+	FuluForkVersionHoodi   = "0x70000910"
+	FuluForkVersionMainnet = "0x06000000"
+


verify these fork versions

Yes, these are correct 👍

jtraglia · 2025-07-11T15:48:01Z

 	var err error
+
+	fuluRequest := new(builderApiFulu.SubmitBlockRequest)


Just a nit, we should remove this new blank line.

jtraglia · 2025-07-11T15:48:25Z

 	var err error
+
+	// The SignedBlockContents type for fulu is the same as that of electra


Can remove this blank line too.

jtraglia · 2025-07-11T15:51:50Z

 		log.Infof("deneb fork detected (currentEpoch: %d / denebEpoch: %d)", common.SlotToEpoch(currentSlot), api.denebEpoch)
 	} else if hasReachedFork(currentSlot, api.capellaEpoch) {
 		log.Infof("capella fork detected (currentEpoch: %d / capellaEpoch: %d)", common.SlotToEpoch(currentSlot), api.capellaEpoch)
+	} else if hasReachedFork(currentSlot, api.fuluEpoch) {
+		log.Infof("fulu fork detected (currentEpoch: %d / fuluEpoch: %d)", common.SlotToEpoch(currentSlot), api.fuluEpoch)


This is wrong. Fulu must be at the top of the list, otherwise this won't work as expected.

jtraglia

This looks really good! Just a few small things.

bharath-123 · 2025-07-14T06:28:22Z

since @metachris is on vacation,

Would love it if at least 2 of the following could take a look at the PR, on the same lines as flashbots/mev-boost#805 (comment):

Faheel/v2 get payload

fix: Parse blocks sent by builder with fork version.

Copilot

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

fix: use payload slot instead of head slot in getPayload

metachris · 2025-08-13T12:37:33Z

 	receivedAt := time.Now().UTC()
 	log := api.log.WithFields(logrus.Fields{
-		"method":                      "getPayload",
+		"method":                      fmt.Sprintf("getPayload%s", version),


this might cause issues for some log queries. maybe rather add another field "getPayloadVersion"?

metachris · 2025-08-13T12:42:21Z

 }
+
+func getSlotFromBuilderJSONPayload(input []byte) (uint64, error) {
+	slot := gjson.Get(string(input), "message.slot")


we already include a fast json parser: https://github.com/buger/jsonparser

maybe use that one instead of adding a second fast one? not feeling strongly about it, we could also consider switching to gjson (it has more stars).

i would kinda lean to using gjson since it also seems more well maintained. last commit to jsonparser is 3 years ago

sgtm, let's do that in another PR then 👍

bharath-123 added 5 commits June 26, 2025 21:33

wip for fulu

fa74812

fix tests

ca0e4f5

minor check

d0e8211

minor fixes

bb077d7

add fulu header

33f6f0b

bharath-123 commented Jul 3, 2025

View reviewed changes

bharath-123 commented Jul 9, 2025

View reviewed changes

bharath-123 added 2 commits July 10, 2025 09:40

use validate builder submission v5 for fulu

2286f15

minor log update

a34d50d

bharath-123 marked this pull request as ready for review July 11, 2025 07:51

jtraglia reviewed Jul 11, 2025

View reviewed changes

jtraglia previously approved these changes Jul 11, 2025

View reviewed changes

address review comments

c376661

bharath-123 dismissed jtraglia’s stale review via c376661 July 14, 2025 05:53

bharath-123 mentioned this pull request Jul 22, 2025

add get payload v2 #746

Closed

4 tasks

faheelsattar and others added 11 commits July 22, 2025 13:28

add get payload v2

4fe4a00

add async block publishing

cb91f6d

address comments

b1594d9

clean logs

93fd699

Merge pull request #62 from faheelsattar/faheel/v2-get-payload

7f48575

Faheel/v2 get payload

add some debug logs

2043022

unmarshall submitted block based on fork

068e30c

devnet-3 related fixes

86268ac

partially parse payload to infer fork version

d06635e

address review comments

de388b1

add test

066f636

bharath-123 added 3 commits August 6, 2025 16:03

add tests for submitBlockPayload

8af3fbf

fix fmt + lint

a2ad020

Merge pull request #63 from bharath-123/bharath/fulu-payload-parsing

a657181

fix: Parse blocks sent by builder with fork version.

metachris requested a review from Copilot August 8, 2025 09:45

Copilot AI reviewed Aug 8, 2025

View reviewed changes

bharath-123 added 5 commits August 11, 2025 19:57

use payload slot instead of headSlot

bbd1271

lint + fmt

ee4b16b

throw warning if proposerEthConsensusVersion is incorrect

484e513

wrap error

7320191

Merge pull request #64 from bharath-123/bharath/use-payload-slot

b681285

fix: use payload slot instead of head slot in getPayload

metachris reviewed Aug 13, 2025

View reviewed changes

metachris previously approved these changes Aug 13, 2025

View reviewed changes

metachris reviewed Aug 13, 2025

View reviewed changes

address review comments

3bb3bc8

bharath-123 dismissed metachris’s stale review via 3bb3bc8 August 13, 2025 16:38

bharath-123 force-pushed the bharath/fulu branch 2 times, most recently from 1b8d3de to 319429a Compare August 13, 2025 17:12

fix CI

37383b2

bharath-123 force-pushed the bharath/fulu branch from 319429a to 37383b2 Compare August 14, 2025 05:08

bharath-123 added 2 commits August 20, 2025 10:11

replace go boost utils to use main branch

b3da6b1

run go mod tidy

024b027

metachris previously approved these changes Aug 20, 2025

View reviewed changes

jtraglia previously approved these changes Aug 21, 2025

View reviewed changes

update deps

0922938

bharath-123 dismissed stale reviews from jtraglia and metachris via 0922938 August 28, 2025 15:34

bharath-123 added 2 commits September 1, 2025 10:15

update go-builder-client deps

4115cc3

update go-builder-client to use attestantio fulu branch

7375783

metachris approved these changes Sep 4, 2025

View reviewed changes

metachris merged commit 7c88124 into flashbots:main Sep 4, 2025
2 checks passed

		var err error

		fuluRequest := new(builderApiFulu.SubmitBlockRequest)

		var err error

		// The SignedBlockContents type for fulu is the same as that of electra

Conversation

bharath-123 commented Jul 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📝 Summary

✅ I have run these commands

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jtraglia left a comment

Choose a reason for hiding this comment

Uh oh!

bharath-123 commented Jul 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

bharath-123 commented Jul 3, 2025 •

edited

Loading

bharath-123 commented Jul 14, 2025 •

edited

Loading