adding builder boost factor to proposer settings

cmd/beacon-chain/flags/base.go

@@ -27,8 +27,8 @@ var (
 	// LocalBlockValueBoost sets a percentage boost for local block construction while using a custom builder.
 	LocalBlockValueBoost = &cli.Uint64Flag{
 		Name: "local-block-value-boost",
-		Usage: "A percentage boost for local block construction as a Uint64. This is used to prioritize local block construction over relay/builder block construction" +
-			"Boost is an additional percentage to multiple local block value. Use builder block if: builder_bid_value * 100 > local_block_value * (local-block-value-boost + 100)",
+		Usage: "A percentage boost for local block construction as a Uint64. This is used to prioritize local block construction over relay/builder block construction. " +
+			"Boost is an additional percentage to multiple local block value. Use builder block if: builder_value * builder-boost-factor > local_value * (local-block-value-boost + 100)",
 		Value: 10,
 	}
 	// ExecutionEngineEndpoint provides an HTTP access endpoint to connect to an execution client on the execution layer

cmd/validator/flags/flags.go

@@ -366,6 +366,14 @@ var (
 		Value: fmt.Sprint(params.BeaconConfig().DefaultBuilderGasLimit),
 	}
 
+	// BuilderBoostFactorFlag sets a multiplier for builder block construction as a Uint64.
+	BuilderBoostFactorFlag = &cli.Uint64Flag{
+		Name: "builder-boost-factor",
+		Usage: "A multiplier for builder block construction as a Uint64. This is used to prioritize relay/builder block construction over local block construction. " +
+			"Boost factor is a multiplier against the builder value. Use builder block if: builder_value * builder-boost-factor > local_value * (local-block-value-boost + 100)",
+		Value: 100,
+	}
+
 	// ValidatorsRegistrationBatchSizeFlag sets the maximum size for one batch of validator registrations. Use a non-positive value to disable batching.
 	ValidatorsRegistrationBatchSizeFlag = &cli.IntFlag{
 		Name:  "validators-registration-batch-size",

cmd/validator/main.go

@@ -83,6 +83,7 @@ var appFlags = []cli.Flag{
 	flags.ProposerSettingsFlag,
 	flags.EnableBuilderFlag,
 	flags.BuilderGasLimitFlag,
+	flags.BuilderBoostFactorFlag,
 	flags.ValidatorsRegistrationBatchSizeFlag,
 	////////////////////
 	cmd.DisableMonitoringFlag,

cmd/validator/usage.go

@@ -121,6 +121,7 @@ var appHelpFlagGroups = []flagGroup{
 			flags.SuggestedFeeRecipientFlag,
 			flags.EnableBuilderFlag,
 			flags.BuilderGasLimitFlag,
+			flags.BuilderBoostFactorFlag,
 			flags.ValidatorsRegistrationBatchSizeFlag,
 			flags.EnableDistributed,
 		},

config/proposer/loader/loader.go

@@ -35,8 +35,9 @@ type settingsLoader struct {
 }
 
 type flagOptions struct {
-	builderConfig *proposer.BuilderConfig
-	gasLimit      *validator.Uint64
+	builderConfig      *proposer.BuilderConfig
+	gasLimit           *validator.Uint64
+	builderBoostFactor *uint64
 }
 
 // SettingsLoaderOption sets additional options that affect the proposer settings
@@ -74,6 +75,17 @@ func WithGasLimit() SettingsLoaderOption {
 	}
 }
 
+// WithBuilderBoostFactor applies the --builder-boost-factor flag to proposer settings
+func WithBuilderBoostFactor() SettingsLoaderOption {
+	return func(cliCtx *cli.Context, psl *settingsLoader) error {
+		if cliCtx.IsSet(flags.BuilderBoostFactorFlag.Name) {
+			bbf := cliCtx.Uint64(flags.BuilderBoostFactorFlag.Name)
+			psl.options.builderBoostFactor = &bbf
+		}
+		return nil
+	}
+}
+
 // NewProposerSettingsLoader returns a new proposer settings loader that can process the proposer settings based on flag options
 func NewProposerSettingsLoader(cliCtx *cli.Context, db iface.ValidatorDB, opts ...SettingsLoaderOption) (*settingsLoader, error) {
 	if cliCtx.IsSet(flags.ProposerSettingsFlag.Name) && cliCtx.IsSet(flags.ProposerSettingsURLFlag.Name) {
@@ -117,8 +129,11 @@ func (psl *settingsLoader) Load(cliCtx *cli.Context) (*proposer.Settings, error)
 	loadConfig := &validatorpb.ProposerSettingsPayload{}
 
 	// override settings based on other options
-	if psl.options.builderConfig != nil && psl.options.gasLimit != nil {
-		psl.options.builderConfig.GasLimit = *psl.options.gasLimit
+	if psl.options != nil && psl.options.builderConfig != nil {
+		if psl.options.gasLimit != nil {
+			psl.options.builderConfig.GasLimit = *psl.options.gasLimit
+		}
+		psl.options.builderConfig.BuilderBoostFactor = psl.options.builderBoostFactor
 	}
 
 	// check if database has settings already
@@ -205,20 +220,8 @@ func (psl *settingsLoader) processProposerSettings(loadedSettings, dbSettings *v
 	// loaded settings have higher priority than db settings
 	newSettings := &validatorpb.ProposerSettingsPayload{}
 
-	var builderConfig *validatorpb.BuilderConfig
-	var gasLimitOnly *validator.Uint64
-
-	if psl.options != nil {
-		if psl.options.builderConfig != nil {
-			builderConfig = psl.options.builderConfig.ToConsensus()
-		}
-		if psl.options.gasLimit != nil {
-			gasLimitOnly = psl.options.gasLimit
-		}
-	}
-
 	if dbSettings != nil && dbSettings.DefaultConfig != nil {
-		if builderConfig == nil {
+		if psl.options == nil || psl.options.builderConfig == nil {
 			dbSettings.DefaultConfig.Builder = nil
 		}
 		newSettings.DefaultConfig = dbSettings.DefaultConfig
@@ -229,12 +232,12 @@ func (psl *settingsLoader) processProposerSettings(loadedSettings, dbSettings *v
 
 	// process any builder overrides on defaults
 	if newSettings.DefaultConfig != nil {
-		newSettings.DefaultConfig.Builder = processBuilderConfig(newSettings.DefaultConfig.Builder, builderConfig, gasLimitOnly)
+		newSettings.DefaultConfig.Builder = processBuilderConfig(newSettings.DefaultConfig.Builder, psl.options)
 	}
 
 	if dbSettings != nil && len(dbSettings.ProposerConfig) != 0 {
 		for _, option := range dbSettings.ProposerConfig {
-			if builderConfig == nil {
+			if psl.options == nil || psl.options.builderConfig == nil {
 				option.Builder = nil
 			}
 		}
@@ -247,7 +250,7 @@ func (psl *settingsLoader) processProposerSettings(loadedSettings, dbSettings *v
 	// process any overrides for proposer config
 	for _, option := range newSettings.ProposerConfig {
 		if option != nil {
-			option.Builder = processBuilderConfig(option.Builder, builderConfig, gasLimitOnly)
+			option.Builder = processBuilderConfig(option.Builder, psl.options)
 		}
 	}
 
@@ -259,18 +262,38 @@ func (psl *settingsLoader) processProposerSettings(loadedSettings, dbSettings *v
 	return newSettings
 }
 
-func processBuilderConfig(current *validatorpb.BuilderConfig, override *validatorpb.BuilderConfig, gasLimitOnly *validator.Uint64) *validatorpb.BuilderConfig {
-	if current != nil {
-		current.GasLimit = reviewGasLimit(current.GasLimit)
-		if override != nil {
-			current.Enabled = override.Enabled
-		}
-		if gasLimitOnly != nil {
-			current.GasLimit = *gasLimitOnly
-		}
+func processBuilderConfig(current *validatorpb.BuilderConfig, options *flagOptions) *validatorpb.BuilderConfig {
+	// If there are no options, return what was passed in
+	if options == nil {
 		return current
 	}
-	return override
+
+	// Initialize an override variable
+	var override *validatorpb.BuilderConfig
+	if options.builderConfig != nil {
+		// Convert the builder config to consensus form if it exists
+		override = options.builderConfig.ToConsensus()
+	}
+	// If there's nothing to process further, return the override or current based on what's available
+	if current == nil {
+		return override
+	}
+
+	if override != nil {
+		current.Enabled = override.Enabled
+	}
+
+	if options.gasLimit != nil {
+		current.GasLimit = *options.gasLimit
+	}
+
+	current.GasLimit = reviewGasLimit(current.GasLimit)
+
+	if options.builderBoostFactor != nil {
+		current.BuilderBoostFactor = options.builderBoostFactor
+	}
+
+	return current
 }
 
 func reviewGasLimit(gasLimit validator.Uint64) validator.Uint64 {