A comprehensive Telegram bot for the GraphLinq ecosystem that provides staking information, price data, and community resources for GLQ token holders.

Live Bot: @GraphlinqBot

• Address Management: Set and view your wallet address
• Personal Staking Info: View your staked GLQ, rewards, tier, and rank
• Portfolio Tracking: Monitor your staking position and USD value

• Network Statistics: Total stakers, total staked, APY rates
• Tier Information: View staking tiers and their distributions
• Price Data: Real-time GLQ pricing and market data
• Community Resources: Links to websites, social media, exchanges
• Documentation: Quick access to GraphLinq resources

• Maintenance Mode: Bot-wide maintenance with admin bypass
• System Monitoring: Server stats, uptime, and performance metrics
• Advanced Logging: Multi-level logging system with file separation

• Python 3.6-3.10 (3.7+ recommended)

  ⚠️ Important: This project uses python-telegram-bot==13.0 which is incompatible with Python 3.11+ and does not support the async patterns introduced in v20+

• Telegram Bot Token (from @BotFather)
• Ethereum/Web3 RPC endpoint (Infura, Alchemy, etc.)
• LiveCoinWatch API key (optional, for price data)

1. Clone the repository

   git clone https://github.com/jrbgit/GraphLinq.TelegramBot.git
   cd GraphLinq.TelegramBot

2. Install dependencies

   pip install -r requirements.txt

3. Set up environment variables

   Create a .env file in the project root:

   # Required
   TELEGRAM_KEY=your_telegram_bot_token_here
   NETWORK_URL=https://your-ethereum-rpc-endpoint.com
   CONTRACT_ADDRESS=0x9F9c8ec3534c3cE16F928381372BfbFBFb9F4D24
   
   # Optional
   LCW_API_KEY=your_livecoinwatch_api_key
   MAINT_MODE=0
   ALLOWED_ADMIN=your_telegram_user_id

4. Run the bot

   python3 bot.py

1. Using Docker Compose (Recommended)

   docker-compose up -d

2. Manual Docker Build

   docker build -t graphlinq-bot .
   docker run -d --name graphlinq-bot graphlinq-bot

For backward compatibility, the following shortcuts are supported:

• /set → /setmyaddress
• /address → /myaddress
• /total → /mytotal
• /rank → /myrank
• /tier → /mytier
• /rewards → /myrewards
• /staked → /totalstaked
• /stakers → /totalstakers

GraphLinq.TelegramBot/
├── bot.py                 # Main bot application
├── config_base.py         # Base configuration and API keys
├── config_contract.py     # Smart contract interface
├── config_logging.py      # Logging configuration
├── config_maint.py        # Maintenance mode settings
├── config_msgs.py         # Bot messages and responses
├── requirements.txt       # Python dependencies
├── docker-compose.yml     # Docker deployment
├── Dockerfile             # Docker container config
├── .env                   # Environment variables (create this)
└── logs/                  # Log files directory
    ├── debug.log
    ├── info.log
    ├── warning.log
    ├── error.log
    └── critical.log

1. Smart Contract Integration: Direct interaction with GraphLinq staking contract
2. Database: SQLite for user address storage
3. Price APIs: LiveCoinWatch and GraphLinq Hub integration
4. Logging System: Multi-level logging with file separation
5. Maintenance Mode: System-wide maintenance with admin bypass

The bot includes the complete ABI for the GraphLinq staking contract, supporting functions like:

• getDepositedGLQ() - User staked amount
• getGlqToClaim() - Claimable rewards
• getPosition() - User rank
• getWalletCurrentTier() - User tier
• getTiersAPY() - Current APY rates
• getTotalStakers() - Total staker count

• Staking Data: Direct smart contract queries via Web3
• Price Data: LiveCoinWatch API and GraphLinq Hub API
• Supply Data: GraphLinq Chain Explorer API
• User Data: Local SQLite database for address storage

• Address Storage: User addresses stored locally in encrypted SQLite database
• Private Commands: Restricted to direct messages only
• Admin Controls: Maintenance mode with admin bypass functionality
• API Key Masking: Sensitive data masked in logs
• Error Handling: Comprehensive exception handling and logging

The bot supports maintenance mode for updates and troubleshooting:

1. Enable: Set MAINT_MODE=1 in environment
2. Admin Bypass: Admin users can still access all functions
3. User Message: Automatic maintenance message to regular users
4. Logging: All maintenance events logged

The bot implements a comprehensive logging system:

• debug.log: Detailed execution flow
• info.log: General information and startup
• warning.log: Non-critical issues
• error.log: Error conditions
• critical.log: Critical failures

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is open source and available under the MIT License.

• Issues: GitHub Issues
• GraphLinq Telegram: Join Community
• Documentation: GraphLinq Docs

• GraphLinq Protocol: https://graphlinq.io
• Staking Platform: https://app.graphlinq.io/app/staking
• Explorer: https://explorer.graphlinq.io
• Hub: https://hub.graphlinq.io

Author: jrbgit
Contact: @jr00t_GLQ
Website: jr00t.com

Built with ❤️ for the GraphLinq community