How linera-io/linera-protocol works
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: client_context.rs Client Context · runtime.rs Execution Runtime · db_storage.rs Protocol Storage · indexer.rs Indexer
Components 23
Wallet and Client
- Linera CLI
linera-service/src/cli/main.rs - Client Context
linera-client/src/client_context.rs - Client Configuration
linera-client/src/config.rs - Wallet State
linera-wallet-json/src/wallet.rs
Chain Protocol
- Core Protocol
linera-core/src/client/mod.rs - Chain Consensus
linera-chain/src/manager.rs - Consensus Proofs
linera-chain/src/justification/proof.rs
Application Runtime
- Execution Runtime
linera-execution/src/runtime.rs - Execution State
linera-execution/src/execution_state_actor.rs - Wasm Runtime
linera-execution/src/wasm/mod.rs - Application SDK
linera-sdk/src/lib.rs
Node Infrastructure
- Protocol Storage
linera-storage/src/db_storage.rs - State Views
linera-views/src/store.rs - Validator RPC
linera-rpc/src/grpc/server.rs - Storage Service
linera-storage-service/src/server.rs
Developer and Data Tools
- Faucet
linera-faucet/server/src/lib.rs - Indexer
linera-indexer/lib/src/indexer.rs - Exporter
linera-exporter/src/runloops/indexer/indexer_exporter.rs - Explorer UI
linera-explorer/src/components/App.vue - Explorer API
linera-explorer-new/server-rust/src/routes.rs - Bridge Relay
linera-bridge/src/main.rs
Other components
- Wallet User
- Ethereum Network
Connections 21
- Wallet User → Linera CLI: issues commands
README.md - Linera CLI → Client Context: uses client
README.md - Client Context → Client Configuration: loads configuration
linera-client/src/client_context.rs - Client Context → Wallet State: updates wallet
- Client Context → Core Protocol: drives client logic
README.md - Core Protocol → Chain Consensus: coordinates chains
README.md - Chain Consensus → Consensus Proofs: uses certificates
- Core Protocol → Validator RPC: communicates by RPC
README.md - Chain Consensus → Execution Runtime: executes blocks
- Execution Runtime → Execution State: updates state
linera-execution/src/execution.rs - Execution Runtime → Wasm Runtime: runs Wasm
- Execution Runtime → Protocol Storage: persists state
- Protocol Storage → State Views: uses data views
README.md - Storage Service → Protocol Storage: serves storage
- Application SDK → Wasm Runtime: targets Wasm
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