# hermes_bot_miniapp

Telegram Mini App / bot that collects a user's public wallet data, fetches balances,
compares against the MemePol puzzle dataset, and returns hints.

Read-only over public data. No private keys, no credential capture, no retention.

## Structure
    src/          Python app package
    config/       config.yaml + .env references (never commit secrets)
    data/         runtime data & state
    logs/         status.log (source of truth for subsystem state)
    tools/        helper scripts

## Setup
    python3 tools/wallet_tools.py --selftest
    python3 tools/log_status.py '{"wallet_data":"ok"}'

## Conventions
- Use system python3 for crypto modules (coincurve, pycryptodome, mnemonic).
- Log to logs/status.log (append-only). Never echo secrets.