Skip to content

refactor(common): clarify watermark and cursor terminology#1850

Merged
Theodus merged 1 commit intomainfrom
theodus/watermark
Feb 23, 2026
Merged

refactor(common): clarify watermark and cursor terminology#1850
Theodus merged 1 commit intomainfrom
theodus/watermark

Conversation

@Theodus
Copy link
Member

@Theodus Theodus commented Feb 23, 2026

Distinguish watermarks (monotonic u64 block numbers) from cursors (resumption points with block num + hash):

  • Watermark: BlockNum type alias for segment progress tracking
  • NetworkCursor: block num + hash for single-network resumption
  • Cursor: multi-network map for stream resumption

Distinguish watermarks (monotonic u64 block numbers) from cursors
(resumption points with block num + hash):
- Watermark: BlockNum type alias for segment progress tracking
- NetworkCursor: block num + hash for single-network resumption
- Cursor: multi-network map for stream resumption
Primary changes:
- ResumeWatermark -> Cursor
- Watermark -> NetworkCursor
- QueryMessage::BlockComplete -> QueryMessage::Watermark
@Theodus Theodus requested review from LNSD and leoyvens February 23, 2026 17:23
@Theodus
Copy link
Member Author

Theodus commented Feb 23, 2026

Leaving as WIP for now, to avoid creating conflicts for @LNSD

@Theodus Theodus marked this pull request as ready for review February 23, 2026 17:30
Copy link
Contributor

@LNSD LNSD left a comment

Choose a reason for hiding this comment

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

LGTM ✅

@Theodus Theodus merged commit bb392c8 into main Feb 23, 2026
7 checks passed
@Theodus Theodus deleted the theodus/watermark branch February 23, 2026 17:38
@Theodus Theodus mentioned this pull request Feb 23, 2026
17 tasks
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.

2 participants