subql okp4

Subql-okp4

? Indexeur de sous-requête pour le protocole OKP4.

Ce référentiel abrite l'indexeur de la sous-requête OKP4, un outil qui fournit des données de chaîne du protocole OKP4 via une API GraphQL. Le projet est basé sur la sous-requête, un outil open-source qui aide à créer des API rapides et fiables pour les applications blockchain.

Explorer

Les services suivants sont disponibles:

Chainid	Service	Point final
okp4-nemeton-1	Aire de jeux	https://explorer.subquery.network/subquery/okp4/nemeton-1
okp4-nemeton-1	Graphique	https://api.subquery.network/sq/okp4/nemeton-1

Installer

Condition préalable

Assurez-vous d'installer correctement les suivants:

• Node.js v18.18 (hydrogène)
• fil v1.22
• Docker
• Subql-Cli v3.2.0 - Installez la sous-requête CLI globalement sur votre terminal en utilisant NPM (nous ne recommandons pas d'utiliser le fil pour installer les dépendances globales): npm install -g @subql/[email protected]

Construire

? Installez les dépendances:

yarn

Générer les types:

yarn prepack

Construire Docker

? Construisez l'image Docker:

docker build -t subql-okp4 .

Exécutez-le:

docker run -ti --rm --name my-indexer 
  -e DB_HOST=postgres 
  -e DB_PORT=5432 
  -e DB_DATABASE=subql 
  -e DB_USER=subql 
  -e DB_PASS=secret 
  subql-okp4

Fournir une autre configuration:

docker run -ti --rm --name my-indexer 
  -e DB_HOST=postgres 
  -e DB_PORT=5432 
  -e DB_DATABASE=subql 
  -e DB_USER=subql 
  -e DB_PASS=secret 
  -v /path/to/new-conf.yaml:/srv/subql/project.yaml 
  subql-okp4

Donnez des arguments supplémentaires au nœud Subql:

docker run -ti --rm --name my-indexer 
  -e DB_HOST=postgres 
  -e DB_PORT=5432 
  -e DB_DATABASE=subql 
  -e DB_USER=subql 
  -e DB_PASS=secret 
  subql-okp4 --batch-size=32 --log-level=debug

Remarque: Pour exécuter le conteneur en mode détaché, remplacez -it --rm par -d dans les commandes ci-dessus.

Usage

Courir

Exécutez le projet avec la pile par défaut:

yarn start:docker

Requête

Ouvrez http: // localhost: 3000 / sur votre navigateur, et essayez la requête suivante:

 query {
  _metadata {
    chain
    lastProcessedHeight
    targetHeight
  }
}

Vous devriez obtenir le résultat suivant:

{
  "data" : {
    "_metadata" : {
      "chain" : " okp4-nemeton-1 " ,
      "lastProcessedHeight" : 2928706 ,
      "targetHeight" : 2928706
    }
  }
}

Base de données

Pendant le développement, il peut être utile d'accéder directement à la base de données pour inspecter et comprendre les données indexées. La base de données est une base de données PostgreSQL, et elle est exécutée dans un conteneur Docker par la commande docker-compose . Notez que la base de données est contenue dans un volume Docker, il persistera donc entre les exécutions.

CLI

Vous pouvez accéder à la base de données PostgreSQL via la commande suivante:

psql -h localhost -p 5432 -U subql -d subql

Les tables sont dans le schéma app .

subql => SET schema ' app ' ;
SET
subql => dt
              List of relations
 Schema |        Name         | Type  | Owner
-- ------+---------------------+-------+-------
 app    | _metadata           | table | subql
 app    | blocks              | table | subql
 app    | messages            | table | subql
 app    | objectarium_objects | table | subql
 app    | transactions        | table | subql

Métabase

Étant donné que le projet utilise PostgreSQL pour indexer les données, vous pouvez utiliser Metabase pour explorer la base de données et créer des tableaux de bord.

Le Docker-Compose est livré avec un profil pour Metabase. Pour le démarrer, courez:

docker-compose --profile metabase up

Ensuite, ouvrez http: // localhost: 3001 / sur votre navigateur et connectez-vous à la base de données avec les informations que vous pouvez trouver dans le fichier .env .

Vous voulez vous impliquer? ?

Veuillez consulter les fichiers de santé OKP4:

• Contributif
• Code de conduite

Ressources utiles

• Documentation de sous-requête