Heimdall-v2 is the consensus client at the core of the Polygon PoS network. It is a complete rewrite of the original Heimdall, built on a fork of Cosmos SDK (Documentation Index
Fetch the complete documentation index at: https://docs.polygon.technology/llms.txt
Use this file to discover all available pages before exploring further.
v0.50.13) and a fork of CometBFT (v0.38.17).
Heimdall-v2 performs the following functions:
- Manages validators and their stake.
- Handles block producer selection for the Bor layer.
- Facilitates span management.
- Orchestrates the state sync mechanism between Ethereum and Polygon PoS.
- Handles checkpoints: periodic Merkle root submissions of Bor block data to Ethereum.
- Handles milestones: fast deterministic finality within 2 to 5 seconds, using vote extensions.
Modules
Heimdall-v2 uses modified versions of some Cosmos SDK modules and a set of fully custom modules:- Modified Cosmos SDK modules:
auth,bank,gov - Custom modules:
bor,chainmanager,checkpoint,clerk,milestone,stake,topup