# casper-network/casper-node architecture

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

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

## Overview

Casper Node is the reference implementation of the Casper blockchain protocol. The principal workflow is a validator joining a peer network, participating in consensus, synchronizing and validating blocks, executing transactions, and persisting chain data. The tree also shows contract tooling and APIs, while the README documents validator launch and smart-contract development. The excerpts establish some engine and storage responsibilities, but do not show the node’s reactor wiring; those subsystem relationships are therefore dashed and unverified.

Main entry points: [`node/src/reactor/main_reactor.rs`](https://github.com/casper-network/casper-node/blob/dev/node/src/reactor/main_reactor.rs) (Event reactor), [`execution_engine/src/engine_state/mod.rs`](https://github.com/casper-network/casper-node/blob/dev/execution_engine/src/engine_state/mod.rs) (Execution engine), [`node/src/app/main.rs`](https://github.com/casper-network/casper-node/blob/dev/node/src/app/main.rs) (Validator node), [`smart_contracts/contract/src/contract_api/storage.rs`](https://github.com/casper-network/casper-node/blob/dev/smart_contracts/contract/src/contract_api/storage.rs) (Contract API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_node["Node Operations"]
  node_node_process["Validator node<br/>[main.rs]"]
  node_reactor["Event reactor<br/>[main_reactor.rs]"]
  node_network["Peer networking<br/>[tasks.rs]"]
  node_consensus["Highway consensus<br/>[highway.rs]"]
  node_sync["Block synchronization"]
  node_validation["Block validation<br/>[block_validator.rs]"]
  node_transactions["Transaction intake"]
  node_contract_runtime["Contract runtime"]
  node_storage[("Node storage<br/>[storage.rs]")]
  node_rest["REST service<br/>[rest_server.rs]"]
  node_event_stream["Event stream"]
  node_diagnostics["Diagnostics port<br/>[tasks.rs]"]
end

subgraph group_execution["Execution Platform"]
  node_engine["Execution engine<br/>[mod.rs]"]
  node_wasm_runtime["Wasm runtime<br/>[mod.rs]"]
  node_wasm_executor["Wasm executor<br/>[wasm_v1.rs]"]
  node_wasm_prep["Wasm preparation<br/>[wasm_prep.rs]"]
end

subgraph group_contracts["Contract Development"]
  node_contract_api["Contract API<br/>[storage.rs]"]
  node_client_contracts["Example contracts<br/>[main.rs]"]
end

subgraph group_tools["Operator Tools"]
  node_cargo_casper["Contract CLI<br/>[cli.rs]"]
end

node_operator(("Node operator"))

node_operator -->|"launches validator"| node_node_process
node_node_process -.->|"dispatches events"| node_reactor
node_reactor -.->|"coordinates"| node_network
node_reactor -.->|"coordinates"| node_consensus
node_reactor -.->|"coordinates"| node_sync
node_reactor -.->|"coordinates"| node_validation
node_reactor -.->|"coordinates"| node_transactions
node_reactor -.->|"coordinates"| node_contract_runtime
node_reactor -.->|"coordinates"| node_storage
node_reactor -.->|"serves"| node_rest
node_reactor -.->|"serves"| node_event_stream
node_reactor -.->|"serves"| node_diagnostics
node_engine -->|"executes Wasm"| node_wasm_executor
node_engine -->|"uses runtime"| node_wasm_runtime
node_engine -.->|"prepares Wasm"| node_wasm_prep
node_contract_api -.->|"invokes host"| node_engine
node_client_contracts -.->|"uses API"| node_contract_api
node_operator -->|"creates contracts"| node_cargo_casper

click node_node_process "https://github.com/casper-network/casper-node/blob/dev/node/src/app/main.rs"
click node_reactor "https://github.com/casper-network/casper-node/blob/dev/node/src/reactor/main_reactor.rs"
click node_network "https://github.com/casper-network/casper-node/blob/dev/node/src/components/network/tasks.rs"
click node_consensus "https://github.com/casper-network/casper-node/blob/dev/node/src/components/consensus/highway_core/highway.rs"
click node_sync "https://github.com/casper-network/casper-node/blob/dev/node/src/components/block_synchronizer.rs"
click node_validation "https://github.com/casper-network/casper-node/blob/dev/node/src/components/block_validator.rs"
click node_transactions "https://github.com/casper-network/casper-node/blob/dev/node/src/components/transaction_acceptor.rs"
click node_contract_runtime "https://github.com/casper-network/casper-node/blob/dev/node/src/components/contract_runtime.rs"
click node_storage "https://github.com/casper-network/casper-node/blob/dev/node/src/components/storage.rs"
click node_engine "https://github.com/casper-network/casper-node/blob/dev/execution_engine/src/engine_state/mod.rs"
click node_wasm_runtime "https://github.com/casper-network/casper-node/blob/dev/execution_engine/src/runtime/mod.rs"
click node_wasm_executor "https://github.com/casper-network/casper-node/blob/dev/execution_engine/src/engine_state/wasm_v1.rs"
click node_wasm_prep "https://github.com/casper-network/casper-node/blob/dev/execution_engine/src/runtime/wasm_prep.rs"
click node_contract_api "https://github.com/casper-network/casper-node/blob/dev/smart_contracts/contract/src/contract_api/storage.rs"
click node_client_contracts "https://github.com/casper-network/casper-node/blob/dev/smart_contracts/contracts/client/add-bid/src/main.rs"
click node_cargo_casper "https://github.com/casper-network/casper-node/blob/dev/cargo_casper/src/cli.rs"
click node_rest "https://github.com/casper-network/casper-node/blob/dev/node/src/components/rest_server.rs"
click node_event_stream "https://github.com/casper-network/casper-node/blob/dev/node/src/components/event_stream_server.rs"
click node_diagnostics "https://github.com/casper-network/casper-node/blob/dev/node/src/components/diagnostics_port/tasks.rs"

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_node_process,node_reactor,node_network,node_consensus,node_sync,node_validation,node_transactions,node_contract_runtime,node_storage,node_rest,node_event_stream,node_diagnostics toneBlue
class node_engine,node_wasm_runtime,node_wasm_executor,node_wasm_prep toneAmber
class node_contract_api,node_client_contracts toneMint
class node_cargo_casper toneRose
class node_operator toneIndigo
```

## Components

### Node Operations

- [Validator node](https://github.com/casper-network/casper-node/blob/dev/node/src/app/main.rs): `node/src/app/main.rs`
- [Event reactor](https://github.com/casper-network/casper-node/blob/dev/node/src/reactor/main_reactor.rs): `node/src/reactor/main_reactor.rs`
- [Peer networking](https://github.com/casper-network/casper-node/blob/dev/node/src/components/network/tasks.rs): `node/src/components/network/tasks.rs`
- [Highway consensus](https://github.com/casper-network/casper-node/blob/dev/node/src/components/consensus/highway_core/highway.rs): `node/src/components/consensus/highway_core/highway.rs`
- [Block synchronization](https://github.com/casper-network/casper-node/blob/dev/node/src/components/block_synchronizer.rs): `node/src/components/block_synchronizer.rs`
- [Block validation](https://github.com/casper-network/casper-node/blob/dev/node/src/components/block_validator.rs): `node/src/components/block_validator.rs`
- [Transaction intake](https://github.com/casper-network/casper-node/blob/dev/node/src/components/transaction_acceptor.rs): `node/src/components/transaction_acceptor.rs`
- [Contract runtime](https://github.com/casper-network/casper-node/blob/dev/node/src/components/contract_runtime.rs): `node/src/components/contract_runtime.rs`
- [Node storage](https://github.com/casper-network/casper-node/blob/dev/node/src/components/storage.rs): `node/src/components/storage.rs`
- [REST service](https://github.com/casper-network/casper-node/blob/dev/node/src/components/rest_server.rs): `node/src/components/rest_server.rs`
- [Event stream](https://github.com/casper-network/casper-node/blob/dev/node/src/components/event_stream_server.rs): `node/src/components/event_stream_server.rs`
- [Diagnostics port](https://github.com/casper-network/casper-node/blob/dev/node/src/components/diagnostics_port/tasks.rs): `node/src/components/diagnostics_port/tasks.rs`

### Execution Platform

- [Execution engine](https://github.com/casper-network/casper-node/blob/dev/execution_engine/src/engine_state/mod.rs): `execution_engine/src/engine_state/mod.rs`
- [Wasm runtime](https://github.com/casper-network/casper-node/blob/dev/execution_engine/src/runtime/mod.rs): `execution_engine/src/runtime/mod.rs`
- [Wasm executor](https://github.com/casper-network/casper-node/blob/dev/execution_engine/src/engine_state/wasm_v1.rs): `execution_engine/src/engine_state/wasm_v1.rs`
- [Wasm preparation](https://github.com/casper-network/casper-node/blob/dev/execution_engine/src/runtime/wasm_prep.rs): `execution_engine/src/runtime/wasm_prep.rs`

### Contract Development

- [Contract API](https://github.com/casper-network/casper-node/blob/dev/smart_contracts/contract/src/contract_api/storage.rs): `smart_contracts/contract/src/contract_api/storage.rs`
- [Example contracts](https://github.com/casper-network/casper-node/blob/dev/smart_contracts/contracts/client/add-bid/src/main.rs): `smart_contracts/contracts/client/add-bid/src/main.rs`

### Operator Tools

- [Contract CLI](https://github.com/casper-network/casper-node/blob/dev/cargo_casper/src/cli.rs): `cargo_casper/src/cli.rs`

### Other components

- **Node operator**

## Connections

- Node operator → Validator node: launches validator
- Validator node → Event reactor: dispatches events
- Event reactor → Peer networking: coordinates
- Event reactor → Highway consensus: coordinates
- Event reactor → Block synchronization: coordinates
- Event reactor → Block validation: coordinates
- Event reactor → Transaction intake: coordinates
- Event reactor → Contract runtime: coordinates
- Event reactor → Node storage: coordinates
- Event reactor → REST service: serves
- Event reactor → Event stream: serves
- Event reactor → Diagnostics port: serves
- Execution engine → Wasm executor: executes Wasm (evidence: `execution_engine/src/engine_state/mod.rs`)
- Execution engine → Wasm runtime: uses runtime (evidence: `execution_engine/src/engine_state/mod.rs`)
- Execution engine → Wasm preparation: prepares Wasm
- Contract API → Execution engine: invokes host
- Example contracts → Contract API: uses API
- Node operator → Contract CLI: creates contracts
