升级一次就换掉整套逻辑:EIP-1967 的三个存储槽与一次 delegatecall 算例

区块浏览器里,一个代理合约的地址、余额、持币都没变,行为却在一笔交易之后完全不同——因为真正执行逻辑的那个合约被换掉了。升级型合约是今天链上协议的主流形态,也是「已经过审计」这句话最容易被误读的地方:审计的对象是实现合约,而能换掉实现合约的是另一个权限。这篇只讲机制、槽位和一次 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.implementation0x360894a1…382bbc
管理员eip1967.proxy.admin0xb5312768…5d6103
信标eip1967.proxy.beacon0xa3f0ad74…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 的命名空间写法,让每组变量从各自的哈希起点开始排布。

五、动手前的五步核查

  1. 读 0x3608… 槽拿到实现地址,确认该地址在浏览器上已验证源码。
  2. 读 0xb531… 槽看管理员是谁:多签还是单个 EOA。EOA 就是单点。
  3. 查升级历史:有没有在毫无预告的情况下换过实现。
  4. 查有没有 timelock:提案到执行之间隔多久,这段时间是你唯一的撤离窗口。
  5. 对比新旧实现合约的变量顺序,确认只是追加,没有插入或改类型。
如果你持有的代币或 LP 依赖某个可升级合约,把「谁能升级」当成和「合约有没有漏洞」同等重要的问题。审计报告回答不了前者。

常见问题

Q1:升级会不会直接把我的余额改掉?

不会「自动」改,但也没有任何保证。新实现合约可以读写任意存储槽,包括余额表。所以「升级不迁移状态」只说明数据还在,不说明数据没被重写。判断依据是升级前后的实现源码差异,不是项目方的口头说明。

Q2:管理员是谁真的重要吗?

重要,而且这是最容易被忽略的一环。管理员如果是单个 EOA,一把私钥就能换掉全部逻辑;如果是多签,攻击成本变成 N 个签名;如果再叠加 timelock,你至少有几天时间撤离。

Q3:代理地址和实现地址,我该看哪一个?

两个都要。代理地址是资金的入口、余额的归属;实现地址是当前真正跑的代码。只查代理会看不到代码被换,只查实现会不知道谁在用它。

Q4:UUPS 和 Transparent 哪个更安全?

没有绝对答案。UUPS 把升级函数放在实现合约里,代理更省 gas,但实现合约写错就永久锁死;Transparent 把权限判断放在代理里,规则更直观,代价是每次调用多一层分支和更高的部署成本。选了哪种,不如查清楚谁握着那把钥匙。

相关阅读

来源与口径(访问日期 2026-10-27)
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 的参数与返回格式。
本文只陈述合约机制与公开规范,不构成投资建议,也不对任何具体项目作安全性背书。
安装 App