用途:把 The Graph(托管服务、Subgraph Studio 或去中心化网络)上的 subgraph 迁移到 Goldsky,属于 drop-in 替换,无需修改 subgraph 代码。迁移前可先判断是否真的需要 subgraph:若目标只是把数据导入数据库做分析或后端,Turbo pipeline 可能更合适;若确实需要托管 GraphQL API,再继续迁移。
主要能力:支持三种迁移路径——从公开 GraphQL 端点(--from-url)、从 IPFS 哈希/部署 ID(--from-ipfs-hash)、或从本地源码(--path,需先构建)。部署后可创建 tag 固定稳定别名(如 prod),使前端 URL 在重新部署时保持不变。
使用方式:先获取真实来源标识,不要猜测或构造 api.thegraph.com 等 URL;IPFS 哈希可通过查询 { _meta { deployment } } 获得。安装 CLI 并登录(goldsky login,Windows 用 WSL),用 goldsky project list 验证。部署命令如 goldsky subgraph deploy my-subgraph/1.0.0 --from-url <endpoint>。用 goldsky subgraph list 和 _meta 查询确认同步进度,再创建 tag 并切换应用端点。
适用场景:需要把现有 subgraph 从 The Graph 迁到 Goldsky 并继续提供 GraphQL 查询的 dApp。
限制:不得编造来源 URL 或 IPFS 哈希;不得报价或声称免费/便宜,费用问题应联系 support@goldsky.com 或销售。常见问题包括 apiVersion 不一致、接口未定义、链 slug 不同、版本已存在、IPFS 超时(524)等,可交由 /subgraph-doctor 处理。从 Alchemy 迁移不在本技能范围。