Skip to content

feat(node): mark sequencer flags as experimental#3802

Open
Ehsan-saradar wants to merge 2 commits into
NethermindEth:mainfrom
Ehsan-saradar:feat/3619-sequencer-experimental-flags
Open

feat(node): mark sequencer flags as experimental#3802
Ehsan-saradar wants to merge 2 commits into
NethermindEth:mainfrom
Ehsan-saradar:feat/3619-sequencer-experimental-flags

Conversation

@Ehsan-saradar

Copy link
Copy Markdown
Contributor

Description

Closes #3619.

Sequencer mode is still incomplete (the node identity/private key is regenerated on every run, and custom networks aren't supported yet), but its flags gave users no indication of that. This mirrors the existing P2P treatment so the sequencer is honestly surfaced as experimental — no behaviour changes, only informational.

What changed

  • Prefixed the --seq.* flag usage strings with EXPERIMENTAL: (seqEnUsage, seqBlockTimeUsage, seqGenesisFileUsage, seqDisableFeesUsage).
  • Renamed the help category from Sequencer to Sequencer (experimental), matching P2P (experimental).
  • Added a logger.Warn when sequencer mode is enabled, mirroring the P2P warning.

Notes

  • No logic, flag behaviour, or dependencies change — this is purely user-facing messaging.

Testing

  • make lint (diff + full): clean
  • make test: pass

Sequencer mode is still incomplete (unstable node identity, no custom
network support) but its flags gave no indication of that. Mirror the
existing P2P treatment: prefix the --seq.* flag usage strings with
EXPERIMENTAL, move them under a "Sequencer (experimental)" help category,
and log a warning when sequencer mode is enabled.

Closes NethermindEth#3619
Copilot AI review requested due to automatic review settings July 7, 2026 08:51

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR improves user-facing messaging around sequencer mode by explicitly marking sequencer CLI flags and help categories as experimental, and by adding a startup warning when sequencer mode is enabled (mirroring existing P2P experimental messaging).

Changes:

  • Prefixes --seq.* flag usage strings with EXPERIMENTAL:.
  • Renames the help category from Sequencer to Sequencer (experimental).
  • Adds a logger.Warn when sequencer mode is enabled.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
node/node.go Adds a warning log when sequencer mode is enabled to surface experimental status.
cmd/juno/usage.go Renames the sequencer help category to indicate experimental status.
cmd/juno/juno.go Updates sequencer flag usage strings to be prefixed with EXPERIMENTAL:.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread node/node.go
)

if cfg.Sequencer {
logger.Warn("Sequencer features enabled. Please note the sequencer is in experimental stage")

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Kept it as-is on purpose here — it mirrors the existing P2P warning so the two read the same. Rewording just this one would make them diverge, and touching the P2P message feels out of scope for this PR. Happy to align both in a follow-up if we want.

Comment thread cmd/juno/juno.go Outdated
seqEnUsage = "EXPERIMENTAL: Enables sequencer mode of operation"
seqBlockTimeUsage = "EXPERIMENTAL: Time to build a block, in seconds"
seqGenesisFileUsage = "EXPERIMENTAL: Path to the genesis file"
seqDisableFeesUsage = "EXPERIMENTAL: Skip charge fee for sequencer execution"

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch, fixed 👍 (that wording was already there — just tidied it while I was on the line).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Mark Sequencer flags as experimental, similar to how P2P flags are marked

2 participants