All lessons · CKB node, RPC and indexer · Start here · Glossary
Computing cell confirmations from get_transaction block_hash and tip headerWorkingFrom one fix
From one fix · Check: partly right · Checked 2026-11-19
To get a cell's confirmation count over raw CKB JSON-RPC, read tx_status.block_hash from get_transaction, look up its number with get_header, then compute tip − included + 1 using get_tip_header; treat a missing block_hash as 0 confirmations. This commit's helper also retries get_transaction without the "0x2" verbosity param if the node rejects it, and treats get_live_cell as live only when status === "live".
Why it matters: Without a confirmation count, a verifier that enforces a minimum confirmation threshold (here MIN_CAPABILITY_CONFIRMATIONS) can neither apply it nor report finality metadata for a just-included or pending capability cell.
Pattern
confirmations: tip >= included ? Number(tip - included + 1n) : 0,Taken from the commit, shortened.
A test changed in the same commit
It sits next to the fix. We did not run it.
- tydeptrai21042004/ckb-skill:
contracts/capability-type/tests/contract.rs,tests/funding-phase1-hardening.test.mjs,tests/week9-portable-rights.test.mjs
- Concepts
- Network and RPC reliability, Indexer queries and cell collection
- Evidence
- From one fix: from one project, checked against its commit
- First seen
- 2026-09-22
- Last changed
- 2026-09-22
- Last checked
- 2026-11-19
- Check against the commit
- partly right: a true core, with a part that is loose or too wide
Sources (1)
- 2026-09-22 · tydeptrai21042004/ckb-skill · 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, "Computing cell confirmations from get_transaction block_hash and tip header", CKB lessons, https://pulse.lusocryptolabs.com/learned/node/computing-cell-confirmations-from-get-transaction-block-hash, CC BY 4.0, last changed 2026-09-22.