All lessons · CKB node, RPC and indexer · Start here · Glossary
Molecule table encoding of absent optional fieldsWorkingFrom one fix
From one fix · Check: right · Checked 2026-11-19
A molecule table or dynvec (Script, CellOutput, WitnessArgs) is serialized as a u32 total size, then one u32 offset per field, then the fields. There is no separate count; readers derive it from the first offset. An absent Opt field takes zero bytes, so its offset equals the next offset, or the total size if it is last. A hand-rolled encoder that inserts a u32 count after the total size, as this commit's dyn_collection does, produces malformed molecule.
Why it matters: An encoder that writes an extra count word shifts every offset, so the node cannot decode the transactions, witnesses or scripts it builds and rejects them.
- Concepts
- Data encoding (molecule, hex, bigints), Witnesses and signatures
- Evidence
- From one fix: from one project, checked against its commit
- First seen
- 2026-10-09
- Last changed
- 2026-10-09
- 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-10-09 · Tactus-Labs/tactus-o1 · more from this project
More about CKB node, RPC and indexer
- Script group hash is the hash of the whole Script, not the code_hash
- Decoding the packed epoch field (number, index, length)
- Nervos DAO compensation from the header's accumulated rate (AR)
Do you maintain a project this lesson came from? Confirm or correct it
Cite this lesson
LusoCryptoLabs, "Molecule table encoding of absent optional fields", CKB lessons, https://pulse.lusocryptolabs.com/learned/node/molecule-table-encoding-of-absent-optional-fields, CC BY 4.0, last changed 2026-10-09.