Polygon's Purley hard fork is live on the PoS mainnet, and the code behind it went public only after validators had already switched to a privately distributed build.
Key Takeaways
- Purley activated on Polygon mainnet November 20.
- Source code was published after activation.
- Rules changed for deposits, staking and checkpoints.
- Heimdall nodes need v0.14.0-priv or later.
Polygon’s announcement on its developer forum places activation at Heimdall block 58,280,000 at 01:39:38 UTC and describes the public v0.14.0 release as functionally identical to the private build mainnet nodes had to run.
The Fork Went Live Before the Code Did
Purley reached the Amoy testnet first, at block 52,108,000 on November 12, and mainnet eight days later. Both activations ran on private builds. Node operators installed those binaries, but the source code only became public when v0.14.0 was tagged on GitHub on November 20.
The GitHub release notes name one difference from the private build: a validator-join account lookup now uses the task context, a change outside consensus. The hard fork itself was merged as a single pull request, #699.
Neither document explains why the public release came second, and the notes do not describe Purley as a security fix. Software teams sometimes hold back code until a change is live, so it cannot be studied and targeted before nodes upgrade. Polygon has not said that was the reason here.
There is precedent for a fuller account arriving later. An earlier Heimdall-v2 release, v0.4.4, went out as an ABCI security patch with a write-up describing how late, malformed vote extensions could halt the chain. Vote extensions sit at the centre of Purley as well.
The opposite reading deserves equal weight. A private rollout followed by a full code release is ordinary practice for consensus changes, and the code is now open to anyone who wants to check what changed.
Three Routes From Ethereum, One Consensus Layer
Polygon PoS runs on two layers. Bor produces blocks, while Heimdall-v2 handles validation, checkpoint submission and coordination with Ethereum. Heimdall-v2 is a rewrite of the original Heimdall, built on forks of Cosmos SDK and CometBFT.
Heimdall cannot take Ethereum data on trust. Polygon’s documentation describes a side transaction as a message whose contents the consensus engine cannot verify by itself, so validators vote on whether the data is correct. Those votes travel as vote extensions, and the first transaction in each Heimdall block carries them in encoded form.
Three kinds of Ethereum-linked data pass through that vote: token deposits heading to Polygon, stake changes made in Ethereum staking contracts, and checkpoints heading back to Ethereum. Purley tightens one rule on each route.
Deposits: The Step Between Ethereum and Your Balance
1 · Ethereum
The deposit goes through the bridge’s RootChainManager contract, which locks the tokens and triggers a StateSynced event.
2 · Heimdall · changed by Purley
Validators watch for the event, one submits a state-sync transaction, and the record enters Heimdall state once more than two thirds of validators agree.
3 · Bor
At the start of each sprint, currently 16 blocks, Bor pulls pending records and the StateReceiver system contract delivers them, minting the tokens on Polygon.
Purley’s bridge rule applies at the middle step. Heimdall now confirms bridge events before acting on them, and the vote extensions that carry validators’ verdicts are signed and authenticated in every block that includes them. The two checks close different gaps: a signature ties a vote to a specific validator, while confirmation tests whether the Ethereum event behind that vote meets Heimdall’s rules before anything is credited.
The release does not define “confirmed.” It sets no block count and announces no change to deposit times. Polygon’s bridging documentation describes Ethereum-to-Polygon delivery as happening within a single sprint, roughly a few minutes.
For anyone waiting on a deposit, the Ethereum transaction hash only proves the first step. A balance that has not appeared is still in the second or third step, and the token contract on Polygon is the record that settles it. A wallet or tracker total is a weaker signal, as Coindoo’s guide to portfolio trackers explains.
Staking: Ethereum Changes Recorded in Sequence
Polygon validators stake on Ethereum, then submit Heimdall transactions acknowledging each stake change. Heimdall’s stake module saves the update once a majority of validators agree that it matches the Ethereum event.
After Purley, Heimdall accepts a stake update only if it carries that validator’s next nonce, a counter that tracks the validator’s stake changes and has nothing to do with the nonce a wallet uses. An update can no longer be accepted while an earlier one is missing, so changes are recorded in the order they occurred.
A smaller fix in the same module does not wait for the fork height: stake messages with a nil amount are now rejected during basic validation, with the result code left unchanged.
Checkpoints: The Buffer Behind Withdrawals
Traffic in the other direction relies on checkpoints. Heimdall gathers Bor blocks into Merkle trees and periodically publishes the root to Ethereum. According to Polygon’s checkpoint documentation, an approved checkpoint goes into a buffer, the bridge submits it to Ethereum with validator signatures, and an acknowledgment clears it. If that acknowledgment is overdue, a No-ACK signal moves the process on.
Withdrawals depend on this channel. Under the bridge’s lock-and-mint model, tokens burned on Polygon are released on Ethereum only after a checkpoint covering the burn has reached Ethereum.
Purley keeps an expired checkpoint in the buffer until an approved checkpoint replaces it, rather than letting the slot clear on expiry. The release does not describe what the earlier behaviour risked, and it announces no change to withdrawal times.
What Node Operators and Token Holders Need to Do
Purley is already active on both networks, so every Heimdall node has to run a compatible build. Polygon describes it as a plain binary upgrade with no new configuration keys, no state migration, no resync and no change to Bor.
Upgrade checklist
- Mainnet: v0.14.0-priv or later, or the public v0.14.0
- Amoy: v0.14.0-beta-priv or later, or the public v0.14.0
- Debian package: verify against its
.checksumfile withsha256sum -cbefore installing - Container:
ghcr.io/0xpolygon/heimdall-v2:v0.14.0 - Confirm:
heimdalld versionprints0.14.0
The release also tidies a few operational details. Config templates now leave external_address empty instead of shipping a node’s address, the bridge’s worker queue has its own name, and from the Purley height, cancelled governance proposals with no destination set are no longer charged.
Token holders have nothing to do. The release asks no one to move or migrate funds.
The Explanation Still Missing
The release leaves one question unanswered: why a fork touching vote extensions, bridge events, stake ordering and checkpoints shipped as a private build first. The clearest answer would be a technical write-up like the one Polygon published for v0.4.4. Until one appears, the forum post, the GitHub notes and pull request #699 are the complete official record, and the code is now available for independent review.
Reporter at Coindoo
Kosta has reported on cryptocurrency markets and blockchain infrastructure since 2020, bringing over six years of hands-on experience in the crypto industry built through daily tracking of markets, trends, and emerging blockchain developments. Specializing in Bitcoin on-chain analysis, institutional ETF flows, and digital asset price action, his work at Coindoo has been cited by other news agencies and consistently covers market developments with a focus on data-driven reporting across Bitcoin, Ethereum, Solana, and XRP. Over the years, Kosta has contributed to multiple crypto media outlets in different regions, authoring over 6,000 articles across the sector. His reporting spans cryptocurrency markets and the broader fintech industry, tracking not only price action but also the technological and regulatory forces shaping the ecosystem. To support his analysis, Kosta actively leverages on-chain data and metrics from leading platforms such as Santiment, Glassnode, and CryptoQuant, enabling deeper, evidence-based market insights. He believes in the power of transparency and the data that underpins the blockchain ecosystem. His academic background in Marketing Management from Denmark further complements his analytical approach, adding a strong understanding of communication strategy and content positioning to his work.
Related stories
Advertisement
Up to 11100 usdt bonus for new users.
Low trading fee.
Best Crypto Portfolio Trackers in 2026: Wallets, DeFi & Bridges
That role has become more useful as bridging and onchain lending have become routine.…
What Is Solana (SOL) and How Does Its Blockchain Work?
Solana is a public blockchain built to process transactions at a pace and cost…
Best Web3 Social Media Platforms of 2026
Key takeaways Bluesky leads decentralized social on scale, without using a blockchain. Farcaster changed…
5 Things You Should Know Before Trading Crypto
Crypto trading can look simple until a fast market, thin order book or leveraged…


