ABI 迁移指南
合约系统一旦投入生产，任何 ABI 层面的迁移都可能影响客户端、第三方集成与监控告警。本文以 ABI迁移指南 为主题，系统讲述跨工具链、跨编译器、跨链等典型场景下的安全迁移路径，并结合 Binance 生态项目的工程经验，给出可以直接执行的检查清单。
一、跨编译器版本迁移
升级 Solidity 编译器是最常见的迁移场景。建议先在分支上做最小升级（仅修改 pragma 与编译器版本），跑一次完整测试，再观察 ABI JSON 的 diff。重点关注 internalType、自定义 error、构造函数字段。在 币安 智能链上做主网升级前，请务必先在测试网完整回归一次。
二、跨 SDK 版本迁移
例如从 ethers v5 升级到 v6。这类迁移看似只动客户端，但 BigInt、Interface 等 API 改动会贯穿整个调用链。建议把所有依赖 ABI 的入口（链上读取、链上写入、事件订阅）逐个梳理并重写一遍。许多 B安 上的做市机器人正是因为没做这一步，在升级后出现莫名其妙的解码错误。