Skip to main content
Version: v1

Common issues

Cannot find module errors on envio start

This error indicates that the indexer is unable to find the necessary files to start the indexer.

Delete the generated folder and run

envio codegen

Always run envio codegen straight after cloning an indexer repo using Envio.

Indexer not starting at the specified start block

If the indexer starts running but does not index the smart contracts from the start_block in the configuration file, then the indexer needs to be stopped before starting it again.

Run

envio stop

and then

envio dev

Tables for entities are not registered on Hasura

Should the tables for the entities outlined in the schema file not show up on Hasura, the database will need to be migrated (deleting previous ones and creating current ones).

Run

envio stop

and then

envio dev

Postgres running locally

If Postgres is running locally on port 5432, then you can run the whole system with a different postgres port by setting the PG_PORT environment variable. For example, if you want to run Postgres on port 5433, then set PG_PORT to 5433.

In practice this could look like this:

ENVIO_PG_PORT=5433 envio codegen
ENVIO_PG_PORT=5433 envio dev

or

export ENVIO_PG_PORT=5433
envio codegen
envio dev

NOTE: you can further customize how you connect to postgres with these additional environment variables ENVIO_POSTGRES_PASSWORD, ENVIO_PG_USER and ENVIO_PG_DATABASE.

Smart contract updated after the initial codegen

If your smart contracts have been changed after the initial codegen, then you need to recreate the ABI for the smart contracts.

Re-export smart contract ABI's using Hardhat ABI exporter and pnpm by running

cd contracts/
pnpm hardhat export-abi

Ensure that the directory for ABI in config.yaml is pointing to the correct folder where ABIs have been freshly generated.

If you keep receiving the warning messages below and are unable to see any of the indexed data, there is likely an issue with the RPC endpoint being used.

Warning messages:

  • Error getting events, will retry after backoff time
  • Failed Combined Query Filter from block
  • Issue while running fetching batch of events from the RPC. Will wait ()ms and try again.

It is recommend to use HyperSync instead, if the network being indexed from is supported.

Otherwise, use a different RPC endpoint that is valid in the config.yaml file.

Using correct version of Node.js

If you are using a version of Node.js that is v16 or older, please update to v18 or newer.

Using correct version of pnpm

If you are using a version of pnpm that is v7.8 or older, please update to v8 or newer.