Skip to content

README.md

Latest commit

 

History

History
64 lines (44 loc) · 3.19 KB

README.md

File metadata and controls

64 lines (44 loc) · 3.19 KB
Raw

Beanbee Bot 🤖

An AI-powered Telegram assistant for trading, analysis, and portfolio management built on BNB Smart Chain (BSC) and opBNB.

Beanbee Bot is an advanced AI-powered Telegram bot designed to be your all-in-one companion for navigating the BNB Chain ecosystem, including BNB Smart Chain (BSC) and opBNB.
It leverages Google's Gemini AI to understand natural language commands, providing a seamless and intuitive interface for everything from complex token analysis to automated trading.

✨ Features

  • 🧠 AI-Powered Chat: Interact with the bot using natural language to get intelligent, context-aware answers about your portfolio, market sentiment, or token safety on BNB Chain.
  • 📈 Portfolio Tracking on BSC: Get a detailed overview of assets across main and trading wallets, including token balances, PnL analysis, and active DeFi/staking positions.
  • 🚀 Automated Trading on PancakeSwap: Execute trades directly through a secure, signature-verified router. Configure automated trading rules based on price or market cap.
  • 🚨 Token Safety Analysis (Rug Alert): Analyze any BSC token for risks with a safety score (0–100) based on liquidity, contract verification, and holder distribution.
  • 💡 Yield Opportunities: Discover personalized yield farming and staking options using data from DeFiLlama and live market feeds.
  • 🔗 Native opBNB Support: Seamlessly switch to opBNB Layer-2 for portfolio tracking, transaction history, and token analytics.
  • 🎯 Wallet & Token Tracking: Monitor any wallet on BSC or opBNB for live notifications and set token price alerts.

🛠 Technology Stack

  • Blockchain: BNB Smart Chain (BSC), opBNB (EVM-compatible)
  • Smart Contracts: Solidity ^0.8.x
  • Frontend: N/A (Telegram Bot)
  • Backend: Node.js, TypeScript, Telegraf.js
  • Database: MongoDB (Mongoose & Typegoose)
  • AI Engine: Google Gemini
  • Data Sources: Moralis, Pyth Network, DeFiLlama, DexScreener, NodeReal
  • Development: Hardhat, Ethers.js, Viem, OpenZeppelin

🌐 Supported Networks

  • BNB Smart Chain Mainnet (Chain ID: 56)
  • BNB Smart Chain Testnet (Chain ID: 97)
  • opBNB Mainnet (Chain ID: 204)

📜 Contract Addresses

Network Core Contract Token Contract Router / Governance
BNB Mainnet 0x8372Ec5Da575D4c637dfaA33a22DF96406D7d1F4 - Secure Router
BNB Testnet TBA TBA TBA
opBNB Mainnet TBA TBA TBA

🚀 Getting Started

  1. Find the Bot: Search for @beanbee_bot on Telegram.
  2. Press Start: Begin onboarding with guided instructions.
  3. Connect Your Wallet: Securely connect via WalletConnect for portfolio tracking and trading.
  4. Explore: Use menus or type natural language queries to access analysis and trading features.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.