Skip to content

Developer Contribution: Republic AI Helper Telegram Bot by solscammer #33

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kursatkorkmazx-spec wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Developer Contribution: Republic AI Helper Telegram Bot by solscammer #33

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 56 additions & 0 deletions testnet/contributions/solscammer.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# 🌐 Republic AI Testnet Helper Bot

**Contribution Type:** Developer Tool
**Author:** solscammer
**Live Bot:** [@republicaihelperbot](https://t.me/republicaihelperbot)
**Repo:** [github.com/kursatkorkmazx-spec/republic-ai-helper-bot](https://github.com/kursatkorkmazx-spec/republic-ai-helper-bot)

---

## Overview

This Telegram bot provides real-time access to Republic AI Testnet data for validators, delegators, and community members. Built using the Republic AI Cosmos RPC and REST API endpoints.

## Technical Stack

- **Language:** Python 3.12
- **Framework:** python-telegram-bot 20.7
- **HTTP Client:** httpx (async)
- **Data:** JSON file-based persistence
- **Infrastructure:** Linux VPS with systemd service
- **Endpoints Used:**
- `https://rpc.republicai.io`
- `https://rest.republicai.io`

## Features Implemented

- [x] Real-time block height & sync status
- [x] Active validator set monitoring (100 validator limit)
- [x] Minimum stake calculation to enter active set
- [x] Full wallet info (balance, staking, rewards, unbonding)
- [x] Validator operator address lookup
- [x] Validator search across 650+ validators (paginated)
- [x] Transaction lookup by hash
- [x] Persistent wallet saving per user
- [x] Automated jail alerts (5 min polling)
- [x] Delegation change notifications
- [x] Daily faucet reminders (09:00 UTC)
- [x] 24/7 uptime via systemd

## Why This Matters

Republic AI's vision depends on a healthy validator set and an engaged community. This bot lowers the barrier to entry for:

1. Node operators who need instant jail/inactive alerts
2. Delegators tracking their staking positions
3. New users exploring the network without technical knowledge

## Usage Stats

Bot is live and serving community members on the Republic AI testnet.

## Links

- 🤖 Bot: [@republicaihelperbot](https://t.me/republicaihelperbot)
- 💻 Code: [github.com/kursatkorkmazx-spec/republic-ai-helper-bot](https://github.com/kursatkorkmazx-spec/republic-ai-helper-bot)
- 🌐 Network: [explorer.republicai.io](https://explorer.republicai.io)