/* 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, } featureconfig.Init(cfg) 6. Add the string for the flags that should be running within E2E to E2EValidatorFlags and E2EBeaconChainFlags. */ package featureconfig import ( "github.com/prysmaticlabs/prysm/shared/params" "github.com/sirupsen/logrus" "gopkg.in/urfave/cli.v2" ) var log = logrus.WithField("prefix", "flags") // Flags is a struct to represent which features the client will perform on runtime. type Flags struct { MinimalConfig bool // MinimalConfig as defined in the spec. WriteSSZStateTransitions bool // WriteSSZStateTransitions to tmp directory. InitSyncNoVerify bool // InitSyncNoVerify when initial syncing w/o verifying block's contents. DisableDynamicCommitteeSubnets bool // Disables dynamic attestation committee subnets via p2p. SkipBLSVerify bool // Skips BLS verification across the runtime. EnableBackupWebhook bool // EnableBackupWebhook to allow database backups to trigger from monitoring port /db/backup. PruneEpochBoundaryStates bool // PruneEpochBoundaryStates prunes the epoch boundary state before last finalized check point. EnableSnappyDBCompression bool // EnableSnappyDBCompression in the database. ProtectProposer bool // ProtectProposer prevents the validator client from signing any proposals that would be considered a slashable offense. ProtectAttester bool // ProtectAttester prevents the validator client from signing any attestations that would be considered a slashable offense. DisableStrictAttestationPubsubVerification bool // DisableStrictAttestationPubsubVerification will disabling strict signature verification in pubsub. DisableUpdateHeadPerAttestation bool // DisableUpdateHeadPerAttestation will disabling update head on per attestation basis. EnableByteMempool bool // EnaableByteMempool memory management. EnableDomainDataCache bool // EnableDomainDataCache caches validator calls to DomainData per epoch. EnableStateGenSigVerify bool // EnableStateGenSigVerify verifies proposer and randao signatures during state gen. CheckHeadState bool // CheckHeadState checks the current headstate before retrieving the desired state from the db. EnableNoise bool // EnableNoise enables the beacon node to use NOISE instead of SECIO when performing a handshake with another peer. DontPruneStateStartUp bool // DontPruneStateStartUp disables pruning state upon beacon node start up. NewStateMgmt bool // NewStateMgmt enables the new state mgmt service. DisableInitSyncQueue bool // DisableInitSyncQueue disables the new initial sync implementation. EnableFieldTrie bool // EnableFieldTrie enables the state from using field specific tries when computing the root. EnableBlockHTR bool // EnableBlockHTR enables custom hashing of our beacon blocks. NoInitSyncBatchSaveBlocks bool // NoInitSyncBatchSaveBlocks disables batch save blocks mode during initial syncing. EnableStateRefCopy bool // EnableStateRefCopy copies the references to objects instead of the objects themselves when copying state fields. WaitForSynced bool // WaitForSynced uses WaitForSynced in validator startup to ensure it can communicate with the beacon node as soon as possible. // DisableForkChoice disables using LMD-GHOST fork choice to update // the head of the chain based on attestations and instead accepts any valid received block // as the chain head. UNSAFE, use with caution. DisableForkChoice bool // BroadcastSlashings enables p2p broadcasting of proposer or attester slashing. BroadcastSlashings bool // Cache toggles. EnableSSZCache bool // EnableSSZCache see https://github.com/prysmaticlabs/prysm/pull/4558. EnableEth1DataVoteCache bool // EnableEth1DataVoteCache; see https://github.com/prysmaticlabs/prysm/issues/3106. EnableSlasherConnection bool // EnableSlasher enable retrieval of slashing events from a slasher instance. EnableBlockTreeCache bool // EnableBlockTreeCache enable fork choice service to maintain latest filtered block tree. KafkaBootstrapServers string // KafkaBootstrapServers to find kafka servers to stream blocks, attestations, etc. CustomGenesisDelay uint64 // CustomGenesisDelay signals how long of a delay to set to start the chain. } var featureConfig *Flags // Get retrieves feature config. func Get() *Flags { if featureConfig == nil { return &Flags{} } return featureConfig } // Init sets the global config equal to the config that is passed in. func Init(c *Flags) { featureConfig = c } // Copy returns copy of the config object. func (c *Flags) Copy() *Flags { return &Flags{ MinimalConfig: c.MinimalConfig, WriteSSZStateTransitions: c.WriteSSZStateTransitions, InitSyncNoVerify: c.InitSyncNoVerify, DisableDynamicCommitteeSubnets: c.DisableDynamicCommitteeSubnets, SkipBLSVerify: c.SkipBLSVerify, EnableBackupWebhook: c.EnableStateRefCopy, PruneEpochBoundaryStates: c.PruneEpochBoundaryStates, EnableSnappyDBCompression: c.EnableSnappyDBCompression, ProtectProposer: c.ProtectProposer, ProtectAttester: c.ProtectAttester, DisableStrictAttestationPubsubVerification: c.DisableStrictAttestationPubsubVerification, DisableUpdateHeadPerAttestation: c.DisableUpdateHeadPerAttestation, EnableByteMempool: c.EnableByteMempool, EnableDomainDataCache: c.EnableDomainDataCache, EnableStateGenSigVerify: c.EnableStateGenSigVerify, CheckHeadState: c.CheckHeadState, EnableNoise: c.EnableNoise, DontPruneStateStartUp: c.DontPruneStateStartUp, NewStateMgmt: c.NewStateMgmt, DisableInitSyncQueue: c.DisableInitSyncQueue, EnableFieldTrie: c.EnableFieldTrie, EnableBlockHTR: c.EnableBlockHTR, NoInitSyncBatchSaveBlocks: c.NoInitSyncBatchSaveBlocks, EnableStateRefCopy: c.EnableStateRefCopy, WaitForSynced: c.WaitForSynced, DisableForkChoice: c.DisableForkChoice, BroadcastSlashings: c.BroadcastSlashings, EnableSSZCache: c.EnableSSZCache, EnableEth1DataVoteCache: c.EnableEth1DataVoteCache, EnableSlasherConnection: c.EnableSlasherConnection, EnableBlockTreeCache: c.EnableBlockTreeCache, KafkaBootstrapServers: c.KafkaBootstrapServers, CustomGenesisDelay: c.CustomGenesisDelay, } } // 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{} cfg = configureConfig(ctx, cfg) if ctx.Bool(devModeFlag.Name) { enableDevModeFlags(ctx) } delay := params.BeaconConfig().MinGenesisDelay if ctx.IsSet(customGenesisDelayFlag.Name) { delay = ctx.Uint64(customGenesisDelayFlag.Name) log.Warnf("Starting ETH2 with genesis delay of %d seconds", delay) } cfg.CustomGenesisDelay = delay if ctx.Bool(writeSSZStateTransitionsFlag.Name) { log.Warn("Writing SSZ states and blocks after state transitions") cfg.WriteSSZStateTransitions = true } if ctx.Bool(disableForkChoiceUnsafeFlag.Name) { log.Warn("UNSAFE: Disabled fork choice for updating chain head") cfg.DisableForkChoice = true } if ctx.Bool(disableDynamicCommitteeSubnets.Name) { log.Warn("Disabled dynamic attestation committee subnets") cfg.DisableDynamicCommitteeSubnets = true } cfg.EnableSSZCache = true if ctx.Bool(disableSSZCache.Name) { log.Warn("Disabled ssz cache") cfg.EnableSSZCache = false } if ctx.Bool(enableEth1DataVoteCacheFlag.Name) { log.Warn("Enabled unsafe eth1 data vote cache") cfg.EnableEth1DataVoteCache = true } if ctx.Bool(initSyncVerifyEverythingFlag.Name) { log.Warn("Initial syncing with verifying all block's content signatures.") cfg.InitSyncNoVerify = false } else { cfg.InitSyncNoVerify = true } if ctx.Bool(skipBLSVerifyFlag.Name) { log.Warn("UNSAFE: Skipping BLS verification at runtime") cfg.SkipBLSVerify = true } if ctx.Bool(enableBackupWebhookFlag.Name) { log.Warn("Allowing database backups to be triggered from HTTP webhook.") cfg.EnableBackupWebhook = true } if ctx.String(kafkaBootstrapServersFlag.Name) != "" { log.Warn("Enabling experimental kafka streaming.") cfg.KafkaBootstrapServers = ctx.String(kafkaBootstrapServersFlag.Name) } if ctx.Bool(enableSlasherFlag.Name) { log.Warn("Enable slasher connection.") cfg.EnableSlasherConnection = true } if ctx.Bool(cacheFilteredBlockTreeFlag.Name) { log.Warn("Enabled filtered block tree cache for fork choice.") cfg.EnableBlockTreeCache = true } if ctx.Bool(disableStrictAttestationPubsubVerificationFlag.Name) { log.Warn("Disabled strict attestation signature verification in pubsub") cfg.DisableStrictAttestationPubsubVerification = true } if ctx.Bool(disableUpdateHeadPerAttestation.Name) { log.Warn("Disabled update head on per attestation basis") cfg.DisableUpdateHeadPerAttestation = true } if ctx.Bool(enableByteMempool.Name) { log.Warn("Enabling experimental memory management for beacon state") cfg.EnableByteMempool = true } if ctx.Bool(enableStateGenSigVerify.Name) { log.Warn("Enabling sig verify for state gen") cfg.EnableStateGenSigVerify = true } if ctx.Bool(checkHeadState.Name) { log.Warn("Enabling check head state for chainservice") cfg.CheckHeadState = true } if ctx.Bool(enableNoiseHandshake.Name) { log.Warn("Enabling noise handshake for peer") cfg.EnableNoise = true } if ctx.Bool(dontPruneStateStartUp.Name) { log.Warn("Not enabling state pruning upon start up") cfg.DontPruneStateStartUp = true } if ctx.Bool(enableNewStateMgmt.Name) { log.Warn("Enabling state management service") cfg.NewStateMgmt = true } if ctx.Bool(disableInitSyncQueue.Name) { log.Warn("Disabled initial sync queue") cfg.DisableInitSyncQueue = true } if ctx.Bool(enableFieldTrie.Name) { log.Warn("Enabling state field trie") cfg.EnableFieldTrie = true } if ctx.Bool(enableCustomBlockHTR.Name) { log.Warn("Enabling custom block hashing") cfg.EnableBlockHTR = true } if ctx.Bool(disableInitSyncBatchSaveBlocks.Name) { log.Warn("Disabling init sync batch save blocks mode") cfg.NoInitSyncBatchSaveBlocks = true } if ctx.Bool(enableStateRefCopy.Name) { log.Warn("Enabling state reference copy") cfg.EnableStateRefCopy = true } if ctx.Bool(broadcastSlashingFlag.Name) { log.Warn("Enabling broadcast slashing to p2p network") cfg.BroadcastSlashings = 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) } // ConfigureValidator sets the global config based // on what flags are enabled for the validator client. func ConfigureValidator(ctx *cli.Context) { complainOnDeprecatedFlags(ctx) cfg := &Flags{} cfg = configureConfig(ctx, cfg) cfg.ProtectProposer = true if ctx.Bool(disableProtectProposerFlag.Name) { log.Warn("Disabled validator proposal slashing protection.") cfg.ProtectProposer = false } cfg.ProtectAttester = true if ctx.Bool(disableProtectAttesterFlag.Name) { log.Warn("Disabled validator attestation slashing protection.") cfg.ProtectAttester = false } if ctx.Bool(enableDomainDataCacheFlag.Name) { log.Warn("Enabled domain data cache.") cfg.EnableDomainDataCache = true } Init(cfg) } // enableDevModeFlags switches development mode features on. func enableDevModeFlags(ctx *cli.Context) { log.Warn("Enabling development mode flags") for _, f := range devModeFlags { 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]) } } } func configureConfig(ctx *cli.Context, cfg *Flags) *Flags { if ctx.Bool(minimalConfigFlag.Name) { log.Warn("Using minimal config") cfg.MinimalConfig = true params.UseMinimalConfig() } else { log.Warn("Using default mainnet config") } return cfg }