subgraph-migration

Migrating a TheGraph subgraph to Envio HyperIndex involves a test-driven workflow for schema conversion, handler translation, and data verification. You implement Envio handlers and run tests until the migration is fully verified against actual subgraph data.

The best way to convert TheGraph schema entities for Envio HyperIndex is to remove the @entity directive, convert Bytes fields to String, and apply @derivedFrom for relationships. These schema conversion steps ensure proper structure in the new environment.

Test-driven development verifies a subgraph migration by rigorously testing the translated Envio handlers against actual subgraph data. You implement handlers and run comprehensive runtime tests until the output matches the original subgraph's results.

You cannot directly copy TheGraph handlers to Envio HyperIndex; you must translate them using specific handler translation patterns. The migration process maps TheGraph handlers to Envio equivalents and validates them against subgraph data to ensure functional parity.

Common pitfalls when migrating from TheGraph to Envio HyperIndex include incorrectly mapping schema relationships and failing to validate translated handlers. The migration guidance provides reusable reference material showing best practices, patterns, and pitfalls to avoid during tests.