E2009 — Volume operation rejected (E_STORAGE_AUTO_TOP_UP_INVALID)

Property	Value
Code	`2009`
Slug	`E2009`
Category	`storage` (Storage)
CIP	CIP-9

What happened

Volume operation rejected (E_STORAGE_AUTO_TOP_UP_INVALID): {detail}. This is the receipt’s what text, produced by the node’s ExecutionError::RasVolume. Placeholders in braces are filled from the failing transaction.

Why it happened

The node rejected the operation with E2009 (category storage, Storage). 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-9.

How to fix

A custom auto top-up needs a non-zero cap and target_epochs of at least 1. Use the Off setting to stop wallet draws.

Receipt example

{
  "code": 2009,
  "slug": "E2009",
  "category": "storage",
  "what": "volume operation rejected (E_STORAGE_AUTO_TOP_UP_INVALID): {detail}",
  "fix": "A custom auto top-up needs a non-zero cap and target_epochs of at least 1. Use the Off setting to stop wallet draws.",
  "docs_url": "https://docs.cowboy.inc/errors/E2009"
}

All Error Codes

View the complete error code reference