从 The Graph 迁移
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 的去中心化网络中。 - 您技术栈中的某个依赖项、仪表板或分析任务会从这些端点之一读取数据。
快速检查代码库的方法：
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 即可。
选项 1：迁移至 Goldsky
1. 获取子图的 IPFS 哈希值
请在停用日期之前，在 The Graph 上查询您现有的子图端点：
query { _meta { deployment }}
deployment 的值即为您的 IPFS 哈希值。 您还可以从 Graph Explorer 或 Subgraph Studio 中的子图页面，将其作为 部署 ID 复制下来。
请立即提取您目前拥有的每个 Kaia 子图的 IPFS 哈希值并保存下来。 在端点还能响应的时候进行数据采集要容易得多。
2. 安装并验证 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> --from-ipfs-hash <your-subgraph-ipfs-hash>
Goldsky 采用相同的子图构建方式，并从您配置的起始区块开始对 Kaia 进行索引。
如果您更倾向于从源代码仓库进行部署，请在项目目录下运行 goldsky subgraph deploy<name>/<version> —— 请参阅 子图部署。
4. 请等待同步完成，然后切换您的端点
使用以下方式跟踪进度：
goldsky subgraph list
一旦子图追上链头，请将应用中的网关 URL 替换为 Goldsky 查询端点：
- 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。
-
从 Graph Explorer 获取 部署 ID（IPFS CID），或者在本地通过 SubQuery 的 IPFS 网关生成一个：
graph build -i https://unauthipfs.subquery.network/ipfs/api/v0 -
打开 SubQuery Explorer，然后选择 发布新项目。
-
输入 CID 以及您的项目元数据，然后发布。
请注意，SubQuery Network 不支持 GraphQL 订阅。 请参阅 将您的 Subgraph 项目发布到 SubQuery 网络 和 Kaia 快速入门，或访问 SubQuery 页面查看针对 Kaia 的入门指南。
选项 3：自行托管图节点
您的子图是可移植的。 您可以自行在 Kaia 归 档 RPC 端点上运行 graph-node，并完全保留原有的映射、模式和查询。
您需要一个 Kaia RPC 端点（请参阅 公共端点 或运行 您自己的节点），此外还需要 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 开发者论坛 或 Kaia Discord 上联系我们。 如果您运行的是大型或复杂的子图，请尽早联系 Kaia 团队，以便我们协助您规划切换工作。