区块浏览器里,一个代理合约的地址、余额、持币都没变,行为却在一笔交易之后完全不同——因为真正执行逻辑的那个合约被换掉了。升级型合约是今天链上协议的主流形态,也是「已经过审计」这句话最容易被误读的地方:审计的对象是实现合约,而能换掉实现合约的是另一个权限。这篇只讲机制、槽位和一次 delegatecall 的算例。
一、delegatecall 改的是调用者自己的存储
普通 call 在对方的上下文里执行,读写对方的存储;delegatecall 把对方的代码拿到自己的上下文里执行,读写的是自己的存储。代理模式全部建立在这条规则上:代码住在实现合约,状态住在代理合约。
代价是变量错位。假设代理合约自己声明了 address public admin;,它落在 slot 0;实现合约 V1 的第一行是 uint256 public total;,也落在 slot 0。任何人调用 V1 的 setTotal(5),写进 slot 0 的值就是 5,代理的管理员当场变成一个非法地址,升级权限失效。这不是漏洞利用,是设计上的必然结果。
二、EIP-1967 把关键变量挪进哈希槽
既然按顺序分配必然撞车,标准做法就是给实现地址、管理员、信标各指定一个几乎不可能被顺序分配命中的槽位。EIP-1967 的取法是:
bytes32(uint256(keccak256("eip1967.proxy.implementation")) - 1)先哈希字符串再减一。减一在数学上并不必要(哈希结果不会恰好落在某个正常变量的槽号上),它是规范里定死的写法,好让所有人用同一个常数去读同一个格子。
| 槽名 | 哈希字符串 | 槽位常量(首尾) |
|---|---|---|
| 实现地址 | eip1967.proxy.implementation | 0x360894a1…382bbc |
| 管理员 | eip1967.proxy.admin | 0xb5312768…5d6103 |
| 信标 | eip1967.proxy.beacon | 0xa3f0ad74…133d50 |
所以核查一个代理合约不必读全部源码:用 eth_getStorageAt 取 0x3608… 这一格的 32 字节,末尾 20 字节就是实现合约地址。浏览器里的「Read as Proxy」标签做的正是这件事。
三、三种升级权限模型对照
| 模型 | 升级逻辑在哪 | 优点 | 风险 |
|---|---|---|---|
| Transparent | 代理合约内,管理员调用不转发 | 规则简单,实现合约无需改造 | 每次调用多一层判断;管理员无法调用业务函数 |
| UUPS | 实现合约内(继承并实现 _authorizeUpgrade) | 代理更小,调用省 gas | 实现合约若漏继承,部署即永久锁死 |
| Beacon | 独立信标合约 | 一次升级覆盖全部实例,适合工厂批量部署 | 信标被攻破等于所有实例同时失守 |
三种模型的共同点是:安全边界不在代码复杂度,而在「谁能让实现地址指向一个新地址」。这个动作没有人监督,就等于后台有一把万能钥匙。
四、升级后变量错位是怎么发生的
算例:V1 依次声明 totalSupply(slot 0)、balances(slot 1)、owner(slot 2)。V2 想在开头加一个 uint8 version,布局变成 version(0)、totalSupply(1)、balances(2)、owner(3)。升级后旧数据整体后移一格:totalSupply 读出来是原先映射的基准槽(一个巨大的数),按地址取余额读到的是 owner 附近的格子,全站余额显示错误。链上存储没有「迁移」这一步,写坏就是写坏,只能靠外部快照重建。
避免办法只有三条:只在末尾追加变量;删除变量时用占位数组留空(storage gap);或者改用 ERC-7201 的命名空间写法,让每组变量从各自的哈希起点开始排布。
五、动手前的五步核查
- 读 0x3608… 槽拿到实现地址,确认该地址在浏览器上已验证源码。
- 读 0xb531… 槽看管理员是谁:多签还是单个 EOA。EOA 就是单点。
- 查升级历史:有没有在毫无预告的情况下换过实现。
- 查有没有 timelock:提案到执行之间隔多久,这段时间是你唯一的撤离窗口。
- 对比新旧实现合约的变量顺序,确认只是追加,没有插入或改类型。
常见问题
不会「自动」改,但也没有任何保证。新实现合约可以读写任意存储槽,包括余额表。所以「升级不迁移状态」只说明数据还在,不说明数据没被重写。判断依据是升级前后的实现源码差异,不是项目方的口头说明。
Q2:管理员是谁真的重要吗?重要,而且这是最容易被忽略的一环。管理员如果是单个 EOA,一把私钥就能换掉全部逻辑;如果是多签,攻击成本变成 N 个签名;如果再叠加 timelock,你至少有几天时间撤离。
Q3:代理地址和实现地址,我该看哪一个?两个都要。代理地址是资金的入口、余额的归属;实现地址是当前真正跑的代码。只查代理会看不到代码被换,只查实现会不知道谁在用它。
Q4:UUPS 和 Transparent 哪个更安全?没有绝对答案。UUPS 把升级函数放在实现合约里,代理更省 gas,但实现合约写错就永久锁死;Transparent 把权限判断放在代理里,规则更直观,代价是每次调用多一层分支和更高的部署成本。选了哪种,不如查清楚谁握着那把钥匙。
相关阅读
1. EIP-1967《Standard Proxy Storage Slots》,eips.ethereum.org/EIPS/eip-1967:三个槽位常量的定义与取法。
2. OpenZeppelin Contracts 文档中 TransparentUpgradeableProxy、UUPSUpgradeable、BeaconProxy 三者的权限模型说明。
3. ERC-7201《Namespaced Storage Layout》,用于说明命名空间存储布局。
4. 以太坊 JSON-RPC 规范 eth_getStorageAt 的参数与返回格式。
本文只陈述合约机制与公开规范,不构成投资建议,也不对任何具体项目作安全性背书。