# concordium/concordium-node architecture

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

- Interactive diagram: https://gitdiagram.com/concordium/concordium-node
- Repository: https://github.com/concordium/concordium-node

## Overview

##### Project type and purpose
- This is a distributed blockchain node implementation (“concordium-node”) plus auxiliary services for data collection and presentation.
- It comprises:
- A Rust-based p2p node (network layer, RPC/CLI, plugin integration).
- A Haskell consensus library (“concordium-consensus”) providing block production, finalization, scheduling, and storage backends.
- A collector (Rust) querying the node and forwarding metrics.
- A collector-backend (Rust) aggregating metrics and exposing an HTTP interface for dashboards.
- A macOS logging wrapper for system logging on macOS.

##### File structure
- Top level:
- collector-backend/
- collector/
- concordium-consensus/  (Haskell package, deep src-lib, src, tests, benchmarks)
- concordium-node/       (Rust crate with bins, network, p2p, grpc2, consensus_ffi)
- macos_logger_wrapper/  (Rust + C wrapper)
- scripts/                (build & deployment scripts, Dockerfiles, packaging)
- service/windows/       (Windows service installer code)
- Patterns:
- Layering: network → consensus FFI → core logic → storage (LMDB)
- Micro-services: node, collector, collector-backend
- FFI integration: Rust node ↔ Haskell consensus
- Multiple packaging targets: Docker, macOS, Windows, Ubuntu

##### README for additional insights
- The Rust node uses the Haskell consensus library either statically or dynamically.
- The collector queries the node’s GRPC or JSON-RPC endpoints.
- The collector-backend listens for collector messages (likely via HTTP or GRPC) and serves a summary for the network dashboard.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External entities
    P2P["P2P Network"]:::external
    Dashboard["Network Dashboard"]:::external
    CLIUsers["CLI Users"]:::external
    OtherNodes["Other Nodes"]:::external

    %% macOS Logger Wrapper
    subgraph "macOS Logger Wrapper"
        MacOSLib["Rust Wrapper Library"]:::rust
        MacOSC["C Bridging Code"]:::rust
    end

    %% Concordium p2p Node
    subgraph "Concordium p2p Node (Rust)"
        direction TB
        NodeLib["Core Library (lib.rs)"]:::rust
        NetLayer["Network Layer"]:::rust
        Conn["Connection/Message Handling"]:::rust
        P2PProt["p2p Protocols"]:::rust
        GRPC["gRPC2 Server"]:::rust
        CLI["CLI Interface"]:::rust
        FFIClient["Consensus FFI Client"]:::rust
        LMDBStore["LMDB Storage Module"]:::storage
        Plugins["Plugins"]:::rust
    end

    %% Consensus Engine
    subgraph "Consensus Engine (Haskell)"
        direction TB
        CoreProto["Core Protocols & Scheduling"]:::haskell
        BlockProd["Block Production & Finalization"]:::haskell
        TreeStore["TreeState LMDB Backend"]:::storage
        FFIExports["External Interfaces & FFI Bindings"]:::haskell
    end

    %% Collector
    subgraph "Collector (Rust)"
        direction TB
        CollectorBin["Main Binary (poller)"]:::rust
        CollectorLib["Library & Configuration"]:::rust
    end

    %% Collector-Backend
    subgraph "Collector-Backend (Rust)"
        direction TB
        BackendBin["Main Binary (node-collector-backend)"]:::rust
        BackendLib["Aggregation & Persistence"]:::rust
        BackendDB["Backend DB"]:::storage
        HTTPServer["HTTP Server"]:::rust
    end

    %% Windows Service Installer
    subgraph "Windows Service Installer"
        direction TB
        WinMain["Service Manager & Entry Point"]:::rust
        WinConfig["Configuration"]:::rust
        WinMgr["Process Manager"]:::rust
        WinSub["Subprocess"]:::rust
        WiX["Installer Definition (WiX)"]:::rust
    end

    %% Packaging Scripts
    subgraph "Packaging & Deployment Scripts"
        direction TB
        CI[".github/workflows"]:::scripts
        MacPkg["macOS-package"]:::scripts
        UbPkg["ubuntu-packages"]:::scripts
        WinBuild["windows"]:::scripts
        BuildHelpers["build-binaries.sh / start.sh"]:::scripts
    end

    %% Relationships
    P2P -->|TCP/p2p| NetLayer
    OtherNodes -->|TCP/p2p| P2PProt
    NetLayer --> Conn
    Conn --> P2PProt
    P2PProt --> Plugins
    NodeLib --> FFIClient
    FFIClient -->|FFI| FFIExports
    FFIExports --> CoreProto
    CoreProto --> BlockProd
    BlockProd --> TreeStore
    NodeLib --> LMDBStore
    MacOSLib -->|os_log| NodeLib
    MacOSLib -->|os_log| CollectorBin
    CollectorBin -->|gRPC/HTTP| GRPC
    CLIUsers -->|CLI| CLI
    CollectorBin --> CollectorLib
    CollectorBin -->|push metrics| BackendBin
    BackendBin --> BackendLib
    BackendLib --> BackendDB
    BackendBin --> HTTPServer
    HTTPServer -->|HTTP| Dashboard

    %% Click events
    click NetLayer "https://github.com/concordium/concordium-node/tree/main/concordium-node/src/network/"
    click Conn "https://github.com/concordium/concordium-node/tree/main/concordium-node/src/connection/"
    click P2PProt "https://github.com/concordium/concordium-node/tree/main/concordium-node/src/p2p/"
    click GRPC "https://github.com/concordium/concordium-node/blob/main/concordium-node/src/grpc2.rs"
    click CLI "https://github.com/concordium/concordium-node/blob/main/concordium-node/src/bin/cli.rs"
    click FFIClient "https://github.com/concordium/concordium-node/tree/main/concordium-node/src/consensus_ffi/"
    click NodeLib "https://github.com/concordium/concordium-node/blob/main/concordium-node/src/lib.rs"

    click CoreProto "https://github.com/concordium/concordium-node/tree/main/concordium-consensus/src/Concordium/KonsensusV1/"
    click BlockProd "https://github.com/concordium/concordium-node/tree/main/concordium-consensus/src/Concordium/Afgjort/"
    click TreeStore "https://github.com/concordium/concordium-node/blob/main/concordium-consensus/src/Concordium/KonsensusV1/TreeState/LowLevel/LMDB.hs"
    click FFIExports "https://github.com/concordium/concordium-node/tree/main/concordium-consensus/src-lib/Concordium/External/"

    click CollectorBin "https://github.com/concordium/concordium-node/blob/main/collector/src/bin/collector.rs"
    click CollectorLib "https://github.com/concordium/concordium-node/tree/main/collector/src/"

    click BackendBin "https://github.com/concordium/concordium-node/blob/main/collector-backend/src/bin/node-collector-backend.rs"
    click BackendLib "https://github.com/concordium/concordium-node/blob/main/collector-backend/src/lib.rs"

    click MacOSLib "https://github.com/concordium/concordium-node/blob/main/macos_logger_wrapper/src/lib.rs"
    click MacOSC "https://github.com/concordium/concordium-node/blob/main/macos_logger_wrapper/macos_log_wrapper.c"

    click WinMain "https://github.com/concordium/concordium-node/blob/main/service/windows/src/main.rs"
    click WinConfig "https://github.com/concordium/concordium-node/blob/main/service/windows/src/config.rs"
    click WinMgr "https://github.com/concordium/concordium-node/blob/main/service/windows/src/manager.rs"
    click WinSub "https://github.com/concordium/concordium-node/blob/main/service/windows/src/subprocess.rs"
    click WiX "https://github.com/concordium/concordium-node/blob/main/service/windows/installer/Node.wxs"

    click CI "https://github.com/concordium/concordium-node/tree/main/.github/workflows/"
    click MacPkg "https://github.com/concordium/concordium-node/tree/main/scripts/distribution/macOS-package/"
    click UbPkg "https://github.com/concordium/concordium-node/tree/main/scripts/distribution/ubuntu-packages/"
    click WinBuild "https://github.com/concordium/concordium-node/tree/main/scripts/distribution/windows/"
    click BuildHelpers "https://github.com/concordium/concordium-node/blob/main/scripts/build-binaries.sh"

    %% Styles
    classDef rust fill:#E8274B,stroke:#000,color:#fff
    classDef haskell fill:#5e5086,stroke:#000,color:#fff
    classDef storage fill:#F3D55B,stroke:#000,color:#000
    classDef external fill:#68C2FF,stroke:#000,color:#000
    classDef scripts fill:#4CAF50,stroke:#000,color:#fff
```
