feat: Miner Alert System (Bounty #28)

[mtarcure]

Summary

Python monitoring service for RustChain miners. Polls the API and fires alerts via email (SMTP) or SMS (Twilio).

• Miner Offline — No attestation within configurable threshold
• Attestation Failure — Stale attestation timestamp across consecutive polls
• Rewards Received — Balance increased above minimum threshold
• Large Transfer — Balance dropped by configurable amount
• Back Online — Recovery notification after offline alert

Features

• Async httpx client with Pydantic models for all API responses
• SQLite persistence for miner state tracking and alert deduplication
• YAML config with env var overrides for secrets (SMTP_PASSWORD, TWILIO_AUTH_TOKEN)
• CLI: python -m rustchain_alerts with --once (cron-friendly) and --history modes
• 25 tests passing (monitor logic, config loading, DB operations)

Files

All files in monitoring/alerts/:

• rustchain_alerts/ — Python package (api, config, db, monitor, notifiers)
• tests/ — 25 pytest tests
• config.yaml — Template configuration
• README.md — Setup and usage documentation
• requirements.txt — Dependencies

Test plan

• All 25 unit tests pass (pytest tests/ -v)
• Config loads from YAML with env var overrides
• Offline detection fires at threshold, deduplicates, clears on recovery
• Balance change detection for rewards and large transfers
• Attestation failure detection on stale timestamps

Closes #28

[mtarcure]

Wallet for payout: wirework