[Bounty #2308] Hardware Eulogy Generator

[HuiNeng6]

Hardware Eulogy Generator - Bounty #2308

Summary

Implements a poetic eulogy generator for miners that have permanently gone offline.

Features

1. Offline Miner Detection: Detects miners that haven't attested for 7+ days
2. Statistics Extraction: Extracts mining statistics from the database:
   • First attestation date
   • Total epochs participated
   • Total RTC earnings
   • Device architecture
   • Multiplier history
3. Eulogy Generation: Generates poetic eulogy text (with optional LLM enhancement)
4. BoTTube Video Creation: Creates memorial videos with:
   • Hardware architecture icons
   • TTS narration
   • Background music
   • RTC earnings counter animation
5. Discord Notification: Sends notifications via webhook or bot

Files Added

• \hardware_eulogy_generator/init.py\ - Package initialization
• \hardware_eulogy_generator/models.py\ - Data models
• \hardware_eulogy_generator/detector.py\ - Offline miner detection
• \hardware_eulogy_generator/eulogy_generator.py\ - Eulogy text generation
• \hardware_eulogy_generator/video_creator.py\ - BoTTube video creation
• \hardware_eulogy_generator/discord_notifier.py\ - Discord notifications
• \hardware_eulogy_generator/main.py\ - Main orchestrator
• \hardware_eulogy_generator/demo.py\ - Demo script
• \hardware_eulogy_generator/README.md\ - Documentation

Testing

The demo script was tested successfully:
\\

RustChain Hardware Eulogy Generator - Demo
Bounty #2308 (25 RTC)

[+] Miner Statistics:
Miner ID: 9dRRMiHiJwjF3VW8...6eeT
Hardware: PowerPC (G4)
Tier: MYTHIC
Multiplier: 4.0x
Epochs: 156
RTC Earned: 42.75
Days Offline: 14
Total Attestations: 2847

[*] Generating eulogy...

In Memoriam: Miner 9dRRMiHi...6eeT

With heavy hearts, we bid farewell to a dedicated miner.
A rare and precious PowerPC artifact, now returned to silicon heaven.
The legendary PowerPC G4, once the heart of Apple's finest machines, now rests.
Over 156 epochs, this miner's hash echoed through the blockchain.
Having earned 42.75 RTC, this miner's legacy lives on.
In the great datacenter in the sky, may this miner find peace.
\\

Usage

\\�ash

Using database

hardware-eulogy --db-path ./rustchain.db --discord-webhook https://...

Dry run (no videos or notifications)

hardware-eulogy --db-path ./rustchain.db --dry-run
\\

Bounty Information

• Bounty ID: #2308
• Reward: 25 RTC
• Wallet Address: \9dRRMiHiJwjF3VW8pXtKDtpmmxAPFy3zWgV2JY5H6eeT\

Notes

• BoTTube video creation requires API access (may need additional permissions)
• TTS narration uses edge-tts (free, no API key required)
• Supports both webhook and bot token for Discord notifications

[github-actions]

Welcome to RustChain! Thanks for your first pull request.

Before we review, please make sure:

• Your PR has a BCOS-L1 or BCOS-L2 label
• New code files include an SPDX license header
• You've tested your changes against the live node

Bounty tiers: Micro (1-10 RTC) | Standard (20-50) | Major (75-100) | Critical (100-150)

A maintainer will review your PR soon. Thanks for contributing!