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.
- poshboytl/omavote:
web/test/tipcheck.test.ts
- 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)
- 2026-10-08 · poshboytl/omavote · more from this project
More about CKB node, RPC and indexer
- get_live_cell may return "unknown" rather than "dead" for a spent output
- Wait for get_indexer_tip to reach the commit block before re-reading cells
- Check indexer lag with get_indexer_tip before signing
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.