A high-performance, secure, event-driven Solana trading bot with a modern web dashboard. The system monitors selected Telegram channels and groups in real-time, extracts SPL token addresses from incoming messages, and executes automated swap transactions on the Solana blockchain using dynamic priority fees and optional MEV protection (Jito).

• 🚀 Real-time Event Stream Engine — GramJS MTProto client listens to messages from specified groups/channels and extracts SPL token contracts within milliseconds.
• 🔒 Enterprise-Grade Private Custody — User private keys are protected at rest using AES-256-GCM encryption. Decryption keys are loaded strictly from the environment, isolating database compromises.
• 📊 Telemetry & Web Dashboard — A real-time web dashboard featuring live telemetry, wallet balances, active network configurations, system logs, and transaction history.
• 📉 Congestion-Aware Priority Fees — Dynamic Compute Budget pricing calculations scale priority fees based on user trade size and network congestion.
• 🛡️ MEV & Frontrun Protection — Optional integration with Jito RPC endpoints to bundle transactions and avoid predatory frontrunning.
• 🔄 Dual-Network Hot-Swapping — Fully supports hot-swapping between devnet and mainnet configurations per user on the fly.
• 🇮🇹 Localized Admin Console — Modern, responsive user interfaces localized in Italian with role-based access validation (ADMIN, DEV, USER).

┌────────────────────────────────────────────────────────────────────────┐
│                              Web Interface                             │
│                     EJS Templates • Bootstrap • Socket.IO               │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │
┌───────────────────────────────────▼────────────────────────────────────┐
│                             Application Server                         │
│                    Express.js • Pino HTTP Logger • Sessions            │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │
┌───────────────────────────────────┼────────────────────────────────────┐
│            Bot Engine             │             DB Layer               │
│        GramJS MTProto Client      │          PostgreSQL (pg)           │
└────────────────┬──────────────────┴──────────────────┬─────────────────┘
                 │                                     │
┌────────────────▼──────────────────┐ ┌────────────────▼─────────────────┐
│          Solana Web3 Core         │ │        Crypto Engine             │
│   @solana/web3.js • spl-token     │ │    AES-256-GCM • Bcrypt          │
└───────────────────────────────────┘ └──────────────────────────────────┘

• Node.js: v18.x or higher
• Database: PostgreSQL 14.x or higher
• API Credentials: Telegram API_ID & API_HASH from my.telegram.org

1. Clone the Repository:

   git clone https://github.com/yourusername/TwitterMonitorTrade.git
   cd TwitterMonitorTrade

2. Install Node Modules:

   npm install

3. Configure Environment: Create a local .env configuration file:

   cp .env.example .env

   Open .env and fill in your Telegram API, Solana RPC, and PostgreSQL database credentials.

4. Initialize Database Schema: Ensure your PostgreSQL server is active and the target database exists, then run:

   npm run db:init

5. Launch the System: Start the application web server and the Telegram listener bot:

   npm run dev

The project exposes standard NPM tasks configured inside package.json:

• Zero-Plaintext Wallet Storage: Wallet private keys are strictly stored encrypted using AES-256-GCM inside the database. Plaintext keys are never written to disk or logs.
• Separation of Concerns: The decryption secret (ENCRYPTION_KEY) is stored outside the database structure (exclusively inside the local system environment).
• Cryptographic Password Salting: Authentication passwords are encrypted using bcrypt salted with 12 rounds, protecting the web dashboard from offline brute-force attacks.
• Strict RBAC Validation: Express route layers enforce access constraints using customized middleware checking ADMIN, DEV, and USER role permissions.

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