ザ・グラフ（GRT）の始め方ガイド【初心者向け】

ザ・グラフ（GRT）は、ブロックチェーンデータのインデックス作成とクエリを行うためのオープンソースのプロトコルです。分散型アプリケーション（dApps）がブロックチェーンから効率的にデータを取得するために不可欠なツールとなっています。本ガイドでは、GRTの基本的な概念から、開発環境の構築、スマートコントラクトのデプロイ、サブグラフの作成、そしてクエリの実行まで、初心者向けに詳細な手順を解説します。

1. GRTの基礎知識

GRTは、ブロックチェーンのデータを整理し、検索可能な形式に変換します。従来のブロックチェーンデータへのアクセスは、ノード全体をスキャンする必要があり、時間とリソースを消費していました。GRTは、この問題を解決するために、以下の主要なコンポーネントで構成されています。

• Graph Node: ブロックチェーンのイベントをリッスンし、データをインデックス化するノードです。
• Graph Protocol: Graph Nodeの動作を管理し、データの整合性を保証するプロトコルです。
• Subgraphs: 特定のブロックチェーンデータに対するインデックス化戦略を定義するものです。
• GraphQL API: インデックス化されたデータにアクセスするためのクエリ言語です。

これらのコンポーネントが連携することで、dAppsはブロックチェーンのデータを迅速かつ効率的に取得できるようになります。

2. 開発環境の構築

GRTの開発を始めるには、以下のツールをインストールする必要があります。

• Node.js: JavaScriptの実行環境です。バージョン14以上を推奨します。
• npm または Yarn: Node.jsのパッケージマネージャーです。
• Graph CLI: GRTの開発を支援するコマンドラインツールです。

Graph CLIのインストール手順は以下の通りです。

npm install -g @graphprotocol/graph-cli

インストール後、以下のコマンドでバージョンを確認し、正しくインストールされていることを確認してください。

graph --version

3. スマートコントラクトのデプロイ

GRTでインデックス化するデータは、通常、スマートコントラクトによって生成されます。したがって、まずスマートコントラクトをブロックチェーンにデプロイする必要があります。ここでは、Solidityで記述された簡単なスマートコントラクトを例に、デプロイの手順を説明します。

例:

pragma solidity ^0.8.0;

contract SimpleStorage {
  uint256 storedData;

  function set(uint256 x) public {
    storedData = x;
  }

  function get() public view returns (uint256) {
    return storedData;
  }
}

このコントラクトをRemixなどのIDEを使用してコンパイルし、MetaMaskなどのウォレットを使用してブロックチェーン（例えば、ローカルのGanacheやテストネットのRinkebyなど）にデプロイします。デプロイ後、コントラクトのアドレスを控えておきます。

4. サブグラフの作成

サブグラフは、インデックス化するデータの定義と、データの取得方法を記述するものです。サブグラフは、以下の3つの主要なファイルで構成されます。

• schema.graphql: インデックス化するデータのスキーマを定義します。
• mapping.ts: ブロックチェーンのイベントをリッスンし、データをスキーマにマッピングするロジックを記述します。
• graph.yaml: サブグラフの設定ファイルです。

4.1 schema.graphqlの作成

schema.graphqlでは、インデックス化するデータの型を定義します。上記のSimpleStorageコントラクトの例では、以下のスキーマを定義できます。

type SimpleStorage @entity {
  id: ID!
  storedData: BigInt!
}

このスキーマは、SimpleStorageエンティティがIDとstoredDataフィールドを持つことを定義しています。

4.2 mapping.tsの作成

mapping.tsでは、ブロックチェーンのイベントをリッスンし、データをスキーマにマッピングするロジックを記述します。上記のSimpleStorageコントラクトの例では、以下のマッピングを定義できます。

import { SimpleStorage } from "../generated/SimpleStorage";
import { SimpleStorage as SimpleStorageEntity } from "../generated/schema";

export function handleSet(event: SimpleStorage.SetEvent):
  void {
  let entity = new SimpleStorageEntity(event.transaction.hash);
  entity.storedData = event.params.x;
  entity.save();
}

このマッピングは、SimpleStorageコントラクトのSetEventイベントが発生したときに、イベントのパラメータxをstoredDataフィールドにマッピングし、エンティティを保存します。

4.3 graph.yamlの作成

graph.yamlでは、サブグラフの設定を定義します。上記のSimpleStorageコントラクトの例では、以下の設定を定義できます。

specVersion: '0.0.2'
version: 0.0.1
runtimeVersion: '0.0.2'
name: simple-storage-subgraph
description: A subgraph for the SimpleStorage contract.
repository: https://github.com/your-username/simple-storage-subgraph
source:
  kind: contract
  network: rinkeby
  address: 0xYourContractAddress
  abi: SimpleStorage

startBlock: 0

この設定は、サブグラフの名前、説明、リポジトリ、コントラクトのアドレス、ABIなどを定義しています。

5. サブグラフのデプロイとクエリの実行

サブグラフを作成したら、Graph Nodeにデプロイし、GraphQL APIを使用してクエリを実行できます。

5.1 サブグラフのデプロイ

以下のコマンドでサブグラフをデプロイします。

graph deploy --node https://play.graphprotocol.com/ your-graph-account-id/simple-storage-subgraph

このコマンドは、サブグラフをGraph Protocolのホストされたサービスにデプロイします。デプロイが完了すると、GraphQL APIのエンドポイントが提供されます。

5.2 クエリの実行

GraphQL APIを使用して、インデックス化されたデータにクエリを実行できます。上記のSimpleStorageコントラクトの例では、以下のクエリを実行できます。

query {
  simpleStorage(id: "0xYourTransactionHash") {
    storedData
  }
}

このクエリは、指定されたトランザクションハッシュに対応するSimpleStorageエンティティのstoredDataフィールドを取得します。

6. その他の考慮事項

GRTの開発には、いくつかの考慮事項があります。

• データモデルの設計: インデックス化するデータのスキーマを慎重に設計する必要があります。
• マッピングロジックの最適化: マッピングロジックは、パフォーマンスに大きな影響を与えます。効率的なロジックを記述する必要があります。
• セキュリティ: サブグラフは、セキュリティ上の脆弱性を持つ可能性があります。安全なコードを記述する必要があります。

まとめ

本ガイドでは、GRTの基本的な概念から、開発環境の構築、スマートコントラクトのデプロイ、サブグラフの作成、そしてクエリの実行まで、初心者向けに詳細な手順を解説しました。GRTは、dAppsの開発において不可欠なツールであり、その習得は、ブロックチェーン開発者にとって大きなメリットとなります。本ガイドを参考に、GRTを活用して、革新的なdAppsを開発してください。