Recetario > Construcción de subgrafos en Base

Construcción de subgrafos en Base

Reading time: 3 min

Esta guía te conducirá rápidamente a través de cómo iniciar, crear e deployar tu subgrafo en Base testnet.

Lo que necesitarás:

Una dirección de contrato de Base testnet
Una wallet cripto (por ejemplo, MetaMask o Coinbase Wallet)

Subgraph Studio

⁠Enlace a esta sección

1. Instala The Graph CLI

⁠Enlace a esta sección

La CLI de The Graph (>=v0.41.0) está escrita en JavaScript y necesitarás tener instalado npm o yarn para usarlo.

# NPM
npm install -g @graphprotocol/graph-cli

# Yarn
yarn global add @graphprotocol/graph-cli

2. Crea tu subgrafo en Subgraph Studio

⁠Enlace a esta sección

Ve a Subgraph Studio y conecta tu wallet crypto.

Una vez conectado, haz clic en "Crear un subgrafo" e ingresa un nombre para tu subgrafo.

Selecciona "Base (testnet)" como la cadena de bloques indexada y haz clic en Crear subgrafo.

3. Inicia tu subgrafo

⁠Enlace a esta sección

Puedes encontrar comandos específicos para su subgrafo en Subgraph Studio.

Asegúrate de que el graph-cli esté actualizado a la última versión (superior a 0.41.0)

graph --versión

Inicia tu subgrafo a partir de un contrato existente.

graph init --studio <SUBGRAPH_SLUG>

Tu slug de subgrafo es un identificador para tu subgrafo. La herramienta CLI te guiará a través de los pasos para crear un subgrafo, que incluyen:

Protocolo: ethereum
Slug de subgrafo: <SUBGRAPH_SLUG>
Directorio para crear el subgrafo en: <SUBGRAPH_SLUG>
Red Ethereum: base-testnet _ Dirección del contrato: <CONTRACT_ADDRESS>
Bloque de inicio (opcional)
Nombre del contrato: <CONTRACT_NAME>
Sí/no a los eventos de indexación (sí significa que tu subgrafo se iniciará con entidades en el esquema y asignaciones simples para eventos emitidos)

3. Escribe tu subgrafo

⁠Enlace a esta sección

Si los eventos emitidos son lo único que deseas indexar, entonces no se requiere trabajo adicional y puedes pasar al siguiente paso.

El comando anterior crea un subgrafo de andamio que puedes usar como punto de partida para construir tu subgrafo. Al realizar cambios en el subgrafo, trabajarás principalmente con tres archivos:

Manifiesto (subgraph.yaml): el manifiesto define qué fuentes de datos indexarán tus subgrafos. Asegúrate de agregar base-testnet como el nombre de la red en el archivo de manifiesto para implementar tu subgrafo en Base testnet.
Schema (schema.graphql) - El esquema GraphQL define los datos que deseas recuperar del subgrafo.
AssemblyScript Mappings (mapping.ts) - Este es el código que traduce los datos de tus fuentes de datos a las entidades definidas en el esquema.

Si deseas indexar datos adicionales, deberás ampliar el manifiesto, el esquema y los mappings.

Para obtener más información sobre cómo escribir tu subgrafo, consulta Crear un subgrafo.

4. Deploy en Subgraph Studio

⁠Enlace a esta sección

Antes de que puedas deployar tu subgraph, deberás autenticarte con Subgraph Studio. Puedes hacer esto ejecutando el siguiente comando:

Autenticar el subgrafo en el estudio

graph auth --studio <DEPLOY_KEY>

A continuación, ingresa el directorio de tu subgrafo.

cd <SUBGRAPH_DIRECTORY>

Construye tu subgrafo con el siguiente comando:

```
graph codegen && graph build
```

Finalmente, puedes deployar tu subgrafo usando este comando:

```
graph deploy --studio <SUBGRAPH_SLUG>
```

5. Consulta tu subgrafo

⁠Enlace a esta sección

Una vez que se deploya tu subgrafo, puedes consultarlo desde tu dapp utilizando la "URL de consulta de desarrollo" en Subgraph Studio.

Nota: la API de Studio tiene un límite de velocidad. Por lo tanto, debe usarse preferentemente para desarrollo y pruebas.

Para obtener más información sobre cómo consultar datos de tu subgrafo, consulta la página Consultar un subgrafo.