cypher-networks/cypher-validator-ops-toolkit
GitHub: cypher-networks/cypher-validator-ops-toolkit
Cosmos Hub验证器操作工具包,提供监控、治理投票警报和AI辅助响应。
Stars: 0 | Forks: 0
# Cypher 验证器操作工具包
为 Cosmos Hub 运营商提供的开放验证器操作工具。
此存储库包含只读监控脚本、治理提案/投票警报、本地 Discord/Ollama 操作助手以及验证器基础设施的实际操作手册。
初始版本专注于 Cosmos Hub 主网和提供者测试网操作。
## 包含内容
```
monitors/
cosmos_mainnet_monitor.sh
cosmos_testnet_monitor.sh
cosmos_mainnet_gov_monitor.sh
cosmos_testnet_gov_monitor.sh
cypher-ai-ops/
Python Discord bot for read-only validator operations help
Local Ollama integration
Monitor-aware alert triage
Safe command allowlist
docs/
cosmos-hub-runbook.md
deployment.md
governance-alerts.md
security-model.md
roadmap.md
```
## 截图
**主网验证器健康警报**
**测试网治理清晰**
**主网验证器警报频道**
**AI 操作助手响应**
## 目标
- 通过简单的健康检查提高验证器的可靠性。
- 通过提案/投票警报减少错过的治理投票。
- 为常见事件提供清晰的运行手册。
- 提供本地 AI 助手,建议安全的只读检查而不执行任意命令。
- 将机密和签名操作保留在自动化之外。
## 安全模型
- 监控脚本为只读。
- 治理监控仅查询提案和投票。
- 没有脚本提交交易。
- Discord 机器人不运行任意用户提供的命令。
- 机密属于本地的 `.env` 文件,决不在 git 中。
- 实际 Discord Webhooks、机器人令牌、私钥、助记词、验证器密钥和钱包文件决不能提交。
请参阅 [docs/security-model.md](docs/security-model.md).
## 快速开始
有两个本地环境文件:
- `~/.validator-monitor.env` 用于 shell 监控脚本。
- `cypher-ai-ops/.env` 用于可选的 Discord/Ollama 机器人。
两者都是根据示例创建并本地编辑的。不要提交实际的 `.env` 文件。
1. 复制监控环境模板:
```
cp .env.example ~/.validator-monitor.env
nano ~/.validator-monitor.env
chmod 600 ~/.validator-monitor.env
```
2. 安装监控脚本:
```
cp monitors/*.sh /home/YOUR_USER/
chmod +x /home/YOUR_USER/cosmos_*_monitor.sh
```
3. 测试脚本:
```
bash -n /home/YOUR_USER/cosmos_mainnet_monitor.sh
bash -n /home/YOUR_USER/cosmos_testnet_monitor.sh
bash -n /home/YOUR_USER/cosmos_mainnet_gov_monitor.sh
bash -n /home/YOUR_USER/cosmos_testnet_gov_monitor.sh
/home/YOUR_USER/cosmos_mainnet_monitor.sh
/home/YOUR_USER/cosmos_mainnet_gov_monitor.sh
```
4. 验证后添加 cron:
```
*/5 * * * * /bin/bash /home/YOUR_USER/cosmos_mainnet_monitor.sh >> /home/YOUR_USER/cosmos_mainnet_monitor.log 2>&1
*/5 * * * * /bin/bash /home/YOUR_USER/cosmos_testnet_monitor.sh >> /home/YOUR_USER/cosmos_testnet_monitor.log 2>&1
*/30 * * * * /bin/bash /home/YOUR_USER/cosmos_mainnet_gov_monitor.sh >> /home/YOUR_USER/cosmos_mainnet_gov_monitor.log 2>&1
*/30 * * * * /bin/bash /home/YOUR_USER/cosmos_testnet_gov_monitor.sh >> /home/YOUR_USER/cosmos_testnet_gov_monitor.log 2>&1
```
请参阅 [docs/deployment.md](docs/deployment.md) 了解完整设置。
## 治理警报
Cosmos 治理监控是这个工具包的第一级部分。它们查询活跃的投票期提案,检查配置的投票者地址是否已投票,并在需要运营商操作时发出警报。
它们不提交投票或消耗燃气。
请参阅 [docs/governance-alerts.md](docs/governance-alerts.md).
## Cypher AI 运维
`cypher-ai-ops/` 机器人是可选的。它本地运行,连接到 Discord,并使用本地 Ollama 模型总结警报并建议安全的下一步检查。
当前版本仅使用本地 Ollama。运营商通过将 `cypher-ai-ops/.env.example` 复制到 `cypher-ai-ops/.env`,输入 Discord 令牌/频道 ID,并设置本地 Ollama URL/模型来配置机器人。
安装详情请参阅 [cypher-ai-ops/README.md](cypher-ai-ops/README.md).
## 状态
这是一个早期的操作工具包。它旨在实用、可审计且易于适应。运营商在使用脚本之前应进行审查,并针对自己的节点布局进行测试。
"实时部署:目前已在 Cypher Networks 上运行生产环境 — cosmosvaloper17vst6zuv6zh5ulvzl6j0kl2ldfsjkfqt635gr8"
## 许可证
MIT。请参阅 [LICENSE](LICENSE).
**测试网治理清晰**
**主网验证器警报频道**
**AI 操作助手响应**
## 目标
- 通过简单的健康检查提高验证器的可靠性。
- 通过提案/投票警报减少错过的治理投票。
- 为常见事件提供清晰的运行手册。
- 提供本地 AI 助手,建议安全的只读检查而不执行任意命令。
- 将机密和签名操作保留在自动化之外。
## 安全模型
- 监控脚本为只读。
- 治理监控仅查询提案和投票。
- 没有脚本提交交易。
- Discord 机器人不运行任意用户提供的命令。
- 机密属于本地的 `.env` 文件,决不在 git 中。
- 实际 Discord Webhooks、机器人令牌、私钥、助记词、验证器密钥和钱包文件决不能提交。
请参阅 [docs/security-model.md](docs/security-model.md).
## 快速开始
有两个本地环境文件:
- `~/.validator-monitor.env` 用于 shell 监控脚本。
- `cypher-ai-ops/.env` 用于可选的 Discord/Ollama 机器人。
两者都是根据示例创建并本地编辑的。不要提交实际的 `.env` 文件。
1. 复制监控环境模板:
```
cp .env.example ~/.validator-monitor.env
nano ~/.validator-monitor.env
chmod 600 ~/.validator-monitor.env
```
2. 安装监控脚本:
```
cp monitors/*.sh /home/YOUR_USER/
chmod +x /home/YOUR_USER/cosmos_*_monitor.sh
```
3. 测试脚本:
```
bash -n /home/YOUR_USER/cosmos_mainnet_monitor.sh
bash -n /home/YOUR_USER/cosmos_testnet_monitor.sh
bash -n /home/YOUR_USER/cosmos_mainnet_gov_monitor.sh
bash -n /home/YOUR_USER/cosmos_testnet_gov_monitor.sh
/home/YOUR_USER/cosmos_mainnet_monitor.sh
/home/YOUR_USER/cosmos_mainnet_gov_monitor.sh
```
4. 验证后添加 cron:
```
*/5 * * * * /bin/bash /home/YOUR_USER/cosmos_mainnet_monitor.sh >> /home/YOUR_USER/cosmos_mainnet_monitor.log 2>&1
*/5 * * * * /bin/bash /home/YOUR_USER/cosmos_testnet_monitor.sh >> /home/YOUR_USER/cosmos_testnet_monitor.log 2>&1
*/30 * * * * /bin/bash /home/YOUR_USER/cosmos_mainnet_gov_monitor.sh >> /home/YOUR_USER/cosmos_mainnet_gov_monitor.log 2>&1
*/30 * * * * /bin/bash /home/YOUR_USER/cosmos_testnet_gov_monitor.sh >> /home/YOUR_USER/cosmos_testnet_gov_monitor.log 2>&1
```
请参阅 [docs/deployment.md](docs/deployment.md) 了解完整设置。
## 治理警报
Cosmos 治理监控是这个工具包的第一级部分。它们查询活跃的投票期提案,检查配置的投票者地址是否已投票,并在需要运营商操作时发出警报。
它们不提交投票或消耗燃气。
请参阅 [docs/governance-alerts.md](docs/governance-alerts.md).
## Cypher AI 运维
`cypher-ai-ops/` 机器人是可选的。它本地运行,连接到 Discord,并使用本地 Ollama 模型总结警报并建议安全的下一步检查。
当前版本仅使用本地 Ollama。运营商通过将 `cypher-ai-ops/.env.example` 复制到 `cypher-ai-ops/.env`,输入 Discord 令牌/频道 ID,并设置本地 Ollama URL/模型来配置机器人。
安装详情请参阅 [cypher-ai-ops/README.md](cypher-ai-ops/README.md).
## 状态
这是一个早期的操作工具包。它旨在实用、可审计且易于适应。运营商在使用脚本之前应进行审查,并针对自己的节点布局进行测试。
"实时部署:目前已在 Cypher Networks 上运行生产环境 — cosmosvaloper17vst6zuv6zh5ulvzl6j0kl2ldfsjkfqt635gr8"
## 许可证
MIT。请参阅 [LICENSE](LICENSE).标签:AI 辅助, Cosmos Hub, Discord 机器人, Ollama 集成, 健康检查, 区块链监控, 基础设施运维, 安全模型, 安全策略, 安全运行, 提示词设计, 日志审计, 治理投票, 监控脚本, 警告系统, 运行手册, 逆向工具