beaconchain

TotalClaw 作者 totalclaw

通过 V2 API 监控 beaconcha.in 上的以太坊验证器仪表板运行状况，重点关注每天一次检查状态和 BeaconScore 优先分类。当用户要求检查验证器运行状况、BeaconScore、错过的职责或为 beaconcha.in 仪表板设置低焦虑的日常监控/警报时使用。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~thisisjeron-beaconchain

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~thisisjeron-beaconchain/file -o thisisjeron-beaconchain.md

## 概述（中文）

通过 V2 API 监控 beaconcha.in 上的以太坊验证器仪表板运行状况，重点关注每天一次检查状态和 BeaconScore 优先分类。当用户要求检查验证器运行状况、BeaconScore、错过的职责或为 beaconcha.in 仪表板设置低焦虑的日常监控/警报时使用。

## 原文

# 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:

```bash
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

```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`