Wallet Analyzer Bot 🕵️‍♂️💸

A powerful Telegram bot designed to analyze Solana wallets for funding sources, suspicious bundling activity, and token transfer patterns. Built with Helius API.

Features ✨

1. 💰 Funding Source Analysis

• Identifies the original funder of a wallet (CEX, Bridge, or another wallet).
• Detects if the wallet is fresh or established.
• Provides links to Solscan and Orb for detailed transaction views.

2. ⚠️ Bundle Detection (Anti-Sybil)

• Analyzes the funder's behavior to detect high-frequency distribution patterns.
• Warns users if the wallet was funded by a suspected bot or script (e.g., funding 10+ wallets within minutes).

3. 🪙 Token Analysis

• Tracks transfers of a specific token (CA) for a given wallet.
• Suspicious Token Bundle Detection: Checks if the token sender distributed tokens to multiple wallets simultaneously (a common sign of a farmed airdrop or sniper bot ring).

4. 🔍 Identity & Labels

• Fetches known labels for wallets (e.g., "Coinbase 1", "Jupiter Aggregator", "Magic Eden").

Commands 🤖

• /start - Initialize the bot and see instructions.
• /analyze <wallet_address> [token_ca] - Analyze a wallet.
  • Example 1: /analyze 7X...8z (Check funding source & bundle status)
  • Example 2: /analyze 7X...8z So111...111 (Check specific token storage & transfers)

Installation 🛠️

1. Clone the repository:

   git clone https://github.com/yunus-0x/walletanalyzer.git
   cd walletanalyzer

2. Install dependencies:

   npm install

3. Set up environment variables: Create a .env file in the root directory and add your API keys:

   TELEGRAM_BOT_TOKEN=your_telegram_bot_token
   HELIUS_API_KEY=your_helius_api_key

   • Get a Telegram Bot Token from @BotFather.
   • Get a Helius API Key from dev.helius.xyz.

4. Run the bot:

   npm start

Requirements

• Node.js (v16+)
• A Helius API Key (Free tier works for basic usage)

License

MIT