All lessons · CCC (TypeScript SDK) · Start here · Glossary
Persist the transaction hash before broadcasting itWorkingFrom one fix
From one fix · Check: right · Checked 2026-11-19
A CKB transaction hash covers the raw transaction but not the witnesses, so after fee completion ccc tx.hash() already gives the final hash before signing. Save that hash to a durable journal before broadcasting, and assert that the hash returned by send equals it. Also assert that signing and preparation did not change the hash, so a rerun after a lost RPC reply waits for the recorded transaction instead of building and sending a duplicate.
Why it matters: If the hash is only recorded from the RPC reply, a crash or lost reply after broadcast leaves no record. A rerun then builds and funds a second transaction, such as another 300 CKB transfer or another order.
Pattern
journal.funding=tx.hash();await save();assert.equal(await submit(frozen(tx),maker),journal.funding);Taken from the commit, shortened.
A test changed in the same commit
It sits next to the fix. We did not run it.
- toastmanAu/openswap:
solver/test/runner.test.ts,tests/src/consensus.rs,tests/src/vectors.rs
- Concepts
- Transaction building and fees, Network and RPC reliability
- Evidence
- From one fix: from one project, checked against its commit
- First seen
- 2026-09-18
- Last changed
- 2026-09-18
- 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-09-18 · toastmanAu/openswap · more from this project
More about CCC (TypeScript SDK)
- CCC client cache can keep dropped transactions; check status without cache
- Clamp the node's get_fee_rate_statistics median before using it as a fee rate
- Classifying sendTransaction failures before dropping a pending CKB transaction
Do you maintain a project this lesson came from? Confirm or correct it
Cite this lesson
LusoCryptoLabs, "Persist the transaction hash before broadcasting it", CKB lessons, https://pulse.lusocryptolabs.com/learned/ccc/persist-the-transaction-hash-before-broadcasting-it, CC BY 4.0, last changed 2026-09-18.