CKB Pulse

All lessons · Other · Start here · Glossary

Recompute occupied capacity when a state cell grows in a transitionWorkingFrom one fix

From one fix · Check: right · Checked 2026-11-19

When a transaction replaces a cell with one holding larger data (here 101 to 207 bytes under the same type script), compute the new occupied floor as 8 + data length + lock (32 code hash + 1 hash type + args) + type (32 + 1 + args) bytes in CKB, and top up from another input if the old capacity falls short (312 CKB input vs a 318 CKB floor here). If the type script also requires output capacity >= input capacity, use the larger of the two bounds rather than shrinking to the floor.

Why it matters: Reusing the old cell's 312 CKB for a 207-byte replacement leaves the output below its 318 CKB occupied floor, so the node rejects the transaction. Shrinking a well-funded cell down to that floor would instead fail the type script's out_cap >= in_cap check.

adds top up and max(floor, input capacity) rule beyond the occupied capacity formula lesson

Pattern

Prefer
const ledgerCapacity = floor > inCap ? floor : inCap;

Taken from the commit, shortened.

A test changed in the same commit

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

Concepts
Capacity and cell size, Transaction building and fees
Evidence
From one fix: from one project, checked against its commit
First seen
2026-09-25
Last changed
2026-09-25
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)

More about Other

All 9 in this topic

Do you maintain a project this lesson came from? Confirm or correct it

Cite this lesson
LusoCryptoLabs, "Recompute occupied capacity when a state cell grows in a transition", CKB lessons, https://pulse.lusocryptolabs.com/learned/other/recompute-occupied-capacity-when-a-state-cell-grows-in-a-tra, CC BY 4.0, last changed 2026-09-25.

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.