CKB Pulse

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 helpers

A test changed in the same commit

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

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)

More about Apps and UI

All 9 in this topic

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.

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.