The Graph旧端点失效:核BNB/Polygon发布状态、Gateway与权限
链小知 · 进阶 · 核验 · 依官方文档整理
用已有子图记录区分Studio部署、Network发布、Indexer同步和Gateway认证,排查staging迁移影响。
开始前准备
- 准备已有脱敏配置、错误或回执记录,保留网络、对象身份、版本及时间;缺项标待核。
- 仅阅读公开文档和已有记录,不登录、安装、调用RPC/API、获取报价、签名、部署、转账或重试业务。
1. 确认受影响的是staging查询
官方9月24日安排在2026年10月8日结束BNB Smart Chain和Polygon的Studio staging查询;其他网络后续安排不能自行补日期。Studio仍用于版本、发布、付款和API key管理,并非整个Studio关闭。
已有Network发布并通过Network查询的子图不因这一安排需要重发。先按原端点区分Studio staging或Gateway,保留原网络与失效时间,日历过了不等于已验证全网切换成功。
检查结果:受影响网络、端点类型和实际故障记录分列。
2. 区分部署、发布和正在服务的版本
部署到Studio供测试与发布到Network是不同阶段。发布让Curator/Indexer能够开始发现和同步,不自动证明目标部署已索引至应用所需区块。
核原Subgraph ID、具体部署/版本、发布记录及Explorer已有状态。文档说更新metadata不会创建新部署版本;不能把标题更新当索引修复。本教程不发布、连接钱包或支付curation。
检查结果:Studio部署、Network发布、metadata与实际部署版本分别有记录。
3. 对照Gateway身份与有效密钥
官方Gateway格式含API key及Subgraph ID,也支持Bearer方式。仅核已有脱敏端点结构和密钥关联;完整URL可能暴露密钥,不写入共享日志或截图。
密钥重新生成会立即使旧key失效。根据已有状态确认是不是端点已换而应用仍引用旧key,不为排查重新生成或尝试请求。
检查结果:正确Subgraph ID、端点种类与原key状态可追溯,凭据已脱敏。
4. 把付款和权限条件与索引同步分开
迁移安排要求配置billing与API key。原key记录可核按日历月的可选USD消费限额、授权域名和允许子图列表;额度或权限缺项不能当成子图没数据。
Foundation声明会为符合范围的新发布子图使用自动curation bot,但这不保证每个部署在某个时点已有Indexer同步。发布材料对奖励资格和curation还有条件;不把通用旧Upgrade Indexer表述当所有迁移实例服务保证。
检查结果:billing/key权限、Network发布与Indexer服务/区块进度各自有证据或待核。
5. 按已有响应和版本判断恢复
将原失败分类为旧staging端点、无Network发布、key失效/权限或消费条件、Indexer同步不足;没有原错误及状态时保持原因未知。
恢复应对应正确Network部署、授权端点与已有成功响应,并再核应用所需区块/实体是否满足;官方迁移目标是连续服务,不等于个人应用已被本教程验证恢复。
检查结果:能指出缺失环节,未用发布成功或域名可打开代替查询恢复。
怎样确认完成
- 形成条件、费用、执行阶段与未证实项的核对记录。
- 本教程仅documentation;未验收实际配置、服务可用性或资金交付。
常见错误与边界
- 协议发布所在Arbitrum网络与所索引BNB/Polygon资产网络不同,不能只按发布链判断数据来源。
- 本教程处理端点迁移;实体schema、区块新鲜度和分页仍需按原查询范围核。