🛡️ RiskRaider - Advanced NFT Risk Analysis Discord Bot

RiskRaider is an advanced Discord bot designed for comprehensive NFT wallet risk analysis (EVM + Solana) and community engagement. Built with cutting-edge technology and professional-grade architecture, RiskRaider helps Discord communities make informed decisions about wallet interactions while providing entertainment and moderation features.

🚀 Key Features

🔍 Advanced Multi-Chain Wallet Risk Analysis

• Ethereum / EVM Chains (Ethereum, Polygon, BSC)

  • Comprehensive analysis using bitsCrunch API

  • AI-powered wallet scoring (0–100)

  • Transaction pattern & anomaly detection

• Solana

  • Solana Wallet Analysis via RPC / Helius API

  • Real-time balance & transaction tracking

  • Scam program detection & suspicious token transfer alerts

  • AI-powered Solana wallet scoring (0–100)

• Cross-Chain Detection

  • Identify connected wallets across EVM + Solana

  • Unified color-coded embeds and risk indicators

🎮 Interactive Entertainment

• Coin Flip, Rock Paper Scissors, Tic-Tac-Toe

• Number Guessing, Trivia Quiz, Magic 8-Ball

🛡️ Professional Moderation

• Advanced kick/ban with reason logging

• Timeout & bulk message purging

• Warning system with progressive discipline

• Role-based admin controls

📊 Performance Monitoring

• Real-time system & bot metrics

• Command usage analytics

• Error logging & uptime monitoring

• Resource usage tracking (CPU, memory, disk)

🎨 Beautiful UI Design

• Glassmorphism effects & branded embeds

• Colorful charts (Chart.js)

• Animated interactions (60fps)

• Mobile-responsive layouts

🏗️ Architecture

• Cog-based Modular System

• Async/Await high-performance ops

• SQLite DB with migrations

• Multi-Chain API Integrations

  • EVM: bitsCrunch

  • Solana: RPC / Helius / Shyft

• Caching & Rate Limiting

• Comprehensive Logging & Error Handling

⚙️ Installation & Setup

Prerequisites

• Python 3.8+ (recommended: 3.11+)

• Discord Developer Account

• API Keys

  • bitsCrunch API (EVM wallet risk analysis)

  • Solana RPC / Helius API (Solana wallet risk analysis)

  • OpenRouter API (optional, for AI insights)

🚀 Quick Start

Clone Repository

git clone https://github.com/Aaditya1273/RiskRaider.git
cd RiskRaider

Install Dependencies

Environment Configuration

Copy .env.example → .env and fill values:

DISCORD_TOKEN=your_discord_bot_token
BITSCRUNCH_API_KEY=your_bitscrunch_api_key
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
HELIUS_API_KEY=your_helius_api_key   # optional
OPENROUTER_API_KEY=your_openrouter_api_key  # optional
PREFIX=!
INVITE_LINK=your_bot_invite_link

Create Discord Application

• Go to Discord Developer Portal

• Create an app & bot → Copy token to .env

• Enable Message Content Intent

📚 Usage Guide

🔍 NFT & Wallet Risk Analysis

/nft_check <wallet_address>              # EVM NFT wallet risk (ETH/Polygon/BSC)
/risk_report <wallet_address>            # Detailed EVM wallet risk assessment
/wallet_check eth <eth_wallet_address>   # Multi-chain: Ethereum wallet check
/wallet_check sol <sol_wallet_address>   # Multi-chain: Solana wallet check

🎮 Games

/coinflip <heads|tails>
/rps <rock|paper|scissors>
/tictactoe @user
/guess <min> <max>
/trivia
/8ball <question>

🛡️ Moderation

/kick @user [reason]
/ban @user [reason]
/timeout @user <duration>
/purge <amount>
/warn @user <reason>

⚡ Utility

/ping
/info
/help
/stats

🪙 Wallet Connection (EVM + Solana)

• EVM Wallets (Ethereum, Polygon, BSC) → MetaMask

• Solana Wallets → Phantom / Solflare

• MetaMask Solana Snap (Experimental) → Enables Solana support directly in MetaMask

Users can connect either MetaMask (EVM) or Phantom (Solana) and analyze wallets seamlessly.

🐳 Docker Deployment

docker compose up -d --build   # Run bot in background
docker compose logs -f         # View logs
docker compose down            # Stop bot

🔧 Development Setup

pip install -r requirements.txt
python bot.py
export LOG_LEVEL=DEBUG   # optional

🔥 Advanced Features

• Multi-layered wallet risk analysis (EVM + Solana)

• Real-time API integration with caching

• AI-generated risk summaries (OpenRouter)

• Visual color-coded scoring system (0–100)

• Monitoring dashboard & auto backups

🐛 Troubleshooting

• Bot not responding → Check intents & permissions

• NFT analysis not working → Verify API keys

• Permission errors → Ensure bot has Admin role

• Solana errors → Verify SOLANA_RPC_URL or HELIUS_API_KEY

🤝 Contributing

• Follow PEP 8 style guide

• Add tests for new features

• Use conventional commits

📈 Versioning

• Current Version: 8.0.0 – Multi-Chain Edition (ETH + Solana)

📜 License

This project is licensed under the Apache License 2.0.

🚀 Acknowledgments

• Discord.py community for docs

• bitsCrunch team for NFT analytics

• Helius / Solana RPC providers

• All contributors who helped expand RiskRaider