用途:将 QuickNode 客户端、端点、代币、链 API 与事件管道的变更视为合约迁移,在目标被证明具备身份一致性、正确性、容量和恢复能力前,保留并行读取路径或重放边界。
前提条件:掌握当前与目标的 SDK、端点、链/网络及产品清单;具备兼容性测试与代表性流量;明确切量负责人、回滚窗口和数据对账计划。
主要步骤:1) 用 Read、Grep 建立变更矩阵,找出 SDK 导入、端点 URL、API 方法、协议、链 ID、归档假设、代币、Stream/Webhook ID、游标和平台目标。2) 核对目标 SDK 平台矩阵、产品 API、链弃用情况、支持的协议、剪枝策略和方法响应,不要用无关链的快速入门推断兼容性。3) 用 Bash(npm:) 做已审查的固定版本 SDK 更新和锁文件变更,用 Write/Edit 在稳定接口后适配、加入双读比较并保留旧配置以便回滚。4) 用 Bash(qn:) 只读检查当前/目标端点、安全、用量、指标、Stream 和 Webhook 状态,仅在明确操作检查点后再创建或变更资源。5) 金丝雀与对账:比较链身份、响应语义、延迟、错误、额度、交易状态和事件完整性;事件迁移从重叠区块开始,按持久事件身份去重。6) 切量与退役:逐步切换流量,在回滚窗口内保留旧端点/代币,取得证据与负责人批准后再注销或归档,并记录弃用与消费方通知。
认证:双跑期间目标凭据与当前路径分开保存。端点代币通过受保护 URL 或 x-token 头认证 RPC;Admin API 检查使用独立的 x-api-key;qn 使用其已认证的账户会话。三者都需在矩阵和回执中脱敏。
错误处理:目标运行时无法加载 SDK 时停止并重查原生平台矩阵;双读不一致先分类语义、新鲜度或链差异;事件缺失时从重叠游标恢复并去重;回滚凭据被注销时停止发布并恢复经测试的恢复身份。
限制:资料未提供具体定价、SLA、支持链完整清单及 QuickNode 官方文档链接,相关事实暂未提供。