CKB Pulse

All lessons · CKB node, RPC and indexer · Start here · Glossary

Verify a self indexed tip against the node's canonical block hash before serving itWorkingFrom one fix

From one fix · Check: right · Checked 2026-11-19

A locally maintained index of CKB blocks can lag the node or still hold an orphaned block after a reorg, so before serving its tip as an anchor, fetch the node's tip number, wait briefly for the index to reach it, then ask the node for the canonical block hash at the indexed height and refuse (503 with NOT_SYNCED or REORGANIZING) unless it equals the indexed hash. The check narrows the window but is not atomic, so a client that signs over the anchor should also compare it with an independent source.

Why it matters: Without the check, a server whose index lags the node or still holds an orphaned block after a reorg hands clients an anchor that is not the node's current canonical tip. Signatures made over that anchor are then rejected as ANCHOR_INVALID or refer to a block that left the chain.

A test changed in the same commit

It sits next to the fix. We did not run it.

Concepts
Network and RPC reliability, Indexer queries and cell collection
Evidence
From one fix: from one project, checked against its commit
First seen
2026-10-08
Last changed
2026-10-08
Last checked
2026-11-19
Check against the commit
right: the lesson follows from its commit and still holds in the code today

Sources (1)

More about CKB node, RPC and indexer

All 45 in this topic

Do you maintain a project this lesson came from? Confirm or correct it

Cite this lesson
LusoCryptoLabs, "Verify a self indexed tip against the node's canonical block hash before serving it", CKB lessons, https://pulse.lusocryptolabs.com/learned/node/verify-a-self-indexed-tip-against-the-node-s-canonical-block, CC BY 4.0, last changed 2026-10-08.

Drawn from public commits and checked against the commit each one came from and the project's code today. Read the source before you rely on one. Text under CC BY 4.0: credit LusoCryptoLabs, CKB lessons, with a link to the lesson. Want a lesson changed or removed? Open an issue.