# coderanchel/vortyxblockchain architecture

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

- Interactive diagram: https://gitdiagram.com/coderanchel/vortyxblockchain
- Repository: https://github.com/coderanchel/vortyxblockchain

## Overview

##### Project type and purpose
- This is a Java‑based blockchain node implementation (“VortyxBlockchain”) with an HTTP API layer for wallet and transaction operations. It implements core blockchain concepts (PoW, Merkle trees, transaction signing) and persists its state in multiple LevelDB key‑value stores.

##### File structure
- Top‑level:
- `src/main/java/app/` → HTTP entry point (`NodeApp.java`), Spring WebFlux controllers, DTOs
- `src/main/java/Core/` → Domain entities (`Block`, `Transaction`, `Wallet`), `Context.java` (service layer), `BlockchainStorage.java` (storage adapter)
- `src/main/java/utils/` → Utility modules (RLP encoding, key‐pair generation, iteration)
- `database/` → On‑disk LevelDB data folders for blocks, mempool, metadata, transactions, wallets
- `data/` → Example JSON data for blocks, transactions, wallets
- Config/build: Gradle, `.env`, `.gitignore`, `nodes.json` (peer info)

##### README for architectural insights
- Layers:
- Presentation/API: Spring WebFlux controllers
- Service/Core: `Context` orchestrates wallets, mempool, mining, chain validation
- Persistence: `BlockchainStorage` wraps LevelDB + RLP encoding
- Networking: P2P via nodes.json and HTTP broadcasting
- Key technologies: Java, Spring WebFlux, LevelDB, RLP, Bouncy Castle (ECDSA), Guava

## Diagram (Mermaid)

```mermaid
graph TD
    %% API Layer
    subgraph "API Layer"
        direction TB
        NodeApp["NodeApp"]:::api
        WalletController["WalletController"]:::api
        TransactionController["TransactionController"]:::api
        subgraph "DTOs"
            direction TB
            KeyPairWalletDTO["KeyPairWalletDTO"]:::api
            TransactionConfirmedDTO["TransactionConfirmedDTO"]:::api
            TransactionDTO["TransactionDTO"]:::api
            TransactionProposalDTO["TransactionProposalDTO"]:::api
            WalletCreationDTO["WalletCreationDTO"]:::api
        end
    end

    %% Service/Core Layer
    subgraph "Service/Core Layer"
        direction TB
        Context["Context"]:::service
        BlockchainStorage["BlockchainStorage"]:::service
    end

    %% Domain Model
    subgraph "Domain Model"
        direction TB
        Block["Block"]:::domain
        TransactionEntity["Transaction"]:::domain
        MinerTrans["MinerTrans"]:::domain
        WalletEntity["Wallet"]:::domain
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        direction TB
        blocksDB[(blocks/)]:::storage
        mempoolDB[(mempool/)]:::storage
        transactionsDB[(transactions/)]:::storage
        walletsDB[(wallets/)]:::storage
        metadataDB[(metadata/)]:::storage
    end

    %% Utilities & Encoding
    subgraph "Utilities & Encoding"
        direction TB
        RLPUtils["rlpUtils"]:::util
        KeyPairUtils["KeyPairUtils"]:::util
        IterationUtils["IterationUtils"]:::util
    end

    %% P2P Network
    subgraph "P2P Network"
        direction TB
        Peers["Peers (nodes.json)"]:::external
    end

    %% Connections
    NodeApp -->|"POST /wallet"| WalletController
    NodeApp -->|"POST /tx"| TransactionController
    WalletController -->|"WalletDTO"| Context
    TransactionController -->|"TransactionDTO"| Context

    Context -->|"validate/sign"| RLPUtils
    Context -->|"generate keys"| KeyPairUtils
    Context -->|"iterate blocks"| IterationUtils

    Context -->|"put/get"| BlockchainStorage
    BlockchainStorage -->|"read/write"| blocksDB
    BlockchainStorage -->|"read/write"| mempoolDB
    BlockchainStorage -->|"read/write"| transactionsDB
    BlockchainStorage -->|"read/write"| walletsDB
    BlockchainStorage -->|"read/write"| metadataDB

    Context -->|"reads"| Block
    Context -->|"reads"| TransactionEntity
    Context -->|"writes"| MinerTrans
    Context -->|"manages"| WalletEntity

    Context -->|"broadcast block/tx"| Peers
    Peers -->|"receive block/tx"| Context

    %% Click Events
    click NodeApp "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/app/NodeApp.java"
    click WalletController "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/app/Controller/WalletController.java"
    click TransactionController "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/app/Controller/TransactionController.java"
    click KeyPairWalletDTO "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/app/DTOS/KeyPairWalletDTO.java"
    click TransactionConfirmedDTO "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/app/DTOS/TransactionConfirmedDTO.java"
    click TransactionDTO "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/app/DTOS/TransactionDTO.java"
    click TransactionProposalDTO "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/app/DTOS/TransactionProposalDTO.java"
    click WalletCreationDTO "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/app/DTOS/WalletCreationDTO.java"
    click Context "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/Core/Context.java"
    click BlockchainStorage "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/Core/BlockchainStorage.java"
    click Block "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/Core/Entities/Block.java"
    click TransactionEntity "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/Core/Entities/Transaction.java"
    click MinerTrans "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/Core/Entities/MinerTrans.java"
    click WalletEntity "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/Core/Entities/Wallet.java"
    click blocksDB "https://github.com/coderanchel/vortyxblockchain/tree/main/database/blocks/"
    click mempoolDB "https://github.com/coderanchel/vortyxblockchain/tree/main/database/mempool/"
    click transactionsDB "https://github.com/coderanchel/vortyxblockchain/tree/main/database/transactions/"
    click walletsDB "https://github.com/coderanchel/vortyxblockchain/tree/main/database/wallets/"
    click metadataDB "https://github.com/coderanchel/vortyxblockchain/tree/main/database/metadata/"
    click RLPUtils "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/utils/rlpUtils.java"
    click KeyPairUtils "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/utils/KeyPairUtils.java"
    click IterationUtils "https://github.com/coderanchel/vortyxblockchain/blob/main/src/main/java/utils/IterationUtils.java"
    click Peers "https://github.com/coderanchel/vortyxblockchain/blob/main/nodes.json"

    %% Styles
    classDef api fill:#ACE7FF,stroke:#0366d6,color:#000
    classDef service fill:#B2F2BB,stroke:#2f9e44,color:#000
    classDef domain fill:#FFF3BF,stroke:#d48806,color:#000
    classDef storage fill:#FFD8A8,stroke:#d9480f,color:#000
    classDef util fill:#D0BFFF,stroke:#7048E8,color:#000
    classDef external fill:#E3E3E3,stroke:#6c757d,color:#000
```
