All lessons · Apps and UI · Start here · Glossary
Pinning JS codecs and derivations to Rust test vectorsWorkingFrom one fix
From one fix · Check: partly right · Checked 2026-11-19
When off-chain JS encodes or derives cell data that a Rust type script decodes or re-derives byte for byte, test the JS against JSON vectors generated by the Rust code, using a distinct value in every field so a wrong offset fails. Mirror the contract's validation refusals and its exact ordering and rounding: BTreeMap ascending key order, BigInt floor division with the dust going to fixed indices, and merging duplicates before dividing. The chain only returns a bare error code, so only this off-chain check can tell you which rule failed.
Why it matters: If the JS sorts, rounds or assigns dust differently from the script, it builds settlement data the script refuses with a bare error code that names no rule.
Pattern
Off-chain JS builds cell data that the script re-derives (sort by lock hash, BigInt floor shares, residual +1 to the lowest keys), with tests asserting the encoded bytes equal Rust vectors.JS codec tested only against itself → load tests/vectors/*.json written by Rust, decode and re-encode it byte for byte, and mirror the contract's decode refusals and immutable-field checks in the encoder and state-advance helpersA test changed in the same commit
It sits next to the fix. We did not run it.
- toastmanAu/daowow:
apps/web/test/entitlements.test.js,crates/daowow-core/tests/gen_vectors.rs - toastmanAu/daowow:
apps/web/test/settlement-codec.test.js
- Concepts
- Data encoding (molecule, hex, bigints), Testing and devnet, Transaction building and fees
- Evidence
- From one fix: from one project, checked against its commit
- First seen
- 2026-11-13
- Last changed
- 2026-11-13
- Last checked
- 2026-11-19
- Check against the commit
- partly right: a true core, with a part that is loose or too wide
Sources (2)
- 2026-11-13 · toastmanAu/daowow · more from this project
- 2026-11-13 · toastmanAu/daowow · more from this project
More about Apps and UI
- Pre-sign checkers must mirror every on-chain comparison
- Exact CKB-to-shannon conversion with BigInt
- Saving local state after the first step of a multi-step flow
Do you maintain a project this lesson came from? Confirm or correct it
Cite this lesson
LusoCryptoLabs, "Pinning JS codecs and derivations to Rust test vectors", CKB lessons, https://pulse.lusocryptolabs.com/learned/apps/pinning-js-codecs-and-derivations-to-rust-test-vectors, CC BY 4.0, last changed 2026-11-13.