Skip to main content
Version: 0.5

CellOverflow

A detector that identifies cell overflow problems.

Why is it bad?​

Cell overflow is an issue specific to the TON blockchain. TON stores data in cells, which are low-level data structures used for serialization and deserialization.

The overflow issue occurs when the user attempts to store more data in a cell than it supports. The current limitation is 1023 bits and 4 references to other cells. When these limits are exceeded, the contract throws an error with the exit code 8 during the compute phase.

Example​

// Bad: storeRef is used more than 4 times
beginCell()
  .storeRef(...)
  .storeAddress(myAddress())
  .storeRef(...)
  .storeRef(...)
  .storeRef(...)
  .storeRef(...)
  .endCell()

Use instead:

// OK: Fixed after the analyzer highlighted it
beginCell()
  .storeRef(...)
  .storeAddress(myAddress())
  .storeRef(...)
  .storeRef(...)
  .storeRef(...)
  .endCell()

Resources​

  1. Cell & Bag of Cells (BoC) | TON Docs
  2. TVM Exit codes | TON Docs
  3. Cells, Builders and Slices | Tact Docs