# etherspot/skandha architecture

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

- Interactive diagram: https://gitdiagram.com/etherspot/skandha
- Repository: https://github.com/etherspot/skandha

## Overview

##### Main Components Identification

The system consists of several key packages that should be represented as major components:

a) Core Components:
- API Layer (packages/api)
- Executor Engine (packages/executor)
- Node Network Layer (packages/node)
- Database Layer (packages/db)
- Monitoring System (packages/monitoring)

b) Supporting Components:
- CLI Interface (packages/cli)
- Parameter Management (packages/params)
- Type System (packages/types)
- Utility Functions (packages/utils)

**┌─ External Interface Layer ─────────────────────┐**
- HTTP/RPC API (Port 14337)                   │
- WebSocket Server                            │
- ┬─┘
- ↕                         │
**┌─ Core Processing Layer ───────────────────┐ │**
- ┌─ Executor Engine ─┐ ┌─ P2P Network ─┐  │ │
- UserOp         │ │ - Discovery    │  │ │
- Validation     │ │ - Gossip       │  │ │
- Bundling      │ │ - Sync         │  │ │
- Mempool       │ └───────────────┘  │ │
- ┘                    │ │
- ┬─┘ │
- ↕                  │   │
**┌─ Storage Layer ──────────────────┐   │   │**
- ┌─ RocksDB ─┐ ┌─ Local DB ─┐    │   │   │
- UserOps │ │ - Config   │    │   │   │
- State   │ │ - Cache    │    │   │   │
- ┘ └───────────┘     │   │   │
- ┘   │   │
- ↕                │   │
**┌─ Monitoring & Metrics ────────────┐│   │**
- Prometheus Metrics              ││   │
- Health Checks                   ││   │
- ┬─┘│   │
- ↕            │  │   │
**┌─ External Services ───────────┐│  │   │**
- Ethereum RPC Node          ││  │   │
- Gas Price Oracles         ││  │   │
- Block Explorers           ││  │   │
- ┘│  │   │

**┌─ Configuration & Control ─────┐│  │   │**
- CLI Interface              ││  │   │
- Config Management          ││  │   │
- ┘│  │   │
- ↓  ↓   ↓

##### Connection Types

- Double lines: Data flow

##### Additional Elements

Important details:
- Entry Point contracts (0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789)
- Supported networks (Mumbai, Sepolia, etc.)
- P2P networking details (Discovery v5, Gossip protocol)
- Bundle processing flow
- UserOp validation pipeline

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph External["External Interface Layer"]
        API["HTTP/RPC API (14337)"]:::api
        WS["WebSocket Server"]:::api
    end

    subgraph Core["Core Processing Layer"]
        subgraph Executor["Executor Engine"]
            UV["UserOp Validation"]:::executor
            BN["Bundling"]:::executor
            MP["Mempool"]:::executor
        end

        subgraph Network["P2P Network"]
            DV["Discovery"]:::network
            GP["Gossip"]:::network
            SY["Sync"]:::network
        end
    end

    subgraph Storage["Storage Layer"]
        subgraph RDB["RocksDB"]
            UO["UserOps"]:::db
            ST["State"]:::db
        end

        subgraph LDB["Local DB"]
            CF["Config"]:::db
            CH["Cache"]:::db
        end
    end

    subgraph Monitor["Monitoring & Metrics"]
        PM["Prometheus Metrics"]:::monitoring
        HC["Health Checks"]:::monitoring
    end

    subgraph External_Svc["External Services"]
        EN["Ethereum RPC Node"]:::external
        GO["Gas Price Oracles"]:::external
        BE["Block Explorers"]:::external
    end

    subgraph Config["Configuration & Control"]
        CLI["CLI Interface"]:::config
        CM["Config Management"]:::config
    end

    %% Connections
    External --> Core
    Core --> Storage
    Core --> Monitor
    Core --> External_Svc
    Storage --> Monitor
    Config --> Core
    Config --> Storage

    %% Styles
    classDef api fill:#2196F3,stroke:#1565C0,color:white
    classDef executor fill:#4CAF50,stroke:#2E7D32,color:white
    classDef network fill:#4CAF50,stroke:#2E7D32,color:white
    classDef db fill:#FFC107,stroke:#FFA000,color:black
    classDef monitoring fill:#FF9800,stroke:#F57C00,color:white
    classDef external fill:#9E9E9E,stroke:#616161,color:white
    classDef config fill:#9C27B0,stroke:#7B1FA2,color:white

    %% Click Events
    click API "https://github.com/etherspot/skandha/tree/master/packages/api/src"
    click UV "https://github.com/etherspot/skandha/tree/master/packages/executor/src/services/UserOpValidation"
    click BN "https://github.com/etherspot/skandha/tree/master/packages/executor/src/services/BundlingService"
    click DV "https://github.com/etherspot/skandha/tree/master/packages/node/src/network/discv5"
    click GP "https://github.com/etherspot/skandha/tree/master/packages/node/src/network/gossip"
    click SY "https://github.com/etherspot/skandha/tree/master/packages/node/src/network/peers"
    click UO "https://github.com/etherspot/skandha/blob/master/packages/db/src/rocksDb.ts"
    click CF "https://github.com/etherspot/skandha/blob/master/packages/db/src/localDb.ts"
    click PM "https://github.com/etherspot/skandha/tree/master/packages/monitoring/src/metrics"
    click HC "https://github.com/etherspot/skandha/blob/master/packages/monitoring/src/server/http.ts"
    click CLI "https://github.com/etherspot/skandha/blob/master/packages/cli/src/cli.ts"
    click CM "https://github.com/etherspot/skandha/tree/master/packages/params/src/networks"
    click GO "https://github.com/etherspot/skandha/tree/master/packages/params/src/gas-price-oracles"
```
