SuperAPI AI 工具集

alchemy-upgrade-migration

通用与其它

查看项目

更新于 10-15 22:42

技能介绍

用途:把已弃用并归档的 alchemy-sdk、alchemy-web3 等集成,迁移到当前按能力拆分的客户端。前提是取得所选产品、链、功能、客户端、认证方式、限制与生命周期的第一方最新文档,并明确产品、应用、安全、数据隐私、预算、发布与运维负责人,以及合成或已批准的非生产夹具、凭证金丝雀、成功标准和经过测试的回滚边界。

当前契约:alchemy-sdk 已弃用且仓库归档。迁移目标按能力区分:JavaScript EVM RPC 用 viem;已文档化的 Data API 用直接适配器;交易类应用与 Portfolio 支持用 @alchemy/wallet-apis;Solana 用 Solana Web3.js。Wallet APIs v5 另有独立的第一方迁移指南,v4 使用者需单独遵循。

主要做法:冻结依赖锁,按能力与副作用清点 alchemy-sdk、alchemy-web3、endpoint、namespace、WebSocket、Notify、Data API、Wallet 与签名器的使用;将 EVM RPC 路由到 viem,产品 HTTP 调用路由到类型化适配器,交易与 Portfolio 路由到 Wallet APIs v5(适用时),Solana 路由到 Solana Web3.js。为值、分页、部分错误、可重试性、链标识、订阅与交易意图定义归一化对等契约,并保留原始差异证据。只读路径用夹具与双读比对;交易路径用模拟/测试网并需显式授权。逐个能力金丝雀发布,设定停止阈值并保留旧产物可部署,只有对等与负路径通过后才移除废弃导入。

限制与边界:不使用隐藏产品差异的通用包装器;不把分页、部分错误、最终性或数值语义差异当作外观对等;金丝雀触发正确性、完整性、延迟、错误或支出阈值时回退旧产物。技能调用本身不授权网络访问、凭证、钱包地址、客户数据、计划变更、支出、密钥创建或轮换、Webhook 变更、部署、重放、交易构造、签名、广播或删除,仅按已批准范围使用 Read、Glob、Grep 及 Write、Edit。需架构、安全、发布/产品分别批准路由、凭证与签名边界、金丝雀与归一化差异,生产交易迁移还需钱包策略批准。输出包括旧调用清单、目标路由、凭证差异、对等模式、夹具/双读证据、金丝雀阈值、废弃导入门禁、发布序列、未解决差异与回滚凭证,并明确标注假设、观察、来源日期、环境特定行为、负责人与未解决缺口。