# screamonei2/conversationarchiver architecture

> Architecture diagram of the GitHub repository screamonei2/conversationarchiver, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/screamonei2/conversationarchiver
- Repository: https://github.com/screamonei2/conversationarchiver

## Overview

##### Project type and purpose
- This is a backend‐only, high‐performance, fully automated Solana blockchain arbitrage bot written in Rust.
- Its goal is to monitor multiple on-chain DEXs (Orca, Raydium, Phoenix), spot price inefficiencies (direct, triangular, cross-DEX), and execute optimized trades autonomously, with risk management (slippage, position sizing, simulation mode) and real-time monitoring (mempool, whales).

##### File structure
- Top‐level:
- Cargo.toml, config.toml (.env) → Rust project manifest and configuration
- src/
– config.rs: loads TOML/env variables
– console.rs: CLI or logging interface
– dex/: DEX connectors (orca.rs, raydium.rs, phoenix.rs)
– engine/: core arbitrage logic
- screener.rs: identifies opportunities
- executor.rs: builds & dispatches transactions
– monitor/: real-time watchers
- mempool.rs: WebSocket stream processing
- whales.rs: big-wallet tracking
– utils/: math (AMM formulas), rpc (rate-limited Solana RPC client)
– models.rs, types.rs: domain data structures
– main.rs: application entry, orchestrates modules

##### README insights
- Architecture section calls out Core Components (Screener, Executor, Monitor, RPC Client, Math Utils) and DEX integrations
- Lists advanced features (transaction simulation, compute budget optimization, confirmation tracking) hinting at sequential flow: data ingestion → screening → planning → simulation → execution → confirmation

- Blue for external systems/services (Solana RPC, Mainnet)
- Green for core modules (Monitor, Screener, Engine)
- Yellow for adapters/connectors (DEX modules)
- Gray for utilities/config

##### Detail
- Every module in src/ as its own component
- Interactions between Monitor, DEX connectors, Screener, and Executor
- Config flow: Config Loader → all modules

## Diagram (Mermaid)

```mermaid
graph TD
  subgraph "External Systems"
    RPC_HTTP["Solana RPC HTTP"]:::external
    RPC_WS["Solana RPC WebSocket"]:::external
    MAINNET(("Solana Mainnet")):::external
  end

  subgraph "Shared Services"
    LIB["Library Root"]:::shared
    MAINAPP["Application Entry Point"]:::shared
    CONFIG["Config Loader"]:::config
    MODELS["Data Models"]:::data
    TYPES["Shared Types"]:::data
    CONSOLE["Console Interface"]:::console
  end

  subgraph "Utilities"
    RPC_CLIENT["RPC Client\n(rate-limited HTTP & WS)"]:::utils
    MATH["Math Utilities\n(AMM Formulas)"]:::utils
  end

  subgraph "DEX Integration"
    DEXROOT["DEX Module"]:::adapters
    ORCA["Orca Connector"]:::adapters
    RAY["Raydium Connector"]:::adapters
    PHX["Phoenix Connector"]:::adapters
  end

  subgraph "Monitoring Services"
    MONROOT["Monitor Module"]:::monitor
    MEMPOOL["Mempool Listener"]:::monitor
    WHALES["Whale Tracker"]:::monitor
  end

  subgraph "Core Engine"
    ENGINEROOT["Engine Module"]:::core
    SCREENER["Screener\n(Opportunity Finder)"]:::core
    EXECUTOR["Executor\n(Transaction Builder & Dispatcher)"]:::core
  end

  MAINAPP --> CONFIG
  MAINAPP --> LIB
  MAINAPP --> MONROOT
  MAINAPP --> DEXROOT
  MAINAPP --> SCREENER
  MAINAPP --> EXECUTOR

  CONFIG --> MONROOT
  CONFIG --> DEXROOT
  CONFIG --> SCREENER
  CONFIG --> RPC_CLIENT
  CONFIG --> MATH
  CONFIG --> EXECUTOR

  RPC_HTTP --> DEXROOT
  RPC_HTTP --> RPC_CLIENT
  RPC_WS --> MONROOT

  DEXROOT --> ORCA
  DEXROOT --> RAY
  DEXROOT --> PHX

  ORCA -->|feeds| SCREENER
  RAY -->|feeds| SCREENER
  PHX -->|feeds| SCREENER

  MONROOT --> MEMPOOL
  MONROOT --> WHALES
  MEMPOOL -->|events| SCREENER
  WHALES -->|events| SCREENER

  SCREENER -->|candidate trades| EXECUTOR
  EXECUTOR -->|builds TX| RPC_CLIENT
  RPC_CLIENT -->|submit/simulate| MAINNET
  MAINNET -->|confirmation| RPC_CLIENT
  RPC_CLIENT -->|confirmation events| EXECUTOR

  EXECUTOR --> CONSOLE
  SCREENER --> CONSOLE
  MONROOT --> CONSOLE

  click CONFIG "https://github.com/screamonei2/conversationarchiver/blob/main/src/config.rs"
  click CONSOLE "https://github.com/screamonei2/conversationarchiver/blob/main/src/console.rs"
  click DEXROOT "https://github.com/screamonei2/conversationarchiver/blob/main/src/dex/mod.rs"
  click ORCA "https://github.com/screamonei2/conversationarchiver/blob/main/src/dex/orca.rs"
  click RAY "https://github.com/screamonei2/conversationarchiver/blob/main/src/dex/raydium.rs"
  click PHX "https://github.com/screamonei2/conversationarchiver/blob/main/src/dex/phoenix.rs"
  click MONROOT "https://github.com/screamonei2/conversationarchiver/blob/main/src/monitor/mod.rs"
  click MEMPOOL "https://github.com/screamonei2/conversationarchiver/blob/main/src/monitor/mempool.rs"
  click WHALES "https://github.com/screamonei2/conversationarchiver/blob/main/src/monitor/whales.rs"
  click SCREENER "https://github.com/screamonei2/conversationarchiver/blob/main/src/engine/screener.rs"
  click EXECUTOR "https://github.com/screamonei2/conversationarchiver/blob/main/src/engine/executor.rs"
  click RPC_CLIENT "https://github.com/screamonei2/conversationarchiver/blob/main/src/utils/rpc.rs"
  click MATH "https://github.com/screamonei2/conversationarchiver/blob/main/src/utils/math.rs"
  click LIB "https://github.com/screamonei2/conversationarchiver/blob/main/src/lib.rs"
  click MAINAPP "https://github.com/screamonei2/conversationarchiver/blob/main/src/main.rs"
  click MODELS "https://github.com/screamonei2/conversationarchiver/blob/main/src/models.rs"
  click TYPES "https://github.com/screamonei2/conversationarchiver/blob/main/src/types.rs"

  classDef external fill:#B3CDE0,stroke:#333,color:#000
  classDef core fill:#C7E9C0,stroke:#333,color:#000
  classDef adapters fill:#FFFFB3,stroke:#333,color:#000
  classDef monitor fill:#CFE2F3,stroke:#333,color:#000
  classDef utils fill:#D9D9D9,stroke:#333,color:#000
  classDef config fill:#F2E6D9,stroke:#333,color:#000
  classDef console fill:#F0D9FF,stroke:#333,color:#000
  classDef data fill:#E8E8E8,stroke:#333,color:#000
  classDef shared fill:#EFEFEF,stroke:#333,color:#000
```
