v0 state

gasWantedCompact

gasWantedCompact is the gas ceiling a compacting transaction is assumed to ask for, used only to price the advertised bounty. A caller compacting an unusually large number of nodes should re-price with storagecost.EvaluateAtFloor directly rather than trust this.

maxText

maxText caps an entry so one caller cannot lock an unbounded deposit in a single call. Small on purpose: this realm is about the NODES, and a fat payload would only hide the thing it exists to show.

Entry

Entry is one element. Author is kept so a drop can be refused to anyone else: soft-deleting a stranger's entry would be vandalism, and the holes this realm studies should come from ordinary use.

entries

Add

Add appends an entry and locks its storage deposit against the caller.

Drop

Drop soft-deletes your own entry, which is what creates a hole. It frees nothing on its own, and that is the point of the realm: the bytes stay locked until somebody compacts. Only the author may drop, so the fragmentation on this page is the honest kind that ordinary use produces.

Compact

Compact frees the dead tree nodes and returns how many it freed. Permissionless by design, and the refund goes to whoever signs this transaction rather than to the realm or to the authors: the chain pays the signer directly, so there is nothing here to distribute and nothing to steal. The worst a caller can do is waste their own gas compacting a board that had no holes.

Fragmentation

Fragmentation reports live elements against allocated indices. The gap between them is what a compaction has to work with. It is a free read so a bot can poll it and decide for itself, which is the whole design: the realm publishes, the caller times.

Reclaimable

Reclaimable is how many dead nodes a Compact would free right now. It is NOT the same as allocated minus live. A dead element only becomes a reclaimable node once every element under it is also dead, so a board with many scattered holes can report a large gap and nothing to reclaim. That difference is exactly what makes the timing a decision instead of a rule.

Quote

Quote prices what a Compact would return, at the default storage price and the floor gas price. Unlike a payload-derived bounty this is a counted quantity: Reclaimable is exact, and storagecost.EstimateNodes multiplies it by a measured per-node constant. Treat it as an advertisement all the same. The authoritative numbers are the chain's, in the StorageUnlockEvent the transaction emits.

entryAt

entryAt reads index i, reporting whether a live entry is there.

Render

ratioSuffix

ratioSuffix adds the fragmentation percentage, and says nothing at all when the board is empty rather than dividing by zero.

verdict