Skip to content

feat(propagation): add block and attestation propagation notebooks #45

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
raulk wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat(propagation): add block and attestation propagation notebooks #45

raulk wants to merge 1 commit into from
+982 −1

Conversation

@raulk
Copy link
Contributor

@raulk raulk commented Jan 14, 2026

Summary

  • Add block propagation notebook (10) visualizing block arrival latency from slot start
  • Add attestation arrival notebook (11) visualizing attestation propagation across 64 subnets
  • Both use CDF-style percentile series (p50-p99) over time

Block propagation notebook

  • Epoch-level aggregation of block first-seen times from Xatu sentry nodes
  • Percentile time-series showing p50-p99 latency throughout the day
  • Network spread analysis (max-min first-seen across nodes per slot)
  • Scatter plot correlating arrival latency with network spread

Attestation arrival notebook

  • Hourly aggregation to efficiently process 2B+ daily attestations
  • Per-committee (subnet 0-63) latency breakdown
  • Slow subnet detection (P99 > 1.5x median)
  • Committee heatmap for visual comparison
  • 4-second deadline reference line (attestations arriving later may miss inclusion)

Test plan

  • Block propagation query tested with sample data
  • Attestation queries tested with sample data
  • Both notebooks render successfully
  • CI passes

@raulk
feat(propagation): add block and attestation propagation notebooks
9d06b9b 
Add two new notebooks for analyzing network propagation latency:

- Block propagation (10): CDF of block arrival times from slot start,
  with percentile series (p50-p99) over time and network spread analysis
- Attestation arrival (11): CDF of attestation arrival times across
  64 committee subnets, with per-committee breakdown and slow subnet detection

Query modules:
- block_propagation: epoch-level aggregation with spread metrics
- attestation_propagation: hourly aggregation for 2B+ daily attestations
- attestation_by_committee: per-subnet latency summary
@github-actions
Copy link

github-actions bot commented Jan 14, 2026

Preview Deployment

🚀 Preview is ready!

URL: https://observatory-staging.ethp2p.dev/pr-45/

Updated: 2026-01-14T13:55:20.479Z

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

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@raulk