從 The Graph 遷移
The Graph 對 Kaia 的支援已於 2026 年 8 月 31 日 結束。 Kaia 子圖不再被索引，其查詢端點不再返回 Kaia 資料，且 Kaia 已不再是 Subgraph Studio 中可部署的網路。
如果您的 dapp 仍指向 The Graph 上的 Kaia 子圖，請將其移至 Goldsky、SubQuery 或自建的圖節點。您的子圖程式碼將原封不動地沿用。
發生了什麼事
The Graph 已停止對 Kaia 的支援。這僅影響託管索引服務。
| 2026年8月31日 | Kaia 子圖已停止建立索引。對 The Graph 閘道器的查詢端點已停止回傳 Kaia 資料。 |
| 現在 | Kaia 已不再是 Subgraph Studio 中可部署的網路。 Kaia 的 graph deploy 失敗。 |
鏈上內容並無任何變更。 Kaia 主網 (8217) 與 Kairos 測試網 (1001)、您的合約以及完整的事件歷史紀錄均不受影響。任何讀取 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 的去中心化網路。 - 您技術堆疊中的某個依賴項、儀表板或分析工作會從這些端點之一讀取資料。
快速檢查您的程式碼庫的方法：
grep -rn "thegraph.com" --include="*.ts" --include="*.js" --include="*.json" --include="*.env*" .
若符合上述任一情況，這些查詢便已失敗。執行遷移後，服務即恢復正常。
如果您是透過 Goldsky、SubQuery、自建的圖資料庫節點來索引 Kaia，或是直接讀取 Kaia RPC 端點，則您不會受到影響。
選擇其他選項
以下這三個選項均將 Kaia 主網和 Kairos 納入指數。
| Goldsky | SubQuery | 自行託管的圖節點 | |
|---|---|---|---|
| 執行現有的子圖 | 是的——子圖規格相同 | 是的 — 透過 IPFS 部署 ID | 是的——它 確實 是圖節點 |
| 遷徙行動 | 一個 CLI 指令 | 發佈現有的建置 | 自行部署基礎架構 |
| 主機服務 | 受管理 | 受管理或去中心化的網路 | 由您來操作 |
| 另提供 | 鏡像（串流至您的資料庫）、RPC、管線 | 單一專案中的多鏈索引 | 完全掌控 |
| 最適合 | 最快的即插即用替換方案 | 多鏈專案、去中心化託管 | 希望避免依賴供應商的團隊 |
若您想要最簡便的解決方案，請使用 Goldsky。 Goldsky 完全相容於 The Graph 的子圖規格，因此現有的 Kaia 子圖可直接遷移過來，無需變更您的映射、資料結構或查詢——僅需變更應用程式中的端點 URL 即可。
關於 The Graph 的遷移指南，通常會從讀取您子圖的部署哈希值開始，該哈希值可從其即時查詢端點取得。對於 Kaia 子圖而言，這已不再可行，因為那些端點已停止回應。
請改從您的子圖原始碼儲存庫進行部署。它無需部署 ID，能產生完全相同的建置結果，目前是值得信賴的解決方案。僅在您先前已儲存過 IPFS 哈希值，或仍可從 Graph Explorer 中的子圖頁面或 Subgraph Studio 讀取該哈希值時，才改用 IPFS 哈希值。
選項 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>
2. 從原始碼部署子圖
在您的 subgraph 專案目錄中：
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 歷史記錄的索引需要時間——請預先規劃，而非期待能立即切換。一旦子圖追上鏈頭，請在您的應用程式中替換閘道網址：
- 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 Network 以及 Kaia 快速入門，或瀏覽 SubQuery 頁面，以取得針對 Kaia 的專屬入門指南。
選項 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 之所以是最快的即插即用方案，是因為它採用單指令遷移，但 SubQuery 和自架設的 GraphNode 同樣是可行的選擇。選擇最適合您技術堆疊的方案。
我需要遷移方面的協助。 請透過 Kaia 開發者論壇 或 Kaia Discord 聯繫我們。如果您正在運作一個大型或複雜的子圖，請聯絡 Kaia 團隊，以便我們協助您規劃切換作業。