🇫🇷 Démarrage rapide de Cøsmos 📜

6 min readJun 27, 2022

Buts 🎯

L’objectif de ce démarrage rapide est d’adopter un projet de démarrage standard sur le réseau Juno, puis de commencer à indexer tous les votes dans le Terra Developer Fund (ouvre un nouvel onglet) (qui a également contribué à SubQuery) Cøsmos.

Important : Avant de commencer, assurez-vous d’avoir initialisé votre projet en suivant les étapes fournies dans la section Commencer ici. Vous devez suivre les 4 étapes suggérées (ouvre une nouvelle fenêtre) pour les utilisateurs de Cøsmos.

Vous pouvez voir le code final de ce projet en visitant ce lien

Maintenant, avançons dans le processus et mettons à jour ces configurations.

Auparavant, dans la section 1. Créer un nouveau projet, vous devez avoir noté 3 fichiers clés. Commençons à les mettre à jour un par un.

Remarque : Le code final de ce projet peut être trouvé ici

1. Mettez à jour votre fichier de schéma GraphQL

Le fichier schema.graphql détermine la forme de vos données à partir de SubQuery en raison du mécanisme du langage de requête GraphQL. Par conséquent, la mise à jour du fichier de schéma GraphQL est le début parfait. Il vous permet de définir votre objectif final en amont.

Mettez à jour le fichier schema.graphql comme suit. L’objectif est d’indexer tous les votes sur le Terra Developer Fund

type Vote @entity {
  id: ID! # id field is always required and must look like this
  blockHeight: BigInt!
  voter: String! # The address that voted
  proposalID: BigInt! # The proposal ID
  vote: Boolean! # If they voted to support or reject the proposal
}

Important : lorsque vous apportez des modifications au fichier de schéma, n’oubliez pas de régénérer votre répertoire de types.

yarn codegennpm run-script codegen

Vous trouverez les modèles générés dans le répertoire /src/types/models.

Consultez notre documentation sur le schéma GraphQL pour obtenir plus d’informations sur le fichier schema.graphql.

Maintenant que vous avez apporté des modifications essentielles au fichier de schéma GraphQL, passons à la configuration suivante.

2. Mettez à jour votre fichier manifeste

Le fichier Project Manifest (project.yaml) est un point d’entrée de votre projet. Il définit la plupart des détails sur la façon dont SubQuery indexera et transformera les données de la chaîne.

Notez que le fichier manifeste a déjà été configuré correctement et ne nécessite pas de modifications importantes, mais vous devez modifier les gestionnaires.

*Étant donné que nous allons indexer tous les votes sur le Terra Developer Fund, nous examinerons les messages qui utilisent l’appel au contrat de vote. Et suite à cela, nous devons mettre à jour la section des sources de données comme suit :

dataSources:
  - kind: cosmos/Runtime
    startBlock: 3246370 # The block when the first proposal in this fund was created
    mapping:
      file: "./dist/index.js"
      handlers:
        - handler: handleTerraDeveloperFund
          kind: cosmos/MessageHandler
          filter:
            type: "/cosmwasm.wasm.v1.MsgExecuteContract"
            # Filter to only messages with the vote function call
            contractCall: "vote" # The name of the contract function that was called
            values: # This is the specific smart contract that we are subscribing to
              contract: "juno1lgnstas4ruflg0eta394y8epq67s4rzhg5anssz3rc5zwvjmmvcql6qps2"

Le code ci-dessus définit que vous exécuterez une fonction de mapping handleTerraDeveloperFund chaque fois qu’il y aura un message de vote du contrat intelligent Terra Developer Fund.

Consultez notre documentation sur le Manifest File pour obtenir plus d’informations sur le fichier manifeste du projet (project.yaml).

Ensuite, approfondissons la configuration de Mapping Function.

3. Ajouter une fonction de mappage

Les fonctions de mapping déterminent comment les données de la chaîne sont transformées en entités GraphQL optimisées que vous avez précédemment définies dans le fichier schema.graphql.

Suivez ces étapes pour ajouter une fonction de mapping :

Accédez à la fonction de mapping par défaut dans le répertoire src/mappings. Vous verrez quatre fonctions exportées : handleBlock, handleEvent, handleMessage, handleTransaction. Supprimez les fonctions handleBlock, handleEvent et handleTransaction car vous ne traiterez que la fonction handleMessage.
La fonction handleMessage reçoit des données d’événement chaque fois qu’un événement correspond aux filtres que vous avez spécifiés précédemment dans project.yaml. Mettons-le à jour pour traiter tous les messages de vote et les enregistrer dans l’entité GraphQL créée précédemment.

Mettez à jour la fonction handleMessage comme suit (notez les importations supplémentaires) :

import { Vote } from "../types";
import { CosmosMessage } from "@subql/types-cosmos";

type Msg = {
  vote: {
    proposal_id: bigint;
    vote: string;
  };
};

export async function handleTerraDeveloperFund(
  message: CosmosMessage<{ sender: string; msg: Msg }>
): Promise<void> {
  // logger.info(JSON.stringify(message));
  // Example vote https://www.mintscan.io/juno/txs/EAA2CC113B3EC79AE5C280C04BE851B82414B108273F0D6464A379D7917600A4

  const voteRecord = Vote.create({
    id: `${message.tx.hash}-${message.idx}`,
    blockHeight: BigInt(message.block.block.header.height),
    voter: message.msg.decodedMsg.sender,
    proposalID: message.msg.decodedMsg.msg.vote.proposal_id,
    vote: message.msg.decodedMsg.msg.vote.vote === "yes",
  });

  await voteRecord.save();
}

Comprenons comment le code ci-dessus fonctionne.

Ici, la fonction reçoit un CosmosMessage qui inclut des données de message sur la charge utile. Nous extrayons ces données puis instancions une nouvelle entité Vote définie précédemment dans le fichier schema.graphql. Après cela, nous ajoutons des informations supplémentaires, puis utilisons la fonction .save() pour enregistrer la nouvelle entité (SubQuery l’enregistrera automatiquement dans la base de données).

Consultez notre documentation sur les Mappings et obtenez des informations détaillées sur les fonctions de mapping.

4. Construisez votre projet

Ensuite, créez votre travail pour exécuter votre nouveau projet SubQuery. Exécutez la commande build à partir du répertoire racine du projet comme indiqué ici :

yarn buildnpm run-script build

Important : Chaque fois que vous apportez des modifications à vos fonctions de mapping, vous devez reconstruire votre projet.

5. Exécutez votre projet localement avec Docker

Chaque fois que vous créez un nouveau projet de sous-requête, n’oubliez jamais de l’exécuter localement sur votre ordinateur et de le tester. Et utiliser Docker est le moyen le plus simple de le faire.

Le fichier docker-compose.yml définit toutes les configurations qui contrôlent l’exécution d’un nœud SubQuery. Pour un nouveau projet, que vous venez d’initialiser, aucune modification majeure n’est nécessaire.

Cependant, visitez Exécuter une sous-requête localement pour obtenir plus d’informations sur le fichier et les paramètres.

Exécutez la commande suivante dans le répertoire du projet :

yarn start:dockernpm run-script start:docker

Remarque : le téléchargement des images requises et le démarrage des différents nœuds et bases de données Postgres peuvent prendre quelques minutes.

6. Interrogez votre projet

Next, let’s query our project. Follow these three simple steps to query your SubQuery project:

Ouvrez votre navigateur et rendez-vous sur http://localhost:3000
Vous verrez un terrain de jeu GraphQL dans le navigateur et les schémas prêts à être interrogés.
Trouvez l’onglet Docs sur le côté droit du terrain de jeu qui devrait ouvrir un tiroir de documentation. Cette documentation est générée automatiquement et vous aide à trouver les entités et les méthodes que vous pouvez interroger.

Essayez la requête suivante pour comprendre comment cela fonctionne pour votre nouveau projet de démarrage SubQuery. N’oubliez pas d’en savoir plus sur le langage de requête GraphQL.

query {
  votes(first: 5, orderBy: BLOCK_HEIGHT_DESC) {
    nodes {
      id
      blockHeight
      voter
      vote
    }
  }
}

Vous verrez le résultat similaire à ci-dessous :

{
  "data": {
    "votes": {
      "nodes": [
        {
          "id": "14B3EE22278C494DFE90EA440A4F049F2D39A31634F0062B0FF362DB2872A979-0",
          "blockHeight": "3246683",
          "voter": "juno1njyvry0t3j5dy4rr6ar5zfglg3cy2e8u745hl7",
          "vote": true
        },
        {
          "id": "23329451CAFF77D5A0416013045530011F4FAFEA94FEEF43784CDF0947B6CA90-0",
          "blockHeight": "3246670",
          "voter": "juno1ewq9l5ae69csh57j8sgjh8z37ypm3lt0jzamwy",
          "vote": true
        },
        {
          "id": "BEAB15E994A4E99BD0631DACF4716C5627E5D0C14E0848BF07A45609CEFB2F0D-0",
          "blockHeight": "3246665",
          "voter": "juno1az0ehz2e5emudyh8hx2qwtfely0lstzj08gg9j",
          "vote": true
        }
      ]
    }
  }
}

Remarque : Le code final de ce projet peut être trouvé ici

Et après?

Toutes nos félicitations! Vous avez maintenant un projet SubQuery exécuté localement qui accepte les requêtes de l’API GraphQL pour le transfert de données depuis bLuna.

Cliquez ici pour savoir quelle devrait être votre prochaine étape dans votre parcours SubQuery.

Remarque : source sub_university 🎓

← — -Avalanche Quick Start — — — Terra Quick Start — — -→