Beaconchain

🔭 每日一键,验证节点零焦虑监控

通过 beaconcha.in V2 API 实现每日一次的以太坊验证节点健康检查,以 BeaconScore 为核心指标,零焦虑监控,异常才需人工介入。

收藏
5.5k
安装
1.6k
版本
0.1.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Beaconchain 技能提供了一套低焦虑的以太坊验证节点日常监控方案。用户只需配置 BEACONCHAIN_API_KEY 和 BEACONCHAIN_DASHBOARD_ID 两个环境变量,即可通过 Python 脚本执行每日一次的健康检查。脚本调用 beaconcha.in V2 API 的 POST /api/v2/ethereum/validators/performance-aggregate 端点,直接读取 data.beaconscore.total 作为核心评估指标,支持 24h/7d/30d/90d/all_time 多种时间窗口。

显著优点

1. 极简心智负担:设计哲学是"健康时一句话带过,异常时才展开",避免用户被日常噪音干扰
2. BeaconScore 优先:以官方聚合指标为核心,而非原始数据堆砌,降低解读门槛

3. 标准化退出码:0=良好、2=需关注、1=错误,便于接入 cron 或自动化告警

4. 纯标准库实现:仅依赖 Python 内置模块(argparse/json/urllib/datetime),零第三方依赖风险

5. 网络最小化:唯一出口为 beaconcha.in HTTPS API,无额外遥测或数据上报

潜在局限

  • 单点依赖:数据来源完全绑定 beaconcha.in,若其 API 故障或调整费率策略,监控即中断
  • 窗口粒度限制:最短仅 24h,无法捕捉分钟级异常(如单个 slot 错过)
  • 无本地历史存储:每次独立查询,无法跨天趋势分析,需用户自行归档 JSON 输出
  • 阈值固定:默认 BeaconScore 警告阈值未在文档中明示,自定义 --warn-threshold 需用户理解指标含义

适合人群

  • 运行少量验证节点的个人质押者(solo stakers)
  • 追求"设置后忘记"极简运维风格的用户
  • 希望通过 cron 实现每日一次被动监控,而非实时告警轰炸的场景

常规风险

  • API 密钥泄露:环境变量或 CLI 参数若被进程列表捕获,存在泄露风险;建议配合 secret 管理工具
  • rate-limit 触发:免费/低档套餐可能在多节点监控时触发限制,导致 exit 1 误报
  • BeaconScore 滞后性:作为聚合指标,可能平滑掉短期性能波动,不适合紧急故障发现
  • dashboard ID 绑定:若用户迁移至新 dashboard,需手动更新配置,无自动发现机制

安全架构亮点

该技能采用严格的安全边界:无本地文件写入、无子进程调用、无 shell 执行、仅 HTTPS 出站,属于典型的只读监控型工具,攻击面极小。

Beaconchain 内容

references文件夹
scripts文件夹
手动下载zip · 5.6 kB
api-notes.mdtext/markdown
请选择文件