# linera-io/linera-protocol architecture

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

- Interactive diagram: https://gitdiagram.com/linera-io/linera-protocol
- Repository: https://github.com/linera-io/linera-protocol

## Overview

Linera is decentralized blockchain infrastructure for low-latency Web3 applications. Its principal workflow starts with a wallet user issuing a command, proceeds through client and validator protocol logic to chain consensus and application execution, and persists the resulting state. The graph also preserves major runtime capabilities visible in the repository, including application development, RPC, indexing, exploration, bridging, and faucet support. Edges are limited to relationships documented in the README or visible in excerpts; dashed, uncited links mark unverified subsystem connections.

Main entry points: [`linera-client/src/client_context.rs`](https://github.com/linera-io/linera-protocol/blob/main/linera-client/src/client_context.rs) (Client Context), [`linera-execution/src/runtime.rs`](https://github.com/linera-io/linera-protocol/blob/main/linera-execution/src/runtime.rs) (Execution Runtime), [`linera-storage/src/db_storage.rs`](https://github.com/linera-io/linera-protocol/blob/main/linera-storage/src/db_storage.rs) (Protocol Storage), [`linera-indexer/lib/src/indexer.rs`](https://github.com/linera-io/linera-protocol/blob/main/linera-indexer/lib/src/indexer.rs) (Indexer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Wallet and Client"]
  node_cli["Linera CLI<br/>[main.rs]"]
  node_client_context["Client Context<br/>[client_context.rs]"]
  node_client_config["Client Configuration<br/>[config.rs]"]
  node_wallet_state[("Wallet State<br/>[wallet.rs]")]
end

subgraph group_protocol["Chain Protocol"]
  node_core_protocol["Core Protocol<br/>[mod.rs]"]
  node_chain_consensus["Chain Consensus<br/>[manager.rs]"]
  node_consensus_proofs["Consensus Proofs<br/>[proof.rs]"]
end

subgraph group_runtime["Application Runtime"]
  node_execution["Execution Runtime<br/>[runtime.rs]"]
  node_execution_state["Execution State"]
  node_wasm_runtime["Wasm Runtime<br/>[mod.rs]"]
  node_sdk["Application SDK<br/>[lib.rs]"]
end

subgraph group_infrastructure["Node Infrastructure"]
  node_storage[("Protocol Storage<br/>[db_storage.rs]")]
  node_views["State Views<br/>[store.rs]"]
  node_rpc["Validator RPC<br/>[server.rs]"]
  node_storage_service["Storage Service<br/>[server.rs]"]
end

subgraph group_ecosystem["Developer and Data Tools"]
  node_faucet["Faucet<br/>[lib.rs]"]
  node_indexer["Indexer<br/>[indexer.rs]"]
  node_exporter["Exporter"]
  node_explorer["Explorer UI<br/>[App.vue]"]
  node_explorer_api["Explorer API<br/>[routes.rs]"]
  node_bridge["Bridge Relay<br/>[main.rs]"]
end

node_wallet_user(("Wallet User"))
node_ethereum(("Ethereum Network"))

node_wallet_user -->|"issues commands"| node_cli
node_cli -->|"uses client"| node_client_context
node_client_context -->|"loads configuration"| node_client_config
node_client_context -.->|"updates wallet"| node_wallet_state
node_client_context -->|"drives client logic"| node_core_protocol
node_core_protocol -->|"coordinates chains"| node_chain_consensus
node_chain_consensus -.->|"uses certificates"| node_consensus_proofs
node_core_protocol -->|"communicates by RPC"| node_rpc
node_chain_consensus -.->|"executes blocks"| node_execution
node_execution -->|"updates state"| node_execution_state
node_execution -.->|"runs Wasm"| node_wasm_runtime
node_execution -.->|"persists state"| node_storage
node_storage -->|"uses data views"| node_views
node_storage_service -.->|"serves storage"| node_storage
node_sdk -->|"targets Wasm"| node_wasm_runtime
node_indexer -.->|"reads chain data"| node_storage
node_exporter -.->|"exports indexed data"| node_indexer
node_explorer -.->|"queries chain data"| node_indexer
node_explorer_api -.->|"serves explorer data"| node_indexer
node_bridge -.->|"relays messages"| node_ethereum
node_wallet_user -.->|"requests funding"| node_faucet

click node_cli "https://github.com/linera-io/linera-protocol/blob/main/linera-service/src/cli/main.rs"
click node_client_context "https://github.com/linera-io/linera-protocol/blob/main/linera-client/src/client_context.rs"
click node_client_config "https://github.com/linera-io/linera-protocol/blob/main/linera-client/src/config.rs"
click node_wallet_state "https://github.com/linera-io/linera-protocol/blob/main/linera-wallet-json/src/wallet.rs"
click node_core_protocol "https://github.com/linera-io/linera-protocol/blob/main/linera-core/src/client/mod.rs"
click node_chain_consensus "https://github.com/linera-io/linera-protocol/blob/main/linera-chain/src/manager.rs"
click node_consensus_proofs "https://github.com/linera-io/linera-protocol/blob/main/linera-chain/src/justification/proof.rs"
click node_execution "https://github.com/linera-io/linera-protocol/blob/main/linera-execution/src/runtime.rs"
click node_execution_state "https://github.com/linera-io/linera-protocol/blob/main/linera-execution/src/execution_state_actor.rs"
click node_wasm_runtime "https://github.com/linera-io/linera-protocol/blob/main/linera-execution/src/wasm/mod.rs"
click node_sdk "https://github.com/linera-io/linera-protocol/blob/main/linera-sdk/src/lib.rs"
click node_storage "https://github.com/linera-io/linera-protocol/blob/main/linera-storage/src/db_storage.rs"
click node_views "https://github.com/linera-io/linera-protocol/blob/main/linera-views/src/store.rs"
click node_rpc "https://github.com/linera-io/linera-protocol/blob/main/linera-rpc/src/grpc/server.rs"
click node_storage_service "https://github.com/linera-io/linera-protocol/blob/main/linera-storage-service/src/server.rs"
click node_faucet "https://github.com/linera-io/linera-protocol/blob/main/linera-faucet/server/src/lib.rs"
click node_indexer "https://github.com/linera-io/linera-protocol/blob/main/linera-indexer/lib/src/indexer.rs"
click node_exporter "https://github.com/linera-io/linera-protocol/blob/main/linera-exporter/src/runloops/indexer/indexer_exporter.rs"
click node_explorer "https://github.com/linera-io/linera-protocol/blob/main/linera-explorer/src/components/App.vue"
click node_explorer_api "https://github.com/linera-io/linera-protocol/blob/main/linera-explorer-new/server-rust/src/routes.rs"
click node_bridge "https://github.com/linera-io/linera-protocol/blob/main/linera-bridge/src/main.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_cli,node_client_context,node_client_config,node_wallet_state,node_wallet_user toneBlue
class node_core_protocol,node_chain_consensus,node_consensus_proofs toneAmber
class node_execution,node_execution_state,node_wasm_runtime,node_sdk toneMint
class node_storage,node_views,node_rpc,node_storage_service toneRose
class node_faucet,node_indexer,node_exporter,node_explorer,node_explorer_api,node_bridge,node_ethereum toneIndigo
```

## Components

### Wallet and Client

- [Linera CLI](https://github.com/linera-io/linera-protocol/blob/main/linera-service/src/cli/main.rs): `linera-service/src/cli/main.rs`
- [Client Context](https://github.com/linera-io/linera-protocol/blob/main/linera-client/src/client_context.rs): `linera-client/src/client_context.rs`
- [Client Configuration](https://github.com/linera-io/linera-protocol/blob/main/linera-client/src/config.rs): `linera-client/src/config.rs`
- [Wallet State](https://github.com/linera-io/linera-protocol/blob/main/linera-wallet-json/src/wallet.rs): `linera-wallet-json/src/wallet.rs`

### Chain Protocol

- [Core Protocol](https://github.com/linera-io/linera-protocol/blob/main/linera-core/src/client/mod.rs): `linera-core/src/client/mod.rs`
- [Chain Consensus](https://github.com/linera-io/linera-protocol/blob/main/linera-chain/src/manager.rs): `linera-chain/src/manager.rs`
- [Consensus Proofs](https://github.com/linera-io/linera-protocol/blob/main/linera-chain/src/justification/proof.rs): `linera-chain/src/justification/proof.rs`

### Application Runtime

- [Execution Runtime](https://github.com/linera-io/linera-protocol/blob/main/linera-execution/src/runtime.rs): `linera-execution/src/runtime.rs`
- [Execution State](https://github.com/linera-io/linera-protocol/blob/main/linera-execution/src/execution_state_actor.rs): `linera-execution/src/execution_state_actor.rs`
- [Wasm Runtime](https://github.com/linera-io/linera-protocol/blob/main/linera-execution/src/wasm/mod.rs): `linera-execution/src/wasm/mod.rs`
- [Application SDK](https://github.com/linera-io/linera-protocol/blob/main/linera-sdk/src/lib.rs): `linera-sdk/src/lib.rs`

### Node Infrastructure

- [Protocol Storage](https://github.com/linera-io/linera-protocol/blob/main/linera-storage/src/db_storage.rs): `linera-storage/src/db_storage.rs`
- [State Views](https://github.com/linera-io/linera-protocol/blob/main/linera-views/src/store.rs): `linera-views/src/store.rs`
- [Validator RPC](https://github.com/linera-io/linera-protocol/blob/main/linera-rpc/src/grpc/server.rs): `linera-rpc/src/grpc/server.rs`
- [Storage Service](https://github.com/linera-io/linera-protocol/blob/main/linera-storage-service/src/server.rs): `linera-storage-service/src/server.rs`

### Developer and Data Tools

- [Faucet](https://github.com/linera-io/linera-protocol/blob/main/linera-faucet/server/src/lib.rs): `linera-faucet/server/src/lib.rs`
- [Indexer](https://github.com/linera-io/linera-protocol/blob/main/linera-indexer/lib/src/indexer.rs): `linera-indexer/lib/src/indexer.rs`
- [Exporter](https://github.com/linera-io/linera-protocol/blob/main/linera-exporter/src/runloops/indexer/indexer_exporter.rs): `linera-exporter/src/runloops/indexer/indexer_exporter.rs`
- [Explorer UI](https://github.com/linera-io/linera-protocol/blob/main/linera-explorer/src/components/App.vue): `linera-explorer/src/components/App.vue`
- [Explorer API](https://github.com/linera-io/linera-protocol/blob/main/linera-explorer-new/server-rust/src/routes.rs): `linera-explorer-new/server-rust/src/routes.rs`
- [Bridge Relay](https://github.com/linera-io/linera-protocol/blob/main/linera-bridge/src/main.rs): `linera-bridge/src/main.rs`

### Other components

- **Wallet User**
- **Ethereum Network**

## Connections

- Wallet User → Linera CLI: issues commands (evidence: `README.md`)
- Linera CLI → Client Context: uses client (evidence: `README.md`)
- Client Context → Client Configuration: loads configuration (evidence: `linera-client/src/client_context.rs`)
- Client Context → Wallet State: updates wallet
- Client Context → Core Protocol: drives client logic (evidence: `README.md`)
- Core Protocol → Chain Consensus: coordinates chains (evidence: `README.md`)
- Chain Consensus → Consensus Proofs: uses certificates
- Core Protocol → Validator RPC: communicates by RPC (evidence: `README.md`)
- Chain Consensus → Execution Runtime: executes blocks
- Execution Runtime → Execution State: updates state (evidence: `linera-execution/src/execution.rs`)
- Execution Runtime → Wasm Runtime: runs Wasm
- Execution Runtime → Protocol Storage: persists state
- Protocol Storage → State Views: uses data views (evidence: `README.md`)
- Storage Service → Protocol Storage: serves storage
- Application SDK → Wasm Runtime: targets Wasm (evidence: `README.md`)
- Indexer → Protocol Storage: reads chain data
- Exporter → Indexer: exports indexed data
- Explorer UI → Indexer: queries chain data
- Explorer API → Indexer: serves explorer data
- Bridge Relay → Ethereum Network: relays messages
- Wallet User → Faucet: requests funding
