/algoping

📣 A tiny cron job that issues a tweet with Algorand Block proposal stats on daily basis

Primary LanguagePythonMIT LicenseMIT



📣 I am a free and open source health monitoring bot for Algorand Developers that issues a tweet with statistics on number of block proposals and other useful daily information.

About

What is AlgoPing?

1. Analytics Tweet Bot:

AlgoPing is a daily cron triggered bot that uses BitQuery GraphQL API to fetch daily stats on total amount of block proposals and info on proposers. It then uses Tweepy to post a tweet with the stats on daily basis to @algoping Twitter account.

2. Health Monitoring Status Page:

Additionally, AlgoPing uses BetterUptime to monitor the status of Node and Indexer servers provided by AlgoNode and AlgoExplorer respectively. Please note the status page is not affiliated with AlgoNode or AlgoExplorer, for official status refer to their respective websites and communication channels. The aim is to simply provide a free unnoficial status page for the Algorand community that aggregates different Node and Indexer Providers.

Please note there are not source codes for health monitoring as AlgoPing relies on a free tier on a third party provider named BetterUptime. If you are interested in setting up your own health monitoring status page, please refer to BetterUptime documentation.

Prerequisites

Installation

  1. Clone the repository:
git clone https://github.com/aorumbayev/algoping.git && cd algoping
  1. Install dependencies:
poetry install
  1. Install pre-commit hooks:
pre-commit install
  1. Done 🎉

Usage

Create twitter app and get your credentials. The following environment variables are required by tweepy:

  • BITQUERY_API_KEY - Specify Bitquery GraphQL API key to get daily stats on total amount of block proposals and info on proposers.

Once you have your credentials, you can run the bot locally with:

PYTHONPATH="." poetry run python src/analytics.py

Contributing

Contributions are welcome if you want to improve existing setup of the bot that is currently reporting to AlgoPing twitter account.

Otherwise, feel free to clone it and tweak it for your needs to run the bot on your own twitter account.