docs(errors): document IE072–IE090 and fill in/correct IE001–IE071 - #1251
Merged
Conversation
Append entries for IE072 through IE090 to docs/errors.md, matching the existing Summary/Description/Solution format. Details sourced from the indexer codebase (packages/indexer-common). IE088 (present POI) is defined in the IndexerErrorCode enum but is not raised on its own; the entry documents that present-POI failures surface as IE062, IE065, or IE089. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K8moxDbc6s6j152GWUCCgC
Replace TODO solutions with guidance grounded in the indexer codebase, add the missing IE037-IE040 summaries (from IndexerErrorCode messages), fix typos (nuber, self-referential grep code), restructure IE035, and mark codes that are defined but no longer thrown by the current codebase (legacy Scalar-Receipt, Vector transfer, state-channel and query-fee voucher flows superseded by TAP) so operators aren't sent chasing them. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K8moxDbc6s6j152GWUCCgC
tmigone
approved these changes
Aug 6, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/errors.mdhad drifted out of date: it stopped at IE071, and manyexisting entries were stubbed with
TODOfor their solution (and a few fortheir summary). This PR brings the reference in line with the current
IndexerErrorCodeenum and fills in the gaps.All new content is grounded in the codebase — summaries come from
INDEXER_ERROR_MESSAGESinpackages/indexer-common/src/errors.ts, and eachdescription/solution is derived from where the code is actually thrown
(
packages/indexer-common/**,packages/indexer-agent/**,packages/indexer-cli/**). Nothing was invented; where a code carries noactionable guidance in the source, that is stated plainly rather than guessed.
Only
docs/errors.mdis changed.What changed
Summary / Description / Solution format — covering the Graph Horizon
provision, allocation, present-POI, collect-rewards and over-allocation
paths, plus batch-tx, subgraph-features and network-contract errors.
TODOsolutions for the many existing codes that had none,based on their throw sites (connectivity/DB/RPC guidance, gas/nonce handling,
POI resolution, etc.).
TODO):failed to query disputable allocations, query epochs, store POI disputes,
and fetch POI disputes.
thrown by the current codebase — the pre-TAP Scalar-Receipt, Vector-transfer,
state-channel and query-fee-voucher flows (IE003, IE016, IE022, IE023,
IE029–IE031, IE033, IE044–IE049, IE052–IE054, IE056) — so operators aren't
sent chasing errors the software can't emit.
nuber→number,and the IE009 solution that told readers to grep for
IE010).Notes for reviewers
Failed to present POI) is defined in the enum but is not thrownanywhere in the current code — the
presentPOIresolver surfaces theunderlying error, and a transaction that never mines is reported as
IE089.It's documented as reserved and routed to
IE062/IE065/IE089ratherthan given a fabricated cause.
Failed to reallocate: indexer is overallocated) and is now documented as well.the current tree, and their summaries name payment mechanisms that TAP
replaced. Happy to soften the wording to just "no longer emitted by current
versions" if maintainers prefer to avoid the TAP attribution.
Verification
TODOplaceholders.