From c5e77ad7c80f7d97da93ed78bafae734f4314c99 Mon Sep 17 00:00:00 2001 From: Arash <33149995+arash009@users.noreply.github.com> Date: Fri, 1 Aug 2025 00:38:23 +1000 Subject: [PATCH 1/2] Update milestones.md Adding information on finality time and how to get latest finalized block --- docs/pos/tutorials/milestones.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/pos/tutorials/milestones.md b/docs/pos/tutorials/milestones.md index 71a1eb9..80346fe 100644 --- a/docs/pos/tutorials/milestones.md +++ b/docs/pos/tutorials/milestones.md @@ -1,5 +1,24 @@ # Understanding and Implementing Milestones with Bor and Heimdall in Polygon PoS +!!! 5second finality in Polygon + +NOTE: With the upgrade to Heimdall v2, deterministic finality on PoS is now achieved in between 3-5seconds thanks to the subsecond block times in Heimdall, meaning miletones are voted on and finalized much faster! + +## How to get Finalized Block + +Simply use the standard eth_getBlockByNumber JSON-RPC method with the "finalized" block parameter to retrieve information about the most recently finalized block in Polygon PoS. Finalized blocks are considered highly secure and irreversible, making them crucial for applications requiring strong transaction certainty. + +To get the finalized block, you can use the following JSON-RPC call: + +Code + +{ + "method": "eth_getBlockByNumber", + "params": ["finalized", true], + "id": 1, + "jsonrpc": "2.0" +} + ## Introduction to Bor and Heimdall in Polygon PoS ### What is Bor? From e46fe3aa8882d2510e739c66f351c99c80083ea2 Mon Sep 17 00:00:00 2001 From: cooganb Date: Fri, 1 Aug 2025 15:14:28 +0000 Subject: [PATCH 2/2] Update milestones info --- docs/pos/tutorials/milestones.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/pos/tutorials/milestones.md b/docs/pos/tutorials/milestones.md index 80346fe..4a2419c 100644 --- a/docs/pos/tutorials/milestones.md +++ b/docs/pos/tutorials/milestones.md @@ -1,8 +1,14 @@ + + # Understanding and Implementing Milestones with Bor and Heimdall in Polygon PoS -!!! 5second finality in Polygon +!!! info "5 Second Finality in Polygon" -NOTE: With the upgrade to Heimdall v2, deterministic finality on PoS is now achieved in between 3-5seconds thanks to the subsecond block times in Heimdall, meaning miletones are voted on and finalized much faster! + NOTE: With the upgrade to Heimdall v2, deterministic finality on PoS is now achieved in between 3-5 seconds thanks to the subsecond block times in Heimdall, meaning miletones are voted on and finalized much faster. ## How to get Finalized Block