feat: adds a flashbots provider #158

dylanlott · 2025-10-02T21:57:59Z

feat: adds a Flashbots provider and submitter

This PR adds a Flashbots provider and submit task to the Builder.

It configures the Flashbots provider from the configured relay URL and uses the builder's signer key to sign all of the bundles it submits to Flashbots.

The Flashbots rbuilder endpoint on Pecorino does not return a proper EthBundleHash when a bundle is submitted, in fact it simply returns an empty response upon success. The endpoint also does not support simulation, so the Flashbots submit task blindly sends the prepared bundle and logs any errors that are returned.

Closes ENG-1414
Closes ENG-1403

dylanlott · 2025-10-02T21:58:15Z

chore: removes bin-base flashbots dependency #160
feat: adds a flashbots provider #158 👈 (View in Graphite)
fix: glibc runtime errors #159
deps: update alloy and add provider-mev-api flag #157
main

This stack of pull requests is managed by Graphite. Learn more about stacking.

- adds a Flashbots provider with the alloy MEV API extensions - adds the logic for building Flashbots bundles in the builder - adds the Flashbots submission task

dylanlott · 2025-10-08T19:08:19Z

src/tasks/submit/flashbots.rs

+                Ok(Some(hash)) => {
+                    tracing::info!(host_block_number = sim_result.host_block_number(), bundle_hash = ?hash, "bundle submitted to flashbots");
+                    span_debug!(span, "bundle submitted to flashbots");
+                }
+                Ok(None) => {
+                    tracing::info!(
+                        host_block_number = sim_result.host_block_number(),
+                        "bundle submitted to flashbots without error"
                    );
-                })
-                .inspect_err(|err| {
-                    span_error!(span, %err, "failed to send bundle to Flashbots");
-                });
+                    span_debug!(span, "bundle submitted to flashbots");
+                }


There is some weirdness here because the rbuilder response doesn't adhere to the Flashbots spec and returns a completely empty response instead of a bundle hash when successfully submitted, but we also want to handle the case where the endpoint does return the expected response. So we log both.

duplicate event

src/tasks/submit/flashbots.rs

prestwich · 2025-10-15T19:08:39Z

src/tasks/submit/flashbots.rs

+            let bundle = match self.prepare(&sim_result).instrument(span.clone()).await {
+                Ok(b) => b,
+                Err(e) => {
+                    tracing::error!(error = %e, "failed to prepare MEV bundle");


duplicate event

prestwich · 2025-10-15T19:08:51Z

src/tasks/submit/flashbots.rs

+                Ok(Some(hash)) => {
+                    tracing::info!(host_block_number = sim_result.host_block_number(), bundle_hash = ?hash, "bundle submitted to flashbots");
+                    span_debug!(span, "bundle submitted to flashbots");
+                }
+                Ok(None) => {
+                    tracing::info!(
+                        host_block_number = sim_result.host_block_number(),
+                        "bundle submitted to flashbots without error"
                    );
-                })
-                .inspect_err(|err| {
-                    span_error!(span, %err, "failed to send bundle to Flashbots");
-                });
+                    span_debug!(span, "bundle submitted to flashbots");
+                }


duplicate event

prestwich · 2025-10-15T19:09:10Z

src/tasks/submit/flashbots.rs

+            match response {
+                Ok(Some(hash)) => {
+                    tracing::info!(host_block_number = sim_result.host_block_number(), bundle_hash = ?hash, "bundle submitted to flashbots");
+                    span_debug!(span, "bundle submitted to flashbots");


duplicate event

prestwich · 2025-10-15T19:09:17Z

src/tasks/submit/flashbots.rs

+                    span_debug!(span, "bundle submitted to flashbots");
+                }
+                Ok(None) => {
+                    tracing::info!(


duplicate event

src/config.rs

prestwich · 2025-10-15T21:00:48Z

src/config.rs

 impl BuilderConfig {
    /// Connect to the Builder signer.
-    pub async fn connect_builder_signer(&self) -> Result<LocalOrAws, SignerError> {
+    pub async fn connect_builder_signer(&self) -> eyre::Result<LocalOrAws> {


why is this type changing?

To make it work with the error type try_join expects. The other connect_* functions return eyre::Result types, so it must match the others' return signatures.

ah ya makes sense

ffr, you can use the FutureExt trait to map future output types in-line

https://docs.rs/futures/latest/futures/future/trait.TryFutureExt.html#method.or_else

in this case something like config.connect_builder_signer().or_else(|e| Err(e.into()))

try_join!( async_fn_1(), async_fn_2().or_else(|e| Err(e.into)), )

prestwich · 2025-10-15T21:02:31Z

src/tasks/submit/flashbots.rs

+                    span_debug!(span, "bundle submitted to flashbots");
+                }
+                Err(e) => {
+                    tracing::error!(error = %e, "failed to submit MEV bundle to flashbots");


duplicate event

src/config.rs

dylanlott mentioned this pull request Oct 2, 2025

deps: update alloy and add provider-mev-api flag #157

Merged

dylanlott temporarily deployed to dev October 2, 2025 22:01 — with GitHub Actions Inactive

dylanlott temporarily deployed to dev October 6, 2025 17:56 — with GitHub Actions Inactive

dylanlott temporarily deployed to dev October 6, 2025 18:49 — with GitHub Actions Inactive

dylanlott temporarily deployed to dev October 6, 2025 20:52 — with GitHub Actions Inactive

dylanlott temporarily deployed to dev October 6, 2025 22:16 — with GitHub Actions Inactive

dylanlott changed the base branch from dylan/update-alloy to graphite-base/158 October 7, 2025 01:15

dylanlott force-pushed the dylan/flashbots-provider branch from 91e0f7c to 178ed31 Compare October 7, 2025 01:15

dylanlott changed the base branch from graphite-base/158 to dylan/glibc October 7, 2025 01:15

dylanlott mentioned this pull request Oct 7, 2025

fix: glibc runtime errors #159

Merged

dylanlott force-pushed the dylan/flashbots-provider branch from 178ed31 to 7f24250 Compare October 7, 2025 01:16

dylanlott force-pushed the dylan/glibc branch from dc8a358 to c51ec23 Compare October 7, 2025 01:23

dylanlott force-pushed the dylan/flashbots-provider branch 2 times, most recently from 26149ac to d275db4 Compare October 7, 2025 01:24

dylanlott force-pushed the dylan/glibc branch from 56d2a07 to 3cbc74f Compare October 7, 2025 01:49

dylanlott force-pushed the dylan/flashbots-provider branch from d275db4 to 514db31 Compare October 7, 2025 01:49

dylanlott force-pushed the dylan/glibc branch 2 times, most recently from a308c0a to b83f0e2 Compare October 7, 2025 21:43

dylanlott force-pushed the dylan/flashbots-provider branch from 514db31 to 14fa362 Compare October 7, 2025 21:43

dylanlott changed the base branch from dylan/glibc to graphite-base/158 October 8, 2025 09:16

dylanlott force-pushed the graphite-base/158 branch from b83f0e2 to 60c3b30 Compare October 8, 2025 09:16

dylanlott force-pushed the dylan/flashbots-provider branch from 14fa362 to cb97db3 Compare October 8, 2025 09:16

graphite-app bot changed the base branch from graphite-base/158 to main October 8, 2025 09:17

dylanlott force-pushed the dylan/flashbots-provider branch 2 times, most recently from 0d8762a to 017a945 Compare October 8, 2025 18:33

dylanlott changed the title ~~wip: adds a flashbots provider~~ feat: adds a flashbots provider Oct 8, 2025

dylanlott marked this pull request as ready for review October 8, 2025 18:41

dylanlott requested review from Evalir and prestwich as code owners October 8, 2025 18:41

dylanlott force-pushed the dylan/flashbots-provider branch from bbde89d to a6aac19 Compare October 8, 2025 19:06

dylanlott added 2 commits October 8, 2025 14:05

feat: adds a flashbots provider and submitter

b3c8198

- adds a Flashbots provider with the alloy MEV API extensions - adds the logic for building Flashbots bundles in the builder - adds the Flashbots submission task

bump alloy back up

7886cce

dylanlott force-pushed the dylan/flashbots-provider branch from a6aac19 to bf0b272 Compare October 8, 2025 20:06

cleanup

25f69fa

dylanlott force-pushed the dylan/flashbots-provider branch from bf0b272 to 25f69fa Compare October 8, 2025 20:08

dylanlott mentioned this pull request Oct 8, 2025

chore: removes bin-base flashbots dependency #160

Merged

dylanlott commented Oct 8, 2025

View reviewed changes

prestwich requested changes Oct 15, 2025

View reviewed changes

fix: condense flashbots constructor items into try_join

4da04ad

prestwich requested changes Oct 15, 2025

View reviewed changes

dylanlott added 5 commits October 15, 2025 15:15

cleanup: adjust scope of clone in flashbots config

9845206

cleanup logging and span usage

57cba6c

fmt clippy

cae2cae

add a log back in

fa3fdb8

use bin-base tracing instead of native tracing

f69a65a

Evalir reviewed Oct 20, 2025

View reviewed changes

src/config.rs Outdated Show resolved Hide resolved

return flashbots type instead of full filler type

e4e09cf

dylanlott requested a review from prestwich October 20, 2025 18:52

prestwich approved these changes Oct 20, 2025

View reviewed changes

dylanlott merged commit 9fac4e0 into main Oct 20, 2025
6 checks passed

dylanlott deleted the dylan/flashbots-provider branch October 20, 2025 20:13

feat: adds a flashbots provider #158

feat: adds a flashbots provider #158

Uh oh!

Conversation

dylanlott commented Oct 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

feat: adds a Flashbots provider and submitter

Uh oh!

dylanlott commented Oct 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

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!

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!

prestwich Oct 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

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!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

dylanlott commented Oct 2, 2025 •

edited

Loading

dylanlott commented Oct 2, 2025 •

edited

Loading

prestwich Oct 15, 2025 •

edited

Loading