Releases: flashbots/mev-boost-relay
v0.32.0
Note
The Fusaka upgrade will happen at slot 13,164,544 (December 3, 2025, 21:49:11 UTC). Read more about the upgrade here: https://blog.ethereum.org/2025/11/06/fusaka-mainnet-announcement
What's Changed
- feat: Add Fusaka support for MEV-Boost relay by @bharath-123 in #745
- Add time column to website by @ilyaluk in #765
- Improve pprof in api service by @ilyaluk in #727
- DVO-1021: Switch to goccy/go-json by @ilyaluk in #730
- log JSON-RPC error data if present by @ilyaluk in #723
- add a local registerValidator cache to avoid going to redis by @metachris in #721
- Try fixing registerValidator cache misses by @metachris in #720
- Avoid type conversion in json registerValidator cache check by @metachris in #729
- remove unnecessary fields from GetStateValidatorsResponse by @ilyaluk in #728
- User error for getPayload request with a non-Electra payload by @metachris in #732
- Fix housekeeper registerValidator DB query by @metachris in #733
- update go builder client to 0.7.1 by @bharath-123 in #757
Version bumps
- update go-boost-utils by @bharath-123 in #763
- chore: update attestantio deps by @bharath-123 in #759
- chore: Update attestantio deps by @bharath-123 in #754
New Contributors
- @bharath-123 made their first contribution in #745
Full Changelog: v0.30.0...v0.32.0
Docker Image: flashbots/mev-boost-relay:0.32.0
$ docker run flashbots/mev-boost-relay:0.32.0
mev-boost-relay v0.32.0
https://github.com/flashbots/mev-boost-relay
Usage:
mev-boost-relay [flags]
mev-boost-relay [command]
Available Commands:
api Start the API server
completion Generate the autocompletion script for the specified shell
help Help about any command
housekeeper Service that runs in the background and does various housekeeping (removing old bids, updating proposer duties, saving metrics, etc.)
tool tools for managing the database
version Print the version number the relay application
website Start the website server
Flags:
-h, --help help for mev-boost-relay
Use "mev-boost-relay [command] --help" for more information about a command.v0.32.0-rc2
First relay release with Fusaka support
What's Changed
- feat: Add Fusaka support for MEV-Boost relay by @bharath-123 in #745
- chore: Update attestantio deps by @bharath-123 in #754
- update go builder client to 0.7.1 by @bharath-123 in #757
- chore: update attestantio deps by @bharath-123 in #759
- User error for getPayload request with a non-Electra payload by @metachris in #732
- Fix housekeeper registerValidator DB query by @metachris in #733
New Contributors
- @bharath-123 made their first contribution in #745
Full Changelog: v0.31.0...v0.32.0-rc2
Docker Image: flashbots/mev-boost-relay:0.32.0rc2
v0.31.0
This release significantly improves latency for registerValidator and getHeader requests by introducing a better registration cache, and avoiding most of the CPU-intensive serialization overhead. For more details, see also #729
This release also allows pprof to run on separate server + port, allowing for longer timeouts. For this, we changed the PPROF environment variable to `PPROF_ADDR, which you may need to update if you've used pprof before:
- Before:
--pprof/PPROF - New:
--pprof-listen-addr/PPROF_ADDR
What's changed since v0.30.0
- Enabled pprof to run on separate server + port, to allow for longer timeouts. For this, we changed the
PPROFenvironment variable to `PPROF_ADDR. PR @ilyaluk in #727 - Improved registerValidator latency by fixing registration cache by @metachris and @ilyaluk #729
- Try fixing registerValidator cache misses by @metachris in #720
- Add a local registerValidator cache to avoid going to redis by @metachris in #721
- Log JSON-RPC error data from validation node by @ilyaluk in #723
- Remove unnecessary fields from GetStateValidatorsResponse by @ilyaluk in #728
- Switch to goccy/go-json by @ilyaluk in #730
Full Changelog: v0.30.0...v0.31.0
Docker Image: flashbots/mev-boost-relay:0.31.0
v0.30.2
What's Changed
This release includes the following minor updates:
- Changed
PPROFenvironment variable toPPROF_ADDR, allowing pprof to be exposed on a separate server, which allows for longer request timeouts to collect longer profiles. PR: Improve pprof in api service by @ilyaluk in #727 - Add a local registerValidator cache to avoid going to redis by @metachris in #721
- Log JSON-RPC error data from validation node by @ilyaluk in #723
Full Changelog: v0.30.1...v0.30.2
v0.30.1
v0.30.1 is a recommended, but not critical upgrade to the Pectra-ready v0.30.0 release.
This patch fixes caching registerValidator requests for SSZ-encoded payloads (re-validating BLS signatures is heavy on CPU and should be avoided).
Changes
- Fixing registerValidator cache misses in #720
Impact
- Cached registrations reduce the number of BLS signature validations
- Increased Redis cache-hit rate
- Increased Redis storage: "Bytes Used For Cache" doubles (because now storing the full registration in cache, instead of only the timestamp).
- Improved registerValidator logging
Background
The timestamp in validator registrations are updated frequently, which made the API revalidate every incoming validator registration. The implemented solution stores the full registration in Redis (instead of only the timestamp), and discards any registrations that wouldn't change any fields anyway.
Full Changelog
v0.30.0
Note
The Pectra upgrade will happen at epoch 364032 (May 7, 2025, 10:05:11am UTC).
Noteworthy Changes
- Add support for Electra by @jtraglia in #613
- Add SSZ support to the Proposer API by @jtraglia in #685
- Add flag to publish block with ssz by @avalonche in #598
- Add support for hoodi by @ilyaluk in #698
- Use dedicated http client for publishing by @avalonche in #608
- Save simulated block value to database by @avalonche in #630
This update includes a database migration: https://github.com/flashbots/mev-boost-relay/blob/main/database/migrations/011_bid_add_simulated_block_value.go
Various Updates
- fix registerValidator content type detection by @metachris in #707
- Improved request content type parsing by @metachris in #708
- Fix payload attributes not updating after missed slot by @avalonche in #601
- fix EligibleAt null / NewNullTime by @metachris in #471
- Block submission metrics by @avalonche in #625
- Add logging and validation improvements by @avalonche in #589
- Add builder demotion metrics by @avalonche in #624
- feat: add basic latency metrics by @0x416e746f6e in #616
- Clean up logging when payload attributes are unknown by @austonst in #579
- Add more profiling logging in submit block by @avalonche in #596
- blocksim - increase http client transport settings by @metachris in #597
- Improve logging by demoting warnings by @avalonche in #612
- BLS key script improvement: allow hex string input by @metachris in #611
- Optimistic v1 fixes by @avalonche in #623
- Add channel to notify externally of new validators by @ferranbt in #632
- Fix notification end of api call instead of per validator by @ferranbt in #634
- feat(builder-spec): Correctly reject SSZ Accept/Content-Types headers. by @ryanschneider in #678
- Decouple logic and periodic scheduling from internal tasks by @ferranbt in #633
- Enforce configurable max payload size for service requests by @jtraglia in #684
- Update README.md by @Ocheretovich in #652
Version Updates
- Upgrade to go 1.24 and fix lint errors by @jtraglia in #681
- Bump github.com/attestantio/go-eth2-client from 0.19.9 to 0.21.1 by @dependabot in #595
- Bump github.com/alicebob/miniredis/v2 from 2.31.0 to 2.32.1 by @dependabot in #590
- Bump github.com/btcsuite/btcd from 0.23.0 to 0.24.0 by @dependabot in #617
- Bump golang.org/x/crypto from 0.20.0 to 0.31.0 by @dependabot in #663
- Bump github.com/btcsuite/btcd from 0.24.0 to 0.24.2 by @dependabot in #664
- Bump github.com/attestantio/go-builder-client from 0.6.1-0.20250218155713-9f16ff484247 to 0.6.1 by @dependabot in #683
- Update all dependencies by @jtraglia in #682
- Update key dependencies by @metachris in #709
New Contributors
- @0x416e746f6e made their first contribution in #616
- @ferranbt made their first contribution in #632
- @Ocheretovich made their first contribution in #652
- @ilyaluk made their first contribution in #698
Full Changelog: v0.29.1...v0.30.0
Docker Image: flashbots/mev-boost-relay:0.30.0
v0.30.0-rc1
Upgrade notes
This is the current Pectra release candidate.
It is not recommended to run this in production until it has been fully tested.
What's Changed
- Add support for Electra by @jtraglia in #613
- Update all dependencies by @jtraglia in #682
- Add logging and validation improvements by @avalonche in #589
- feat(builder-spec): Correctly reject SSZ Accept/Content-Types headers. by @ryanschneider in #678
- Clean up logging when payload attributes are unknown by @austonst in #579
- Add more profiling logging in submit block by @avalonche in #596
- Bump github.com/attestantio/go-eth2-client from 0.19.9 to 0.21.1 by @dependabot in #595
- Add flag to publish block with ssz by @avalonche in #598
- Fix payload attributes not updating after missed slot by @avalonche in #601
- fix EligibleAt null / NewNullTime by @metachris in #471
- blocksim - increase http client transport settings by @metachris in #597
- Bump github.com/alicebob/miniredis/v2 from 2.31.0 to 2.32.1 by @dependabot in #590
- Use dedicated http client for publishing by @avalonche in #608
- Improve logging by demoting warnings by @avalonche in #612
- BLS key script improvement: allow hex string input by @metachris in #611
- Optimistic v1 fixes by @avalonche in #623
- feat: add basic latency metrics by @0x416e746f6e in #616
- Add builder demotion metrics by @avalonche in #624
- Block submission metrics by @avalonche in #625
- Add channel to notify externally of new validators by @ferranbt in #632
- Fix notification end of api call instead of per validator by @ferranbt in #634
- Decouple logic and periodic scheduling from internal tasks by @ferranbt in #633
- Save simulated block value to database by @avalonche in #630
- Bump github.com/btcsuite/btcd from 0.23.0 to 0.24.0 by @dependabot in #617
- Bump golang.org/x/crypto from 0.20.0 to 0.31.0 by @dependabot in #663
- Bump github.com/btcsuite/btcd from 0.24.0 to 0.24.2 by @dependabot in #664
- Upgrade to go 1.24 and fix lint errors by @jtraglia in #681
- Update README.md by @Ocheretovich in #652
Database migrations
This release includes one database migration:
Migrations will automatically be applied when starting a new instance.
New Contributors
- @0x416e746f6e made their first contribution in #616
- @ferranbt made their first contribution in #632
- @Ocheretovich made their first contribution in #652
Special Mentions
Big shoutout to @jtraglia and @ryanschneider for all the hard work around Pectra!
Full Changelog: v0.29.1...v0.30.0-rc1
v0.29.1
Upgrade Notes
Recommended upgrade from v0.29 as this fixes a misconfiguration in the publish block flag in which the flag publishes the wrong way around.
In the v0.29 release the USE_V2_PUBLISH_BLOCK_ENDPOINT flag was removed in favor of the USE_V1_PUBLISH_BLOCK_ENDPOINT flag which enabled the v1 publish block endpoint. However that was not configured correctly in the last release which resulted in the v2 publish block endpoint being enabled if the USE_V1_PUBLISH_BLOCK_ENDPOINT flag was set and vice versa.
Also adds a blob column to the relay website to show the number of blobs contained in the block
What's Changed
- Add Blob column to website by @avalonche in #576
- Publish block V1 flag fix by @avalonche in #585
Special Mentions
Thank you and shout out to @alextes for reporting #581 for the flag misconfiguration and raising a fix.
Full Changelog: v0.29...v0.29.1
Docker Image: flashbots/mev-boost-relay:0.29.1
v0.29
Upgrade Notes
- This release adds support for the upcoming Deneb fork and is fully backwards compatible with Capella
- Ensure the beacon node is upgraded and restart the relay before the fork so the relay gets the latest fork schedule. The relay will not error if the Deneb fork schedule is not found.
What's Changed
- Deneb Support by @avalonche in #564
- Various type clean ups and completely migrated to attestant types.
Uses the v2 publish block endpoint on the CL by default
- the
USE_V2_PUBLISH_BLOCK_ENDPOINTflag is removed. - to switch to the v1 endpoint set the
USE_V1_PUBLISH_BLOCK_ENDPOINTenvironment variable.
Dependency Updates
- Bump github.com/gorilla/mux from 1.8.0 to 1.8.1 by @dependabot in #550
- Bump github.com/spf13/cobra from 1.6.1 to 1.8.0 by @dependabot in #551
- Bump golang.org/x/text from 0.13.0 to 0.14.0 by @dependabot in #552
- Bump golang.org/x/crypto from 0.14.0 to 0.17.0 by @dependabot in #561
- Bump github.com/attestantio/go-eth2-client from 0.16.4 to 0.19.9 by @dependabot in #565
- Bump github.com/attestantio/go-builder-client from 0.3.0 to 0.4.2 by @dependabot in #559
Full Changelog: v0.28...v0.29
Docker Image: flashbots/mev-boost-relay:0.29
v0.28
Upgrade Notes
- This release adds holesky support with the flag
--network holesky
What's Changed
Adds a new LINK_DATA_API env var on the relay website for custom network customization. Also some caching optimizations for building the docker image.
- ci/cache docker layers by @paulopontesm in #543
- website custom data origin by @sukoneck in #549
- Add holesky support in relay by @avalonche in #554
Dependency Updates
- Bump github.com/flashbots/go-utils from 0.4.12 to 0.5.0 by @dependabot in #533
- Bump github.com/ethereum/go-ethereum from 1.12.2 to 1.13.1 by @dependabot in #531
- Bump github.com/ethereum/go-ethereum from 1.13.1 to 1.13.4 by @dependabot in #542
- Bump golang.org/x/net from 0.10.0 to 0.17.0 by @dependabot in #540
- Bump github.com/alicebob/miniredis/v2 from 2.30.5 to 2.31.0 by @dependabot in #539
New Contributors
- @paulopontesm made their first contribution in #543
- @sukoneck made their first contribution in #549
Full Changelog: v0.27...v0.28
Docker Image: flashbots/mev-boost-relay:0.28

