How paritytech/polkadot-sdk works
The Polkadot SDK is a toolkit for building blockchain runtimes and nodes, including parachains and cross-chain bridges. A principal interoperability workflow is relaying finalized headers and messages between chains: relay commands select the operation, relay components handle chain access and synchronization, and bridge pallets verify and process updates. The tree also shows Snowbridge’s Ethereum-facing queues and beacon verification, plus Cumulus parachain services. The README describes the SDK’s broader scope; sampled source is sparse, so links between most listed subsystems are intentionally omitted.
Main entry points: mod.rs Relay commands · finality_loop.rs Finality sync · message_lane_loop.rs Message sync · parachains_loop.rs Parachain sync
Components 21
Runtime building blocks
- Runtime primitives
bridges/primitives/runtime/src/lib.rs
Bridge runtime
- Header-chain bridge
bridges/modules/grandpa/src/lib.rs - Parachain bridge
bridges/modules/parachains/src/lib.rs - Message lanes
bridges/modules/messages/src/lib.rs - Relayer registry
bridges/modules/relayers/src/lib.rs - XCM bridge hub
bridges/modules/xcm-bridge-hub/src/lib.rs - Hub router
bridges/modules/xcm-bridge-hub-router/src/lib.rs - Ethereum light client
bridges/snowbridge/pallets/ethereum-client/src/lib.rs - Inbound queue
bridges/snowbridge/pallets/inbound-queue/src/lib.rs - Outbound queue
bridges/snowbridge/pallets/outbound-queue/src/lib.rs - Beacon verification
bridges/snowbridge/primitives/beacon/src/lib.rs
Relay services
- Relay commands
bridges/relays/lib-substrate-relay/src/cli/mod.rs - Chain client
bridges/relays/client-substrate/src/client/mod.rs - Finality sync
bridges/relays/finality/src/finality_loop.rs - Message sync
bridges/relays/messages/src/message_lane_loop.rs - Parachain sync
bridges/relays/parachains/src/parachains_loop.rs
Parachain services
- Collator service
cumulus/client/collator/src/service.rs - Aura consensus
cumulus/client/consensus/aura/src/lib.rs - Parachain system
cumulus/pallets/parachain-system/src/lib.rs - Relay-chain interface
cumulus/client/relay-chain-interface/src/lib.rs
Other components
- Chain developer
Connections 15
- Chain developer → Relay commands: runs commands
- Finality sync → Chain client: accesses chains
- Message sync → Chain client: accesses chains
- Parachain sync → Chain client: accesses chains
- Relay commands → Finality sync: starts sync
- Relay commands → Message sync: starts sync
- Relay commands → Parachain sync: starts sync
- Finality sync → Header-chain bridge: submits proofs
- Message sync → Message lanes: relays messages
- Parachain sync → Parachain bridge: relays proofs
- Ethereum light client → Beacon verification: verifies updates
- Collator service → Aura consensus: uses consensus
- Collator service → Relay-chain interface: connects to relay
- Parachain system → Relay-chain interface: uses relay data
- Chain developer → Runtime primitives: builds with