Error reference

Every error @subsquid/pipes raises carries a stable code, and its message ends with a link back to the page for that code. Match on the code, or on the instanceof class, rather than on the message text. Messages get reworded; codes are stable.

​

Pipe configuration

• E0001 Pipe requires a unique id
• E0002 Invalid block range
• E0003 Unusable instruction discriminator set

​

Fork handling

• E1001 Target does not support fork handling
• E1002 Fork with no canonical blocks
• E1003 resolveFork() returned no cursor
• E1004 Portal contract violation
• E1005 Fork reported on the finalized stream

​

ClickHouse target

• E2001 Invalid maxRows
• E2002 Unparseable table name
• E2003 Cannot roll back a Distributed table
• E2004 Rollback engine collapses on the wrong column
• E2005 Rollback table has no sign column
• E2006 Invalid rollback index column
• E2007 Chain fork with no rollback handler

​

Postgres (Drizzle) target

• E2101 Drizzle client missing
• E2102 Invalid retention
• E2103 Advisory lock not acquired
• E2104 Untracked table
• E2105 Missing primary key
• E2106 Circular foreign keys
• E2107 Column name unresolved

​

BigQuery target

• E2201 Cannot determine GCP project id
• E2202 Partition column missing from schema
• E2203 Partition column has the wrong type
• E2204 Partition column is nullable
• E2205 Table is not range-partitioned
• E2206 Unsupported field shape for auto-create
• E2207 Declared column missing from live table
• E2208 Column type or mode mismatch
• E2209 Write to an unregistered table
• E2210 Internal schema-map mismatch
• E2211 Corrupt in-flight sync row
• E2212 Orphaned tracked data
• E2213 BigQuery rejected rows in AppendRows

​

Parquet target

• E2301 No tables declared
• E2302 Duplicate table name
• E2303 Empty schema
• E2304 Block-number column missing
• E2305 Block-number column has the wrong type
• E2306 Unsupported compression codec
• E2307 Unsupported column type
• E2308 Write to an unregistered table
• E2309 File collision
• E2310 Corrupt state file
• E2311 Block-number column is optional
• E2312 Invalid block-number value
• E2313 Row value does not match column type
• E2314 Crash recovery could not delete an over-cursor file
• E2315 Invalid nested schema
• E2316 Invalid segment coverage range
• E2317 State file disagrees with the data files
• E2320 Engine output is not a Parquet file

​

Google PubSub target

• E2401 Topic does not exist
• E2402 Reserved attribute name
• E2403 Attribute budget exceeded
• E2404 Message too large
• E2405 Canonical codec cannot encode this value
• E2406 Canonical codec met a cycle
• E2407 Dataset reports no finalized head
• E2408 Fork reported under assumeNoForks
• E2409 Block has no hash
• E2410 State file is locked
• E2411 State schema version mismatch
• E2412 Ordering key while message ordering is disabled
• E2413 Materialized id moved
• E2414 Delete-free window route without an empty value
• E2415 Draft without a usable block
• E2416 publishFrom: 'latest' cannot be resolved
• E2417 State file unavailable
• E2418 Two drafts with the same id in one batch
• E2419 State file belongs to another producer
• E2421 State wire configuration changed
• E2422 Invalid BigQuery CDC row
• E2423 Route missing during recovery
• E2424 Change sequence exhausted
• E2425 No routes configured
• E2426 Signal draft without a usable block
• E2427 Finalized-only signal from an unfinalized block