Skip to main content

Error Code Reference

Every failed transaction receipt carries a structured error with a stable numeric code, a machine-readable slug, and human-authored remediation hints.

Error Format

When a transaction fails, the receipt includes a structured error object:

Code Ranges

The registry contains 177 codes across 12 categories:

All Error Codes

E1000–E1099: Transaction pre-checks

Signature, nonce, basefee, and balance checks that run before the actor handler executes, plus CIP-15 route-manifest acceptance checks numbered in this block.

E1100–E1199: PVM static validation

Compile-time determinism checks enforced at actor deploy.

E1200–E1299: Runtime / host API

Errors during actor execution — host calls, state access, and messaging.

E1300–E1399: Entitlements / manifest

Entitlement declaration and grant errors.

E1400–E1499: CIP-20 tokens

Fungible token operations — create, transfer, approve, permit, hooks.

E1500–E1599: Timers / deferred / commit-reveal

Scheduled execution and commit-reveal protocol errors.

E1600–E1699: Runner / consensus / job

Off-chain compute runner registration, job dispatch, and verification.

E1700–E1799: CBSS

Cowboy Blind Secret Store — secret access, release receipts, time-lock release (CIP-24), library errors (CIP-26), and sealed-bid auctions (CIP-34).

E1800–E1899: Watchtower stream access

Stream key manager and watchtower host-call errors (CIP-7), plus the synchronous token/pause host errors that share the host-code arithmetic.

E1900–E1999: Internal / fallback

Unclassified errors — report with tx hash.

E2000–E2099: CIP-9 RAS / storage volumes

Named storage volume create/lookup and manifest-commit rejections (CIP-9).

Reading Errors

From the CLI / RPC

From a Python Actor

Raising Structured Errors

Use SDK exception classes for automatic structured error population: