# mdominikd/telegram-solana-privatekey-extractor architecture

> Architecture diagram of the GitHub repository mdominikd/telegram-solana-privatekey-extractor, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mdominikd/telegram-solana-privatekey-extractor
- Repository: https://github.com/mdominikd/telegram-solana-privatekey-extractor

## Overview

This is a CLI application that monitors selected Telegram chats, scans historical and incoming messages for Solana addresses, private keys, and mnemonic phrases, and transfers funds from discovered wallets to configured destinations. The application entry point coordinates configuration and monitoring; TelegramMonitor owns channel setup and message processing, while detector, wallet, and logging components handle distinct stages. The README documents capabilities beyond the sampled excerpts; links to those services are cited to the README, and unsampled internals are not inferred.

Main entry points: [`src/core/TelegramMonitor.js`](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/core/TelegramMonitor.js) (Telegram monitor), [`src/index.js`](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/index.js) (App orchestrator), [`src/core/SolanaWallet.js`](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/core/SolanaWallet.js) (Wallet processing), [`src/managers/ChannelManager.js`](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/managers/ChannelManager.js) (Channel manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_coordination["Application and setup"]
  node_app["App orchestrator<br/>[index.js]"]
  node_input["CLI prompts<br/>[InputHelper.js]"]
  node_constants["Application constants<br/>[Constants.js]"]
  node_contracts["Errors and contracts<br/>[Interfaces.js]"]
end

subgraph group_telegram["Telegram monitoring"]
  node_monitor["Telegram monitor<br/>[TelegramMonitor.js]"]
  node_channels["Channel manager<br/>[ChannelManager.js]"]
  node_history["History scan<br/>[TelegramMonitor.js]"]
  node_live["Live message handling<br/>[TelegramMonitor.js]"]
end

subgraph group_solana["Detection and transfers"]
  node_detector["Pattern detector<br/>[PatternDetector.js]"]
  node_wallet["Wallet processing<br/>[SolanaWallet.js]"]
end

subgraph group_state["Configuration and records"]
  node_config["Config manager<br/>[ConfigManager.js]"]
  node_config_store[("Telegram config")]
  node_channel_store[("Saved channels")]
  node_logger["Log manager<br/>[LogManager.js]"]
  node_log_files[("Log files")]
end

node_user(("CLI user"))
node_telegram_service["Telegram service"]
node_rpc["Solana RPC"]
node_destinations[("Destination wallets")]

node_user -->|"starts"| node_app
node_app -->|"initializes"| node_config
node_app -->|"starts"| node_monitor
node_app -->|"logs events"| node_logger
node_config -->|"reads and writes"| node_config_store
node_user -->|"answers prompts"| node_input
node_channels -->|"prompts"| node_input
node_monitor -->|"sets up"| node_channels
node_channels -->|"reads and writes"| node_channel_store
node_monitor -->|"connects and authenticates"| node_telegram_service
node_telegram_service -->|"delivers messages"| node_monitor
node_monitor -->|"scans"| node_history
node_monitor -->|"starts monitoring"| node_live
node_history -->|"checks messages"| node_detector
node_live -->|"checks messages"| node_detector
node_live -->|"records matches"| node_logger
node_live -->|"processes keys"| node_wallet
node_wallet -->|"checks and transfers"| node_rpc
node_wallet -->|"sends funds to"| node_destinations
node_logger -->|"writes records"| node_log_files
node_detector -->|"uses patterns"| node_constants
node_wallet -->|"uses settings"| node_constants

click node_app "https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/index.js"
click node_input "https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/utils/InputHelper.js"
click node_config "https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/managers/ConfigManager.js"
click node_monitor "https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/core/TelegramMonitor.js"
click node_channels "https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/managers/ChannelManager.js"
click node_history "https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/core/TelegramMonitor.js"
click node_live "https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/core/TelegramMonitor.js"
click node_detector "https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/core/PatternDetector.js"
click node_wallet "https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/core/SolanaWallet.js"
click node_logger "https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/managers/LogManager.js"
click node_constants "https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/utils/Constants.js"
click node_contracts "https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/types/Interfaces.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_input,node_constants,node_contracts,node_user toneBlue
class node_monitor,node_channels,node_history,node_live,node_destinations toneAmber
class node_detector,node_wallet toneMint
class node_config,node_config_store,node_channel_store,node_logger,node_log_files toneRose
class node_telegram_service,node_rpc toneIndigo
```

## Components

### Application and setup

- [App orchestrator](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/index.js): `src/index.js`
- [CLI prompts](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/utils/InputHelper.js): `src/utils/InputHelper.js`
- [Application constants](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/utils/Constants.js): `src/utils/Constants.js`
- [Errors and contracts](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/types/Interfaces.js): `src/types/Interfaces.js`

### Telegram monitoring

- [Telegram monitor](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/core/TelegramMonitor.js): `src/core/TelegramMonitor.js`
- [Channel manager](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/managers/ChannelManager.js): `src/managers/ChannelManager.js`
- [History scan](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/core/TelegramMonitor.js): `src/core/TelegramMonitor.js`
- [Live message handling](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/core/TelegramMonitor.js): `src/core/TelegramMonitor.js`

### Detection and transfers

- [Pattern detector](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/core/PatternDetector.js): `src/core/PatternDetector.js`
- [Wallet processing](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/core/SolanaWallet.js): `src/core/SolanaWallet.js`

### Configuration and records

- [Config manager](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/managers/ConfigManager.js): `src/managers/ConfigManager.js`
- **Telegram config**
- **Saved channels**
- [Log manager](https://github.com/mdominikd/telegram-solana-privatekey-extractor/blob/main/src/managers/LogManager.js): `src/managers/LogManager.js`
- **Log files**

### Other components

- **CLI user**
- **Telegram service**
- **Solana RPC**
- **Destination wallets**

## Connections

- CLI user → App orchestrator: starts (evidence: `README.md`)
- App orchestrator → Config manager: initializes (evidence: `src/index.js`)
- App orchestrator → Telegram monitor: starts (evidence: `src/index.js`)
- App orchestrator → Log manager: logs events (evidence: `src/index.js`)
- Config manager → Telegram config: reads and writes (evidence: `src/managers/ConfigManager.js`)
- CLI user → CLI prompts: answers prompts (evidence: `README.md`)
- Channel manager → CLI prompts: prompts (evidence: `src/managers/ChannelManager.js`)
- Telegram monitor → Channel manager: sets up (evidence: `src/core/TelegramMonitor.js`)
- Channel manager → Saved channels: reads and writes (evidence: `src/managers/ChannelManager.js`)
- Telegram monitor → Telegram service: connects and authenticates (evidence: `src/core/TelegramMonitor.js`)
- Telegram service → Telegram monitor: delivers messages (evidence: `README.md`)
- Telegram monitor → History scan: scans (evidence: `src/core/TelegramMonitor.js`)
- Telegram monitor → Live message handling: starts monitoring (evidence: `src/core/TelegramMonitor.js`)
- History scan → Pattern detector: checks messages (evidence: `README.md`)
- Live message handling → Pattern detector: checks messages (evidence: `src/core/TelegramMonitor.js`)
- Live message handling → Log manager: records matches (evidence: `src/core/TelegramMonitor.js`)
- Live message handling → Wallet processing: processes keys (evidence: `src/core/TelegramMonitor.js`)
- Wallet processing → Solana RPC: checks and transfers (evidence: `README.md`)
- Wallet processing → Destination wallets: sends funds to (evidence: `README.md`)
- Log manager → Log files: writes records (evidence: `src/managers/LogManager.js`)
- Pattern detector → Application constants: uses patterns (evidence: `src/core/PatternDetector.js`)
- Wallet processing → Application constants: uses settings (evidence: `src/core/SolanaWallet.js`)
