# aswinsaathappan/drunix architecture

> Architecture diagram of the GitHub repository aswinsaathappan/drunix, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aswinsaathappan/drunix
- Repository: https://github.com/aswinsaathappan/drunix

## Overview

Drunix is a Hyperledger Fabric-derived distributed-ledger platform. Its principal workflow is a client submitting a transaction to a peer for endorsement, followed by ordering, validation, and ledger commit. The map also preserves the README’s emphasized capabilities: separated peer responsibilities, SQL-backed state, private-data sharing, and stateless validation, alongside chaincode execution, discovery, and administration. Several subsystems are represented by their exact tree paths, but their internal connections are left unasserted where the supplied excerpts do not establish them.

Main entry points: [`core/peer/peer.go`](https://github.com/aswinsaathappan/drunix/blob/main/core/peer/peer.go) (Peer node), [`core/committer/txvalidator/v20/validator.go`](https://github.com/aswinsaathappan/drunix/blob/main/core/committer/txvalidator/v20/validator.go) (Transaction validation), [`core/ledger/kvledger/kv_ledger.go`](https://github.com/aswinsaathappan/drunix/blob/main/core/ledger/kvledger/kv_ledger.go) (Peer ledger), [`core/chaincode/chaincode_support.go`](https://github.com/aswinsaathappan/drunix/blob/main/core/chaincode/chaincode_support.go) (Chaincode runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_peer_tx["Peer transactions"]
  node_peer["Peer node<br/>[peer.go]"]
  node_endorser["Endorsement<br/>[endorser.go]"]
  node_validation["Transaction validation<br/>[validator.go]"]
  node_stateless_validation["Stateless validation"]
  node_policy["Policy evaluation<br/>[application.go]"]
  node_state_validation["State-based validation<br/>[vpmanagerimpl.go]"]
  node_fake_query_executor["Query executor fake<br/>[query_executor.go]"]
end

subgraph group_ordering_ledger["Ordering and ledger"]
  node_orderer["Orderer service<br/>[main.go]"]
  node_raft_storage[("Raft persistence<br/>[storage.go]")]
  node_ledger[("Peer ledger<br/>[kv_ledger.go]")]
  node_block_storage[("Block storage<br/>[blockstore.go]")]
  node_state_db[("State database<br/>[statesqldb.go]")]
  node_private_data[("Private data storage<br/>[store.go]")]
end

subgraph group_chaincode["Chaincode runtime"]
  node_chaincode_lifecycle["Chaincode lifecycle<br/>[lifecycle.go]"]
  node_chaincode_runtime["Chaincode runtime"]
  node_docker_runtime["Docker runtime"]
end

subgraph group_network_services["Network services"]
  node_gossip["Gossip service<br/>[gossip_service.go]"]
  node_discovery["Peer discovery<br/>[service.go]"]
end

subgraph group_admin_config["Administration and config"]
  node_cryptogen["Identity generation<br/>[main.go]"]
  node_configtxgen["Channel config generation<br/>[main.go]"]
  node_configtxlator["Config translation<br/>[main.go]"]
  node_peer_cli["Peer CLI<br/>[main.go]"]
  node_query_committed["Committed chaincode query<br/>[querycommitted.go]"]
end

node_client(("Client application"))

node_client -.->|"submits transactions"| node_peer
node_peer -.->|"routes proposals"| node_endorser
node_endorser -.->|"invokes chaincode"| node_chaincode_runtime
node_peer -.->|"broadcasts transactions"| node_orderer
node_orderer -->|"persists consensus data"| node_raft_storage
node_peer -.->|"commits transactions"| node_validation
node_validation -->|"dispatches validation"| node_stateless_validation
node_validation -.->|"checks policy"| node_policy
node_validation -->|"checks key policies"| node_state_validation
node_validation -->|"reads transaction state"| node_ledger
node_ledger -.->|"stores blocks"| node_block_storage
node_ledger -.->|"stores world state"| node_state_db
node_ledger -.->|"tracks private data"| node_private_data
node_peer -.->|"manages definitions"| node_chaincode_lifecycle
node_chaincode_lifecycle -->|"provides metadata"| node_chaincode_runtime
node_chaincode_runtime -.->|"starts containers"| node_docker_runtime
node_peer -->|"exchanges network data"| node_gossip
node_peer -.->|"serves discovery"| node_discovery
node_client -.->|"requests peers"| node_discovery
node_peer_cli -->|"runs lifecycle query"| node_query_committed
node_configtxgen -.->|"configures channels"| node_configtxlator

click node_peer "https://github.com/aswinsaathappan/drunix/blob/main/core/peer/peer.go"
click node_endorser "https://github.com/aswinsaathappan/drunix/blob/main/core/endorser/endorser.go"
click node_validation "https://github.com/aswinsaathappan/drunix/blob/main/core/committer/txvalidator/v20/validator.go"
click node_stateless_validation "https://github.com/aswinsaathappan/drunix/blob/main/core/committer/txvalidator/v20/plugindispatcher/custom_query_executer.go"
click node_policy "https://github.com/aswinsaathappan/drunix/blob/main/core/policy/application.go"
click node_state_validation "https://github.com/aswinsaathappan/drunix/blob/main/core/common/validation/statebased/vpmanagerimpl.go"
click node_fake_query_executor "https://github.com/aswinsaathappan/drunix/blob/main/core/endorser/fake/query_executor.go"
click node_orderer "https://github.com/aswinsaathappan/drunix/blob/main/orderer/common/server/main.go"
click node_raft_storage "https://github.com/aswinsaathappan/drunix/blob/main/orderer/consensus/etcdraft/storage.go"
click node_ledger "https://github.com/aswinsaathappan/drunix/blob/main/core/ledger/kvledger/kv_ledger.go"
click node_block_storage "https://github.com/aswinsaathappan/drunix/blob/main/common/ledger/blkstorage/blockstore.go"
click node_state_db "https://github.com/aswinsaathappan/drunix/blob/main/core/ledger/kvledger/txmgmt/statedb/statesqldb/statesqldb.go"
click node_private_data "https://github.com/aswinsaathappan/drunix/blob/main/core/ledger/pvtdatastorage/store.go"
click node_chaincode_lifecycle "https://github.com/aswinsaathappan/drunix/blob/main/core/chaincode/lifecycle/lifecycle.go"
click node_chaincode_runtime "https://github.com/aswinsaathappan/drunix/blob/main/core/chaincode/chaincode_support.go"
click node_docker_runtime "https://github.com/aswinsaathappan/drunix/blob/main/core/container/dockercontroller/dockercontroller.go"
click node_gossip "https://github.com/aswinsaathappan/drunix/blob/main/gossip/service/gossip_service.go"
click node_discovery "https://github.com/aswinsaathappan/drunix/blob/main/discovery/service.go"
click node_cryptogen "https://github.com/aswinsaathappan/drunix/blob/main/cmd/cryptogen/main.go"
click node_configtxgen "https://github.com/aswinsaathappan/drunix/blob/main/cmd/configtxgen/main.go"
click node_configtxlator "https://github.com/aswinsaathappan/drunix/blob/main/cmd/configtxlator/main.go"
click node_peer_cli "https://github.com/aswinsaathappan/drunix/blob/main/cmd/peer/main.go"
click node_query_committed "https://github.com/aswinsaathappan/drunix/blob/main/internal/peer/lifecycle/chaincode/querycommitted.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_peer,node_endorser,node_validation,node_stateless_validation,node_policy,node_state_validation,node_fake_query_executor,node_client toneBlue
class node_orderer,node_raft_storage,node_ledger,node_block_storage,node_state_db,node_private_data toneAmber
class node_chaincode_lifecycle,node_chaincode_runtime,node_docker_runtime toneMint
class node_gossip,node_discovery toneRose
class node_cryptogen,node_configtxgen,node_configtxlator,node_peer_cli,node_query_committed toneIndigo
```

## Components

### Peer transactions

- [Peer node](https://github.com/aswinsaathappan/drunix/blob/main/core/peer/peer.go): `core/peer/peer.go`
- [Endorsement](https://github.com/aswinsaathappan/drunix/blob/main/core/endorser/endorser.go): `core/endorser/endorser.go`
- [Transaction validation](https://github.com/aswinsaathappan/drunix/blob/main/core/committer/txvalidator/v20/validator.go): `core/committer/txvalidator/v20/validator.go`
- [Stateless validation](https://github.com/aswinsaathappan/drunix/blob/main/core/committer/txvalidator/v20/plugindispatcher/custom_query_executer.go): `core/committer/txvalidator/v20/plugindispatcher/custom_query_executer.go`
- [Policy evaluation](https://github.com/aswinsaathappan/drunix/blob/main/core/policy/application.go): `core/policy/application.go`
- [State-based validation](https://github.com/aswinsaathappan/drunix/blob/main/core/common/validation/statebased/vpmanagerimpl.go): `core/common/validation/statebased/vpmanagerimpl.go`
- [Query executor fake](https://github.com/aswinsaathappan/drunix/blob/main/core/endorser/fake/query_executor.go): `core/endorser/fake/query_executor.go`

### Ordering and ledger

- [Orderer service](https://github.com/aswinsaathappan/drunix/blob/main/orderer/common/server/main.go): `orderer/common/server/main.go`
- [Raft persistence](https://github.com/aswinsaathappan/drunix/blob/main/orderer/consensus/etcdraft/storage.go): `orderer/consensus/etcdraft/storage.go`
- [Peer ledger](https://github.com/aswinsaathappan/drunix/blob/main/core/ledger/kvledger/kv_ledger.go): `core/ledger/kvledger/kv_ledger.go`
- [Block storage](https://github.com/aswinsaathappan/drunix/blob/main/common/ledger/blkstorage/blockstore.go): `common/ledger/blkstorage/blockstore.go`
- [State database](https://github.com/aswinsaathappan/drunix/blob/main/core/ledger/kvledger/txmgmt/statedb/statesqldb/statesqldb.go): `core/ledger/kvledger/txmgmt/statedb/statesqldb/statesqldb.go`
- [Private data storage](https://github.com/aswinsaathappan/drunix/blob/main/core/ledger/pvtdatastorage/store.go): `core/ledger/pvtdatastorage/store.go`

### Chaincode runtime

- [Chaincode lifecycle](https://github.com/aswinsaathappan/drunix/blob/main/core/chaincode/lifecycle/lifecycle.go): `core/chaincode/lifecycle/lifecycle.go`
- [Chaincode runtime](https://github.com/aswinsaathappan/drunix/blob/main/core/chaincode/chaincode_support.go): `core/chaincode/chaincode_support.go`
- [Docker runtime](https://github.com/aswinsaathappan/drunix/blob/main/core/container/dockercontroller/dockercontroller.go): `core/container/dockercontroller/dockercontroller.go`

### Network services

- [Gossip service](https://github.com/aswinsaathappan/drunix/blob/main/gossip/service/gossip_service.go): `gossip/service/gossip_service.go`
- [Peer discovery](https://github.com/aswinsaathappan/drunix/blob/main/discovery/service.go): `discovery/service.go`

### Administration and config

- [Identity generation](https://github.com/aswinsaathappan/drunix/blob/main/cmd/cryptogen/main.go): `cmd/cryptogen/main.go`
- [Channel config generation](https://github.com/aswinsaathappan/drunix/blob/main/cmd/configtxgen/main.go): `cmd/configtxgen/main.go`
- [Config translation](https://github.com/aswinsaathappan/drunix/blob/main/cmd/configtxlator/main.go): `cmd/configtxlator/main.go`
- [Peer CLI](https://github.com/aswinsaathappan/drunix/blob/main/cmd/peer/main.go): `cmd/peer/main.go`
- [Committed chaincode query](https://github.com/aswinsaathappan/drunix/blob/main/internal/peer/lifecycle/chaincode/querycommitted.go): `internal/peer/lifecycle/chaincode/querycommitted.go`

### Other components

- **Client application**

## Connections

- Client application → Peer node: submits transactions
- Peer node → Endorsement: routes proposals
- Endorsement → Chaincode runtime: invokes chaincode
- Peer node → Orderer service: broadcasts transactions
- Orderer service → Raft persistence: persists consensus data (evidence: `orderer/common/server/main.go`)
- Peer node → Transaction validation: commits transactions
- Transaction validation → Stateless validation: dispatches validation (evidence: `core/committer/txvalidator/v20/plugindispatcher/custom_query_executer.go`)
- Transaction validation → Policy evaluation: checks policy
- Transaction validation → State-based validation: checks key policies (evidence: `core/common/validation/statebased/vpmanagerimpl.go`)
- Transaction validation → Peer ledger: reads transaction state
- Peer ledger → Block storage: stores blocks
- Peer ledger → State database: stores world state
- Peer ledger → Private data storage: tracks private data
- Peer node → Chaincode lifecycle: manages definitions
- Chaincode lifecycle → Chaincode runtime: provides metadata
- Chaincode runtime → Docker runtime: starts containers
- Peer node → Gossip service: exchanges network data (evidence: `gossip/service/gossip_service.go`)
- Peer node → Peer discovery: serves discovery
- Client application → Peer discovery: requests peers
- Peer CLI → Committed chaincode query: runs lifecycle query (evidence: `cmd/peer/main.go`)
- Channel config generation → Config translation: configures channels
