サブグラフとは

コントラクトは処理のたびにイベントログを残します。「誰から誰へいくら送られた」「どのプールで交換が起きた」といった記録です。サブグラフは、このうちどれを拾い、どんな項目にまとめるかを宣言します。データベースの設計図に近いものだと考えると分かりやすいでしょう。

定義を登録すると、指定した開始ブロックから順にログを読み直してデータが作られます。取引量の多いコントラクトでは、この初期構築に時間がかかります。アプリ側は構築が終わるのを待ってから問い合わせる必要があります。

実務で気を付けるのは、定義が集計結果をそのまま決めてしまう点です。イベントの取りこぼしや、単位の扱いを誤ると、画面に出る数字が静かにずれます。チェーン上の値は正しいのに表示だけが違う、という不具合の多くはこの層で起きています。