Skip to content

docs(ccip-latency): add live per-chain finality observations reference#3976

Open
Flotapponnier wants to merge 1 commit into
smartcontractkit:mainfrom
Flotapponnier:add-ocb-live-finality
Open

docs(ccip-latency): add live per-chain finality observations reference#3976
Flotapponnier wants to merge 1 commit into
smartcontractkit:mainfrom
Flotapponnier:add-ocb-live-finality

Conversation

@Flotapponnier

Copy link
Copy Markdown

Summary

Add a small subsection at the end of src/content/ccip/ccip-execution-latency.mdx (right before the closing paragraph) that points readers to a live third-party benchmark of L1 finality time. The existing Finality by blockchain table gives useful estimated averages and the accompanying Aside explicitly notes that "these times can vary significantly due to network conditions and other factors". This addition gives integrators a complementary live-data source to sanity-check their assumed finality window against current chain state.

Why

ccip-execution-latency.mdx is centred on the impact of source-chain finality on CCIP end-to-end latency. The table lists ~45 supported chains with estimated finality times ranging from < 1 second (Avalanche, Solana) to 12 hours (Corn). Devs building on CCIP often need to know whether those numbers still hold in current network conditions, especially:

  • On chains where an upgrade or congestion event has changed finality behaviour recently
  • On rollup chains where L1 finality drift affects total settlement time
  • When choosing block-depth vs finality-tag security parameters

OpenChainBench measures wall-clock seconds between latest and finalized blocks for 11 L1s (Ethereum, Solana, BNB, Avalanche, SUI, Stellar, TON, Bitcoin, Litecoin, TRON, Monero), refreshed every 10 seconds. Not a replacement for the CCIP-specific finality methods documented above; a live sanity-check complement.

About OpenChainBench

Test plan

  • Single-file addition, one ### subsection appended before the existing closing paragraph
  • No structural change, no table modification, no existing content touched
  • Preserves the existing Finality by blockchain table and the Aside note above
  • Reference URLs verified live

Happy to reword, move to an <Aside>, or drop entirely if this does not fit the docs' tone.

Append a subsection right before the closing paragraph on
src/content/ccip/ccip-execution-latency.mdx pointing readers to a live
third-party benchmark of L1 finality time. The existing Aside on that
page explicitly warns that estimated finality times can vary
significantly with network conditions; this addition gives integrators a
complementary live-data source to sanity-check their assumed finality
window.

Covers 11 L1 chains (Ethereum, Solana, BNB, Avalanche, SUI, Stellar, TON,
Bitcoin, Litecoin, TRON, Monero) via wall-clock latest-vs-finalized block
delta, refreshed every 10s under an open methodology.

Source: https://github.com/ChainBench/OpenChainBench (MIT)
Data license: CC-BY-4.0
@Flotapponnier
Flotapponnier requested review from a team as code owners July 17, 2026 13:53
@vercel

vercel Bot commented Jul 17, 2026

Copy link
Copy Markdown

Someone is attempting to deploy a commit to the Chainlink Labs Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant