CKB Pulse

Todas as lições · Apps and UI · Começa aqui · Glossário

Pinning JS codecs and derivations to Rust test vectorsPráticoDe uma correção

De uma correção · Verificação: em parte certa · Verificada em 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.

Porque importa: 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.

Padrão

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

Um teste mudou no mesmo commit

Está ao lado da correcção. Nós não o corremos.

Conceitos
Data encoding (molecule, hex, bigints), Testing and devnet, Transaction building and fees
Evidência
De uma correção: de um projeto, verificada contra o commit
Vista pela primeira vez
2026-11-13
Última mudança
2026-11-13
Última verificação
2026-11-19
Verificação contra o commit
em parte certa: um núcleo verdadeiro, com uma parte solta ou demasiado larga

Fontes (2)

Mais sobre Apps and UI

Ver as 9 deste tema

Manténs um projeto de onde esta lição veio? Confirma ou corrige

Citar esta lição
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.

Tiradas de commits públicos e verificadas contra o commit de onde cada uma veio e o código de hoje do projeto. Lê a fonte antes de confiar numa. Texto sob CC BY 4.0: dá crédito à LusoCryptoLabs, CKB lessons, com uma ligação para a lição. Queres que uma lição seja mudada ou retirada? Abre um issue.