Un Subgraph es una API personalizada construida sobre el protocolo The Graph que indexa y organiza datos blockchain para consulta eficiente usando GraphQL. Define qué datos indexar y cómo estructurarlos para consultas.
Piensa en un subgraph como un esquema de base de datos personalizado para datos blockchain - defines qué rastrear y cómo consultarlo.
Resumen del Protocolo The Graph
Cómo Funciona The Graph
1. Desarrollador crea subgraph
- Define esquema
- Escribe mappings
- Despliega a red
2. Indexers procesan datos
- Corren nodos
- Indexan blockchain
- Sirven consultas
3. Aplicaciones consultan datos
- Consultas GraphQL
- Resultados instantáneos
- Pagan con tokens GRT
Copy link
Componentes de Subgraph
1. Schema (schema.graphql)
Define estructura de datos
type Token @entity {
id: ID!
name: String!
symbol: String!
decimals: Int!
totalSupply: BigInt!
}
type Transfer @entity {
id: ID!
token: Token!
from: Account!
to: Account!
value: BigInt!
timestamp: BigInt!
}
type Account @entity {
id: ID!
balance: BigInt!
transfers: [Transfer!]! @derivedFrom(field: "from")
}
import { Transfer as TransferEvent, Token } from '../generated/schema'
import { Transfer } from '../generated/Token/Token'
export function handleTransfer(event: TransferEvent): void {
let transfer = new Transfer(
event.transaction.hash.toHex() + '-' + event.logIndex.toString()
)
transfer.from = event.params.from
transfer.to = event.params.to
transfer.value = event.params.value
transfer.timestamp = event.block.timestamp
transfer.save()
}
Copy link
Consultando Subgraphs
Consultas GraphQL
# Obtener todas las transferencias
{
transfers(first: 10, orderBy: timestamp, orderDirection: desc) {
id
from
to
value
timestamp
}
}
# Obtener balance de cuenta
{
account(id: "0x1234...") {
id
balance
transfers(first: 5) {
id
value
timestamp
}
}
}
# Filtrar y paginar
{
transfers(
where: { value_gt: "1000000000000000000" }
first: 100
skip: 0
orderBy: timestamp
orderDirection: desc
) {
id
from
to
value
}
}