flags

Documentation

Index

• Variables
• func MergeFlags(groups ...[]cli.Flag) []cli.Flag

Variables

var (
	L1NodeEndpoint = cli.StringFlag{
		Name:     "l1",
		Usage:    "Websocket RPC endpoint of a L1 ethereum node",
		Required: true,
		Category: commonCategory,
	}
	L2NodeEndpoint = cli.StringFlag{
		Name:     "l2",
		Usage:    "Websocket RPC endpoint of a L2 taiko-geth node",
		Required: true,
		Category: commonCategory,
	}
	TaikoL1Address = cli.StringFlag{
		Name:     "taikoL1",
		Usage:    "TaikoL1 contract address",
		Required: true,
		Category: commonCategory,
	}
	TaikoL2Address = cli.StringFlag{
		Name:     "taikoL2",
		Usage:    "TaikoL2 contract address",
		Required: true,
		Category: commonCategory,
	}
	// Optional flags used by all client softwares.
	// Logging
	Verbosity = &cli.IntFlag{
		Name:     "verbosity",
		Usage:    "Logging verbosity: 0=silent, 1=error, 2=warn, 3=info, 4=debug, 5=detail",
		Value:    3,
		Category: loggingCategory,
	}
	LogJson = &cli.BoolFlag{
		Name:     "log.json",
		Usage:    "Format logs with JSON",
		Category: loggingCategory,
	}
	// Metrics
	MetricsEnabled = &cli.BoolFlag{
		Name:     "metrics",
		Usage:    "Enable metrics collection and reporting",
		Category: metricsCategory,
		Value:    false,
	}
	MetricsAddr = &cli.StringFlag{
		Name:     "metrics.addr",
		Usage:    "Metrics reporting server listening address",
		Category: metricsCategory,
		Value:    "0.0.0.0",
	}
	MetricsPort = &cli.IntFlag{
		Name:     "metrics.port",
		Usage:    "Metrics reporting server listening port",
		Category: metricsCategory,
		Value:    6060,
	}
)

Required flags used by all client softwares.

var (
	L2NodeEngineEndpoint = cli.StringFlag{
		Name:     "l2.engine",
		Usage:    "Engine API RPC endpoint of a L2 ethereum node",
		Required: true,
		Category: driverCategory,
	}
	ThrowawayBlocksBuilderPrivKey = cli.StringFlag{
		Name: "l2.throwawayBlockBuilderPrivKey",
		Usage: "Private key of the L2 throwaway blocks builder," +
			"who will be the suggested fee recipient of L2 throwaway blocks",
		Required: true,
		Category: driverCategory,
	}
	JWTSecret = cli.StringFlag{
		Name:     "jwtSecret",
		Usage:    "Path to a JWT secret to use for authenticated RPC endpoints",
		Required: true,
		Category: driverCategory,
	}
)

Flags used by driver.

var (
	L1ProposerPrivKey = cli.StringFlag{
		Name:     "l1.proposerPrivKey",
		Usage:    "Private key of the L1 proposer, who will send TaikoL1.proposeBlock transactions",
		Required: true,
		Category: proposerCategory,
	}
	L2SuggestedFeeRecipient = cli.StringFlag{
		Name:     "l2.suggestedFeeRecipient",
		Usage:    "Address of the proposed block's suggested fee recipient",
		Required: true,
		Category: proposerCategory,
	}
	ProposeInterval = cli.StringFlag{
		Name:     "proposeInterval",
		Usage:    "Time interval to propose L2 pending transactions",
		Required: true,
		Category: proposerCategory,
	}
)

Required flags used by proposer.

var (
	CommitSlot = cli.Uint64Flag{
		Name:     "commitSlot",
		Usage:    "The commit slot will be used by proposer, by default, a random number will be used",
		Value:    rand.Uint64(),
		Category: proposerCategory,
	}
	ShufflePoolContent = cli.BoolFlag{
		Name:     "shufflePoolContent",
		Usage:    "Perform a weighted shuffle when building the transactions list to propose",
		Value:    false,
		Category: proposerCategory,
	}
)

Optional flags used by proposer.

var (
	ProduceInvalidBlocks = cli.BoolFlag{
		Name:     "produceInvalidBlocks",
		Usage:    "Special flag for testnet testing, if activated, the proposer will start producing bad blocks",
		Hidden:   true,
		Category: proposerCategory,
	}
	ProduceInvalidBlocksInterval = cli.Uint64Flag{
		Name:     "produceInvalidBlocksInterval",
		Usage:    "Special flag for testnet testing, if activated, bad blocks will be produced every N valid blocks",
		Hidden:   true,
		Category: proposerCategory,
	}
)

Special flags for testing.

var (
	ZkEvmRpcdEndpoint = cli.StringFlag{
		Name:     "zkevmRpcdEndpoint",
		Usage:    "RPC endpoint of a ZKEVM RPCD service",
		Required: true,
		Category: proverCategory,
	}
	ZkEvmRpcdParamsPath = cli.StringFlag{
		Name:     "zkevmRpcdParamsPath",
		Usage:    "Path of ZKEVM parameters file to use",
		Required: true,
		Category: proverCategory,
	}
	L1ProverPrivKey = cli.StringFlag{
		Name: "l1.proverPrivKey",
		Usage: "Private key of L1 prover, " +
			"who will send TaikoL1.proveBlock / TaikoL1.proveBlockInvalid transactions",
		Required: true,
		Category: proverCategory,
	}
)

Required flags used by prover.

var CommonFlags = []cli.Flag{

	&L1NodeEndpoint,
	&L2NodeEndpoint,
	&TaikoL1Address,
	&TaikoL2Address,

	Verbosity,
	LogJson,
	MetricsEnabled,
	MetricsAddr,
	MetricsPort,
}

All common flags.

var DriverFlags = MergeFlags(CommonFlags, []cli.Flag{
	&L2NodeEngineEndpoint,
	&ThrowawayBlocksBuilderPrivKey,
	&JWTSecret,
	&P2PSyncVerifiedBlocks,
})

All driver flags.

var (
	Dummy = cli.BoolFlag{
		Name:     "dummy",
		Usage:    "Produce dummy proofs",
		Value:    false,
		Category: proverCategory,
	}
)

Special flags for testing.

var (
	P2PSyncVerifiedBlocks = cli.BoolFlag{
		Name:     "p2p.syncVerifiedBlocks",
		Usage:    "Try P2P syncing verified blocks between L2 nodes, will be helpful to bring a new node online quickly",
		Value:    false,
		Category: driverCategory,
	}
)

Optional flags used by driver.

var ProposerFlags = MergeFlags(CommonFlags, []cli.Flag{
	&L1ProposerPrivKey,
	&L2SuggestedFeeRecipient,
	&ProposeInterval,
	&ProduceInvalidBlocks,
	&ProduceInvalidBlocksInterval,
	&ShufflePoolContent,
	&CommitSlot,
})

All proposer flags.

var ProverFlags = MergeFlags(CommonFlags, []cli.Flag{
	&ZkEvmRpcdEndpoint,
	&ZkEvmRpcdParamsPath,
	&L1ProverPrivKey,
	&Dummy,
})

All prover flags.

Functions

func MergeFlags

func MergeFlags(groups ...[]cli.Flag) []cli.Flag

MergeFlags merges the given flag slices.