智能合约:v1 版本就要把降落伞装好
摘要
为什么可升级性、暂停开关和灾难恢复机制必须在智能合约的 v1 版本中就交付,而不是推迟到 v2——尤其是在 AI 生成代码日益普遍的背景下(Veracode 2025 年研究显示其漏洞率高达约 45%),静默失败和类似 Moonwell 预言机漏洞导致 178 万美元损失这类攻击事件正变得更加频繁。
暂无内容
查看缓存全文
缓存时间: 2026/10/10 03:28
# 在你的智能合约 v1 中就装上降落伞:为什么可升级性和灾难恢复不是 v2 功能
原文来源:https://medium.com/@giladha/ship-the-parachute-in-v1-why-upgradeability-and-disaster-recovery-are-not-v2-features-88191f35ba1c
作者:Gilad Haimov (https://medium.com/@giladha?source=post_page---byline--88191f35ba1c-----------------------------------------)
***你的 v1 智能合约在它能承受你之前,都不算完成。***
有一件事总是让我惊讶,而且随着行业向 AI 开发转型,这种情况越来越多:新团队竟如此轻易地在 v1 智能合约中省略掉可升级性和灾难恢复功能。
需要说明的是,这些功能通常都在路线图上——紧挨着审计、漏洞赏金,以及所有其他上线之后才会发生的事情。省略发生在 v1 本身,也就是真正部署到链上、接收真实存款、并率先遭到攻击的那个版本。
不难理解为什么会这样。没有代理合约、没有暂停开关、没有 owner 的 v1 合约更简单。演示效果更好。感觉更干净,更符合不可变性的精神。而当代码是由 AI 生成而非人工编写时(如今大多数年轻团队的默认做法),恢复功能是第一批消失的东西,因为它们在 happy path(正常流程)中是不可见的。一个 AI 模型生成金库合约时,会给你存款、取款和收益策略。它很少会主动提供熔断器。没有它,演示照样能跑通。
关于 AI 生成代码的数据在这里并不能让人安心。Veracode 2025 年 GenAI 研究发现,在超过 100 个模型中,大约 45% 的 AI 生成代码引入了 OWASP Top 10 中的漏洞。这不是某个边缘工具在产出垃圾。这是整个领域的平均水平,而这类任务是团队现在直接交给 AI agent 处理、连第二眼都不看的。
而且后果已经带着具体的名字和日期出现了。2026 年 2 月,Moonwell 损失了约 178 万美元,原因是预言机配置错误将 cbETH 定价为 1.12 美元而非大约 2,200 美元,暴露的头寸在大约四分钟内被抽干。一位查看了有问题的 pull request 的安全研究人员指出,它似乎由前沿 AI 模型共同编写。这是一位研究人员的公开解读,并非官方事后调查结论,模型是否真的导致了这个漏洞也不是团队外任何人能证实的。但没有争议的是事件的形态:代码看起来是对的,编译通过了,被合并了,而在人类做出决定之前,钱已经没了。这就是你的 v1 现在所要进入的环境。
快没什么问题。我每天都在自己的工作中使用 AI。但它提高了一个决定的赌注——这个决定在部署时几乎零成本,之后几乎不可能更改:你的 v1 是否能在出问题时(不是"如果"出问题时)被修复、暂停或回滚。
## 那些墓碑
在选择不可变的 v1 之前,每个创始人都应该了解的几个故事。
**Parity,2017 年。** 一位用户初始化了 Parity 多签钱包背后的共享库合约,然后触发了它的自毁。每一个依赖该库的钱包瞬间冻结。587 个钱包中的 513,774 ETH 被锁住——不是被偷走,只是永远无法访问了,但从所有者角度来看,这是一回事。一份恢复资金的提案(EIP-999)被提交给社区,但从未被采纳。那些钱至今仍然冻结着。没有暂停,没有升级路径,没有恢复函数。没有人能争论什么,因为没有人能做任何事。
**The DAO,2016 年。** The DAO 因其 split 函数中的重入漏洞损失了约 360 万 ETH,当时价值约 6000 万美元。它同样没有暂停和升级机制。唯一可用的恢复方式是将整个 Ethereum 区块链一分为二,这就是 ETH 和 ETC 的由来。当你的灾难恢复计划需要硬分叉底层区块链时,你就没有灾难恢复计划。
**Audius,2022 年。** 这个案例值得仔细理解,因为通常的叙述是错误的。它并非只是忘记了一个存储间隙那么简单。Audius 使用了一个自定义的可升级代理合约,其 admin 地址存放在存储槽 0——与 OpenZeppelin 的 `Initializable` 用于初始化标志的槽位相同。这个冲突使初始化守卫被误读为已满足,合约可以被重新初始化,攻击者随后将大量治理代币委托给自己,并通过了一个恶意提案。约 1856 万 AUDIO 离开了国库,据报道价值约 600 万美元。此前的两次审计都未能发现这个槽位冲突。教训不是"加一个间隙"。教训是:代理合约下的存储布局是承重结构,而且它会静默失败。
**Kinto,2025 年。** 一次漏洞利用抽走了约 155 万美元——与这份名单上的其他案例相比是个小数目。Kinto 在几周内就关停了。这就是创始人低估的部分:一个协议不需要九位数的损失才会死。它需要的是一个它无法承受、无法解释、也无法恢复的损失,而且在它拥有足够的资产负债表或足够的信任来经受一次这样的损失之前到来。可恢复性不仅仅是关于把钱拿回来。而是关于在糟糕的一周之后,你还能拥有一家公司。
我曾为一条 L1 编写过创世合约,也在活跃的 EVM 主网上执行过协议升级,交易的另一端是真实的价值。创世是 v1 的最纯粹形态:没有之前的版本,没有迁移,不需要与用户协调,你在区块 0 中内置的任何东西,整个网络都会继承。没有一个运营过活跃协议的人会故意发布不可变的 v1。你会学到——仅仅一次——知道一个错误无法撤销是什么感觉,然后你再也不会把那种感觉设计进系统里了。
## v1 检查清单
以下是我不会在没有它的情况下发布的项目。每一项在部署时都很便宜。大多数无法事后补装。
> 我强烈建议你的团队要么在 v1 中实现所有这些功能,要么有一个非常好的理由不这样做。
### 1. 从第一天起就可升级,使用 UUPS,且 owner 就是升级者
使用代理合约。具体来说,使用 UUPS(ERC-1822),除非你有具体的理由不这么做。
UUPS 将代理合约保持为最小的 ERC-1967 外壳,把升级逻辑放在实现合约中——你的访问控制已经在那里了。不需要单独部署、注资和跟踪一个 ProxyAdmin 合约,也不需要在 admin 选择器和用户选择器之间做区分和推理。OpenZeppelin 已经将其官方推荐转向了这一方向:其当前文档将 UUPS 描述为轻量、多用途的默认选择,并指出 Transparent 模式将 admin 逻辑放在代理合约中,部署成本更高。我在这里会跳过你们可能会看到引用的每次调用的具体 gas 数字,因为它们依赖于不断变化的库版本,而且与当前 Transparent 代理相比,每次调用的差异比传说中要小。优先选择 UUPS 的持久理由是更小的部署足迹和信任面中少一个合约。
还有一个大多数团队会错过的选项。因为升级函数在实现合约中,后续版本可以将其移除,合约在赢得稳定性之后可以主动选择变得不可变,而不是在第一天就因意外而不可变。把移除当作一个刻意的、最终的行为。误发布这个移除,你就再也不能升级合约了。这与资金冻结的灾难不同——业务逻辑还在运行——但这是一个没有存在理由的自设死胡同。
简要介绍两个竞争者。Transparent 代理仍然可用,是一个合理的选择。Diamond(ERC-2535)对于超出合约大小限制的系统来说确实强大,但那是一大套机制和审计面,很少是一个小团队的正确 v1 选择。当一次升级需要同时作用于多个相同合约时,Beacon 代理才有意义——而这种共享的爆炸半径也正是它们的风险。
现在是团队容易搞错的部分。在 UUPS 中,整个系统的入口是一个函数:
```
function _authorizeUpgrade(address newImplementation) internal override onlyOwner {}
```
强制升级权限就是 owner 地址。不是一台开发者笔记本上的单独升级密钥,不是某个没人记得分配过的地址,不是测试期间授予且从未撤销的角色。拥有合约的地址就是能够升级它的地址:一套用多签和时间锁来保护的密钥,一个一旦被攻破就已是你最坏情况的地址,这样升级路径本身不会引入新的最坏情况。你发明的每一个额外特权地址,都是一把可能丢失、泄露、或被离职人员留下的额外密钥。直白地说,v1 不应该有两个神。
另外两条不可选的 UUPS 规则:
- 永远不要发布一个移除或破坏升级函数的升级,除非那是上面提到的刻意的最终步骤。OpenZeppelin 的工具链有兼容性检查,可以捕捉大多数这种情况;保持它们开启。
- 在主网之前,在分叉上测试升级路径。一个从未被实践过的升级机制是一个假设,不是一个能力。
### 2. 构造函数陷阱:在可升级合约中,构造函数不会运行
这一条值得单独一节,因为它会产生一种特定的、可复现的、静默的 bug,而生成的代码不断地踩进去。
当你部署一个可升级合约时,存在两个不同的东西:实现合约(部署一次)和代理合约(持有状态,用户实际交互的对象)。构造函数只运行一次——在实现合约上,针对实现合约自己的存储运行。它永远不会为代理合约运行。你在构造函数中写的每一行初始化代码——分配 owner、链接依赖、记录配置值——都发生在没人使用的存储中,而代理合约从诞生起就全部未初始化。
这就是为什么可升级合约通过一个由 `initializer` 修饰符保护的 `initialize()` 函数来进行初始化:它是普通的函数代码,通过代理合约执行,写入代理合约的存储。
现在是那个连谨慎开发者都会中招的部分:内联变量初始化是构造函数代码。当你写
```
uint256 public feeBps = 250;
```
编译器会把这条赋值放进构造函数。在普通合约中它工作正常,读起来是干净、地道的 Solidity——这正是模型如此可靠地生成它的原因,因为它们的训练样本大多是普通合约。而在代理合约后面,`feeBps` 读出来是 0,直到 `initialize()` 设置它,没有任何 revert,没有任何警告,演示中看起来一切正常。你的费用静默地变成了零。或者你的国库变成了零地址。或者你的上限变成了无限。唯一的部分例外是 `immutable` 变量——它们在字节码中而非存储中,确实会通过代理合约保留。它们对真正的常量来说没问题,但对任何每次部署都需要不同的值来说毫无用处。
规则集简短到可以在代码审查中强制执行:
- 在可升级实现中,构造函数只包含一样东西:`_disableInitializers()`。这个调用锁定实现合约,防止有人直接初始化它并夺取控制权——这个漏洞在 2021 年使 KeeperDAO 和 Rivermen 的真实资金陷入风险,在 2022 年让一位 Wormhole 研究人员因一个未初始化的实现合约获得了 1000 万美元赏金,当时有史以来最高。注意这个调用**不做**什么:它不会初始化你的代理合约。锁定实现合约和初始化代理合约是两件事,把它们当作一件事就是未初始化代理事故不断重演的原因。
- 所有真正的初始化都在 `initialize()` 中,由 `initializer` 修饰符保护,显式设置每一个变量,包括那些有明显默认值的变量。
- 可升级代码库中构造函数里的任何非平凡逻辑——连接合约、初始化状态、授权 spender——都是代码审查中的阻断性问题。没有例外。
### 3. 存储纪律:间隙,或命名空间存储
可升级合约在所有版本之间共享一个存储布局。如果一个基类合约在 v2 中新增了一个变量,其下方的每个变量都会偏移,新实现会在原本存放用户余额的地方读到垃圾数据。这种失败模式是静默的。没有 revert,只有错误的数据。它与上面 Audius 的冲突属于同一类问题。
经典的防御方式是在每个可升级基类合约末尾保留一个间隙:
```
uint256[50] private __gap;
```
在 v2 中新增变量时,将间隙缩小相应的槽数。现代替代方案是 ERC-7201 命名空间存储,这也是 OpenZeppelin Contracts v5 为其可升级变体所使用的方案:每个模块将其状态保存在自己计算出的位置,因此模块间的冲突在结构上不太可能发生。两种纪律都可以工作,精心管理的只追加布局甚至可以在没有预留间隙的情况下保持兼容。行不通的是没有纪律然后寄希望于运气。第一天就选定一种方案,在代码审查中强制执行,并在 CI 中添加存储布局检查,这样破坏布局的 pull request 会在构建阶段失败,而不是在主网上失败。
### 4. 所有权变更:永远两步走
如果这份清单上有一项我要纹在部署清单上的,那就是这一项,因为它拆除了所有权变更中最不可逆的那个错误。
一步式所有权转移在同一笔交易中就是最终的。如果新地址中有拼写错误、属于错误的网络、是一个无法签名的合约、或者只是一个没人持有密钥的地址,转移仍然会成功。旧 owner 消失了,新 owner 在任何实际意义上都不存在了,这一页上的所有能力都随着那一笔误操作的交易一起死亡:无法升级、无法暂停、无法救援、无法更改参数,永远如此。协议继续运行,带着用户资金,但管理员的位子上空无一人。这是自设的 Parity 冻结,浓缩在一行代码中。
两步所有权(OpenZeppelin 的 `Ownable2Step`)消除了这一类失败。当前 owner 提名一个新 owner。什么都没有改变。然后新地址必须从新地址主动接受所有权,证明它存在、被人控制、并能签名。只有到那时转移才完成。一个错误的提名变成了一次可以恢复的尴尬,而不是永久的损失。代价是多一笔交易。
诚实地说说它做不到的事。两步所有权保护你不会把控制权交给一个没人持有的地址。它对被攻破的 owner 密钥毫无作用:持有该密钥的攻击者可以自己提名自己并接受,全程内部操作。它是防误操作的保险,不是防盗窃的保险。密钥泄露后的生存能力是另一个设计,是下一项内容。
相关且更简单的一点:永远不要在活跃的 v1 上调用 `renounceOwnership`。放弃所有权被包装成去中心化和终局性。在 v1 阶段,它实际上是扔掉降落伞来证明你信任飞机。
### 5. 每个特权地址都必须可替换
在真实系统中,所有权不是唯一的特权地址。有可以暂停的 guardian、提供价格的 oracle、接收费用的 treasury,可能还有 keeper 或 strategist 角色。这些地址中的每一个都必须能被 owner 更换,因为地址有两种失败方式:密钥被攻破,和密钥丢失。
对一个不可更改的地址推演一下场景。一个被攻破的 guardian 密钥意味着攻击者可以永远在任何时候暂停你的协议——一个你无法修复的永久拒绝服务。仅仅丢失密钥——无人之过、毫无恶意——也会在 admin 层面产生 Parity 式的结果:能力在纸面上存在,但永远无法再被行使。
所以规则是机械式的:合约视为特权的任何地址都有一个 setter,setter 仅限 owner 调用,setter 发出事件(第 8 项),而且对于 owner 来说……
相似文章
契约式 AI 治理中没人谈论的问题:开发者随时可以修改契约,而没有任何东西能察觉到这一点。
# 为 AI 智能体构建运行时治理层 一位开发者描述了他为 AI 智能体构建的运行时治理层:通过**密码学密封**(cryptographic sealing)与**仅追加的版本注册表**(append-only version registry)来固定契约的不可变性;通过程序化声明,支持无契约的动态生成智能体;并在此之上加入**凭据网关**(credential gateway)与 **CI lint**,作为第三道强制约束防线。
AI代理终于解决了智能合约从未能解决的问题——争议解决和灰色地带条款
AI代理现在可以解读智能合约中的模糊条款,使微交易的争议解决成为可能,并将智能合约扩展到僵化的if/then逻辑之外。
我们不断看到AI代理意外地修改或部署真实基础设施——你希望在实际故障发生前捕捉到哪种具体失败?
本文强调了AI代理无意中修改或部署真实基础设施这一反复出现的问题,并引发了一场关于应在故障发生前捕捉哪些类型失败的讨论。
一个AI文档生成器为客户节省了数小时,直到它悄然添加了一个条款
AI文档生成器为小机构自动化了合同创建,但产生了一个幻觉条款,这导致了一个解决方案:将关键部分从AI生成中隔离出来,以防止错误。
@VitalikButerin: 许多人声称,在AI辅助的漏洞查找下,安全的代码(因而任何无需信任的东西)将是不可能的…
Vitalik Buterin分享了一个乐观的看法,认为AI辅助的形式化验证是实现安全、无需信任的代码的途径,并链接到他的博客文章,该文章解释了使用Lean进行形式化验证的基础知识。