合约升级事件应该监控哪些字段
监控代理合约的升级事件，核心关注四个字段：新实现地址（implementation）、旧实现地址（previousImplementation）、触发者（upgrader/triggeredBy）、交易哈希（transactionHash）。这四个字段能告诉你"谁在什么时候把合约逻辑换成了什么"。2026年3月Etherscan上线了"历史代理"标签页，专门汇总这些信息。
步骤1：找到升级事件的标准化格式——EIP-1967
做什么：确认你监控的合约遵循哪个升级标准，以此确定需要抓取哪些事件。
怎么做：
绝大多数代理合约遵循EIP-1967标准，会统一发出
Upgraded(address indexed implementation)事件。透明代理（Transparent Proxy）还会发出
AdminChanged(address previousAdmin, address newAdmin)事件，记录管理员变更。管理员换了，意味着未来可能有人用新管理员权限执行升级。如果项目使用Beacon代理模式，事件是
BeaconUpgraded(address indexed beacon)，记录的是信标地址变化，而不是实现地址本身。
做到什么程度算完成：你确认了目标合约的代理类型（透明代理/信标代理/其他），知道应该看哪个事件名称。
步骤2：监控升级事件的四个核心字段
做什么：从升级事件日志中提取关键字段并记录。
怎么做：升级事件中，以下四个字段是必须记录和分析的：
| 字段 | 含义 | 为什么重要 |
|---|---|---|
implementation / in_beacon | 新的实现合约地址 | 这是升级后逻辑所在的位置——新代码是否经过验证、是否已知安全 |
previousImplementation（如有） | 旧的实现合约地址 | 用于追踪版本变更路径，判断升级是"演进"还是"替换" |
transaction_hash | 执行升级的那笔交易 | 可以通过交易追溯具体操作人、Gas消耗和更多上下文 |
block_timestamp + block_number | 升级发生的时间和区块 | 判断升级发生的时间窗口，便于关联其他链上或链下事件 |
Range Docs中列出了代理升级监控的规则：检测到ERC-1967代理升级事件时触发，记录代理指向的新实现代码。
做到什么程度算完成：你能从一次升级事件中准确提取出这四个字段。
关键提醒：升级事件中，Upgraded事件只包含"新地址"，不包含"旧地址"。要获取旧地址，需要回查代理合约的implementation()存储槽，或者在事件发生前记录状态快照。部分高级监控系统会在升级前后分别读取存储槽来对比。
步骤3：利用Etherscan的"历史代理"功能批量查看
做什么：2026年3月Etherscan上线了新功能，可以直接查看代理合约的完整升级历史，无需手动翻日志。
怎么做：
在Etherscan上打开目标代理合约的详情页。
找到新增的"Historical Proxy"标签页，点击进入。
页面会自动汇总该合约的所有升级记录，包括每次升级的实现地址和对应的交易哈希。
Etherscan已支持自动识别代理合约，大多数情况下无需手动确认。
做到什么程度算完成：你通过Etherscan的汇总视图拿到了该合约的完整升级历史列表。
步骤4：监控管理员（Admin）变更作为前置预警
做什么：升级的前置条件是管理员权限变更。监控管理员地址变化，比监控升级本身更早发现风险。
怎么做：
透明代理的
AdminChanged事件记录了管理员从谁变成了谁。如果管理员地址从多签钱包变成了一个普通EOA地址，或者变成了0x00...，这是高危信号。
对于
ProxyAdmin合约，需要监控OwnershipTransferred事件，它记录了谁有权调用upgrade方法。Range Docs也将"代理管理员变更"列为独立监控规则，与"代理升级"同等重要。
做到什么程度算完成：你确认了当前管理员地址，并已建立管理员变更的监控规则。
前置条件
在开始监控前，确认你已获取目标代理合约地址。如果使用Etherscan的"Historical Proxy"功能，无需任何额外工具，直接访问浏览器即可。如果使用链上监听工具（如Range、Dune等），需要确保已为对应链配置了事件监听。
常见失败原因
只看
Upgraded事件，忽略了AdminChanged：管理员换人后新管理员可能在未来某个时间点升级。管理员变更本身不是升级，但往往是升级的前奏，优先级同样高。混淆了代理实现升级和合约参数变更：很多项目会通过调用合约方法改变参数，这与"升级逻辑代码"是两回事。参数变更不会触发
Upgraded事件，需要用其他规则监控。未处理Beacon代理的升级逻辑：Beacon代理的升级事件是
BeaconUpgraded，记录的是信标地址变化，而非实现地址本身。需要从信标合约再读取当前实现地址。
风险提醒
资金风险：如果合约升级事件没有被及时监控，项目方可能在用户不知情的情况下将逻辑替换为恶意版本，导致资产被盗或冻结。Range Docs将此列为"接管和rug-pull最相关的事件"之一。
账户风险：无直接账户风险，但如果你是该合约的授权用户，升级后的新逻辑可能改变你的权限状态。
合规风险：无。
确认你已经正确完成的标志：你已成功从升级事件中提取了implementation、transaction_hash和时间戳。如果使用Etherscan的"Historical Proxy"标签，你已能看到该合约的完整升级历史列表。下一步：建议同时建立管理员变更的监控规则——新管理员换人比升级本身更值得警惕，因为那是控制升级权限的人换了。
