Beaconchain

Monitor Ethereum validator dashboard health on beaconcha.in via V2 API, focused on one-check-per-day status and BeaconScore-first triage. Use when the user asks to check validator health, BeaconScore, missed duties, or set up low-anxiety daily monitoring/alerts for a beaconcha.in dashboard.

Security Scan

The skill's code, declared requirements, and runtime instructions are consistent with its stated purpose of performing a daily beaconcha.in dashboard health check and only require the two expected environment variables plus python3.

Purpose & Capability

Name/description match the implementation: the script POSTs to beaconcha.in performance-aggregate and reads BEACONCHAIN_API_KEY and BEACONCHAIN_DASHBOARD_ID. There are no unrelated binaries, hosts, or credentials requested.

Instruction Scope

SKILL.md instructions align with the script: calls only the documented API endpoint, uses only env vars or CLI flags declared, prints JSON/concise outputs, and documents exit codes. The script does not read other files, spawn shells, or transmit data to other endpoints.

Install Mechanism

No install specification is provided (instruction-only with an included Python script). This is low-risk; the script appears self-contained and uses only Python standard library modules.

Credentials

The skill requires only BEACONCHAIN_API_KEY and BEACONCHAIN_DASHBOARD_ID (and python3). Those are appropriate and necessary for calling the beaconcha.in API. No unrelated secrets or config paths are requested.

Persistence & Privilege

Skill is not always-enabled and sets disableModelInvocation=true (so the model will not autonomously invoke it). It does not modify other skills or system settings.

Assessment

This skill is internally consistent and implements precisely what it claims: a small Python script that POSTs to beaconcha.in and reports a simple daily status. Before installing, ensure you trust beaconcha.in and are comfortable granting that API key to this script (treat BEACONCHAIN_API_KEY as a secret). Review/scan the included script in your environment before running, store the key in a secure secret store or environment isolated from other services, and consider creating an API key with minimal scope or a dedicated key for this monitoring use. If you plan to run it on a schedule (cron), run it in a restricted environment (non-privileged account, limited network access) and rotate the API key if you suspect compromise. Finally, the skill disables autonomous model invocation, so it will only run when you explicitly call it.

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

Quick Start

1. Set credentials as env vars:
   • BEACONCHAIN_API_KEY
   • BEACONCHAIN_DASHBOARD_ID
2. Run:

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

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

python3 skills/beaconchain/scripts/check_dashboard.py

JSON output (for cron/parsing)

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

Custom threshold

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