/* Package featureconfig defines which features are enabled for runtime in order to selectively enable certain features to maintain a stable runtime. The process for implementing new features using this package is as follows: 1. Add a new CMD flag in flags.go, and place it in the proper list(s) var for its client. 2. Add a condition for the flag in the proper Configure function(s) below. 3. Place any "new" behavior in the `if flagEnabled` statement. 4. Place any "previous" behavior in the `else` statement. 5. Ensure any tests using the new feature fail if the flag isn't enabled. 5a. Use the following to enable your flag for tests: cfg := &featureconfig.Flags{ VerifyAttestationSigs: true, } resetCfg := featureconfig.InitWithReset(cfg) defer resetCfg() 6. Add the string for the flags that should be running within E2E to E2EValidatorFlags and E2EBeaconChainFlags. */ package featureconfig import ( "sync" "time" "github.com/prysmaticlabs/prysm/shared/params" "github.com/sirupsen/logrus" "github.com/urfave/cli/v2" ) var log = logrus.WithField("prefix", "flags") const enabledFeatureFlag = "Enabled feature flag" // Flags is a struct to represent which features the client will perform on runtime. type Flags struct { // Testnet Flags. ToledoTestnet bool // ToledoTestnet defines the flag through which we can enable the node to run on the Toledo testnet. PyrmontTestnet bool // PyrmontTestnet defines the flag through which we can enable the node to run on the Pyrmont testnet. // Feature related flags. WriteSSZStateTransitions bool // WriteSSZStateTransitions to tmp directory. SkipBLSVerify bool // Skips BLS verification across the runtime. SlasherProtection bool // SlasherProtection protects validator fron sending over a slashable offense over the network using external slasher. EnablePeerScorer bool // EnablePeerScorer enables experimental peer scoring in p2p. EnableLargerGossipHistory bool // EnableLargerGossipHistory increases the gossip history we store in our caches. WriteWalletPasswordOnWebOnboarding bool // WriteWalletPasswordOnWebOnboarding writes the password to disk after Prysm web signup. DisableAttestingHistoryDBCache bool // DisableAttestingHistoryDBCache for the validator client increases disk reads/writes. UpdateHeadTimely bool // UpdateHeadTimely updates head right after state transition. ProposerAttsSelectionUsingMaxCover bool // ProposerAttsSelectionUsingMaxCover enables max-cover algorithm when selecting attestations for proposing. EnableOptimizedBalanceUpdate bool // EnableOptimizedBalanceUpdate uses an updated method of performing balance updates. EnableDoppelGanger bool // EnableDoppelGanger enables doppelganger protection on startup for the validator. // Logging related toggles. DisableGRPCConnectionLogs bool // Disables logging when a new grpc client has connected. // Slasher toggles. DisableLookback bool // DisableLookback updates slasher to not use the lookback and update validator histories until epoch 0. DisableBroadcastSlashings bool // DisableBroadcastSlashings disables p2p broadcasting of proposer and attester slashings. // Cache toggles. EnableSSZCache bool // EnableSSZCache see https://github.com/prysmaticlabs/prysm/pull/4558. EnableNextSlotStateCache bool // EnableNextSlotStateCache enables next slot state cache to improve validator performance. // Bug fixes related flags. AttestTimely bool // AttestTimely fixes #8185. It is gated behind a flag to ensure beacon node's fix can safely roll out first. We'll invert this in v1.1.0. KafkaBootstrapServers string // KafkaBootstrapServers to find kafka servers to stream blocks, attestations, etc. AttestationAggregationStrategy string // AttestationAggregationStrategy defines aggregation strategy to be used when aggregating. // KeystoreImportDebounceInterval specifies the time duration the validator waits to reload new keys if they have // changed on disk. This feature is for advanced use cases only. KeystoreImportDebounceInterval time.Duration // EnableSlashingProtectionPruning for the validator client. EnableSlashingProtectionPruning bool } var featureConfig *Flags var featureConfigLock sync.RWMutex // Get retrieves feature config. func Get() *Flags { featureConfigLock.RLock() defer featureConfigLock.RUnlock() if featureConfig == nil { return &Flags{} } return featureConfig } // Init sets the global config equal to the config that is passed in. func Init(c *Flags) { featureConfigLock.Lock() defer featureConfigLock.Unlock() featureConfig = c } // InitWithReset sets the global config and returns function that is used to reset configuration. func InitWithReset(c *Flags) func() { var prevConfig Flags if featureConfig != nil { prevConfig = *featureConfig } else { prevConfig = Flags{} } resetFunc := func() { Init(&prevConfig) } Init(c) return resetFunc } // configureTestnet sets the config according to specified testnet flag func configureTestnet(ctx *cli.Context, cfg *Flags) { if ctx.Bool(ToledoTestnet.Name) { log.Warn("Running on Toledo Testnet") params.UseToledoConfig() params.UseToledoNetworkConfig() cfg.ToledoTestnet = true } else if ctx.Bool(PyrmontTestnet.Name) { log.Warn("Running on Pyrmont Testnet") params.UsePyrmontConfig() params.UsePyrmontNetworkConfig() cfg.PyrmontTestnet = true } else if ctx.Bool(PraterTestnet.Name) { log.Warn("Running on the Prater Testnet") params.UsePraterConfig() params.UsePraterNetworkConfig() } else { log.Warn("Running on Ethereum Consensus Mainnet") params.UseMainnetConfig() } } // ConfigureBeaconChain sets the global config based // on what flags are enabled for the beacon-chain client. func ConfigureBeaconChain(ctx *cli.Context) { complainOnDeprecatedFlags(ctx) cfg := &Flags{} if ctx.Bool(devModeFlag.Name) { enableDevModeFlags(ctx) } configureTestnet(ctx, cfg) if ctx.Bool(writeSSZStateTransitionsFlag.Name) { log.WithField(writeSSZStateTransitionsFlag.Name, writeSSZStateTransitionsFlag.Usage).Warn(enabledFeatureFlag) cfg.WriteSSZStateTransitions = true } cfg.EnableSSZCache = true if ctx.String(kafkaBootstrapServersFlag.Name) != "" { log.WithField(kafkaBootstrapServersFlag.Name, kafkaBootstrapServersFlag.Usage).Warn(enabledFeatureFlag) cfg.KafkaBootstrapServers = ctx.String(kafkaBootstrapServersFlag.Name) } if ctx.IsSet(disableGRPCConnectionLogging.Name) { log.WithField(disableGRPCConnectionLogging.Name, disableGRPCConnectionLogging.Usage).Warn(enabledFeatureFlag) cfg.DisableGRPCConnectionLogs = true } cfg.AttestationAggregationStrategy = ctx.String(attestationAggregationStrategy.Name) if ctx.Bool(forceOptMaxCoverAggregationStategy.Name) { log.WithField(forceOptMaxCoverAggregationStategy.Name, forceOptMaxCoverAggregationStategy.Usage).Warn(enabledFeatureFlag) cfg.AttestationAggregationStrategy = "opt_max_cover" } if ctx.Bool(enablePeerScorer.Name) { log.WithField(enablePeerScorer.Name, enablePeerScorer.Usage).Warn(enabledFeatureFlag) cfg.EnablePeerScorer = true } if ctx.Bool(checkPtInfoCache.Name) { log.Warn("Advance check point info cache is no longer supported and will soon be deleted") } if ctx.Bool(enableLargerGossipHistory.Name) { log.WithField(enableLargerGossipHistory.Name, enableLargerGossipHistory.Usage).Warn(enabledFeatureFlag) cfg.EnableLargerGossipHistory = true } if ctx.Bool(disableBroadcastSlashingFlag.Name) { log.WithField(disableBroadcastSlashingFlag.Name, disableBroadcastSlashingFlag.Usage).Warn(enabledFeatureFlag) cfg.DisableBroadcastSlashings = true } if ctx.Bool(enableNextSlotStateCache.Name) { log.WithField(enableNextSlotStateCache.Name, enableNextSlotStateCache.Usage).Warn(enabledFeatureFlag) cfg.EnableNextSlotStateCache = true } if ctx.Bool(updateHeadTimely.Name) { log.WithField(updateHeadTimely.Name, updateHeadTimely.Usage).Warn(enabledFeatureFlag) cfg.UpdateHeadTimely = true } cfg.ProposerAttsSelectionUsingMaxCover = true if ctx.Bool(disableProposerAttsSelectionUsingMaxCover.Name) { log.WithField(disableProposerAttsSelectionUsingMaxCover.Name, disableProposerAttsSelectionUsingMaxCover.Usage).Warn(enabledFeatureFlag) cfg.ProposerAttsSelectionUsingMaxCover = false } if ctx.Bool(enableOptimizedBalanceUpdate.Name) { log.WithField(enableOptimizedBalanceUpdate.Name, enableOptimizedBalanceUpdate.Usage).Warn(enabledFeatureFlag) cfg.EnableOptimizedBalanceUpdate = true } Init(cfg) } // ConfigureSlasher sets the global config based // on what flags are enabled for the slasher client. func ConfigureSlasher(ctx *cli.Context) { complainOnDeprecatedFlags(ctx) cfg := &Flags{} configureTestnet(ctx, cfg) if ctx.Bool(disableLookbackFlag.Name) { log.WithField(disableLookbackFlag.Name, disableLookbackFlag.Usage).Warn(enabledFeatureFlag) cfg.DisableLookback = true } Init(cfg) } // ConfigureValidator sets the global config based // on what flags are enabled for the validator client. func ConfigureValidator(ctx *cli.Context) { complainOnDeprecatedFlags(ctx) cfg := &Flags{} configureTestnet(ctx, cfg) if ctx.Bool(enableExternalSlasherProtectionFlag.Name) { log.WithField(enableExternalSlasherProtectionFlag.Name, enableExternalSlasherProtectionFlag.Usage).Warn(enabledFeatureFlag) cfg.SlasherProtection = true } if ctx.Bool(writeWalletPasswordOnWebOnboarding.Name) { log.WithField(writeWalletPasswordOnWebOnboarding.Name, writeWalletPasswordOnWebOnboarding.Usage).Warn(enabledFeatureFlag) cfg.WriteWalletPasswordOnWebOnboarding = true } if ctx.Bool(disableAttestingHistoryDBCache.Name) { log.WithField(disableAttestingHistoryDBCache.Name, disableAttestingHistoryDBCache.Usage).Warn(enabledFeatureFlag) cfg.DisableAttestingHistoryDBCache = true } if ctx.Bool(attestTimely.Name) { log.WithField(attestTimely.Name, attestTimely.Usage).Warn(enabledFeatureFlag) cfg.AttestTimely = true } if ctx.Bool(enableSlashingProtectionPruning.Name) { log.WithField(enableSlashingProtectionPruning.Name, enableSlashingProtectionPruning.Usage).Warn(enabledFeatureFlag) cfg.EnableSlashingProtectionPruning = true } if ctx.Bool(enableDoppelGangerProtection.Name) { log.WithField(enableDoppelGangerProtection.Name, enableDoppelGangerProtection.Usage).Warn(enabledFeatureFlag) cfg.EnableDoppelGanger = true } cfg.KeystoreImportDebounceInterval = ctx.Duration(dynamicKeyReloadDebounceInterval.Name) Init(cfg) } // enableDevModeFlags switches development mode features on. func enableDevModeFlags(ctx *cli.Context) { log.Warn("Enabling development mode flags") for _, f := range devModeFlags { log.WithField("flag", f.Names()[0]).Debug("Enabling development mode flag") if !ctx.IsSet(f.Names()[0]) { if err := ctx.Set(f.Names()[0], "true"); err != nil { log.WithError(err).Debug("Error enabling development mode flag") } } } } func complainOnDeprecatedFlags(ctx *cli.Context) { for _, f := range deprecatedFlags { if ctx.IsSet(f.Names()[0]) { log.Errorf("%s is deprecated and has no effect. Do not use this flag, it will be deleted soon.", f.Names()[0]) } } }