# wavesplatform/waves architecture

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

- Interactive diagram: https://gitdiagram.com/wavesplatform/waves
- Repository: https://github.com/wavesplatform/waves

## Overview

Waves Node is a reference blockchain node. Its principal workflow is to accept transactions through node interfaces, validate and incorporate blockchain activity, persist chain state, and expose updated data through APIs and blockchain-update events. The README also identifies block generation, peer-to-peer networking, gRPC, and RIDE as major capabilities. The map uses the sampled startup, storage, language, and cache code plus documented capabilities; several central node internals named by the source index are absent from the supplied tree, so their implementation paths and detailed links are omitted.

Main entry points: [`node/src/main/scala/com/wavesplatform/Application.scala`](https://github.com/wavesplatform/waves/blob/version-1.6.x/node/src/main/scala/com/wavesplatform/Application.scala) (Node startup), [`repl/shared/src/main/scala/com/wavesplatform/lang/v1/repl/ReplEngine.scala`](https://github.com/wavesplatform/waves/blob/version-1.6.x/repl/shared/src/main/scala/com/wavesplatform/lang/v1/repl/ReplEngine.scala) (RIDE REPL), [`lang/shared/src/main/scala/com/wavesplatform/lang/v1/evaluator`](https://github.com/wavesplatform/waves/tree/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/lang/v1/evaluator) (RIDE evaluator), [`grpc-server/src/main/scala/com/wavesplatform/api/grpc`](https://github.com/wavesplatform/waves/tree/version-1.6.x/grpc-server/src/main/scala/com/wavesplatform/api/grpc) (gRPC API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Node runtime"]
  node_app["Node startup<br/>[Application.scala]"]
  node_settings["Node settings"]
  node_p2p["Peer networking"]
end

subgraph group_chain["Chain processing"]
  node_validation["Transaction validation"]
  node_blocks["Block model<br/>[Block.scala]"]
  node_microblocks["Microblock model<br/>[MicroBlock.scala]"]
  node_storagefactory["Storage assembly"]
  node_state["Chain state"]
  node_database[("Node database<br/>[Storage.scala]")]
  node_miner["Block generation"]
end

subgraph group_interfaces["Node interfaces"]
  node_rest["REST API"]
  node_grpc["gRPC API"]
  node_updates["Blockchain updates"]
end

subgraph group_ride["RIDE language"]
  node_rideparser["RIDE parser<br/>[Parser.scala]"]
  node_ridecompiler["RIDE compiler"]
  node_rideevaluator["RIDE evaluator"]
  node_purecontext["Built-in functions<br/>[PureContext.scala]"]
  node_repl["RIDE REPL<br/>[ReplEngine.scala]"]
  node_bytes["Byte strings<br/>[ByteStr.scala]"]
  node_limits["Execution limits"]
  node_stdlib["Standard library versions"]
end

node_operator(("Node operator"))

node_operator -->|"starts"| node_app
node_app -->|"configures"| node_settings
node_app -->|"registers"| node_rest
node_app -.->|"starts"| node_p2p
node_app -.->|"enables optionally"| node_grpc
node_storagefactory -->|"constructs"| node_state
node_storagefactory -->|"opens"| node_database
node_operator -.->|"submits transactions"| node_validation
node_operator -->|"connects peers"| node_p2p
node_operator -.->|"requests generation"| node_miner
node_operator -->|"queries or submits"| node_rest
node_operator -->|"queries"| node_grpc
node_operator -.->|"evaluates expressions"| node_repl
node_repl -->|"parses"| node_rideparser
node_repl -->|"compiles"| node_ridecompiler
node_repl -->|"evaluates"| node_rideevaluator
node_rideparser -->|"uses"| node_bytes
node_repl -->|"selects version"| node_stdlib
node_rideevaluator -.->|"uses functions"| node_purecontext
node_rideevaluator -.->|"applies limits"| node_limits
node_grpc -.->|"streams updates"| node_updates

click node_app "https://github.com/wavesplatform/waves/blob/version-1.6.x/node/src/main/scala/com/wavesplatform/Application.scala"
click node_settings "https://github.com/wavesplatform/waves/blob/version-1.6.x/node/src/main/scala/com/wavesplatform/settings/WavesSettings.scala"
click node_p2p "https://github.com/wavesplatform/waves/tree/version-1.6.x/node/src/main/scala/com/wavesplatform/network"
click node_validation "https://github.com/wavesplatform/waves/tree/version-1.6.x/node/src/main/scala/com/wavesplatform/transaction"
click node_blocks "https://github.com/wavesplatform/waves/blob/version-1.6.x/node/src/main/scala/com/wavesplatform/block/Block.scala"
click node_microblocks "https://github.com/wavesplatform/waves/blob/version-1.6.x/node/src/main/scala/com/wavesplatform/block/MicroBlock.scala"
click node_storagefactory "https://github.com/wavesplatform/waves/blob/version-1.6.x/node/src/main/scala/com/wavesplatform/history/StorageFactory.scala"
click node_state "https://github.com/wavesplatform/waves/tree/version-1.6.x/node/src/main/scala/com/wavesplatform/state"
click node_database "https://github.com/wavesplatform/waves/blob/version-1.6.x/node/src/main/scala/com/wavesplatform/database/Storage.scala"
click node_miner "https://github.com/wavesplatform/waves/tree/version-1.6.x/node/src/main/scala/com/wavesplatform/mining"
click node_rest "https://github.com/wavesplatform/waves/tree/version-1.6.x/node/src/main/scala/com/wavesplatform/api/http"
click node_grpc "https://github.com/wavesplatform/waves/tree/version-1.6.x/grpc-server/src/main/scala/com/wavesplatform/api/grpc"
click node_updates "https://github.com/wavesplatform/waves/tree/version-1.6.x/grpc-server/src/main/scala/com/wavesplatform/events"
click node_rideparser "https://github.com/wavesplatform/waves/blob/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/lang/v1/parser/Parser.scala"
click node_ridecompiler "https://github.com/wavesplatform/waves/tree/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/lang/v1/compiler"
click node_rideevaluator "https://github.com/wavesplatform/waves/tree/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/lang/v1/evaluator"
click node_purecontext "https://github.com/wavesplatform/waves/blob/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/lang/v1/evaluator/ctx/impl/PureContext.scala"
click node_repl "https://github.com/wavesplatform/waves/blob/version-1.6.x/repl/shared/src/main/scala/com/wavesplatform/lang/v1/repl/ReplEngine.scala"
click node_bytes "https://github.com/wavesplatform/waves/blob/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/common/state/ByteStr.scala"
click node_limits "https://github.com/wavesplatform/waves/blob/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/lang/v1/ContractLimits.scala"
click node_stdlib "https://github.com/wavesplatform/waves/blob/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/lang/directives/values/StdLibVersion.scala"

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_app,node_settings,node_p2p toneBlue
class node_validation,node_blocks,node_microblocks,node_storagefactory,node_state,node_database,node_miner toneAmber
class node_rest,node_grpc,node_updates toneMint
class node_rideparser,node_ridecompiler,node_rideevaluator,node_purecontext,node_repl,node_bytes,node_limits,node_stdlib toneRose
class node_operator toneIndigo
```

## Components

### Node runtime

- [Node startup](https://github.com/wavesplatform/waves/blob/version-1.6.x/node/src/main/scala/com/wavesplatform/Application.scala): `node/src/main/scala/com/wavesplatform/Application.scala`
- [Node settings](https://github.com/wavesplatform/waves/blob/version-1.6.x/node/src/main/scala/com/wavesplatform/settings/WavesSettings.scala): `node/src/main/scala/com/wavesplatform/settings/WavesSettings.scala`
- [Peer networking](https://github.com/wavesplatform/waves/tree/version-1.6.x/node/src/main/scala/com/wavesplatform/network): `node/src/main/scala/com/wavesplatform/network`

### Chain processing

- [Transaction validation](https://github.com/wavesplatform/waves/tree/version-1.6.x/node/src/main/scala/com/wavesplatform/transaction): `node/src/main/scala/com/wavesplatform/transaction`
- [Block model](https://github.com/wavesplatform/waves/blob/version-1.6.x/node/src/main/scala/com/wavesplatform/block/Block.scala): `node/src/main/scala/com/wavesplatform/block/Block.scala`
- [Microblock model](https://github.com/wavesplatform/waves/blob/version-1.6.x/node/src/main/scala/com/wavesplatform/block/MicroBlock.scala): `node/src/main/scala/com/wavesplatform/block/MicroBlock.scala`
- [Storage assembly](https://github.com/wavesplatform/waves/blob/version-1.6.x/node/src/main/scala/com/wavesplatform/history/StorageFactory.scala): `node/src/main/scala/com/wavesplatform/history/StorageFactory.scala`
- [Chain state](https://github.com/wavesplatform/waves/tree/version-1.6.x/node/src/main/scala/com/wavesplatform/state): `node/src/main/scala/com/wavesplatform/state`
- [Node database](https://github.com/wavesplatform/waves/blob/version-1.6.x/node/src/main/scala/com/wavesplatform/database/Storage.scala): `node/src/main/scala/com/wavesplatform/database/Storage.scala`
- [Block generation](https://github.com/wavesplatform/waves/tree/version-1.6.x/node/src/main/scala/com/wavesplatform/mining): `node/src/main/scala/com/wavesplatform/mining`

### Node interfaces

- [REST API](https://github.com/wavesplatform/waves/tree/version-1.6.x/node/src/main/scala/com/wavesplatform/api/http): `node/src/main/scala/com/wavesplatform/api/http`
- [gRPC API](https://github.com/wavesplatform/waves/tree/version-1.6.x/grpc-server/src/main/scala/com/wavesplatform/api/grpc): `grpc-server/src/main/scala/com/wavesplatform/api/grpc`
- [Blockchain updates](https://github.com/wavesplatform/waves/tree/version-1.6.x/grpc-server/src/main/scala/com/wavesplatform/events): `grpc-server/src/main/scala/com/wavesplatform/events`

### RIDE language

- [RIDE parser](https://github.com/wavesplatform/waves/blob/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/lang/v1/parser/Parser.scala): `lang/shared/src/main/scala/com/wavesplatform/lang/v1/parser/Parser.scala`
- [RIDE compiler](https://github.com/wavesplatform/waves/tree/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/lang/v1/compiler): `lang/shared/src/main/scala/com/wavesplatform/lang/v1/compiler`
- [RIDE evaluator](https://github.com/wavesplatform/waves/tree/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/lang/v1/evaluator): `lang/shared/src/main/scala/com/wavesplatform/lang/v1/evaluator`
- [Built-in functions](https://github.com/wavesplatform/waves/blob/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/lang/v1/evaluator/ctx/impl/PureContext.scala): `lang/shared/src/main/scala/com/wavesplatform/lang/v1/evaluator/ctx/impl/PureContext.scala`
- [RIDE REPL](https://github.com/wavesplatform/waves/blob/version-1.6.x/repl/shared/src/main/scala/com/wavesplatform/lang/v1/repl/ReplEngine.scala): `repl/shared/src/main/scala/com/wavesplatform/lang/v1/repl/ReplEngine.scala`
- [Byte strings](https://github.com/wavesplatform/waves/blob/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/common/state/ByteStr.scala): `lang/shared/src/main/scala/com/wavesplatform/common/state/ByteStr.scala`
- [Execution limits](https://github.com/wavesplatform/waves/blob/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/lang/v1/ContractLimits.scala): `lang/shared/src/main/scala/com/wavesplatform/lang/v1/ContractLimits.scala`
- [Standard library versions](https://github.com/wavesplatform/waves/blob/version-1.6.x/lang/shared/src/main/scala/com/wavesplatform/lang/directives/values/StdLibVersion.scala): `lang/shared/src/main/scala/com/wavesplatform/lang/directives/values/StdLibVersion.scala`

### Other components

- **Node operator**

## Connections

- Node operator → Node startup: starts (evidence: `README.md`)
- Node startup → Node settings: configures (evidence: `node/src/main/scala/com/wavesplatform/Application.scala`)
- Node startup → REST API: registers (evidence: `node/src/main/scala/com/wavesplatform/Application.scala`)
- Node startup → Peer networking: starts (evidence: `node/src/main/scala/com/wavesplatform/Application.scala`)
- Node startup → gRPC API: enables optionally (evidence: `README.md`)
- Storage assembly → Chain state: constructs (evidence: `node/src/main/scala/com/wavesplatform/history/StorageFactory.scala`)
- Storage assembly → Node database: opens (evidence: `node/src/main/scala/com/wavesplatform/history/StorageFactory.scala`)
- Node operator → Transaction validation: submits transactions
- Node operator → Peer networking: connects peers (evidence: `README.md`)
- Node operator → Block generation: requests generation
- Node operator → REST API: queries or submits (evidence: `README.md`)
- Node operator → gRPC API: queries (evidence: `README.md`)
- Node operator → RIDE REPL: evaluates expressions
- RIDE REPL → RIDE parser: parses (evidence: `repl/shared/src/main/scala/com/wavesplatform/lang/v1/repl/ReplEngine.scala`)
- RIDE REPL → RIDE compiler: compiles (evidence: `repl/shared/src/main/scala/com/wavesplatform/lang/v1/repl/ReplEngine.scala`)
- RIDE REPL → RIDE evaluator: evaluates (evidence: `repl/shared/src/main/scala/com/wavesplatform/lang/v1/repl/ReplEngine.scala`)
- RIDE parser → Byte strings: uses (evidence: `lang/shared/src/main/scala/com/wavesplatform/lang/v1/parser/Parser.scala`)
- RIDE REPL → Standard library versions: selects version (evidence: `repl/shared/src/main/scala/com/wavesplatform/lang/v1/repl/ReplEngine.scala`)
- RIDE evaluator → Built-in functions: uses functions (evidence: `lang/shared/src/main/scala/com/wavesplatform/lang/v1/evaluator/ctx/impl/PureContext.scala`)
- RIDE evaluator → Execution limits: applies limits (evidence: `lang/shared/src/main/scala/com/wavesplatform/lang/v1/evaluator/ctx/impl/PureContext.scala`)
- gRPC API → Blockchain updates: streams updates (evidence: `README.md`)
