E1412 — Transfer hook exceeded cell cap

Property	Value
Code	`1412`
Slug	`E1412`
Category	`gas` (Gas)
CIP	CIP-20 §Hook Constraints

What happened

Transfer hook exceeded cell cap: used {used} cells, cap {cap}. This is the receipt’s what text, produced by the node’s ExecutionError::TokenHookCellsExceeded. Placeholders in braces are filled from the failing transaction.

Why it happened

The node rejected the operation with E1412 (category gas, Gas). The receipt’s why field carries the specific cause and context carries structured details, such as the values that filled the placeholders above. The normative rule is in CIP-20 §Hook Constraints.

How to fix

Transfer hook exceeded the 50_000-cell cap. Reduce state writes in the hook.

Receipt example

{
  "code": 1412,
  "slug": "E1412",
  "category": "gas",
  "what": "transfer hook exceeded cell cap: used {used} cells, cap {cap}",
  "fix": "Transfer hook exceeded the 50_000-cell cap. Reduce state writes in the hook.",
  "docs_url": "https://docs.cowboy.inc/errors/E1412"
}

All Error Codes

View the complete error code reference