Backrun bundles

crates/op-rbuilder/src/args/op.rs

@@ -5,8 +5,8 @@
 //! clap [Args](clap::Args) for optimism rollup configuration
 
 use crate::{
-    flashtestations::args::FlashtestationsArgs, gas_limiter::args::GasLimiterArgs,
-    tx_signer::Signer,
+    backrun_bundle::BackrunBundleArgs, flashtestations::args::FlashtestationsArgs,
+    gas_limiter::args::GasLimiterArgs, tx_signer::Signer,
 };
 use alloy_primitives::Address;
 use anyhow::{Result, anyhow};
@@ -66,6 +66,8 @@ pub struct OpRbuilderArgs {
     pub flashtestations: FlashtestationsArgs,
     #[command(flatten)]
     pub gas_limiter: GasLimiterArgs,
+    #[command(flatten)]
+    pub backrun_bundle: BackrunBundleArgs,
 }
 
 impl Default for OpRbuilderArgs {

crates/op-rbuilder/src/backrun_bundle/args.rs

@@ -0,0 +1,57 @@
+use clap::Args;
+
+const DEFAULT_BACKRUNS_ENABLED: bool = false;
+const DEFAULT_MAX_CONSIDERED_PER_BLOCK: usize = 100;
+const DEFAULT_MAX_LANDED_PER_BLOCK: usize = 100;
+const DEFAULT_MAX_CONSIDERED_PER_TRANSACTION: usize = 10;
+const DEFAULT_MAX_LANDED_PER_TRANSACTION: usize = 1;
+
+#[derive(Debug, Clone, PartialEq, Eq, Args)]
+pub struct BackrunBundleArgs {
+    #[arg(long = "backruns.enabled", default_value_t = DEFAULT_BACKRUNS_ENABLED)]
+    pub backruns_enabled: bool,
+    #[arg(
+        long = "backruns.max_considered_backruns_per_block",
+        default_value_t = DEFAULT_MAX_CONSIDERED_PER_BLOCK
+    )]
+    pub max_considered_backruns_per_block: usize,
+    #[arg(long = "backruns.max_landed_backruns_per_block", default_value_t = DEFAULT_MAX_LANDED_PER_BLOCK)]
+    pub max_landed_backruns_per_block: usize,
+    #[arg(
+        long = "backruns.max_considered_backruns_per_transaction",
+        default_value_t = DEFAULT_MAX_CONSIDERED_PER_TRANSACTION
+    )]
+    pub max_considered_backruns_per_transaction: usize,
+    #[arg(
+        long = "backruns.max_landed_backruns_per_transaction",
+        default_value_t = DEFAULT_MAX_LANDED_PER_TRANSACTION
+    )]
+    pub max_landed_backruns_per_transaction: usize,
+}
+
+impl BackrunBundleArgs {
+    pub fn is_limit_reached(
+        &self,
+        block_backruns_considered: usize,
+        block_backruns_landed: usize,
+        tx_backruns_considered: usize,
+        tx_backruns_landed: usize,
+    ) -> bool {
+        tx_backruns_considered >= self.max_considered_backruns_per_transaction
+            || tx_backruns_landed >= self.max_landed_backruns_per_transaction
+            || block_backruns_considered >= self.max_considered_backruns_per_block
+            || block_backruns_landed >= self.max_landed_backruns_per_block
+    }
+}
+
+impl Default for BackrunBundleArgs {
+    fn default() -> Self {
+        Self {
+            backruns_enabled: DEFAULT_BACKRUNS_ENABLED,
+            max_considered_backruns_per_block: DEFAULT_MAX_CONSIDERED_PER_BLOCK,
+            max_landed_backruns_per_block: DEFAULT_MAX_LANDED_PER_BLOCK,
+            max_considered_backruns_per_transaction: DEFAULT_MAX_CONSIDERED_PER_TRANSACTION,
+            max_landed_backruns_per_transaction: DEFAULT_MAX_LANDED_PER_TRANSACTION,
+        }
+    }
+}