Puntos clave
- The Graph transforma datos de red en entidades que pueden consultarse con GraphQL.
- Un subgraph define qué eventos se indexan y cómo se organizan los resultados.
- La aplicación debe contemplar retrasos de indexación y cambios del esquema.
¿Qué es The Graph?
The Graph proporciona herramientas e infraestructura para indexar datos blockchain y consultarlos mediante GraphQL. Un subgraph define cómo transformar información de una red en entidades que una aplicación puede consultar. Esto facilita históricos, filtros y relaciones que serían costosos de reconstruir en cada petición al RPC.
El índice es una representación derivada de la cadena. Su utilidad depende de reglas de transformación correctas y del progreso de indexación. Consultar un dato mediante GraphQL no demuestra que corresponda al último bloque ni sustituye la comprobación del estado cuando se prepara una operación crítica.
Cómo funciona
Un subgraph incluye un manifiesto con fuentes y handlers, un esquema de entidades y mappings habitualmente escritos en AssemblyScript. Los handlers procesan la información y actualizan las entidades. Se define desde qué bloque comenzar y cómo relacionar eventos con identificadores estables.
Graph Node está implementado principalmente en Rust. Puede operarse infraestructura propia o utilizar los servicios disponibles en el ecosistema, según el despliegue. La cobertura de redes y capacidades se consulta para el destino elegido; una lista histórica de cadenas no garantiza soporte en cualquier modalidad de publicación.
Qué aporta The Graph
Un historial de depósitos puede guardar cada movimiento y mantener agregados por cuenta. La aplicación consulta páginas de resultados y muestra la referencia de la transacción para investigar diferencias. Los identificadores evitan colisiones entre eventos de una misma operación y permiten relacionar entidades sin depender del orden visual de la interfaz.
Las consultas pueden incorporar información sobre el bloque indexado y errores. El producto debe decidir cuándo mostrar datos con retraso y cuándo advertir que una vista no está actualizada. Para análisis reproducible conviene fijar la referencia de bloque en las consultas que deben describir el mismo estado.
Limitaciones y criterios de elección
Los mappings tienen restricciones de ejecución y determinismo; no equivalen a un backend que consulta cualquier API privada y realiza trabajos arbitrarios. Si se necesita combinar lógica empresarial sensible con datos externos, puede ser adecuado un indexador propio o una arquitectura complementaria.
Cambiar el esquema o la lógica puede requerir reconstruir el índice y revisar consumidores. El presupuesto incluye consultas, indexación y operación según la modalidad utilizada, sin asumir una tarifa universal. La selección se apoya en el modelo de datos, la latencia tolerada y la capacidad de detectar resultados incompletos o desactualizados.
También conocido como
- Subgraph
- GRT
- Graph Protocol
