# vatshayan/blockchain-final-year-project architecture

> Architecture diagram of the GitHub repository vatshayan/blockchain-final-year-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vatshayan/blockchain-final-year-project
- Repository: https://github.com/vatshayan/blockchain-final-year-project

## Overview

##### Project type and purpose
- This is a research/demo “Decentralized Blockchain Money Transaction System” implemented in a single Jupyter notebook plus accompanying report/PPT.
- Purpose: illustrate blockchain fundamentals—wallet/key management, transaction creation, block formation (Proof-of-Work), P2P broadcast, ledger maintenance.

##### File structure
- Top level contains:
- Blockchain_Project_dem.ipynb – the core Python notebook with all code
- Blockchain Money PPT.pdf – presentation slides
- README.md – description and links
- No separate “frontend” or “backend” directories: the entire system is in code cells.
- No explicit deployment scripts—this is a local/demo environment.

##### README for additional insights
- Emphasizes research/demo, no real production UI.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Application Layer
    subgraph "Application Layer"
        User["User"]:::offchain
        Wallet["Wallet / Client UI"]:::offchain
        TransactionManager["Transaction Manager"]:::offchain
    end

    %% Network & Consensus Layer
    subgraph "Network & Consensus Layer"
        Mempool["Mempool (pending tx)"]:::offchain
        Miner["Miner / Consensus Engine"]:::offchain
        P2P["P2P Network Layer"]:::network
        OtherNodes["Other Nodes"]:::network
    end

    %% Data Layer
    subgraph "Data Layer"
        Ledger["Blockchain Ledger"]:::onchain
        Crypto["Cryptography Module"]:::onchain
    end

    %% Documentation
    subgraph "Documentation"
        README["Project Documentation & Overview"]:::external
        PPT["Presentation Slides"]:::external
    end

    %% Transaction Flow (dashed)
    User -.->|"initiate tx"| Wallet
    Wallet -.->|"create & sign tx"| Crypto
    Crypto -.->|"signed tx"| TransactionManager
    TransactionManager -.->|"broadcast tx"| P2P
    P2P -.->|"propagate tx"| Mempool
    Mempool -.->|"select tx"| Miner

    %% Block Flow (solid)
    Miner -->|"append block"| Ledger
    Miner -->|"broadcast block"| P2P
    P2P -->|"propagate block"| OtherNodes
    OtherNodes -->|"validate & append"| Ledger
    Miner -.->|"use PoW / hashing"| Crypto

    %% Click Events
    click Wallet "https://github.com/vatshayan/blockchain-final-year-project/blob/main/Blockchain_Project_dem.ipynb"
    click TransactionManager "https://github.com/vatshayan/blockchain-final-year-project/blob/main/Blockchain_Project_dem.ipynb"
    click Mempool "https://github.com/vatshayan/blockchain-final-year-project/blob/main/Blockchain_Project_dem.ipynb"
    click Miner "https://github.com/vatshayan/blockchain-final-year-project/blob/main/Blockchain_Project_dem.ipynb"
    click P2P "https://github.com/vatshayan/blockchain-final-year-project/blob/main/Blockchain_Project_dem.ipynb"
    click Ledger "https://github.com/vatshayan/blockchain-final-year-project/blob/main/Blockchain_Project_dem.ipynb"
    click Crypto "https://github.com/vatshayan/blockchain-final-year-project/blob/main/Blockchain_Project_dem.ipynb"
    click README "https://github.com/vatshayan/blockchain-final-year-project/blob/main/README.md"
    click PPT "https://github.com/vatshayan/blockchain-final-year-project/blob/main/Blockchain Money PPT.pdf"

    %% Styles
    classDef offchain fill:#bfb,stroke:#080;
    classDef onchain fill:#bbf,stroke:#008;
    classDef network fill:#fbc,stroke:#f80;
    classDef external fill:#eee,stroke:#666,stroke-dasharray: 5 5;

    %% Legend
    Legend(["Legend:\nGreen = Off-chain\nBlue = On-chain\nOrange = Network\nDashed = Transactions\nSolid = Blocks"]):::external
```
