Version: v1

This section provides an exhaustive list of potential errors you could face while using Envio, along with explanations for each error.

Below table indicates the different error categories and sub-categories:

Hundreds Digit of Error Code	Sub-category	Category
1**	Configuration File	Initialization related errors
2**	Schema File	Initialization related errors
3**	ABI File	Initialization related errors
4**	Initialization Arguments	Initialization related errors
5**	Event Handling	Event Related Errors
6**	Event Syncing	Event Related Errors
7**	Database Functions	Database Related Errors
8**	Database Migrations and Tracking	Database Related Errors
9**	Contract Interface Manager	Contract Related Errors
10**	Chain Manager	Network Related Errors
11**	Lazy Loader	General Errors

_{"Sub-category" indicates the specific file or function in which the error is being encountered.}
_{"Category" indicates the broader part of indexing process in which the error is being encountered.}

Initialization related errors

`EE100`: Invalid Addresses

Invalid smart contract addresses present in the configuration file.

Use smart contract addresses in the valid format belonging to the correct chain.

`EE101`: Unique Contract Names

The configuration file contains non-unique contract names.

Use unique contract names in the configuration file.

`EE102`: Reserved Words in the Configuration file

Using reserved programming words in the configuration file.

Envio prohibits use of reserved words from JavaScript, TypeScript and ReScript in the configuration file as it may conflict with the auto-generated code.

Please refer to reserved words page for the full list of reserved words.

Avoid using reserved words in the configuration file.

`EE103`: Parse Event Error

Unable to parse event signature due to an error.

Refer to the configuration page on how to correctly define a human readable ABI.

`EE104`: Resolve Config Path

Failed to resolve the config path.

Ensure that the configuration file exists in the correct directory.

`EE105`: Deserialize Config

Failed to deserialize the config file.

Refer to the configuration page for more information.

`EE106`: Undefined Network Config

There is no hypersync_config or rpc_config defined for the network ID defined in the configuration file.

Refer to the HyperSync or RPC Sync page for more information.

`EE108`: Valid Postgres Database

Provide a valid postgres database name.

Requirements for a valid name:

It must start with a letter or underscore.
It can contain letters, numbers, and underscores (no spaces).
It must have a maximum length of 63 characters.

`EE109`: Incorrect RPC URL

The config file contains RPC URLs in an incorrect format.

The RPC URLs need to start with either http:// or https://.

`EE110`: End block is greater than start block for a given network

If an endblock is specified, the endBlock must be greater than the startBlock in your config.yaml file.

`EE111`: Invalid characters for the contract/event names in the config file

The names are used for the auto-generated code and must be valid identifiers, containing only alphanumeric characters and underscores.

`EE200`: Read Schema Error

Failed to read schema file.

Ensure that the schema file is placed in the correct directory.

`EE201`: Parse Schema Error

Failed to parse the schema.

Ensure that there are no syntax errors in schema.graphql file in the directory.

Refer to the schema page for more information.

`EE202`: Multiple `@derivedFrom`

Cannot use more than one @derivedFrom directive on an entity.

Refer to the schema page for more information.

`EE203`: Missing Field Argument for `@derivedFrom`

No field argument supplied to @derivedFrom.

Provide a field value for the @derivedFrom directive used.

Refer to the schema page for more information.

`EE204`: Invalid `@derivedFrom` Argument

field argument in @derivedFrom needs to contain a string.

Refer to the schema page for more information.

`EE207`: Undefined Type

11 Failed to parse undefined type in the schema.

Use one of the following types in the schema:

ID
String
Int
Float
Boolean
Bytes
BigInt

`EE208`: Unsupported Nullable Scalars

Nullable scalars inside lists are unsupported.

Include a ! after your scalar.

`EE209`: Unsupported Multidimensional Lists

Nullable multi-dimensional list types are unsupported.

Include a ! for your inner list type eg. [[Int!]!]

`EE210`: Reserved Words in the Schema file

Using reserved programming words in the schema file.

Envio prohibits use of reserved words from JavaScript and ReScript in the schema file as it may conflict with the auto-generated code.

Please refer to reserved words page for the full list of reserved words.

Avoid using reserved words in the schema file.

`EE211`: Unsupported Arrays of Entities

Please use one of the methods for referencing entities outlined in the documentation.

`EE212`: Schema contains the following reserved enum names

Envio makes use of internal enums that cannot be duplicated in the schema file, please see the envio internal reserved words list for the internal reserved types.

`EE213`: Schema enum has duplicate values

Please ensure all values within each schema enum type are unique.

`EE214`: Schema contains the following enums and entities with the same name

All enum and entity definitions must have unique names within the schema. Please update the schema with unique identifier for all types and enums.

`EE300`: Event ABI Error

Cannot parse the provided ABI for contract.

Use an event that belongs in your ABI for the configuration file.

`EE301`: Missing ABI File Path

Add abi_file_path for contract to parse the event.

`EE302`: Invalid ABI File Path

Provide a valid abi_file_path for named events.

`EE303`: Missing Event In ABI

Unable to find an event named in your ABI.

Use an event that belongs in your ABI for the configuration file.

`EE304`: Mismatched Event Signature

Event signature does not exist in provided ABI file.

Ensure that the same event signature from the ABI is used in the configuration file.

`EE305`: ABI Config Mismatch

Event signature in ABI does not match the config.

Ensure that the same event signature from the ABI is used in the configuration file.

`EE400`: Invalid Directory Name

Specified directory is invalid.

Use a different directory without special characters such as / \ : * ? " < > |.

`EE401`: Existing Directory

Specified directory already exists.

Use a different directory for initialization.

`EE402`: Invalid Subgraph ID

Invalid ID provided for subgraph migration.

Provide a subgraph ID that starts with Qm.

Event Related Errors

`EE500`: Event Handler File Not Found

Issue importing the Event Handler file.

Ensure that the file is in the correct directory as per the configuration file.

The Event Handler file should be compiling as well.

Refer to the event handlers page for more information.

`EE600`: Top Level Error

Hit a top-level error catcher while processing events.

Database Related Errors

For all of the database related errors, rerun DB migrations using the following command:

envio local db-migrate setup

`EE700`: Parse DB Row

Unable to parse row from the database.

`EE800`: Raw Table Creation

Error in creating raw events table.

`EE801`: Dynamic Contracts Table Creation

Error in creating dynamic contracts table.

`EE802`: Entity Tables Creation

Error in creating entity tables.

`EE803`: Tracking Tables Error

Error in tracking tables.

`EE804`: Drop Entity Tables

Error dropping entity tables.

`EE805`: Drop Tables Except Raw

Error dropping tables except for raw events.

`EE806`: Clear Metadata

Error clearing metadata.

Indexing may still work - but you may have issues querying the data in Hasura.

`EE807`: Tracking a Table

Error in tracking a table.

Indexing may still work - but you may have issues querying the data in Hasura.

`EE808`: View Permissions

Error setting up view permissions.

Indexing may still work - but you may have issues querying the data in Hasura.

Contract Related Errors

`EE900`: Undefined Contract

Undefined contract specified.

Verify that contract name is defined in the configuration file.

`EE901`: Interface Mapping Error

Unexpected case - contract name not found in interface mapping.

Network Related Errors

`EE1000`: Undefined Chain

Undefined chain ID used for chain manager.

Use a valid chain ID in the configuration file.

General Errors

`EE1100`: Promise Timeout

Top-level promise timeout reached.

Initialization related errors

EE100: Invalid Addresses​

EE101: Unique Contract Names​

EE102: Reserved Words in the Configuration file​

EE103: Parse Event Error​

EE104: Resolve Config Path​

EE105: Deserialize Config​

EE106: Undefined Network Config​

EE108: Valid Postgres Database​

EE109: Incorrect RPC URL​

EE110: End block is greater than start block for a given network​

EE111: Invalid characters for the contract/event names in the config file​

EE200: Read Schema Error​

EE201: Parse Schema Error​

EE202: Multiple @derivedFrom​

EE203: Missing Field Argument for @derivedFrom​

EE204: Invalid @derivedFrom Argument​

EE207: Undefined Type​

EE208: Unsupported Nullable Scalars​

EE209: Unsupported Multidimensional Lists​

EE210: Reserved Words in the Schema file​

EE211: Unsupported Arrays of Entities​

EE212: Schema contains the following reserved enum names​

EE213: Schema enum has duplicate values​

EE214: Schema contains the following enums and entities with the same name​

EE300: Event ABI Error​

EE301: Missing ABI File Path​

EE302: Invalid ABI File Path​

EE303: Missing Event In ABI​

EE304: Mismatched Event Signature​

EE305: ABI Config Mismatch​

EE400: Invalid Directory Name​

EE401: Existing Directory​

EE402: Invalid Subgraph ID​

Event Related Errors

EE500: Event Handler File Not Found​

EE600: Top Level Error​

Database Related Errors

EE700: Parse DB Row​

EE800: Raw Table Creation​

EE801: Dynamic Contracts Table Creation​

EE802: Entity Tables Creation​

EE803: Tracking Tables Error​

EE804: Drop Entity Tables​

EE805: Drop Tables Except Raw​

EE806: Clear Metadata​

EE807: Tracking a Table​

EE808: View Permissions​

Contract Related Errors

EE900: Undefined Contract​

EE901: Interface Mapping Error​

Network Related Errors

EE1000: Undefined Chain​

General Errors

EE1100: Promise Timeout​

`EE100`: Invalid Addresses

`EE101`: Unique Contract Names

`EE102`: Reserved Words in the Configuration file

`EE103`: Parse Event Error

`EE104`: Resolve Config Path

`EE105`: Deserialize Config

`EE106`: Undefined Network Config

`EE108`: Valid Postgres Database

`EE109`: Incorrect RPC URL

`EE110`: End block is greater than start block for a given network

`EE111`: Invalid characters for the contract/event names in the config file

`EE200`: Read Schema Error

`EE201`: Parse Schema Error

`EE202`: Multiple `@derivedFrom`

`EE203`: Missing Field Argument for `@derivedFrom`

`EE204`: Invalid `@derivedFrom` Argument

`EE207`: Undefined Type

`EE208`: Unsupported Nullable Scalars

`EE209`: Unsupported Multidimensional Lists

`EE210`: Reserved Words in the Schema file

`EE211`: Unsupported Arrays of Entities

`EE212`: Schema contains the following reserved enum names

`EE213`: Schema enum has duplicate values

`EE214`: Schema contains the following enums and entities with the same name

`EE300`: Event ABI Error

`EE301`: Missing ABI File Path

`EE302`: Invalid ABI File Path

`EE303`: Missing Event In ABI

`EE304`: Mismatched Event Signature

`EE305`: ABI Config Mismatch

`EE400`: Invalid Directory Name

`EE401`: Existing Directory

`EE402`: Invalid Subgraph ID

`EE500`: Event Handler File Not Found

`EE600`: Top Level Error

`EE700`: Parse DB Row

`EE800`: Raw Table Creation

`EE801`: Dynamic Contracts Table Creation

`EE802`: Entity Tables Creation

`EE803`: Tracking Tables Error

`EE804`: Drop Entity Tables

`EE805`: Drop Tables Except Raw

`EE806`: Clear Metadata

`EE807`: Tracking a Table

`EE808`: View Permissions

`EE900`: Undefined Contract

`EE901`: Interface Mapping Error

`EE1000`: Undefined Chain

`EE1100`: Promise Timeout