✓ Verified 💻 Development ✓ Enhanced Data

Beaconchain

Monitor Ethereum validator dashboard health on beaconcha.in via V2 API, focused on one-check-per-day

Rating: 4.9 (451 reviews)
Downloads: 48,779 downloads
Version: 1.0.0

Overview

Monitor Ethereum validator dashboard health on beaconcha.in via V2 API, focused on one-check-per-day status.

Complete Documentation

View Source →

Beaconchain

Use this skill to reduce validator-check anxiety: do one concise daily health check, then only surface issues.

Quick Start

Set credentials as env vars:
BEACONCHAIN_API_KEY
BEACONCHAIN_DASHBOARD_ID
Run:

bash

python3 skills/beaconchain/scripts/check_dashboard.py --json

Interpret exit code:
0 = good
2 = bad (needs attention)
1 = error (auth/rate-limit/endpoint failure)

Monitoring Workflow

Run scripts/check_dashboard.py once per day.
If status=good, respond with a short reassurance and avoid extra detail.
If status=bad, report:
BeaconScore (if available)
Which signal tripped (missed/penalty fallback)
Next action: inspect dashboard details and validator logs.
If status=error, report key checks:
API key validity
dashboard ID
plan/rate-limit permissions.

Command Patterns

Basic check

bash

python3 skills/beaconchain/scripts/check_dashboard.py

JSON output (for cron/parsing)

bash

python3 skills/beaconchain/scripts/check_dashboard.py --json

Custom threshold

bash

python3 skills/beaconchain/scripts/check_dashboard.py --warn-threshold 75

Notes

Script uses POST /api/v2/ethereum/validators/performance-aggregate with dashboard selector and reads data.beaconscore.total directly.
Default window is 24h; supported windows: 24h, 7d, 30d, 90d, all_time.
Keep responses intentionally terse when healthy to support low-anxiety operations.

Security & Transparency

Runtime: python3 only, using Python standard library (argparse, json, urllib, datetime).
Credentials: reads BEACONCHAIN_API_KEY and BEACONCHAIN_DASHBOARD_ID (or equivalent CLI flags).
Network egress: only https://beaconcha.in/api/v2/ethereum/validators/performance-aggregate.
Local filesystem: no writes, no shell execution, no subprocess spawning.

References

API overview: references/api-notes.md

Installation

Terminal bash


openclaw install beaconchain

Copied!

💻Code Examples

python3 skills/beaconchain/scripts/check_dashboard.py --json

python3-skillsbeaconchainscriptscheckdashboardpy---json.txt

3. Interpret exit code:
   - `0` = good
   - `2` = bad (needs attention)
   - `1` = error (auth/rate-limit/endpoint failure)

## Monitoring Workflow

1. Run `scripts/check_dashboard.py` once per day.
2. If `status=good`, respond with a short reassurance and avoid extra detail.
3. If `status=bad`, report:
   - BeaconScore (if available)
   - Which signal tripped (missed/penalty fallback)
   - Next action: inspect dashboard details and validator logs.
4. If `status=error`, report key checks:
   - API key validity
   - dashboard ID
   - plan/rate-limit permissions.

## Command Patterns

### Basic check