diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md b/i18n/ja/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md index affdd6c5fd92..5cedbd48318a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md @@ -2,7 +2,18 @@ ブロックチェーンインデクサーは、ブロックチェーン技術の文脈で使用されるツールで、ブロックチェーン上に保存されたデータの検索、クエリ、アクセスの効率と速度を向上させる。 ブロックチェーンのデータを整理したデータベースを作成・管理することで、ユーザーはブロックチェーン全体をゼロから処理することなく、素早く情報を取り出すことができる。 ブロックチェーンのデータを整理したデータベースを作成・管理することで、ユーザーはブロックチェーン全体をゼロから処理することなく、素早く情報を取り出すことができる。 +:::caution The Graphは2026年8月31日にKaiaでの提供を終了します + +[The Graph](https://thegraph.com/)におけるKaiaのサポートは、**2026年8月31日**をもって終了します。 その日付を過ぎると、Kaiaサブグラフのインデックス作成は停止し、それらのクエリエンドポイントはデータを返さなくなります。 お使いのDappがこれらに依存している場合は、\*\*[The Graphからの移行](./migrate-from-the-graph.md)\*\*をご覧ください。サブグラフのコードは、変更を加えることなくGoldsky、SubQuery、またはセルフホスト型のグラフノードにそのまま引き継ぐことができます。 + +::: + 以下のプロバイダーがKaiaと統合し、ブロックチェーンインデキシングサービスを提供しています： -- [グラフ](https://thegraph.com/) -- [SubQuery Network](https://academy.subquery.network/) +| プロバイダー | カイア・ネットワークス | 注記 | +| -------------------------- | ------------------------------ | --------------------------------------------------------------------- | +| [Goldsky](./goldsky.md) | メインネット、カイロス | 管理対象サブグラフとミラーデータストリーミング。 サブグラフ仕様と互換性があるため、既存のサブグラフは単一のCLIコマンドで移行できます。 | +| [SubQuery](./subquery.md) | メインネット、カイロス | 単一のプロジェクト内でのマルチチェーン・インデックス化。マネージドおよび分散型のネットワークホスティングに対応。 | +| [The Graph](./thegraph.md) | メインネット、カイロス — **2026年8月31日まで** | カイアに沈む夕日。 「The Graphからの移行」[はこちら](./migrate-from-the-graph.md)をご覧ください。 | + +独自のインデックス作成インフラを運用したい場合は、KaiaアーカイブのRPCエンドポイントに対して、[graph-node](https://github.com/graphprotocol/graph-node)を自分で実行することも可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md b/i18n/ja/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md new file mode 100644 index 000000000000..27b58daeb76c --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md @@ -0,0 +1,186 @@ +--- +title: The Graphからの移行 +sidebar_label: The Graphからの移行 +--- + +# The Graphからの移行 + +:::caution 日没に関するお知らせ + +**The Graph** における Kaia のサポートは、**2026年8月31日**をもって終了します。 その日付を過ぎると、Kaiaサブグラフのインデックス作成は停止し、それらのクエリエンドポイントはデータを返さなくなります。 お使いのDappがThe Graph上のKaiaサブグラフからデータを取得している場合は、ダウンタイムを避けるため、**2026年8月31日**までに別のインデクサーへ移行してください。 + +::: + +## 何が変化しているのか + +現在、The Graph では Kaia メインネット (8217) および Kairos テストネット (1001) がサポートされており、Kaia サブグラフのインデックス作成は Upgrade Indexer によって提供されています。 このサポートは**2026年8月31日**をもって終了します。 + +| 日付 | どうなるのか | +| -------------- | ------------------------------------------------------------------------------ | +| **2026年8月31日** | Kaiaのサブグラフのインデックス作成が停止します。 The Graphのゲートウェイ上のクエリエンドポイントが、Kaiaデータの返却を停止しました。 | +| 日没の後 | Subgraph Studioにおいて、Kaiaはもはやデプロイ可能なネットワークではなくなりました。 Kaiaの`graph deploy`が失敗します。 | + +オンチェーン上の状況に何の変化もありません。 KaiaメインネットとKairos、ユーザーの契約、およびイベント履歴には影響がありません。ホストされているインデックス作成サービスのみが廃止されます。 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の分散型ネットワークに公開します。 +- スタック内の依存関係、ダッシュボード、または分析ジョブは、これらのエンドポイントのいずれかからデータを読み取ります。 + +コードベースを素早く確認する方法： + +```bash +grep -rn "thegraph.com" --include="*.ts" --include="*.js" --include="*.json" --include="*.env*" . +``` + +Goldsky、SubQuery、自己ホスト型のグラフノードを使用してKaiaをインデックス化する場合、またはKaiaのRPCエンドポイントを直接読み取る場合は、この影響は**ありません**。 + +## 別の選択肢を選んでください + +以下の3つのオプションはすべて、本日、Kaia MainnetおよびKairosをインデックスに追加します。 + +| | [Goldsky](./goldsky.md) | [SubQuery](./subquery.md) | 自己ホスト型グラフノード | +| ------------------ | ------------------------------ | ----------------------------- | ------------------- | +| **既存のサブグラフを実行します** | はい — 同じ部分グラフの仕様です | はい — IPFSのデプロイメントIDを通じて | はい――それは確かにグラフのノードです | +| **移行作業** | 1つのCLIコマンド | 既存のビルドを公開する | 独自のインフラを構築する | +| **ホスティング** | 管理対象 | 管理型ネットワークまたは分散型ネットワーク | 操作するのはあなたです | +| **その他にも** | Mirror（DBへのストリーム転送）、RPC、パイプライン | 1つのプロジェクトにおけるマルチチェーン・インデックス作成 | 完全な制御 | +| **おすすめ** | 最も迅速なドロップイン交換 | マルチチェーン・プロジェクト、分散型ホスティング | ベンダーへの依存を避けたいチーム | + +**最短の道をお探しなら、Goldskyをご利用ください。** GoldskyはThe Graphのサブグラフ仕様に完全に準拠しているため、既存のKaiaサブグラフを、マッピング、スキーマ、クエリを変更することなく移行できます。変更されるのは、アプリ内のエンドポイントURLのみです。 + +## 選択肢 1：Goldsky への移行 + +### 1. サブグラフのIPFSハッシュを取得する + +終了日までに、The Graph上で既存のサブグラフエンドポイントを照会してください： + +```graphql +query { + _meta { + deployment + } +} +``` + +`deployment` の値は、IPFS ハッシュです。 また、[Graph Explorer](https://thegraph.com/explorer) または Subgraph Studio のサブグラフのページから、**デプロイメント ID** としてコピーすることもできます。 + +:::tip 8月31日までにこれを行ってください + +現在所有しているすべてのKaiaサブグラフについて、IPFSハッシュを取得し、保存してください。 エンドポイントがまだ応答しているうちにデータを収集するほうが、はるかに簡単です。 + +::: + +### 3. Goldsky CLI のインストールと認証 + +```bash +# macOS / Linux +curl https://goldsky.com | sh + +# Windows +npm install -g @goldskycom/cli +``` + +[app.goldsky.com](https://app.goldsky.com) の **プロジェクト設定** で API キーを作成してから、次の手順を実行してください： + +```bash +goldsky login +``` + +CI環境またはヘッドレス環境の場合： + +```bash +goldsky login --token +``` + +### 3. サブグラフを再配置する + +```bash +goldsky subgraph deploy / --from-ipfs-hash +``` + +Goldskyは同じサブグラフの構築を行い、設定された開始ブロックからKaiaのインデックス作成を開始します。 + +代わりにソースリポジトリからデプロイしたい場合は、プロジェクトディレクトリから `goldsky subgraph deploy/` を実行してください。詳細は [サブグラフのデプロイ](https://docs.goldsky.com/subgraphs/deploying-subgraphs) を参照してください。 + +### 4. 同期が完了するのを待ってから、エンドポイントを切り替えてください + +進捗状況は以下で確認できます： + +```bash +goldsky subgraph list +``` + +サブグラフがチェーンヘッドに追いついたら、アプリ内のゲートウェイURLをGoldskyのクエリエンドポイントに置き換えてください： + +```diff +- const queryUrl = 'https://gateway.thegraph.com/api//subgraphs/id/'; ++ const queryUrl = 'https://api.goldsky.com/api/public//subgraphs///gn'; +``` + +GraphQLクエリに変更はありません。 Goldsky上でKaiaサブグラフをゼロから構築する手順の詳細については、[Goldsky](./goldsky.md)を参照してください。 + +## オプション 2：SubQuery への移行 + +SubQueryは既存のサブグラフの構築を実行できるほか、マルチチェーンプロジェクト向けの独自のSDKもサポートしています。 + +1. Graph Explorer から **デプロイメント ID** (IPFS CID) を取得するか、SubQuery の IPFS ゲートウェイを利用してローカルで生成してください： + + ```bash + graph build -i https://unauthipfs.subquery.network/ipfs/api/v0 + ``` + +2. [SubQuery Explorer](https://explorer.subquery.network) を開き、**「新しいプロジェクトを公開」** を選択します。 + +3. CIDとプロジェクトのメタデータを入力し、公開してください。 + +なお、SubQuery NetworkではGraphQLのサブスクリプションはサポートされていません。 [SubGraphプロジェクトをSubQueryネットワークに公開する方法](https://subquery.network/doc/subquery_network/architects/publish-subgraph.html)や[Kaiaクイックスタート](https://subquery.network/doc/indexer/quickstart/quickstart_chains/kaia.html)、あるいはKaia専用のスターターについては[SubQuery](./subquery.md)のページをご覧ください。 + +## オプション 3：グラフノードのセルフホスティング + +あなたの部分グラフは移植可能です。 KaiaアーカイブのRPCエンドポイントに対して、[graph-node](https://github.com/graphprotocol/graph-node)を自分で実行し、マッピング、スキーマ、クエリをそのまま維持することができます。 + +Kaia RPCエンドポイント（[パブリックエンドポイント](../../../references/public-en.md)を参照するか、[独自のノード](../../../nodes/endpoint-node/endpoint-node.md)を実行してください）に加え、PostgreSQLとIPFSが必要になります。 これにより、インフラを自ら運用するという代償を払う代わりに、完全な制御が可能となり、ベンダーへの依存もなくなります。 + +## 移行チェックリスト + +- [ ] チームが管理しているすべてのKaiaサブグラフを、内部ダッシュボードや分析ジョブも含めてすべてリストアップしてください。 +- [ ] **2026年8月31日までに**、それぞれについてIPFSハッシュおよびデプロイメントIDを保存しておいてください。 +- [ ] 各サブグラフについて、開始ブロックおよび接ぎ木設定を保存します。 +- [ ] 各サブグラフを、選択したプロバイダーにデプロイしてください。 +- [ ] 各サブグラフがチェーンの先頭と同期するのを待ちます。 +- [ ] 既知のクエリをいくつか両方のエンドポイントで実行し、結果が一致することを確認してください。 +- [ ] アプリ、環境変数、およびCIのシークレット内のエンドポイントURLとAPIキーを更新してください。 +- [ ] サブグラフのエンドポイントを参照するサードパーティの連携機能やパートナーをすべて更新してください。 +- [ ] アプリをデプロイし、本番環境のトラフィックが新しいエンドポイントから読み込まれていることを確認してください。 +- [ ] Kaiaでのみ使用されている「The Graph」の課金アカウントまたはAPIキーをキャンセルしてください。 + +## よくある質問 + +**これは私のスマートコントラクトやオンチェーンデータに影響しますか？** +いいえ。 廃止されるのは、ホスト型インデックス作成サービスのみです。 Kaia上の契約、取引、およびイベントログには変更はなく、どのインデクサーからでも引き続き完全に検索可能です。 + +**サブグラフを書き直さなければならないのでしょうか？** +いいえ。 Goldsky、SubQuery、およびセルフホスト型のグラフノードは、いずれも標準のサブグラフ仕様を実装しています。 `schema.graphql`、マッピング、および GraphQL クエリはそのまま引き継がれます。 + +**2026年8月31日以降、The Graph上の私のサブグラフはどうなるのでしょうか？** +Kaiaのインデックス作成が停止し、そのクエリエンドポイントはKaiaデータを返さなくなります。 ダウンタイムを避けるため、その日までに移行を行ってください。 + +**他のチェーンに対するクエリは引き続き機能しますか？** +はい。 これはカイアにのみ影響します。 The Graphを通じて他のネットワーク上で実行しているサブグラフには影響はありません。 + +**カイアは特定のプロバイダーを推奨しているのでしょうか？** +いいえ。 Goldskyは1つのコマンドで移行できるため、最も導入が容易な選択肢ですが、SubQueryやセルフホスト型のGraphNodeも同様に有効な選択肢です。 ご自身のスタックに合ったものを選んでください。 + +**移行についてサポートが必要です。** +[Kaia Developer Forum](https://devforum.kaia.io) または Kaia Discord までご連絡ください。 大規模または複雑なサブグラフを運用している場合は、移行計画の策定を支援できるよう、早めにKaiaチームまでご連絡ください。 + +## 今後の手順 + +- [Goldsky](./goldsky.md) — Kaiaサブグラフのデプロイ手順（ステップバイステップ） +- [SubQuery](./subquery.md) — Kaia におけるマルチチェーン・インデックス機能 +- [インデクサーの概要](./indexers.md) — Kaiaのすべてのインデックス作成オプション diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md b/i18n/ja/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md index 9aed53fdb4c6..0a1fb1653f42 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md @@ -6,11 +6,21 @@ sidebar_label: The Graph ![](/img/banners/kaia-thegraph.png) +:::caution 日没のお知らせ + +The GraphにおけるKaiaのサポートは、**2026年8月31日**をもって終了します。 その日付を過ぎると、Kaiaサブグラフのインデックス作成は停止し、それらのクエリエンドポイントはデータを返さなくなります。 + +お使いのDappがThe Graph上のKaiaサブグラフからデータを取得している場合は、\*\*[The Graphからの移行](./migrate-from-the-graph.md)\*\*の手順に従い、サポート終了日までに[Goldsky](./goldsky.md)、[SubQuery](./subquery.md)、またはセルフホスト型のGraphノードへ移行してください。 サブグラフのコードは変更なしでそのまま引き継がれます。 + +以下のガイドは、本サービスが稼働している間、参考として掲載されています。 + +::: + ## はじめに スマートコントラクトの履歴データを取得することは、ダップ構築時にフラストレーションがたまることがある。 [The Graph](https://thegraph.com/)は、サブグラフと呼ばれるAPIを通じてスマートコントラクトのデータを照会する簡単な方法を提供する。 Graphのインフラはインデクサーの分散型ネットワークに依存しており、あなたのダップが真の分散型になることを可能にする。 -カイア・メインネットとテストネットはどちらもザ・グラフのサポートを受けている。 +The Graphでは、**2026年8月31日**まで、Kaiaのメインネットおよびテストネットの両方がサポートされます。 ## クイックスタート diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md b/i18n/ko/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md index 1f361571e261..d0e43c15faa7 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md @@ -2,7 +2,18 @@ 블록체인 인덱서는 블록체인 기술에 사용되는 도구로, 블록체인에 저장된 데이터의 검색, 쿼리, 액세스의 효율성과 속도를 개선합니다. 블록체인 데이터의 체계적인 데이터베이스를 생성하고 유지하여 사용자가 전체 블록체인을 처음부터 처리할 필요 없이 정보를 빠르게 검색할 수 있도록 합니다. +:::caution The Graph는 2026년 8월 31일에 Kaia에서 서비스를 종료합니다. + +[The Graph](https://thegraph.com/)에서의 Kaia 지원은 **2026년 8월 31일**에 종료됩니다. 해당 날짜가 지나면 카이아 서브그래프의 색인 생성이 중단되고, 해당 쿼리 엔드포인트에서 데이터를 반환하지 않게 됩니다. 사용 중인 DApp이 해당 그래프에 의존하고 있다면, \*\*[The Graph에서 마이그레이션하기](./migrate-from-the-graph.md)\*\*를 참조하세요. 서브그래프 코드는 수정 없이 Goldsky, SubQuery 또는 자체 호스팅 그래프 노드로 그대로 이관됩니다. + +::: + Kaia와 통합하여 블록체인 인덱싱 서비스를 제공하는 공급자는 다음과 같습니다: -- [The Graph](https://thegraph.com/) -- [SubQuery Network](https://academy.subquery.network/) +| 제공자 | 카이아 네트워크 | 참고 사항 | +| -------------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------- | +| [Goldsky](./goldsky.md) | 메인넷, 카이로스 | 관리형 하위 그래프 및 미러 데이터 스트리밍. 서브그래프 사양과 호환되므로, 기존 서브그래프는 단일 CLI 명령어로 마이그레이션할 수 있습니다. | +| [SubQuery](./subquery.md) | 메인넷, 카이로스 | 단일 프로젝트 내에서 멀티 체인 인덱싱을 지원하며, 관리형 및 탈중앙화 네트워크 호스팅을 제공합니다. | +| [The Graph](./thegraph.md) | 메인넷, 카이로스 — **2026년 8월 31일까지** | 카이아의 석양. [The Graph에서 마이그레이션하기](./migrate-from-the-graph.md)를 참조하세요. | + +직접 인덱싱 인프라를 운영하고 싶다면, Kaia 아카이브 RPC 엔드포인트를 대상으로 [graph-node](https://github.com/graphprotocol/graph-node)를 직접 실행할 수도 있습니다. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md b/i18n/ko/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md new file mode 100644 index 000000000000..5dca4d3d63b1 --- /dev/null +++ b/i18n/ko/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md @@ -0,0 +1,186 @@ +--- +title: The Graph에서 마이그레이션하기 +sidebar_label: The Graph에서 마이그레이션하기 +--- + +# The Graph에서 마이그레이션하기 + +:::caution 일몰 공고 + +**The Graph**에서의 Kaia 지원은 **2026년 8월 31일**에 종료됩니다. 해당 날짜가 지나면 카이아 서브그래프의 색인 생성이 중단되고, 해당 쿼리 엔드포인트에서 데이터를 반환하지 않게 됩니다. 사용 중인 DApp이 The Graph의 Kaia 서브그래프에서 데이터를 읽어오는 경우, 서비스 중단을 방지하기 위해 **2026년 8월 31일** 이전에 다른 인덱서로 마이그레이션하시기 바랍니다. + +::: + +## 무엇이 바뀌고 있는가 + +현재 The Graph에서는 Kaia 메인넷(8217)과 Kairos 테스트넷(1001)이 지원되고 있으며, Kaia 서브그래프에 대한 인덱싱은 Upgrade Indexer가 담당하고 있습니다. 해당 지원은 **2026년 8월 31일**에 종료됩니다. + +| 날짜 | 무슨 일이 일어나는지 | +| ---------------- | ---------------------------------------------------------------------------------------------------------------- | +| **2026년 8월 31일** | Kaia 하위 그래프의 색인 생성이 중단됩니다. The Graph 게이트웨이의 쿼리 엔드포인트에서 Kaia 데이터를 더 이상 반환하지 않습니다. | +| 해가 진 뒤 | Kaia는 더 이상 Subgraph Studio에서 배포 가능한 네트워크가 아닙니다. Kaia용 `graph deploy`가 실패합니다. | + +온체인상으로는 아무런 변화도 없습니다. Kaia 메인넷과 Kairos, 사용자의 계약 및 이벤트 내역에는 아무런 영향이 없으며, 호스팅되는 인덱싱 서비스만 중단됩니다. Kaia RPC 엔드포인트를 읽는 모든 인덱서는 동일한 데이터를 재구성할 수 있습니다. + +## 여러분도 영향을 받고 계신가요? + +다음 중 하나라도 해당된다면 귀하도 영향을 받게 됩니다: + +- 앱은 Kaia 서브그래프를 가리키는 `gateway.thegraph.com` 또는 `gateway-arbitrum.network.thegraph.com`의 URL을 조회합니다. +- 사용자의 앱은 Subgraph Studio(`api.studio.thegraph.com/query/...`)에서 Kaia 서브그래프 엔드포인트에 쿼리를 보냅니다. +- `graph deploy --studio` 명령어를 사용하여 Kaia 서브그래프를 배포하거나, The Graph의 분산형 네트워크에 게시할 수 있습니다. +- 스택 내의 종속성, 대시보드 또는 분석 작업이 해당 엔드포인트 중 하나에서 데이터를 읽어옵니다. + +코드베이스를 빠르게 확인하는 방법: + +```bash +grep -rn "thegraph.com" --include="*.ts" --include="*.js" --include="*.json" --include="*.env*" . +``` + +Goldsky, SubQuery, 자체 호스팅 그래프 노드를 통해 Kaia를 색인화하거나 Kaia RPC 엔드포인트를 직접 읽는 경우에는 **영향을 받지 않습니다**. + +## 대안을 선택하세요 + +아래의 세 가지 옵션 모두 오늘부터 Kaia 메인넷과 Kairos를 지수로 편입합니다. + +| | [Goldsky](./goldsky.md) | [SubQuery](./subquery.md) | 자체 호스팅 그래프 노드 | +| ------------------------ | --------------------------------------------------- | ------------------------- | ---------------------- | +| **기존 하위 그래프 실행** | 네 — 동일한 부분그래프 사양입니다. | 네 — IPFS 배포 ID를 통해 | 네 — _그건_ 그래프 노드입니다 | +| **이주 노력** | CLI 명령어 하나 | 기존 빌드 게시하기 | 자체 인프라 구축 | +| **호스팅** | 관리형 | 중앙 집중형 또는 분산형 네트워크 | 사용자가 직접 조작합니다 | +| **또한 다음과 같은 서비스를 제공합니다** | Mirror (데이터베이스 스트리밍), RPC, 파이프라인 | 단일 프로젝트 내의 멀티체인 인덱싱 | 완전한 제어 | +| **다음에 가장 적합합니다** | 가장 빠른 드롭인 교체 | 다중 체인 프로젝트, 탈중앙화 호스팅 | 공급업체에 대한 의존성을 원치 않는 팀들 | + +**가장 간편한 방법을 원하신다면 Goldsky를 사용하세요.** Goldsky는 The Graph의 서브그래프 사양과 완벽하게 호환되므로, 기존 Kaia 서브그래프를 매핑, 스키마, 쿼리를 변경하지 않고 그대로 이전할 수 있습니다. 앱 내의 엔드포인트 URL만 변경되면 됩니다. + +## 옵션 1: Goldsky로 이전하기 + +### 1. 서브그래프의 IPFS 해시값 확인하기 + +종료일 전에 The Graph에서 기존 서브그래프 엔드포인트를 조회하세요: + +```graphql +query { + _meta { + deployment + } +} +``` + +`deployment` 값은 귀하의 IPFS 해시입니다. 또한 [Graph Explorer](https://thegraph.com/explorer)나 Subgraph Studio에서 서브그래프 페이지의 **배포 ID**를 복사할 수도 있습니다. + +:::tip 8월 31일 이전에 이 작업을 완료해 주세요 + +현재 소유하고 있는 모든 Kaia 서브그래프에 대한 IPFS 해시를 조회하여 저장하세요. 엔드포인트가 아직 응답하는 동안 데이터를 수집하는 것이 훨씬 더 쉽습니다. + +::: + +### 2. Goldsky CLI 설치 및 인증 + +```bash +# macOS / Linux +curl https://goldsky.com | sh + +# Windows +npm install -g @goldskycom/cli +``` + +[app.goldsky.com](https://app.goldsky.com)의 **프로젝트 설정**에서 API 키를 생성한 다음, 다음 단계를 따르세요: + +```bash +goldsky login +``` + +CI 또는 헤드리스 환경의 경우: + +```bash +goldsky login --token +``` + +### 3. 서브그래프를 재배치합니다 + +```bash +goldsky subgraph deploy / --from-ipfs-hash +``` + +Goldsky는 동일한 서브그래프 구축 방식을 적용하고, 사용자가 설정한 시작 블록부터 Kaia에 대한 인덱싱을 시작합니다. + +대신 소스 저장소에서 배포하고 싶다면, 프로젝트 디렉터리에서 `goldsky subgraph deploy /` 명령을 실행하세요. 자세한 내용은 [서브그래프 배포](https://docs.goldsky.com/subgraphs/deploying-subgraphs)를 참조하세요. + +### 4. 동기화가 완료될 때까지 기다린 후 엔드포인트를 전환하세요. + +다음 방법을 통해 진행 상황을 확인하세요: + +```bash +goldsky subgraph list +``` + +서브그래프가 체인 헤드에 도달하면, 앱 내의 게이트웨이 URL을 Goldsky 쿼리 엔드포인트로 교체하십시오: + +```diff +- const queryUrl = 'https://gateway.thegraph.com/api//subgraphs/id/'; ++ const queryUrl = 'https://api.goldsky.com/api/public//subgraphs///gn'; +``` + +GraphQL 쿼리는 변경되지 않습니다. Goldsky에서 Kaia 서브그래프를 처음부터 구축하는 방법에 대한 자세한 안내는 [Goldsky](./goldsky.md)를 참조하십시오. + +## 옵션 2: SubQuery로 마이그레이션 + +SubQuery는 기존 서브그래프 빌드를 실행할 수 있을 뿐만 아니라, 멀티체인 프로젝트를 위한 자체 SDK도 지원합니다. + +1. Graph Explorer에서 **배포 ID**(IPFS CID)를 확인하거나, SubQuery의 IPFS 게이트웨이를 사용하여 로컬에서 직접 생성하세요: + + ```bash + graph build -i https://unauthipfs.subquery.network/ipfs/api/v0 + ``` + +2. [SubQuery Explorer](https://explorer.subquery.network)를 열고 **새 프로젝트 게시**를 선택합니다. + +3. CID와 프로젝트 메타데이터를 입력한 다음 게시하세요. + +SubQuery Network는 GraphQL 구독 기능을 지원하지 않는다는 점에 유의하시기 바랍니다. [Subgraph 프로젝트를 SubQuery 네트워크에 게시하기](https://subquery.network/doc/subquery_network/architects/publish-subgraph.html) 및 [Kaia 빠른 시작 가이드](https://subquery.network/doc/indexer/quickstart/quickstart_chains/kaia.html)를 참조하거나, Kaia 전용 시작 가이드를 보려면 [SubQuery](./subquery.md) 페이지를 확인하세요. + +## 옵션 3: 그래프 노드 자체 호스팅 + +사용자의 부분 그래프는 이식 가능합니다. Kaia 아카이브 RPC 엔드포인트를 대상으로 [graph-node](https://github.com/graphprotocol/graph-node)를 직접 실행하고, 매핑, 스키마 및 쿼리를 현재 상태 그대로 유지할 수 있습니다. + +Kaia RPC 엔드포인트([공개 엔드포인트](../../../references/public-en.md)를 참조하거나 [자체 노드](../../../nodes/endpoint-node/endpoint-node.md)를 실행)와 PostgreSQL, IPFS가 필요합니다. 이를 통해 인프라를 직접 운영해야 하는 대가를 치르긴 하지만, 완전한 통제권을 확보할 수 있으며 공급업체에 대한 의존성을 없앨 수 있습니다. + +## 전환 체크리스트 + +- [ ] 팀에서 관리하는 모든 Kaia 하위 그래프를 나열해 주세요. 여기에는 내부 대시보드와 분석 작업도 포함됩니다. +- [ ] **2026년 8월 31일 이전**에 각 항목의 IPFS 해시/배포 ID를 저장해 두십시오. +- [ ] 각 부분 그래프에 대한 시작 블록과 접합 구성을 저장합니다. +- [ ] 각 서브그래프를 선택한 제공업체에 배포하십시오. +- [ ] 각 서브그래프가 체인 헤드와 동기화될 때까지 기다립니다. +- [ ] 알려진 쿼리 몇 가지를 두 엔드포인트 모두에 대해 비교해 보고, 결과가 일치하는지 확인하십시오. +- [ ] 앱, 환경 변수 및 CI 시크릿에 지정된 엔드포인트 URL과 API 키를 업데이트하십시오. +- [ ] 서브그래프 엔드포인트를 사용하는 모든 타사 연동 서비스나 파트너를 업데이트하십시오. +- [ ] 앱을 배포하고, 프로덕션 트래픽이 새로운 엔드포인트에서 정상적으로 처리되는지 확인하십시오. +- [ ] Kaia에만 사용되는 The Graph 청구 계정 또는 API 키를 취소하십시오. + +## 자주 묻는 질문 + +**이것이 제 스마트 계약이나 온체인 데이터에 영향을 미치나요?** +아니요. 호스팅형 색인 서비스만 중단됩니다. Kaia에 저장된 귀하의 계약, 거래 및 이벤트 로그는 변경되지 않았으며, 모든 인덱서에서 여전히 완벽하게 검색할 수 있습니다. + +**서브그래프를 다시 작성해야 하나요?** +아니요. Goldsky, SubQuery, 그리고 자체 호스팅 그래프 노드는 모두 표준 서브그래프 사양을 따릅니다. `schema.graphql`, 매핑 및 GraphQL 쿼리는 그대로 유지됩니다. + +**2026년 8월 31일 이후 The Graph에 있는 제 서브그래프는 어떻게 되나요?** +Kaia에 대한 인덱싱이 중단되며, 해당 쿼리 엔드포인트는 더 이상 Kaia 데이터를 반환하지 않게 됩니다. 서비스 중단 시간을 피하려면 해당 날짜 이전에 마이그레이션을 완료하십시오. + +**다른 체인에 대한 쿼리는 여전히 작동할까요?** +네. 이는 카이아에게만 영향을 미칩니다. The Graph를 통해 다른 네트워크에서 실행하는 서브그래프는 영향을 받지 않습니다. + +**카이아가 특정 업체를 추천하고 있나요?** +아닙니다. Goldsky는 단일 명령어로 마이그레이션이 가능하기 때문에 가장 빠르게 도입할 수 있는 방법이지만, SubQuery와 자체 호스팅 그래프 노드 역시 모두 유효한 선택지입니다. 자신의 스택에 맞는 것을 선택하세요. + +**마이그레이션에 도움이 필요합니다.** +[Kaia 개발자 포럼](https://devforum.kaia.io)이나 Kaia 디스코드에서 문의해 주세요. 대규모 또는 복잡한 하위 그래프를 운영 중이라면, Kaia 팀에 미리 연락해 주시면 전환 계획을 수립하는 데 도움을 드릴 수 있습니다. + +## 다음 단계 + +- [Goldsky](./goldsky.md) — Kaia 서브그래프 배포하기, 단계별 안내 +- [SubQuery](./subquery.md) — Kaia에서의 멀티체인 인덱싱 +- [인덱서 개요](./indexers.md) — Kaia의 모든 인덱싱 옵션 diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md b/i18n/ko/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md index 2350ad41078a..3df371c35b31 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md @@ -6,11 +6,21 @@ sidebar_label: The Graph ![](/img/banners/kaia-thegraph.png) +:::caution 일몰 공고 + +The Graph에서의 Kaia 지원은 **2026년 8월 31일**에 종료됩니다. 해당 날짜가 지나면 카이아 서브그래프의 색인 생성이 중단되고, 해당 쿼리 엔드포인트에서 데이터를 반환하지 않게 됩니다. + +사용 중인 DApp이 The Graph의 Kaia 서브그래프에서 데이터를 읽어오는 경우, **[The Graph에서 마이그레이션하기](./migrate-from-the-graph.md)** 안내를 따라 종료일 전에 [Goldsky](./goldsky.md), [SubQuery](./subquery.md) 또는 자체 호스팅 그래프 노드로 이전하시기 바랍니다. 서브그래프 코드는 변경 없이 그대로 적용됩니다. + +아래 안내문은 서비스가 운영 중인 동안 참고용으로 제공됩니다. + +::: + ## 소개 Getting historical data on a smart contract can be frustrating when building a dapp. [The Graph](https://thegraph.com/) provides an easy way to query smart contract data through APIs known as subgraphs. The Graph’s infrastructure relies on a decentralized network of indexers, enabling your dapp to become truly decentralized. -Both Kaia Mainnet & Testnet are supported by The Graph. +The Graph는 **2026년 8월 31일**까지 Kaia 메인넷과 테스트넷을 모두 지원합니다. ## Quick Start diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md b/i18n/vi/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md index 719544529fb6..a5a143f410ee 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md @@ -2,7 +2,18 @@ Blockchain indexers are tools used in the context of blockchain technology to improve the efficiency and speed of searching, querying, and accessing data stored on a blockchain. They create and maintain organized databases of the blockchain's data, allowing users to quickly retrieve information without needing to process the entire blockchain from scratch. +:::caution The Graph sẽ ngừng hoạt động trên Kaia vào ngày 31 tháng 8 năm 2026 + +Dịch vụ hỗ trợ Kaia trên [The Graph](https://thegraph.com/) sẽ kết thúc vào ngày **31 tháng 8 năm 2026**. Sau ngày đó, các tiểu đồ thị Kaia sẽ ngừng lập chỉ mục và các điểm cuối truy vấn của chúng sẽ ngừng trả về dữ liệu. Nếu ứng dụng phi tập trung (dapp) của bạn phụ thuộc vào một trong các nền tảng này, hãy tham khảo **[Hướng dẫn chuyển đổi từ The Graph](./migrate-from-the-graph.md)** — mã nguồn của subgraph sẽ được chuyển sang Goldsky, SubQuery hoặc một nút đồ thị tự lưu trữ mà không cần chỉnh sửa. + +::: + The following providers have integrated with Kaia to deliver blockchain indexing services: -- [The Graph](https://thegraph.com/) -- [SubQuery Network](https://academy.subquery.network/) +| Nhà cung cấp | Mạng lưới Kaia | Ghi chú | +| -------------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [Goldsky](./goldsky.md) | Mạng chính, Kairos | Các tiểu đồ thị được quản lý kết hợp với truyền dữ liệu Mirror. Tương thích với đặc tả subgraph, do đó các subgraph hiện có có thể được di chuyển chỉ bằng một lệnh CLI duy nhất. | +| [SubQuery](./subquery.md) | Mạng chính, Kairos | Chỉ mục đa chuỗi trong một dự án duy nhất, với dịch vụ lưu trữ mạng được quản lý và phi tập trung. | +| [The Graph](./thegraph.md) | Mạng chính, Kairos — **đến ngày 31 tháng 8 năm 2026** | Hoàng hôn trên Kaia. Xem [Chuyển đổi từ The Graph](./migrate-from-the-graph.md). | + +Bạn cũng có thể tự chạy [graph-node](https://github.com/graphprotocol/graph-node) trên một điểm cuối RPC của kho lưu trữ Kaia nếu bạn muốn tự vận hành cơ sở hạ tầng lập chỉ mục của riêng mình. diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md b/i18n/vi/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md new file mode 100644 index 000000000000..513324a165a4 --- /dev/null +++ b/i18n/vi/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md @@ -0,0 +1,186 @@ +--- +title: Chuyển đổi từ The Graph +sidebar_label: Chuyển đổi từ The Graph +--- + +# Chuyển đổi từ The Graph + +:::caution Thông báo về hoàng hôn + +Dịch vụ hỗ trợ Kaia trên **The Graph** sẽ kết thúc vào ngày **31 tháng 8 năm 2026**. Sau ngày đó, các tiểu đồ thị Kaia sẽ ngừng lập chỉ mục và các điểm cuối truy vấn của chúng sẽ ngừng trả về dữ liệu. Nếu ứng dụng phi tập trung (dapp) của bạn truy xuất dữ liệu từ một tiểu đồ thị Kaia trên The Graph, hãy chuyển sang sử dụng một máy chỉ mục khác trước ngày **31 tháng 8 năm 2026** để tránh tình trạng ngừng hoạt động. + +::: + +## Điều gì đang thay đổi + +Hiện tại, Kaia Mainnet (8217) và Kairos Testnet (1001) đã được hỗ trợ trên The Graph, trong đó việc lập chỉ mục cho các tiểu đồ thị (subgraph) của Kaia được thực hiện bởi Upgrade Indexer. Chương trình hỗ trợ này sẽ kết thúc vào ngày **31 tháng 8 năm 2026**. + +| Ngày | Điều gì sẽ xảy ra | +| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **Ngày 31 tháng 8 năm 2026** | Các đồ thị con của Kaia ngừng lập chỉ mục. Các điểm cuối truy vấn trên cổng của The Graph đã ngừng trả về dữ liệu Kaia. | +| Sau khi mặt trời lặn | Kaia hiện không còn là mạng có thể triển khai trong Subgraph Studio nữa. Lệnh `graph deploy` cho Kaia không thành công. | + +Không có gì thay đổi trên chuỗi. Kaia Mainnet và Kairos, các hợp đồng của bạn cũng như lịch sử sự kiện của bạn sẽ không bị ảnh hưởng — chỉ có dịch vụ lập chỉ mục được lưu trữ là sẽ ngừng hoạt động. Bất kỳ trình lập chỉ mục nào có thể đọc điểm cuối RPC của Kaia đều có thể tái tạo lại cùng một dữ liệu. + +## Bạn có bị ảnh hưởng không? + +Bạn sẽ bị ảnh hưởng nếu có bất kỳ trường hợp nào sau đây xảy ra: + +- Ứng dụng của bạn gửi yêu cầu đến một URL trên `gateway.thegraph.com` hoặc `gateway-arbitrum.network.thegraph.com`, URL này trỏ đến một subgraph Kaia. +- Ứng dụng của bạn đang truy vấn một điểm cuối tiểu đồ thị Kaia từ Subgraph Studio (`api.studio.thegraph.com/query/...`). +- Bạn có thể triển khai các tiểu đồ thị Kaia bằng lệnh `graph deploy --studio` hoặc xuất bản chúng lên mạng lưới phi tập trung của The Graph. +- Một tác vụ phụ thuộc, bảng điều khiển hoặc tác vụ phân tích trong hệ thống của bạn sẽ truy xuất dữ liệu từ một trong các điểm cuối đó. + +Một cách nhanh chóng để kiểm tra cơ sở mã của bạn: + +```bash +grep -rn "thegraph.com" --include="*.ts" --include="*.js" --include="*.json" --include="*.env*" . +``` + +Bạn **sẽ không** bị ảnh hưởng nếu bạn lập chỉ mục Kaia bằng Goldsky, SubQuery, một nút đồ thị tự lưu trữ hoặc bằng cách truy cập trực tiếp vào điểm cuối RPC của Kaia. + +## Chọn một phương án khác + +Cả ba tùy chọn dưới đây đều niêm yết Kaia Mainnet và Kairos ngay hôm nay. + +| | [Goldsky](./goldsky.md) | [SubQuery](./subquery.md) | Nút đồ thị tự lưu trữ | +| -------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------- | --------------------------------------------- | +| **Chạy các tiểu đồ thị hiện có** | Đúng — cùng một thông số kỹ thuật của đồ thị con | Đúng — thông qua ID triển khai IPFS | Đúng vậy — đó _chính là_ nút đồ thị | +| **Nỗ lực di cư** | Một lệnh CLI | Phát hành bản dựng hiện có | Tự cung cấp hạ tầng của riêng bạn | +| **Dịch vụ lưu trữ** | Được quản lý | Mạng lưới được quản lý hay mạng lưới phi tập trung | Bạn hãy vận hành nó | +| **Ngoài ra còn cung cấp** | Mirror (truyền dữ liệu trực tiếp vào cơ sở dữ liệu của bạn), RPC, các đường ống | Chỉ mục đa chuỗi trong một dự án | Kiểm soát hoàn toàn | +| **Phù hợp nhất cho** | Giải pháp thay thế nhanh nhất | Các dự án đa chuỗi, dịch vụ lưu trữ phi tập trung | Các đội muốn không phụ thuộc vào nhà cung cấp | + +**Nếu bạn muốn có lộ trình ngắn nhất, hãy sử dụng Goldsky.** Goldsky hoàn toàn tương thích với đặc tả tiểu đồ thị của The Graph, do đó, một tiểu đồ thị Kaia hiện có có thể được chuyển sang mà không cần thay đổi các bản ánh xạ, lược đồ hay truy vấn của bạn — chỉ có URL điểm cuối trong ứng dụng của bạn là thay đổi. + +## Lựa chọn 1: Chuyển sang Goldsky + +### 1. Lấy mã băm IPFS của đồ thị con của bạn + +Hãy truy vấn điểm cuối của tiểu đồ thị hiện có của bạn trên The Graph trước ngày ngừng hỗ trợ: + +```graphql +query { + _meta { + deployment + } +} +``` + +Giá trị `deployment` là mã băm IPFS của bạn. Bạn cũng có thể sao chép thông tin này dưới dạng **ID triển khai** từ trang của subgraph trên [Graph Explorer](https://thegraph.com/explorer) hoặc Subgraph Studio. + +:::tip Hãy làm việc này trước ngày 31 tháng 8 + +Hãy trích xuất mã băm IPFS cho từng tiểu đồ thị Kaia mà bạn đang sở hữu và lưu lại. Việc thu thập dữ liệu sẽ dễ dàng hơn nhiều khi các thiết bị đầu cuối của bạn vẫn còn phản hồi. + +::: + +### 2. Cài đặt và xác thực Goldsky CLI + +```bash +# macOS / Linux +curl https://goldsky.com | sh + +# Windows +npm install -g @goldskycom/cli +``` + +Tạo khóa API trong phần **Cài đặt dự án** tại [app.goldsky.com](https://app.goldsky.com), sau đó: + +```bash +goldsky login +``` + +Đối với môi trường CI hoặc môi trường không giao diện người dùng: + +```bash +goldsky login --token +``` + +### 3. Triển khai lại tiểu đồ thị + +```bash +goldsky subgraph deploy / --from-ipfs-hash +``` + +Goldsky thực hiện quy trình xây dựng tiểu đồ thị tương tự và bắt đầu lập chỉ mục Kaia từ khối bắt đầu mà bạn đã cấu hình. + +Nếu bạn muốn triển khai từ kho lưu trữ nguồn, hãy chạy lệnh `goldsky subgraph deploy /` từ thư mục dự án — xem [Triển khai subgraph](https://docs.goldsky.com/subgraphs/deploying-subgraphs). + +### 4. Hãy đợi quá trình đồng bộ hóa hoàn tất rồi chuyển sang điểm cuối của bạn + +Theo dõi tiến độ bằng: + +```bash +goldsky subgraph list +``` + +Khi mạng con đã bắt kịp đầu chuỗi, hãy thay thế URL cổng trong ứng dụng của bạn bằng điểm cuối truy vấn Goldsky: + +```diff +- const queryUrl = 'https://gateway.thegraph.com/api//subgraphs/id/'; ++ const queryUrl = 'https://api.goldsky.com/api/public//subgraphs///gn'; +``` + +Các truy vấn GraphQL của bạn không thay đổi. Để xem hướng dẫn chi tiết về cách xây dựng một tiểu đồ thị Kaia trên Goldsky từ đầu, hãy truy cập [Goldsky](./goldsky.md). + +## Lựa chọn 2: Chuyển sang SubQuery + +SubQuery có thể chạy quá trình xây dựng subgraph đã có sẵn, đồng thời cũng hỗ trợ SDK riêng của mình dành cho các dự án đa chuỗi. + +1. Lấy **ID triển khai** (IPFS CID) từ Graph Explorer, hoặc tạo một ID như vậy tại máy cục bộ thông qua cổng IPFS của SubQuery: + + ```bash + graph build -i https://unauthipfs.subquery.network/ipfs/api/v0 + ``` + +2. Mở [SubQuery Explorer](https://explorer.subquery.network) và chọn **Publish New Project**. + +3. Nhập mã CID cùng với siêu dữ liệu dự án của bạn, sau đó nhấn nút “Xuất bản”. + +Xin lưu ý rằng mạng SubQuery không hỗ trợ tính năng đăng ký (subscription) trong GraphQL. Xem [Hướng dẫn xuất bản dự án Subgraph của bạn lên Mạng SubQuery](https://subquery.network/doc/subquery_network/architects/publish-subgraph.html) và [Hướng dẫn bắt đầu nhanh với Kaia](https://subquery.network/doc/indexer/quickstart/quickstart_chains/kaia.html), hoặc trang [SubQuery](./subquery.md) để tham khảo các hướng dẫn khởi đầu dành riêng cho Kaia. + +## Lựa chọn 3: Tự lưu trữ nút đồ thị + +Đồ thị con của bạn có tính di động. Bạn có thể tự chạy [graph-node](https://github.com/graphprotocol/graph-node) trên một điểm cuối RPC của kho lưu trữ Kaia và giữ nguyên các bản ánh xạ, lược đồ và truy vấn của mình như hiện tại. + +Bạn sẽ cần một điểm cuối RPC của Kaia (xem [Các điểm cuối công khai](../../../references/public-en.md) hoặc chạy [nút của riêng bạn](../../../nodes/endpoint-node/endpoint-node.md)), cùng với PostgreSQL và IPFS. Điều này mang lại cho bạn quyền kiểm soát hoàn toàn và không phụ thuộc vào nhà cung cấp, nhưng đổi lại, bạn phải tự vận hành cơ sở hạ tầng. + +## Danh sách kiểm tra chuyển đổi + +- [ ] Liệt kê tất cả các tiểu đồ thị Kaia mà nhóm của bạn đang quản lý, bao gồm cả các bảng điều khiển nội bộ và các tác vụ phân tích. +- [ ] Hãy lưu lại mã băm IPFS / ID triển khai của từng mục **trước ngày 31 tháng 8 năm 2026**. +- [ ] Lưu khối bắt đầu và bất kỳ cấu hình ghép nào cho mỗi đồ thị con. +- [ ] Triển khai từng đồ thị con lên nhà cung cấp mà bạn đã chọn. +- [ ] Chờ cho đến khi mỗi tiểu đồ thị đồng bộ hóa với đầu chuỗi. +- [ ] Hãy so sánh một số truy vấn đã biết với cả hai điểm cuối và xác nhận xem kết quả có khớp nhau hay không. +- [ ] Cập nhật các URL điểm cuối và khóa API trong ứng dụng, các biến môi trường và thông tin bí mật CI của bạn. +- [ ] Cập nhật các tích hợp của bên thứ ba hoặc các đối tác đang sử dụng điểm cuối subgraph của bạn. +- [ ] Triển khai ứng dụng của bạn và xác nhận rằng lưu lượng truy cập trên môi trường sản xuất được xử lý từ điểm cuối mới. +- [ ] Hủy dịch vụ thanh toán The Graph hoặc các khóa API chỉ được sử dụng cho Kaia. + +## Câu hỏi thường gặp + +**Điều này có ảnh hưởng đến các hợp đồng thông minh hoặc dữ liệu trên chuỗi của tôi không?** +Không. Chỉ có dịch vụ lập chỉ mục được lưu trữ là sẽ ngừng hoạt động. Các hợp đồng, giao dịch và nhật ký sự kiện của bạn trên Kaia vẫn giữ nguyên và vẫn có thể được tra cứu đầy đủ bởi bất kỳ trình lập chỉ mục nào. + +**Tôi có phải viết lại tiểu đồ thị của mình không?** +Không. Goldsky, SubQuery và các nút đồ thị tự lưu trữ đều chạy theo tiêu chuẩn subgraph. Tệp `schema.graphql`, các bản ánh xạ và các truy vấn GraphQL của bạn sẽ được giữ nguyên. + +**Điều gì sẽ xảy ra với tiểu đồ thị của tôi trên The Graph sau ngày 31 tháng 8 năm 2026?** +Hệ thống sẽ ngừng lập chỉ mục cho Kaia và điểm cuối truy vấn của nó sẽ ngừng trả về dữ liệu Kaia. Hãy thực hiện việc di chuyển trước ngày đó để tránh thời gian ngừng hoạt động. + +**Các truy vấn dành cho các chuỗi khác có còn hoạt động không?** +Có. Điều này chỉ ảnh hưởng đến Kaia. Các tiểu đồ thị mà bạn chạy trên các mạng khác thông qua The Graph sẽ không bị ảnh hưởng. + +**Kaia có đề xuất một nhà cung cấp nào không?** +Không. Goldsky là phương án triển khai nhanh nhất nhờ tính năng di chuyển chỉ bằng một lệnh, nhưng SubQuery và nút đồ thị tự lưu trữ cũng là những lựa chọn hợp lý không kém. Hãy chọn giải pháp phù hợp với hệ thống công nghệ của bạn. + +**Tôi cần trợ giúp về việc di chuyển dữ liệu.** +Hãy liên hệ qua [Diễn đàn Nhà phát triển Kaia](https://devforum.kaia.io) hoặc kênh Discord của Kaia. Nếu bạn đang vận hành một tiểu đồ thị lớn hoặc phức tạp, hãy liên hệ với đội ngũ Kaia càng sớm càng tốt để chúng tôi có thể hỗ trợ bạn lập kế hoạch chuyển đổi. + +## Các bước tiếp theo + +- [Goldsky](./goldsky.md) — Triển khai một tiểu đồ thị Kaia, từng bước một +- [SubQuery](./subquery.md) — lập chỉ mục đa chuỗi trên Kaia +- [Tổng quan về các công cụ lập chỉ mục](./indexers.md) — tất cả các tùy chọn lập chỉ mục trên Kaia diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md b/i18n/vi/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md index 048b0047aff0..ced3a2386a58 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md @@ -6,11 +6,21 @@ sidebar_label: The Graph ![](/img/banners/kaia-thegraph.png) +:::caution Thông báo về hoàng hôn + +Dịch vụ hỗ trợ Kaia trên The Graph sẽ kết thúc vào ngày **31 tháng 8 năm 2026**. Sau ngày đó, các tiểu đồ thị Kaia sẽ ngừng lập chỉ mục và các điểm cuối truy vấn của chúng sẽ ngừng trả về dữ liệu. + +Nếu ứng dụng phi tập trung (dapp) của bạn truy xuất dữ liệu từ một subgraph Kaia trên The Graph, hãy làm theo hướng dẫn **[Chuyển đổi từ The Graph](./migrate-from-the-graph.md)** để chuyển sang [Goldsky](./goldsky.md), [SubQuery](./subquery.md) hoặc một nút đồ thị tự lưu trữ trước ngày ngừng hỗ trợ. Mã đoạn đồ thị con của bạn sẽ được giữ nguyên như cũ. + +Hướng dẫn dưới đây được lưu giữ để tham khảo trong thời gian dịch vụ vẫn đang hoạt động. + +::: + ## Giới thiệu Getting historical data on a smart contract can be frustrating when building a dapp. [The Graph](https://thegraph.com/) provides an easy way to query smart contract data through APIs known as subgraphs. The Graph’s infrastructure relies on a decentralized network of indexers, enabling your dapp to become truly decentralized. -Both Kaia Mainnet & Testnet are supported by The Graph. +Cả Kaia Mainnet và Testnet đều được The Graph hỗ trợ cho đến **ngày 31 tháng 8 năm 2026**. ## Quick Start diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md index ec2b34d7b44e..d11232caa04b 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md @@ -2,7 +2,18 @@ 区块链索引器是区块链技术中使用的工具，用于提高搜索、查询和访问存储在区块链上的数据的效率和速度。 它们创建并维护区块链数据的有序数据库，使用户能够快速检索信息，而无需从头开始处理整个区块链。 +:::caution 2026年8月31日，《The Graph》将在凯亚（Kaia）正式停运 + +[The Graph](https://thegraph.com/) 对 Kaia 的支持将于 **2026 年 8 月 31 日** 结束。 在此日期之后，Kaia 子图将停止索引，其查询端点也将停止返回数据。 如果您的 dapp 依赖于其中一种，请参阅 **[从 The Graph 迁移](./migrate-from-the-graph.md)** —— 您的子图代码可直接迁移至 Goldsky、SubQuery 或自托管的图节点，无需任何修改。 + +::: + 以下供应商已与 Kaia 集成，提供区块链索引服务： -- [图表](https://thegraph.com/) -- [SubQuery Network](https://academy.subquery.network/) +| 服务提供商 | Kaia 网络 | 注释 | +| -------------------------- | ---------------------------------- | --------------------------------------------------------- | +| [Goldsky](./goldsky.md) | 主网，Kairos | 托管子图加上 Mirror 数据流。 符合子图规范，因此只需一条 CLI 命令即可迁移现有子图。 | +| [SubQuery](./subquery.md) | 主网，Kairos | 在单个项目中实现多链索引，同时支持托管式和去中心化网络托管。 | +| [The Graph](./thegraph.md) | 主网，Kairos — **截至 2026 年 8 月 31 日** | 凯亚的日落。 请参阅 [从 The Graph 迁移](./migrate-from-the-graph.md)。 | + +如果您更希望自行运营索引基础设施，也可以直接在 Kaia 归档 RPC 端点上运行 [graph-node](https://github.com/graphprotocol/graph-node)。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md new file mode 100644 index 000000000000..7c3724f0171d --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md @@ -0,0 +1,186 @@ +--- +title: 从 The Graph 迁移 +sidebar_label: 从 The Graph 迁移 +--- + +# 从 The Graph 迁移 + +:::caution 终止服务通知 + +Kaia 在 **The Graph** 上的支持将于 **2026 年 8 月 31 日** 结束。 在此日期之后，Kaia 子图将停止索引，其查询端点也将停止返回数据。 如果您的去中心化应用（dapp）从 The Graph 上的 Kaia 子图读取数据，请务必在 **2026 年 8 月 31 日** 之前迁移到另一个索引器，以避免服务中断。 + +::: + +## 有哪些变化 + +The Graph 目前支持 Kaia 主网 (8217) 和 Kairos 测试网 (1001)，其中 Kaia 子图的索引工作由 Upgrade Indexer 负责。 该支持服务将于**2026年8月31日**终止。 + +| 日期 | 会发生什么 | +| -------------- | ------------------------------------------------------------------ | +| **2026年8月31日** | Kaia 子图停止索引。 对 The Graph 网关的查询端点不再返回 Kaia 数据。 | +| 日落之后 | 在 Subgraph Studio 中，Kaia 已不再是一个可部署的网络。 Kaia 的 `graph deploy` 操作失败。 | + +链上没有任何变化。 Kaia 主网和 Kairos、您的合约以及您的事件历史记录均不受影响——只有托管的索引服务将被移除。 任何能够读取 Kaia RPC 端点的索引器都可以重建相同的数据。 + +## 您是否受到影响？ + +如果符合以下任一情况，您将受到影响： + +- 您的应用向 `gateway.thegraph.com` 或 `gateway-arbitrum.network.thegraph.com` 上的某个 URL 发起查询，该 URL 指向一个 Kaia 子图。 +- 您的应用从 Subgraph Studio（`api.studio.thegraph.com/query/...`）查询了一个 Kaia 子图端点。 +- 您可以使用 `graph deploy --studio` 部署 Kaia 子图，或将其发布到 The Graph 的去中心化网络中。 +- 您技术栈中的某个依赖项、仪表板或分析任务会从这些端点之一读取数据。 + +快速检查代码库的方法： + +```bash +grep -rn "thegraph.com" --include="*.ts" --include="*.js" --include="*.json" --include="*.env*" . +``` + +如果您使用 Goldsky、SubQuery、自托管的图节点对 Kaia 进行索引，或者直接读取 Kaia RPC 端点，则您**不会**受到影响。 + +## 选择其他选项 + +以下这三个选项均已于今日将Kaia主网和Kairos纳入指数。 + +| | [Goldsky](./goldsky.md) | [SubQuery](./subquery.md) | 自托管的图节点 | +| ---------- | ----------------------- | ------------------------- | ----------------------------------------- | +| **运行现有子图** | 是的——子图规范相同 | 是的——通过 IPFS 部署 ID | 是的——它_确实_是图节点 | +| **迁移工作** | 一条 CLI 命令 | 发布现有构建 | 部署您自己的基础设施 | +| **主机托管** | 托管 | 集中式或去中心化网络 | 由你来操作 | +| **此外还提供** | 镜像（流式传输到数据库）、RPC、管道 | 在一个项目中实现多链索引 | 完全控制 | +| **最适合** | 最快捷的即插即用替换方案 | 多链项目、去中心化托管 | 希望摆脱对供应商依赖的团队 | + +**若想走最短路径，请使用 Goldsky。** Goldsky 与 The Graph 的子图规范完全兼容，因此现有的 Kaia 子图可直接迁移，无需更改映射、模式或查询——只需在应用中更新端点 URL 即可。 + +## 选项 1：迁移至 Goldsky + +### 1. 获取子图的 IPFS 哈希值 + +请在停用日期之前，在 The Graph 上查询您现有的子图端点： + +```graphql +query { + _meta { + deployment + } +} +``` + +`deployment` 的值即为您的 IPFS 哈希值。 您还可以从 [Graph Explorer](https://thegraph.com/explorer) 或 Subgraph Studio 中的子图页面，将其作为 **部署 ID** 复制下来。 + +:::tip 请在8月31日之前完成此操作 + +请立即提取您目前拥有的每个 Kaia 子图的 IPFS 哈希值并保存下来。 在端点还能响应的时候进行数据采集要容易得多。 + +::: + +### 2. 安装并验证 Goldsky CLI + +```bash +# macOS / Linux +curl https://goldsky.com | sh + +# Windows +npm install -g @goldskycom/cli +``` + +在 [app.goldsky.com](https://app.goldsky.com) 的 **项目设置** 下创建一个 API 密钥，然后： + +```bash +goldsky login +``` + +对于 CI 或无头环境： + +```bash +goldsky login --token +``` + +### 3. 重新部署子图 + +```bash +goldsky subgraph deploy / --from-ipfs-hash +``` + +Goldsky 采用相同的子图构建方式，并从您配置的起始区块开始对 Kaia 进行索引。 + +如果您更倾向于从源代码仓库进行部署，请在项目目录下运行 `goldsky subgraph deploy/` —— 请参阅 [子图部署](https://docs.goldsky.com/subgraphs/deploying-subgraphs)。 + +### 4. 请等待同步完成，然后切换您的端点 + +使用以下方式跟踪进度： + +```bash +goldsky subgraph list +``` + +一旦子图追上链头，请将应用中的网关 URL 替换为 Goldsky 查询端点： + +```diff +- const queryUrl = 'https://gateway.thegraph.com/api//subgraphs/id/'; ++ const queryUrl = 'https://api.goldsky.com/api/public//subgraphs///gn'; +``` + +您的 GraphQL 查询不会发生变化。 有关在 Goldsky 上从零开始构建 Kaia 子图的完整分步指南，请参阅 [Goldsky](./goldsky.md)。 + +## 方案 2：迁移到 SubQuery + +SubQuery 可以运行现有的子图构建，同时也为多链项目提供了自己的 SDK。 + +1. 从 Graph Explorer 获取 **部署 ID**（IPFS CID），或者在本地通过 SubQuery 的 IPFS 网关生成一个： + + ```bash + graph build -i https://unauthipfs.subquery.network/ipfs/api/v0 + ``` + +2. 打开 [SubQuery Explorer](https://explorer.subquery.network)，然后选择 **发布新项目**。 + +3. 输入 CID 以及您的项目元数据，然后发布。 + +请注意，SubQuery Network 不支持 GraphQL 订阅。 请参阅 [将您的 Subgraph 项目发布到 SubQuery 网络](https://subquery.network/doc/subquery_network/architects/publish-subgraph.html) 和 [Kaia 快速入门](https://subquery.network/doc/indexer/quickstart/quickstart_chains/kaia.html)，或访问 [SubQuery](./subquery.md) 页面查看针对 Kaia 的入门指南。 + +## 选项 3：自行托管图节点 + +您的子图是可移植的。 您可以自行在 Kaia 归档 RPC 端点上运行 [graph-node](https://github.com/graphprotocol/graph-node)，并完全保留原有的映射、模式和查询。 + +您需要一个 Kaia RPC 端点（请参阅 [公共端点](../../../references/public-en.md) 或运行 [您自己的节点](../../../nodes/endpoint-node/endpoint-node.md)），此外还需要 PostgreSQL 和 IPFS。 这使您能够完全掌控一切，且不受供应商制约，但代价是您需要自行运营基础设施。 + +## 切换检查清单 + +- [ ] 请列出贵团队拥有的所有 Kaia 子图，包括内部仪表盘和分析任务。 +- [ ] 请在 **2026年8月31日之前** 保存每个的 IPFS 哈希值/部署 ID。 +- [ ] 保存每个子图的起始块以及任何接枝配置。 +- [ ] 将每个子图部署到您选择的提供商上。 +- [ ] 等待每个子图与链头同步。 +- [ ] 将几个已知的查询分别提交至这两个端点进行比较，并确认结果是否一致。 +- [ ] 请更新应用、环境变量和 CI 密钥中的端点 URL 和 API 密钥。 +- [ ] 请更新任何调用您子图端点的第三方集成或合作伙伴。 +- [ ] 部署您的应用，并确认生产环境中的流量能够通过新端点进行读取。 +- [ ] 取消仅用于 Kaia 的 The Graph 计费或 API 密钥。 + +## 常见问题解答 + +**这会影响我的智能合约或链上数据吗？** +不会。 只有托管索引服务将被停用。 您在 Kaia 上的合约、交易和事件日志保持不变，任何索引器均可对其进行全面查询。 + +**我必须重写子图吗？** +不需要。 Goldsky、SubQuery 和自托管的 Graph-Node 均遵循标准子图规范。 您的 `schema.graphql`、映射和 GraphQL 查询将被保留。 + +**2026年8月31日之后，我在The Graph上的子图会怎样？** +系统将停止对Kaia的索引，其查询端点也将停止返回Kaia数据。 请在该日期之前完成迁移，以避免系统停机。 + +**针对其他区块链的查询还能正常工作吗？** +可以。 这只影响凯亚。 您通过 The Graph 在其他网络上运行的子图不会受到影响。 + +**凯亚是在推荐某家服务商吗？** +不是。 Goldsky 之所以是最快的即用型方案，是因为它支持单命令迁移，但 SubQuery 和自托管的 graph-node 同样可行。 选择适合您技术栈的方案。 + +**我需要迁移方面的帮助。** +请在 [Kaia 开发者论坛](https://devforum.kaia.io) 或 Kaia Discord 上联系我们。 如果您运行的是大型或复杂的子图，请尽早联系 Kaia 团队，以便我们协助您规划切换工作。 + +## 下一步 + +- [Goldsky](./goldsky.md) — 逐步部署一个 Kaia 子图 +- [SubQuery](./subquery.md) — Kaia 上的多链索引 +- [索引器概述](./indexers.md) — Kaia 上的所有索引选项 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md index 5ded7d6ff28b..59b1ac7ca269 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md @@ -6,11 +6,21 @@ sidebar_label: The Graph ![](/img/banners/kaia-thegraph.png) +:::caution 终止服务通知 + +The Graph 上对 Kaia 的支持将于 **2026 年 8 月 31 日** 结束。 在此日期之后，Kaia 子图将停止索引，其查询端点也将停止返回数据。 + +如果您的 DApp 从 The Graph 上的 Kaia 子图中读取数据，请按照 **[从 The Graph 迁移](./migrate-from-the-graph.md)** 的指引，在停用日期之前迁移至 [Goldsky](./goldsky.md)、[SubQuery](./subquery.md) 或自托管的图节点。 您的子图代码将原样保留。 + +以下指南在服务仍在运行期间供参考。 + +::: + ## 导言 在构建 dapp 时，获取智能合约的历史数据可能会令人沮丧。 [The Graph](https://thegraph.com/) 通过被称为子图的应用程序接口，提供了一种查询智能合约数据的简便方法。 图形的基础设施依赖于索引器的去中心化网络，使您的 dapp 真正实现去中心化。 -Kaia Mainnet 和 Testnet 均由 The Graph 提供支持。 +The Graph 将支持 Kaia 主网和测试网，直至 **2026 年 8 月 31 日**。 ## 快速入门 diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md index fbc0d460e357..ece34b9a513d 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/build/tools/indexers/indexers.md @@ -2,7 +2,18 @@ 區塊鏈索引器是區塊鏈技術中使用的工具，用於提高搜索、查詢和訪問存儲在區塊鏈上的數據的效率和速度。 它們創建並維護區塊鏈數據的有序數據庫，使用戶能夠快速檢索信息，而無需從頭開始處理整個區塊鏈。 +:::caution The Graph 將於 2026 年 8 月 31 日在 Kaia 上停止服務 + +[The Graph](https://thegraph.com/) 對 Kaia 的支援將於 **2026 年 8 月 31 日** 結束。 自該日期起，Kaia 子圖將停止建立索引，且其查詢端點將不再傳回資料。 若您的 dapp 依賴其中一種，請參閱 **[從 The Graph 遷移](./migrate-from-the-graph.md)** —— 您的子圖程式碼可直接套用至 Goldsky、SubQuery 或自建的圖節點，無需任何修改。 + +::: + 以下供應商已與 Kaia 集成，提供區塊鏈索引服務： -- [圖表](https://thegraph.com/) -- [SubQuery Network](https://academy.subquery.network/) +| 供應商 | Kaia 網路 | 註釋 | +| -------------------------- | ---------------------------------- | --------------------------------------------------------- | +| [Goldsky](./goldsky.md) | 主網，Kairos | 受管子圖加上 Mirror 資料串流。 符合子圖規格，因此現有的子圖只需透過單一 CLI 指令即可完成遷移。 | +| [SubQuery](./subquery.md) | 主網，Kairos | 在單一專案中實現多鏈索引，並採用託管與去中心化網路託管模式。 | +| [The Graph](./thegraph.md) | 主網，Kairos — **截至 2026 年 8 月 31 日** | 凱亞的日落。 請參閱 [從 The Graph 遷移](./migrate-from-the-graph.md)。 | + +如果您希望自行架設索引基礎架構，也可以直接在 Kaia 存檔的 RPC 端點上執行 [graph-node](https://github.com/graphprotocol/graph-node)。 diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md new file mode 100644 index 000000000000..5bf7223dc167 --- /dev/null +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/build/tools/indexers/migrate-from-the-graph.md @@ -0,0 +1,186 @@ +--- +title: 從 The Graph 遷移 +sidebar_label: 從 The Graph 遷移 +--- + +# 從 The Graph 遷移 + +:::caution 日落通知 + +Kaia 在 **The Graph** 上的支援將於 **2026 年 8 月 31 日** 結束。 自該日期起，Kaia 子圖將停止建立索引，且其查詢端點將不再傳回資料。 若您的去中心化應用程式（dapp）從 The Graph 上的 Kaia 子圖讀取資料，請務必在 **2026 年 8 月 31 日** 之前遷移至其他索引器，以避免服務中斷。 + +::: + +## 有哪些變化 + +The Graph 目前支援 Kaia 主網 (8217) 和 Kairos 測試網 (1001)，其中 Kaia 子圖的索引服務由 Upgrade Indexer 提供。 該項支援將於 **2026年8月31日** 結束。 + +| 日期 | 會發生什麼事 | +| -------------- | ------------------------------------------------------------ | +| **2026年8月31日** | Kaia 子圖停止建立索引。 對 The Graph 閘道器的查詢端點已停止返回 Kaia 資料。 | +| 日落之後 | Kaia 已不再是 Subgraph Studio 中可部署的網路。 Kaia 的 `graph deploy` 失敗。 | + +鏈上並無任何變更。 Kaia 主網與 Kairos、您的合約以及您的事件歷史紀錄均不受影響——僅有託管的索引服務將停止運作。 任何能讀取 Kaia RPC 端點的索引器，皆可重建相同資料。 + +## 您是否受到影響？ + +若符合以下任一情況，您即受影響： + +- 您的應用程式會向 `gateway.thegraph.com` 或 `gateway-arbitrum.network.thegraph.com` 上的某個 URL 發出查詢，該 URL 指向一個 Kaia 子圖。 +- 您的應用程式從 Subgraph Studio 查詢 Kaia 子圖端點（`api.studio.thegraph.com/query/...`）。 +- 您可以使用 `graph deploy --studio` 部署 Kaia 子圖，或將其發佈至 The Graph 的去中心化網路。 +- 您技術堆疊中的某個依賴項、儀表板或分析工作會從這些端點之一讀取資料。 + +快速檢查您的程式碼庫的方法： + +```bash +grep -rn "thegraph.com" --include="*.ts" --include="*.js" --include="*.json" --include="*.env*" . +``` + +如果您是透過 Goldsky、SubQuery、自建的圖資料庫節點來索引 Kaia，或是直接讀取 Kaia RPC 端點，則您**不會**受到影響。 + +## 選擇其他選項 + +以下這三種選擇均已於今日將 Kaia 主網和 Kairos 納入指數。 + +| | [Goldsky](./goldsky.md) | [SubQuery](./subquery.md) | 自行託管的圖節點 | +| ----------- | ----------------------- | ------------------------- | --------------- | +| **執行現有的子圖** | 是的——子圖規格相同 | 是的 — 透過 IPFS 部署 ID | 是的——它 _確實_ 是圖節點 | +| **遷徙行動** | 一個 CLI 指令 | 發佈現有的建置 | 自行部署基礎架構 | +| **主機服務** | 受管理 | 受管理或去中心化的網路 | 由您來操作 | +| **另提供** | 鏡像（串流至您的資料庫）、RPC、管線 | 單一專案中的多鏈索引 | 完全掌控 | +| **最適合** | 最快的即插即用替換方案 | 多鏈專案、去中心化託管 | 希望避免依賴供應商的團隊 | + +**若您想要最簡便的解決方案，請使用 Goldsky。** Goldsky 完全相容於 The Graph 的子圖規格，因此現有的 Kaia 子圖可直接遷移過來，無需變更您的映射、資料結構或查詢——僅需變更應用程式中的端點 URL 即可。 + +## 選項 1：遷移至 Goldsky + +### 1. 取得您的子圖的 IPFS 雜湊值 + +請在停用日期前，於 The Graph 上查詢您現有的子圖端點： + +```graphql +query { + _meta { + deployment + } +} +``` + +`deployment` 的值即是您的 IPFS 雜湊值。 您也可以從 [Graph Explorer](https://thegraph.com/explorer) 或 Subgraph Studio 中的子圖頁面，將其複製為 **部署 ID**。 + +:::tip 請在 8 月 31 日之前完成此事項 + +請立即擷取您目前擁有的每個 Kaia 子圖的 IPFS 哈希值，並將其儲存起來。 當您的終端裝置仍能回應時，進行資料蒐集會容易得多。 + +::: + +### 2. 安裝並驗證 Goldsky CLI + +```bash +# macOS / Linux +curl https://goldsky.com | sh + +# Windows +npm install -g @goldskycom/cli +``` + +請在 [app.goldsky.com](https://app.goldsky.com) 的 **專案設定** 下建立一個 API 金鑰，然後： + +```bash +goldsky login +``` + +針對 CI 或無介面環境： + +```bash +goldsky login --token +``` + +### 3. 重新部署子圖 + +```bash +goldsky subgraph deploy / --from-ipfs-hash +``` + +Goldsky 採用相同的子圖建構方式，並從您設定的起始區塊開始對 Kaia 進行索引。 + +若您希望改從原始碼儲存庫進行部署，請在專案目錄中執行 `goldsky subgraph deploy/` — 詳見 [部署子圖](https://docs.goldsky.com/subgraphs/deploying-subgraphs)。 + +### 4. 請等待同步完成，然後切換您的終端點 + +透過以下方式追蹤進度： + +```bash +goldsky subgraph list +``` + +一旦子圖追上鏈頭，請將應用程式中的網關 URL 替換為 Goldsky 查詢端點： + +```diff +- const queryUrl = 'https://gateway.thegraph.com/api//subgraphs/id/'; ++ const queryUrl = 'https://api.goldsky.com/api/public//subgraphs///gn'; +``` + +您的 GraphQL 查詢不會改變。 若要了解在 Goldsky 上從頭開始建構 Kaia 子圖的完整操作指南，請參閱 [Goldsky](./goldsky.md)。 + +## 選項 2：遷移至 SubQuery + +SubQuery 能夠執行現有的子圖建構，同時也為多鏈專案提供專屬的 SDK。 + +1. 從 Graph Explorer 取得 **部署 ID**（IPFS CID），或透過 SubQuery 的 IPFS 閘道在本地端建立一個： + + ```bash + graph build -i https://unauthipfs.subquery.network/ipfs/api/v0 + ``` + +2. 開啟 [SubQuery Explorer](https://explorer.subquery.network)，並選擇 **發佈新專案**。 + +3. 輸入 CID 以及您的專案元資料，然後發佈。 + +請注意，SubQuery Network 不支援 GraphQL 訂閱功能。 請參閱 [將您的 Subgraph 專案發佈至 SubQuery Network](https://subquery.network/doc/subquery_network/architects/publish-subgraph.html) 以及 [Kaia 快速入門](https://subquery.network/doc/indexer/quickstart/quickstart_chains/kaia.html)，或瀏覽 [SubQuery](./subquery.md) 頁面，以取得針對 Kaia 的專屬入門指南。 + +## 選項 3：自行架設圖節點 + +您的子圖具有可移植性。 您可以自行針對 Kaia 存檔的 RPC 端點執行 [graph-node](https://github.com/graphprotocol/graph-node)，並完全保留原有的映射、資料結構與查詢。 + +您將需要一個 Kaia RPC 端點（請參閱 [公開端點](../../../references/public-en.md) 或執行 [您自己的節點](../../../nodes/endpoint-node/endpoint-node.md)），此外還需安裝 PostgreSQL 和 IPFS。 這讓您能完全掌控一切，且無需依賴供應商，但代價是必須自行營運基礎架構。 + +## 切換檢查清單 + +- [ ] 請列出貴團隊所擁有的所有 Kaia 子圖，包括內部儀表板和分析工作。 +- [ ] 請在 **2026 年 8 月 31 日之前** 將每個項目的 IPFS 哈希值／部署 ID 保存下來。 +- [ ] 儲存每個子圖的起始區塊及任何接枝配置。 +- [ ] 將每個子圖部署至您選擇的服務供應商。 +- [ ] 等待每個子圖與鏈頭同步。 +- [ ] 將幾個已知的查詢分別對照兩個端點進行比對，並確認結果是否一致。 +- [ ] 請在您的應用程式、環境變數及 CI 機密中更新端點 URL 和 API 金鑰。 +- [ ] 請更新任何使用您的子圖端點的第三方整合服務或合作夥伴。 +- [ ] 部署您的應用程式，並確認生產環境的流量能從新端點讀取。 +- [ ] 取消僅用於 Kaia 的 The Graph 帳單或 API 金鑰。 + +## 常見問題 + +**這會影響我的智慧合約或鏈上資料嗎？** +不會。 只有託管式索引服務將會停止提供。 您在 Kaia 上的合約、交易及事件日誌均未變更，且任何索引器仍可對其進行完整查詢。 + +**我必須重寫我的子圖嗎？** +不需要。 Goldsky、SubQuery 以及自架設的圖節點皆支援標準子圖規範。 您的 `schema.graphql`、映射以及 GraphQL 查詢都會被保留下來。 + +**2026 年 8 月 31 日之後，我在 The Graph 上的子圖會如何？** +系統將停止對 Kaia 進行索引，且其查詢端點將不再返回 Kaia 資料。 請在該日期之前完成遷移，以避免服務中斷。 + +**針對其他區塊鏈的查詢是否仍能正常運作？** +是的。 這只會影響凱亞。 您透過 The Graph 在其他網路上記跑的子圖並不會受到影響。 + +**凱亞是否推薦某家服務供應商？** +不是。 Goldsky 之所以是最快的即插即用方案，是因為它採用單指令遷移，但 SubQuery 和自架設的 GraphNode 同樣是可行的選擇。 選擇最適合您技術堆疊的方案。 + +**我需要遷移方面的協助。** +請透過 [Kaia 開發者論壇](https://devforum.kaia.io) 或 Kaia Discord 聯繫我們。 若您營運的是大型或複雜的子圖，請盡早聯繫 Kaia 團隊，以便我們協助您規劃系統切換事宜。 + +## 下一步 + +- [Goldsky](./goldsky.md) — 逐步部署 Kaia 子圖 +- [SubQuery](./subquery.md) — 基於 Kaia 的多鏈索引功能 +- [索引器概覽](./indexers.md) — Kaia 上的所有索引選項 diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md index d7d9d251ada5..3150af9d0fbc 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/build/tools/indexers/thegraph.md @@ -6,11 +6,21 @@ sidebar_label: The Graph ![](/img/banners/kaia-thegraph.png) +:::caution 日落通知 + +The Graph 上的 Kaia 支援將於 **2026 年 8 月 31 日** 終止。 自該日期起，Kaia 子圖將停止建立索引，且其查詢端點將不再傳回資料。 + +若您的 dapp 從 The Graph 上的 Kaia 子圖讀取資料，請依照 **[從 The Graph 遷移](./migrate-from-the-graph.md)** 的指引，在停用日期前遷移至 [Goldsky](./goldsky.md)、[SubQuery](./subquery.md) 或自行託管的圖節點。 您的子圖程式碼將原封不動地沿用下來。 + +以下指南在服務仍運作期間供參考之用。 + +::: + ## 導言 在構建 dapp 時，獲取智能合約的歷史數據可能會令人沮喪。 [The Graph](https://thegraph.com/) 通過被稱為子圖的應用程序接口，提供了一種查詢智能合約數據的簡便方法。 圖形的基礎設施依賴於索引器的去中心化網絡，使您的 dapp 真正實現去中心化。 -Kaia Mainnet 和 Testnet 均由 The Graph 提供支持。 +The Graph 將持續支援 Kaia 主網與測試網，直至 **2026 年 8 月 31 日** 為止。 ## 快速入門