Setup & Installation

Prerequisites

  • Python 3.12+

  • Alchemy account with HTTP and WebSocket keys for Ethereum and Base

  • Telegram Bot token (via @BotFather)

  • (Optional) Prometheus + Grafana to scrape /metrics

Install

git clone https://github.com/your-org/eonflow.git
cd eonflow
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

You can also use Poetry: poetry install

Configuration

Copy the examples and edit:

cp config/config.example.yaml config/config.yaml
cp config/keys.example.json config/keys.json

  • config.yaml: runtime settings (chains enabled, feature flags, panel options).

  • keys.json: secrets (Alchemy HTTP/WS endpoints, Telegram bot token).

Never commit real keys. Prefer environment variables or secret managers in production.

Run the System

Telegram Panel

python -m eonflow.main
# or
python start_eonflow.py

Health & Metrics

python -m eonflow.api.server
# GET /healthz   -> 200 OK
# GET /metrics   -> Prometheus exposition
# GET /info      -> capabilities JSON

First‑Run Bootstrap (optional)

python scripts/bootstrap.py

This validates Python version, required packages, config files, and RPC reachability.

PreviousTelegram PanelNextTroubleshooting