How offchainlabs/prysm works
Prysm is a Go implementation of Ethereum consensus, with beacon-node and validator runtimes. A beacon node processes consensus data, coordinates fork choice and execution, and exposes node APIs; validator services manage signing keys and interact with beacon nodes. The tree also shows peer networking, persistence, light-client, slasher, and monitoring subsystems. The supplied excerpts establish some execution-engine, runtime, and key-manager behavior, but not most wiring; unverified relationships are omitted rather than inferred.
Main entry points: main.go Beacon runtime · cli_manager.go Account management · keymanager.go Remote signer · handlers_keymanager.go Validator key API
Components 26
Beacon node
- Beacon runtime
cmd/beacon-chain/main.go - Node lifecycle
beacon-chain/node - Synchronization
beacon-chain/sync/service.go
Consensus processing
- Chain processing
beacon-chain/blockchain - Fork choice
beacon-chain/forkchoice/doubly-linked-tree - State transitions
beacon-chain/core/transition - Consensus operations
beacon-chain/core - Execution coordination
beacon-chain/blockchain/execution_engine.go - Execution client service
beacon-chain/execution/engine_client.go - Engine JSON-RPC
beacon-chain/execution/engine_jsonrpc.go - Block builder
beacon-chain/builder/service.go
Networking and APIs
- Peer networking
beacon-chain/p2p - Beacon APIs
beacon-chain/rpc/eth/beacon/handlers.go - SSZ query API
beacon-chain/rpc/prysm/beacon/ssz_query.go
Validator services
- Validator runtime
cmd/validator/main.go - Account management
validator/accounts/cli_manager.go - Local key manager
validator/keymanager/local/keymanager.go - Remote signer
validator/keymanager/remote-web3signer/keymanager.go - Validator key API
validator/rpc/handlers_keymanager.go - Slasher
beacon-chain/slasher/service.go
State and persistence
- Beacon database
beacon-chain/db/kv - Genesis state
genesis/storage.go - Light client
beacon-chain/light-client/lightclient.go
Other components
- Node operator
- Execution client
- Web3Signer
Connections 17
- Node operator → Beacon runtime: starts node
- Beacon runtime → Node lifecycle: starts runtime
cmd/beacon-chain/main.go - Beacon runtime → Block builder: wires builder
cmd/beacon-chain/main.go - Beacon runtime → Synchronization: wires sync
cmd/beacon-chain/main.go - Chain processing → Execution client service: calls execution
beacon-chain/blockchain/execution_engine.go - Execution client service → Engine JSON-RPC: implements RPC
- Engine JSON-RPC → Execution client: sends requests
- Beacon runtime → Chain processing: wires chain
cmd/beacon-chain/main.go - Node operator → Validator runtime: starts validator
- Validator runtime → Account management: loads accounts
- Account management → Local key manager: uses key manager
validator/accounts/cli_manager.go - Account management → Remote signer: uses key manager
- Validator key API → Local key manager: manages keys
- Validator key API → Remote signer: manages keys
- Remote signer → Web3Signer: signs remotely
- Beacon runtime → Beacon APIs: exposes APIs
- Beacon runtime → SSZ query API: exposes query