合约搬家实战：协议迁移的盘点、撤授权、转换与留档清单

协议升级公告里出现一个新地址，旧地址宣布弃用，你的 LP 仓位、待领奖励和授权还挂在旧的上面。合约迁移是每个长期持有 DeFi 仓位的人迟早要遇到的流程，本文把搬家的标准动作、可跳过的环节和容易漏项的位置列成一条完整动线。

搬家前先确认迁移的类型，因为动作差异很大。第一种是单向迁移：旧合约冻结新增功能但保留取款，官方提供一键迁移工具，把旧仓位的等值资产按比率存入新合约。第二种是并行期：新旧市场同时开放，利率和参数可能有差异，用户自行选择去向，通常旧市场被逐步调低参数以引导转移。第三种最麻烦：只公告不工具，需要用户手动从旧协议取出、再手动存入新协议，全程两步都不是原子的，中间存在一段裸奔窗口。确定类型只看两处：官方文档的迁移专页和旧合约的事件日志，别依据群聊里的转述。

清单化的第一步是盘点挂单项。LP 仓位本体、未领取的手续费、锁在挖矿合约里的奖励凭证、还在生效的授权、被借贷市场引用的抵押状态、自动复投合约的委托关系——每一项都是独立资产或独立敞口，迁移工具一键带走的比例，往往没有想象的那么高。逐项截图留档，因为旧界面在切换后可能随时下线，届时你连补领入口都找不到。

第二步处理顺序上有一个原则：先解除风险，再搬运资产。旧授权里的大额无限授权应在旧市场退役前先撤，留在一个未来可能带漏洞的合约上的授权，是迁移期最容易被忽视的敞口。待领奖励在旧合约仍可用时先全部领出，迁移工具通常只搬本金，不会替你完成领取动作。仓位类资产走官方迁移通道优先于手动拆仓，因为手动退出会按当前池子状态承受一次滑点，官方迁移多数按记账比率转换，绕开了这笔摩擦。

第三步在新地址重新落地时的核验，和普通新建仓位没有区别但常被省略：新合约地址逐字符核对，新市场的参数逐项对照迁移说明，新授权只给刚好够用的额度。特别留意迁移说明里对小数的处理——新旧合约的精度、计价口径偶有调整，跨合约的等额不等于等价，转换比率的解释段落要看原文而不是摘要。

最后留一份迁移后的复盘文档：每一笔的原始交易哈希、迁移交易哈希、新地址，按资产分栏。迁移期常见的领不到、看不见余额这类问题，绝大多数靠原始哈希能在几个小时内定位，没有这份表就会变成好几天的悬案。

合约迁移同时是一次风险再定价的提示：旧合约的审计报告、历史漏洞记录不一定自动适用于新代码，新合约有没有独立审计、权限模型是否改变，应当在搬之前而不是搬之后看。

迁移收尾时做一次双向复盘：把旧地址的最后几笔交易哈希逐条存档，确认没有遗漏的领取动作；把新地址的初始交互记录与迁移说明逐项对照，确认余额、授权、参数三项全部符合预期。多数迁移事故的损失都不大，真正的问题是信息断代——三个月后旧界面下线，没人记得当初转了多少、转换比率当时怎么解释。花十分钟整理这份档案，等于给未来某个紧张的深夜买了一份保险，也是对一整套旧合约最体面的告别方式。

本文为仓位迁移流程与自查清单，不构成投资建议；具体迁移方案以协议官方公告与合约核验为准。