Tutorials & Examples

2021-11-24 Ungefähr 2 min

# Tutorials & Examples

In der Kurzanleitung haben wir sehr schnell ein Beispiel durchgespielt, um Ihnen einen Eindruck davon zu geben, was SubQuery ist und wie es funktioniert. Hier sehen wir uns den Workflow beim Erstellen Ihres Projekts und die Schlüsseldateien, mit denen Sie arbeiten, genauer an.

# SubQuery Examples

Einige der folgenden Beispiele gehen davon aus, dass Sie das Startpaket im Abschnitt Schnellstart erfolgreich initialisiert haben. Ausgehend von diesem Startpaket durchlaufen wir den Standardprozess zum Anpassen und Implementieren Ihres SubQuery-Projekts.

  1. Initialise your project using subql init --specVersion 0.2.0 PROJECT_NAME. alternatively you can use the old spec version subql init PROJECT_NAME
  2. Aktualisieren Sie die Manifestdatei (project.yaml), um Informationen über Ihre Blockchain und die zuzuordnenden Entitäten aufzunehmen – siehe Manifestdatei
  3. Erstellen Sie GraphQL-Entitäten in Ihrem Schema (schema.graphql), die die Form der Daten definieren, die Sie extrahieren und für die Abfrage beibehalten – siehe GraphQL-Schema
  4. Fügen Sie alle Mapping-Funktionen (zB mappingHandlers.ts) hinzu, die Sie aufrufen möchten, um Kettendaten in die von Ihnen definierten GraphQL-Entitäten umzuwandeln - siehe Mapping
  5. Generieren, erstellen und veröffentlichen Sie Ihren Code in SubQuery-Projekten (oder führen Sie ihn in Ihrem eigenen lokalen Knoten aus) - siehe Starterprojekt ausführen und abfragen in unserer Kurzanleitung.

# Verzeichnisaufbau

Die folgende Übersicht bietet einen Überblick über die Verzeichnisstruktur eines SubQuery-Projekts, wenn der Befehl init ausgeführt wird.

- project-name
  L package.json
  L project.yaml
  L README.md
  L schema.graphql
  L tsconfig.json
  L docker-compose.yml
  L src
    L index.ts
    L mappings
      L mappingHandlers.ts
  L .gitignore
1
2
3
4
5
6
7
8
9
10
11
12

Example

SubQuery-Verzeichnisstruktur

# Codegenerierung

Immer wenn Sie Ihre GraphQL-Entitäten ändern, müssen Sie Ihr Typenverzeichnis mit dem folgenden Befehl neu generieren.

yarn codegen
1

Dadurch wird ein neues Verzeichnis erstellt (oder das vorhandene aktualisiert) src/types, das generierte Entitätsklassen für jeden Typ enthält, den Sie zuvor in schema.graphql definiert haben. Diese Klassen bieten typsicheres Laden von Entitäten sowie Lese- und Schreibzugriff auf Entitätsfelder. Weitere Informationen zu diesem Prozess finden Sie im GraphQL-Schema.

# Bauen

Um Ihr SubQuery-Projekt auf einem lokal gehosteten SubQuery-Knoten auszuführen, müssen Sie zuerst Ihre Arbeit erstellen.

Führen Sie den Build-Befehl aus dem Stammverzeichnis des Projekts aus.

Zuletzt geändert: November 24, 2021 02:27