The Graphからの移行
The GraphにおけるKaiaのサポートは、2026年8月31日をもって終了しました。 Kaiaのサブグラフはインデックス登録されなくなり、そのクエリエンドポイントはKaiaデータを返さなくなり、またSubgraph StudioではKaiaはデプロイ可能なネットワークではなくなりました。
お使いのDappが依然としてThe Graph上のKaiaサブグラフを参照している場合は、Goldsky、SubQuery、または自己ホスト型のグラフノードに移行してください。サブグラフのコードは変更なしでそのまま引き継がれます。
何が起きたのか
The GraphはKaiaのサポートを終了しました。この影響は、ホスト型インデックス作成サービスにのみ及んだ。
| 2026年8月31日 | Kaiaのサブグラフのインデックス作成が停止しました。 The Graphのゲートウェイ上のクエリエンドポイントが、Kaiaデータの返却を停止しました。 |
| 今 | Subgraph Studioにおいて、Kaiaはもはやデプロイ可能なネットワークではなくなりました。 Kaiaのgraph deployが失敗します。 |
オンチェーン上の変更は一切ありません。 Kaiaメインネット(8217)およびKairosテストネット(1001)、ユーザーの契約、およびイベントの全履歴には影響がありません。 Kaia RPCエンドポイントを読み取るインデクサーであれば、ジェネシスからまったく同じデータを再構築できます。履歴が失われることはなく、オンチェーンでの復旧作業も一切必要ありません。
あなたも影響を受けていますか?
以下のいずれかに該当する場合、影響を受けます:
- アプリは、Kaiaサブグラフを指す
gateway.thegraph.comまたはgateway-arbitrum.network.thegraph.com上のURLに対してクエリを実行します。 - アプリは、Subgraph Studio(
api.studio.thegraph.com/query/...)からKaiaサブグラフのエンドポイントに対してクエリを実行します。 - Kaiaのサブグラフは、
graph deploy --studioコマンドでデプロイするか、The Graphの分散型ネットワークに公開します。 - スタック内の依存関係、ダッシュボード、または分析ジョブは、これらのエンドポイントのいずれかからデータを読み取ります。
コードベースを素早く確認する方法:
grep -rn "thegraph.com" --include="*.ts" --include="*.js" --include="*.json" --include="*.env*" .
以下のいずれかに該当する場合、それらのクエリはすでに失敗しています。移行を行うと、サービスが復旧します。
Goldsky、SubQuery、自己ホスト型のグラフノードを使用してKaiaをインデックス化する場合、またはKaiaのRPCエンドポイントを直接読み取る場合は、この影響はありません。
別の選択肢を選んでください
以下の3つのオプションはすべて、Kaia MainnetとKairosをインデックスに登録しています。
| Goldsky | SubQuery | 自己ホスト型グラフノード | |
|---|---|---|---|
| 既存のサブグラフを実行します | はい — 同じ部分グラフの仕様です | はい — IPFSのデプロイメントIDを通じて | はい――それは確かにグラフのノードです |
| 移行作業 | 1つのCLIコマンド | 既存のビルドを公開する | 独自のインフラを構築する |
| ホスティング | 管理対象 | 管理型ネットワークまたは分散型ネットワーク | 操作するのはあなたです |
| その他にも | Mirror(DBへのストリーム転送)、RPC、パイプライン | 1つのプロジェクトにおけるマルチチェーン・インデックス作成 | 完全な制御 |
| おすすめ | 最も迅速なドロップイン交換 | マルチチェーン・プロジェクト、分散型ホスティング | ベンダーへの依存を避けたいチーム |
最短の道をお探しなら、Goldskyをご利用ください。 GoldskyはThe Graphのサブグラフ仕様に完全に準拠しているため、既存のKaiaサブグラフを、マッピング、スキーマ、クエリを変更することなく移行できます。変更されるのは、アプリ内のエンドポイントURLのみです。
The Graph の移行ガイドでは、通常、まずサブグラフのデプロイメントハッシュを、そのライブクエリエンドポイントから読み取ることから始めます。カイアのサブグラフについては、それらのエンドポイントが応答しなくなったため、もはやそれは不可能です。
代わりに、サブグラフのソースリポジトリからデプロイしてください。デプロイメントIDを必要とせず、同一のビルドを生成し、現在ではこれが信頼できる方法となっています。 IPFSハッシュに頼るのは、以前に保存しておいた場合、またはGraph ExplorerやSubgraph Studioのサブグラフのページからまだ読み取れる場合に限ってください。
選択肢 1:Goldsky への移行
1. Goldsky CLI のインストールと認証
# macOS / Linuxcurl https://goldsky.com | sh# Windowsnpm install -g @goldskycom/cli
app.goldsky.com の プロジェクト設定 で API キーを作成してから、次の手順を実行してください:
goldsky login
CI環境またはヘッドレス環境の場合:
goldsky login --token <API_KEY>
3. ソースからサブグラフをデプロイする
サブグラフ・プロジェクトのディレクトリから:
goldsky subgraph deploy <your-subgraph-name>/<version>
Goldskyは、subgraph.yaml、schema.graphql、およびマッピングに基づいて構築を行い、設定された開始ブロックからKaiaのインデックス作成を開始します。詳細については、サブグラフのデプロイを参照してください。
以前のビルドのIPFSハッシュがまだ手元にある場合は、そのビルドそのものをデプロイすることも可能です:
goldsky subgraph deploy <your-subgraph-name>/<version> --from-ipfs-hash <your-subgraph-ipfs-hash>
3. 同期が完了するのを待ってから、エンドポイントを切り替えてください
進捗状況は以下で確認できます:
goldsky subgraph list
スタートブロックからKaiaの履歴を再インデックスするには時間がかかります。即座に切り替わることを期待するのではなく、そのための時間を確保しておくようにしてください。サブグラフがチェーンヘッドに追いついたら、アプリ内のゲートウェイURLを置き換えてください:
- const queryUrl = 'https://gateway.thegraph.com/api/<api-key>/subgraphs/id/<subgraph-id>';+ const queryUrl = 'https://api.goldsky.com/api/public/<project-id>/subgraphs/<name>/<version>/gn';
GraphQLクエリに変更はありません。 Goldsky上でKaiaサブグラフをゼロから構築する手順の詳細については、Goldskyを参照してください。
オプション 2:SubQuery への移行
SubQueryは、既存のサブグラフの構築を実行できるほか、マルチチェーンプロジェクト向けの独自のSDKもサポートしています。
-
SubQueryのIPFSゲートウェイに対してサブグラフを構築し、デプロイメントID(CID)を生成します:
graph build -i https://unauthipfs.subquery.network/ipfs/api/v0サービス終了前にGraph ExplorerからデプロイメントIDを保存しておいた場合は、そのIDを代わりに使用できます。
-
SubQuery Explorer を開き、「新しいプロジェクトを公開」 を選択します。
-
CIDとプロジェクトのメタデータを入力し、公開してください。
なお、SubQuery NetworkではGraphQLのサブスクリプションはサポートされていません。 SubGraphプロジェクトをSubQueryネットワークに公開する方法やKaiaクイックスタート、あるいはKaia専用のスターターについてはSubQueryのページをご覧ください。
オプション 3:グラフノードのセルフホスティング
あなたの部分グラフは移植可能です。 KaiaアーカイブのRPCエンドポイントに対して、graph-nodeを自分で実行し、マッピング、スキーマ、クエリをそのまま維持することができます。
Kaia RPCエンドポイント(パブリックエンドポイントを参照するか、独自のノードを実行してください)に加え、PostgreSQLとIPFSが必要になります。これにより、インフラを自ら運用するという代償を払う代わりに、完全な制御が可能となり、ベンダーへの依存もなくなります。
移行チェックリスト
- チームが管理しているすべてのKaiaサブグラフを、内部ダッシュボードや分析ジョブも含めてすべてリストアップしてください。
- それぞれについて、ソースリポジトリ、その開始ブロック、およびグラフト設定(ある場合)を特定してください。
- 各サブグラフを、選択したプロバイダーにデプロイしてください。
- 各サブグラフがチェーンの先頭と同期するのを待ちます。
- 既知のクエリをいくつか新しいエンドポイントで実行し、結果が正しいことを確認してください。
- アプリ、環境変数、およびCIのシークレット内のエンドポイントURLとAPIキーを更新してください。
- サブグラフエンドポイントを利用するサードパーティの連携サービスやパートナーをすべて更新してください。
- アプリをデプロイし、本番環境のトラフィックが新しいエンドポイントから読み込まれていることを確認してください。
- Kaiaでのみ使用されていた「The Graph」の課金アカウントまたはAPIキーを無効にしてください。
よくある質問
これは私のスマートコントラクトやオンチェーンデータに影響しますか? いいえ。ホスト型インデックス作成サービスだけが廃止されました。 Kaia上の契約、取引、およびイベントログには変更はなく、どのインデクサーからも引き続き完全にクエリ可能です。
サブグラフを書き直す必要がありますか?
いいえ。 Goldsky、SubQuery、およびセルフホスト型のグラフノードは、いずれも標準のサブグラフ仕様に対応しています。 schema.graphql、マッピング、および GraphQL クエリは引き継がれます。
サブグラフのデプロイメントIDを保存しておかなかった。私のサブグラフは失われてしまったのでしょうか? いいえ。デプロイメント ID は、データではなくビルドを識別するものです。ソースリポジトリからデプロイすると、新しいインデクサーがチェーンから同じデータセットを再構築します。
サブグラフのソースコードももう手元にありません。 インデックス化されたデータは再構築できますが、マッピングとスキーマは書き直す必要があります。 Goldskyのガイドを参考に、ご自身のコントラクトのABIと、そのコントラクトがデプロイされたブロックを基に作業を開始してください。
他のチェーンに対するクエリは引き続き機能しますか? はい。この影響を受けたのはカイアだけだった。 The Graphを通じて他のネットワーク上で実行しているサブグラフには影響はありません。
カイアは特定のプロバイダーを推奨しているのでしょうか? いいえ。 Goldskyは1つのコマンドで移行できるため、最も導入が容易な選択肢ですが、SubQueryやセルフホスト型のGraphNodeも同様に有効な選択肢です。ご自身のスタックに合ったものを選んでください。
移行についてサポートが必要です。 Kaia Developer Forum または Kaia Discord までご連絡ください。大規模または複雑なサブグラフを運用されている場合は、Kaiaチームまでご連絡ください。移行計画の策定をお手伝いいたします。