Beaconchain
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:
CODEBLOCK0
- 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. - 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.
- 4. If
status=error, report key checks:
- API key validity
- dashboard ID
- plan/rate-limit permissions.
Command Patterns
Basic check
CODEBLOCK1
JSON output (for cron/parsing)
CODEBLOCK2
Custom threshold
CODEBLOCK3
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: INLINECODE25
Beaconchain
使用此技能减少验证者检查焦虑：每天进行一次简洁的健康检查，仅在出现问题时才上报。
快速开始
- 1. 将凭证设置为环境变量：
- BEACONCHAIN
APIKEY
- BEACONCHAIN
DASHBOARDID
- 2. 运行：
bash
python3 skills/beaconchain/scripts/check_dashboard.py --json
- 3. 解读退出码：
- 0 = 正常
- 2 = 异常（需要关注）
- 1 = 错误（认证/速率限制/端点故障）
监控工作流程
- 1. 每天运行一次 scripts/check_dashboard.py。
- 如果 status=good，回复简短确认信息，避免额外细节。
- 如果 status=bad，报告：
- BeaconScore（如可用）
- 触发信号（遗漏/惩罚回退）
- 下一步操作：检查仪表盘详情和验证者日志。
- 4. 如果 status=error，报告关键检查项：
- API密钥有效性
- 仪表盘ID
- 计划/速率限制权限。
命令模式
基本检查
bash
python3 skills/beaconchain/scripts/check_dashboard.py
JSON输出（用于定时任务/解析）
bash
python3 skills/beaconchain/scripts/check_dashboard.py --json
自定义阈值
bash
python3 skills/beaconchain/scripts/check_dashboard.py --warn-threshold 75
注意事项
- - 脚本使用 POST /api/v2/ethereum/validators/performance-aggregate 配合仪表盘选择器，直接读取 data.beaconscore.total。
- 默认时间窗口为 24h；支持的时间窗口：24h、7d、30d、90d、all_time。
- 健康状态下保持回复简洁，以支持低焦虑操作。
安全与透明度
- - 运行环境：仅 python3，使用Python标准库（argparse、json、urllib、datetime）。
- 凭证：读取 BEACONCHAINAPIKEY 和 BEACONCHAINDASHBOARDID（或等效CLI标志）。
- 网络出口：仅 https://beaconcha.in/api/v2/ethereum/validators/performance-aggregate。
- 本地文件系统：无写入操作，无shell执行，无子进程生成。
参考
- - API概述：references/api-notes.md
