← COMP5565 全部讲次
L04a-6 · 第 4 周

L04a-6 开发生命周期:五个阶段和一条升级路

DApp 从设计到升级走五个阶段;测试之外多出一层安全审计,部署之后只能靠事件盯着,合约改不了就用代理模式另起一层。

一句话版

一个 DApp 从想法到上线再到维护,走五个阶段:设计、实现、测试与审计、部署、升级。和传统软件最大的不同只有一条:合约上了主网就改不了。后面每个阶段的特殊做法,都是从这一条推出来的。

前五页讲了 DApp 的部件和工具,这一页把它们放进一条时间线。

先认识这几个词

词 全称 / 读法 一句人话
单元测试 unit test 一个函数一个函数地检查
集成测试 integration test 前端、合约一起跑,看整体通不通
安全审计 security audit 请外部专家专门找漏洞
事件 event,emit 发出 合约主动写进交易日志的一条记录
代理模式 proxy pattern 地址和数据放一个合约,逻辑放另一个,可以换
delegatecall 读 “delegate-call” 借别的合约的代码,改自己的存储
多签 multisig 要几个人里的多数一起签名才能执行
时间锁 timelock 操作先公布,等一段时间才生效

一个类比:造一座桥

设计桥要先算清楚荷载,因为桥一旦合龙就很难返工。施工前会先做缩尺模型,放进风洞里吹。完工后请第三方机构来做验收检测,因为桥上每天要过成千上万辆车。通车后桥上装满传感器,一有异常就报警。

桥老了要加固,路面还在,车照样走,背后的结构换了。

合约开发是同一条路:设计更重,测试多一层外部检测,上线后靠传感器盯着,升级时对外的路面不动。

类比在哪里失效:

  • 桥可以封路施工。合约升级时,用户一直在调同一个地址,不会感觉到停工。
  • 桥的图纸是保密的。合约代码和状态全部公开,攻击者可以慢慢研究,比造桥的人看得还仔细。

从零讲起

1. 五个阶段

它解决什么问题

考试最常出的简答题之一:按顺序写出 DApp 开发生命周期的五个阶段,并说出每个阶段做什么。只背五个英文词不够,要能说出每阶段的三项关键动作。

从哪来(补充)

把开发切成前后相接的阶段、做完一段才进下一段,这种做法叫瀑布模型。它最早的正式图示通常归于 Winston W. Royce 1970 年的论文,更早 Herbert Benington 在 1956 年就描述过分阶段开发。

课件的五阶段在形状上接近瀑布,只多了一条从升级回到实现的回路。

出处:Wikipedia: Waterfall model

直觉

五个阶段可以按“上主网”这条线切成两半。前三个阶段在上主网之前,可以随便犯错;后两个在上主网之后,每个错都是真金白银。

所以前半段要格外重:设计要想清楚,测试之外还要审计。后半段要格外小心:部署后要盯着,升级要有人把关。

一步一步看

目标:按顺序走完 DApp 生命周期五个阶段,看出每个阶段做哪几件事,以及升级为什么要另起一层代理。

  1. 先看整条流程。

    生命周期五阶段流程图:第一阶段 Design 包括概念与需求定义、用户体验草图、架构与技术选型,第二阶段 Implementation,第三阶段 Testing 与 Auditing,第四阶段 Deployment,第五阶段 Upgrades;一条虚线从 Upgrades 回到 Implementation,标注合约代码部署后无法直接修改,改逻辑只能另起一层代理

  2. Design:概念化,定义 DApp 要解决什么问题;用户体验,画草图;架构,定合约结构、存储方案和集成点。

  3. Implementation:搭开发环境(Truffle、Hardhat 或 Remix),写合约并编译,部署到测试网,在不花真钱的情况下模拟真实条件。

  4. Testing & Auditing:单元测试、集成测试、安全审计三层,下一节细讲。

  5. Deployment:部署到主网,前端切到主网并写用户指南,开始监控。

  6. Upgrades:代理模式、治理机制、持续监控,第四节细讲。

怎么判断

给一个开发动作,判断它属于哪个阶段,问它发生在上主网之前还是之后、是在造东西还是在检查东西。画草图、选存储方案是 Design。写代码、上测试网是 Implementation。找 bug、请人审是 Testing & Auditing。切主网、写用户指南、开监控是 Deployment。换逻辑、定谁有权换是 Upgrades。

常见误解

设计阶段和传统应用差不多,先做出来再说

传统应用上线后可以随时打补丁,合约不行。存储结构一旦定下,之后的升级都要兼容它,所以设计阶段要比传统应用重得多。

五个阶段走完一遍就结束了

Upgrades 会回到 Implementation,改好的新逻辑同样要再测、再审、再部署。图上那条虚线就是这个回路。

试一下

"把前端连接的网络从 Sepolia 改成主网"属于哪个阶段?

Deployment。课件把“DApp Launch”放在这一阶段:前端切到主网,同时提供用户指南。

2. 测试与安全审计

它解决什么问题

传统软件做单元测试和集成测试就算完整。区块链合约要多一层:请外部专家专门找漏洞。课件把它和测试放在同一个阶段,这一层为什么必须有,是常考的简答。

从哪来(补充)

审计为什么重要,最常被引用的例子是 The DAO。2016 年 6 月 17 日,这个合约的递归调用漏洞被利用,约 360 万 ether 被转走,大约是它募集总额 11.5 million 的三分之一。

以太坊社区在 2016 年 7 月 20 日硬分叉回滚了这次转账,没有跟着分叉的旧链成了 Ethereum Classic。

出处:Wikipedia: The DAO

直觉

单元测试查一个函数对不对,集成测试查整个 DApp 连不连得通。这两层只回答“它按我想的那样工作吗”。

审计回答另一个问题:别人能不能让它按我没想到的方式工作。写代码的人很难发现自己没想到的路径,所以要请外人来。

一步一步看

目标:把单元测试、集成测试、安全审计三层分开看,看出审计为什么是区块链合约非做不可的一层。

  1. 先看三层的分工。

    测试与审计三层示意图:单元测试检查单个合约函数是否按预期工作,集成测试让整个 DApp 一起跑并检查前端与合约连通,这两层传统软件也做;第三层安全审计用青绿色强调,请外部专家专门找漏洞,是区块链独有的;下方列出三个原因:代码部署后改不了,代码和状态全公开让攻击者能慢慢研究,合约里直接放着钱让漏洞一被发现就能立刻变现

  2. 单元测试:一个合约函数一个函数地查。

  3. 集成测试:前端和合约一起跑,包括前后端是否连通。

  4. 安全审计:外部专家阅读代码,专门找漏洞。

  5. 记住审计必须存在的三个原因:代码不可改,代码和状态全部公开,合约里直接放着钱。

  6. 三个原因叠在一起,才让审计从“可以做”变成“必须做”。

怎么判断

判断一个项目需不需要审计,逐条对照三个原因。合约部署后能不能改?代码是不是公开?合约里有没有放钱?三条都是“是”,就必须审计。今天主网上的绝大多数 DeFi 合约三条全中。

常见误解

测试覆盖率做到很高,就不需要审计了

测试只能查你想到的情况。The DAO 的漏洞是一种开发者没想到的调用顺序,测试写得再多也测不到你没设想的路径。

审计就是测试里的一种,课件把它写在 Testing 下面

课件把它和测试放在同一阶段,阶段名本身叫 Testing & Auditing。两者回答的问题不同,执行的人也不同,审计通常由团队之外的人做。

试一下

传统网站的后端代码也公开在 GitHub 上,为什么它通常不需要外部审计?

三个原因只中了一个。网站代码发现漏洞后可以马上打补丁,服务器里通常也不直接存着可以一键转走的钱。合约三条全中,才必须审计。

3. 部署与监控

它解决什么问题

合约上了主网,任何人都能调用,开发者挡不住。能做的只有盯着:一旦出现异常或大额交易,尽快知道,赶在损失扩大前处理。

直觉

监控服务看不到合约内部的变量变化,只能读交易日志。合约要主动把关键动作写进日志,这一步叫 emit 事件。合约不发事件,监控就只看到“有一笔交易”,看不出交易里发生了什么。

一步一步看

目标:顺着上线后的监控链路走一遍,看出合约怎样靠 emit 事件,让监控在异常或大额交易时及时告警。

  1. 部署到主网。

  2. 前端切到主网,配好用户指南。

  3. 开监控。看监控的链路:

    部署后监控链路图:合约被任何人调用时 emit 事件写进交易日志,监控服务一直读日志,遇到异常或大额交易就发出用青绿色强调的告警,团队赶在损失扩大前处理;下方说明合约不主动发事件,监控就只能看到有交易,看不出交易里发生了什么

  4. 合约在关键函数里 emit 事件,比如转账、提款、改参数。

  5. 监控服务持续读日志,设阈值:单笔金额过大、短时间内调用过多。

  6. 超过阈值就告警,团队决定是否暂停合约或通知用户。

怎么判断

检查一份部署方案是否完整,看三件事:合约是不是部署在主网;前端连的是不是主网;关键操作有没有 emit 事件并接入监控。

第二件听起来像废话,却是真实事故来源:前端写死了测试网的 chain ID,用户在主网上操作,交易就发到了错误的网络。

常见误解

监控能挡住攻击

监控只能发现,挡不住。合约部署后谁都能调用。发现之后要靠合约里预先写好的暂停开关,或者升级机制,才能止损。

只要交易上链,监控就能看出里面发生了什么

监控能看到交易发生、调用了哪个函数。函数内部改了什么,要靠合约主动 emit 的事件才看得清。

试一下

一个借贷合约要能被监控到"大额提款",合约代码里至少要做什么?

在提款函数里 emit 一个事件,带上提款人和金额。监控服务读这个事件,按金额设阈值告警。

4. 升级与代理模式

它解决什么问题

合约代码部署后无法直接修改,可是 bug 总会有,需求也会变。课件第五阶段给出的答案是代理模式:对外地址和数据不动,背后的逻辑可以换。

直觉

把一个合约拆成两个。代理合约保存全部存储,有一个永不改变的对外地址;实现合约只放逻辑。用户调用代理,代理用 delegatecall 把调用转给实现合约。

delegatecall 的特性是“用别人的代码、改自己的存储”:跑的是实现合约的代码,改的是代理合约的数据。升级时只要让代理指向新的实现合约。

一步一步看

目标:跟着一次从 v1 换到 v2 的升级,看出用户的地址和余额都没变、逻辑已经换新,换指向的权力归谁。

  1. 用户一直调用代理合约的固定地址。

  2. 代理合约保存余额等全部状态。

  3. 代理用 delegatecall 把调用转给当前的实现合约 v1。

  4. 升级:部署实现合约 v2,让代理改为指向 v2。

    代理模式升级示意图:用户一直调同一个地址,也就是代理合约 Proxy,它保存全部存储;代理通过 delegatecall 把调用转给实现合约,原来指向 v1,升级后用青绿色强调指向 v2,v2 的代码改的是代理的存储;下方提问谁有权换指向,答案是治理,例如多签和时间锁,因为换指向的权力很大

  5. 用户的地址和余额都没变,逻辑已经是新的了。

  6. 谁有权换指向,交给治理机制:多签或时间锁。

  7. 持续监控:网络本身也会升级,合约要跟着检查兼容性。

怎么判断

评估一个可升级合约安不安全,看换指向的权力在谁手里。一个私钥说了算:持有人可以把逻辑换成任意代码,等于随时能拿走所有用户的钱。多签:要多数人同意。时间锁:改动先公布、等一段时间才生效,用户有时间撤出。

可升级合约是用一部分去中心化换来的,治理机制是给它兜底的那一层。

常见误解

合约写了 selfdestruct,删掉重新部署就算升级

重新部署后地址变了,旧数据也带不过去。而且 EIP-6780 之后,selfdestruct 只在同一笔交易里创建的合约上才真正删除代码和存储,这条路基本被封死。

用了代理模式,合约就和传统软件一样随时能改,没有风险

能改本身就是风险。谁有权换实现合约,谁就能改写全部用户资产的逻辑,所以治理机制是必须的。

试一下

代理模式下,v2 新增了一个状态变量,放在了 v1 原有变量的前面。可能会出什么问题?

代理的存储布局是 v1 定下的。v2 的代码按自己的布局读写同一块存储,新变量插到前面,后面的变量就全部错位,读出来的余额可能是别的值。新变量只能往后加。

把它们串起来

四个概念都从“合约上了主网就改不了”这一条推出来。因为改不了,设计要更重,五阶段里前三个都在上主网之前。因为改不了、又公开、又放着钱,测试之外要加审计。因为挡不住调用,部署后只能靠事件盯着。因为改不了,升级只能另起一层代理,而代理的权力又要靠治理来管。

代理模式依赖的 delegatecall,在后面讲 Solidity 语法时会落到代码层面。

课件里的坑

  • p.11 说合约“可以被删除,如果写了可访问的 SELFDESTRUCT”。按今天的以太坊这句已不成立:EIP-6780(2024-03-13 Dencun 升级)之后,只有在同一笔交易里创建的合约才会真正删除代码和存储。
  • p.31 把部署到测试网写成“可选”。实际开发中测试网这一步很少能省,本地链测不出真实网络条件。
  • p.32 把安全审计放在 Testing 阶段里,容易让人以为它是测试的一种。答题时写清它是区块链独有的一层,并给出三个原因。
  • p.31 还列着 Truffle,它已停止维护,同一套课件的 p.27 已经把它删掉了。
  • p.33 的“确保前端连的是主网”看起来是废话,真实事故里常见的是前端写死了测试网 chain ID。

课后 10 分钟

这 10 分钟怎么用:按顺序默写五个阶段,每个阶段写出三项关键动作;再用一句话写出审计必须存在的三个原因;最后画一张代理模式的图。

必背

  1. 生命周期五阶段:Design → Implementation(本地链或测试网)→ Testing & Auditing → Deployment → Upgrades
  2. Design 三项:概念化、用户体验、架构(合约结构、存储方案、集成点);合约不可改,所以设计阶段比传统应用重得多
  3. Testing 三层:单元测试、集成测试(含前后端)、安全审计;审计是区块链独有的,因为代码部署后不可改、代码和状态全部公开、合约里直接放着钱
  4. Deployment 三项:主网部署、前端切到主网并写用户指南、监控异常与大额交易;监控靠合约 emit 的事件
  5. 合约代码部署后无法直接修改,升级只能靠代理模式(proxy pattern)另起一层间接;这是生命周期最后一个阶段单独存在的原因
  6. Upgrades 三项:代理模式(技术基础是 delegatecall,用别人的代码、改自己的存储)、治理机制(多签或时间锁,给升级权兜底)、持续监控并跟进网络升级(如 EIP-6780)

课件例题

本讲课件没有例题落在生命周期这一部分,p.30–p.34 是五张阶段说明页。

完整例题

题面(按课件 p.30–p.34 的考法自编):一个团队要做一个众筹 DApp。下面六个动作各属于哪个阶段?(a) 决定把出资记录存在合约里、项目图片存在 IPFS;(b) 用 Hardhat 写合约并部署到 Sepolia;(c) 请外部公司审代码;(d) 前端切到主网;(e) 在退款函数里 emit 事件并接入告警;(f) 发现 bug 后让代理指向新的实现合约。

  1. (a) 决定存储方案属于架构设计,归 Design。
  2. (b) 搭环境、写合约、上测试网,归 Implementation。
  3. (c) 外部专家找漏洞,归 Testing & Auditing。
  4. (d) 前端切主网,是 DApp Launch,归 Deployment。
  5. (e) 事件加告警是监控。首次上线时归 Deployment;上线后持续做,Upgrades 阶段也有持续监控一项。
  6. (f) 换实现合约,归 Upgrades。
  7. 检查顺序:六个动作按 a 到 f 正好对应五阶段从前到后,(e) 横跨两个阶段。

要点:先判断动作在上主网之前还是之后,再看是在造、在查还是在改。

变式题(先自己做)

自编情境:(1) 一个团队说“我们的合约不可升级,所以不需要第五阶段”。这个说法哪里对、哪里不对?(2) 一个可升级合约的升级权在一个开发者的私钥里。列出两种风险,并各给一个改进办法。

提示

第一问看 Upgrades 三项里,哪一项和合约能不能换逻辑无关。第二问想想私钥丢了和私钥持有人作恶两种情况。

判分点与答案(非官方评分标准)

判分点:① 第一问指出持续监控与网络升级兼容不依赖代理;② 第二问分清“丢失”与“作恶”两种风险;③ 改进办法落到多签或时间锁。

(1) 对的部分:没有代理,就不能换逻辑,代理模式和升级治理确实用不上。不对的部分:第五阶段还有持续监控和跟进网络升级。EIP-6780 这样的网络升级照样会改变合约行为,团队仍要检查兼容性;出了问题的不可升级合约,只能另部署一个新合约并迁移用户。

(2) 风险一:私钥丢失或被盗,攻击者可以把逻辑换成任意代码,转走全部资金。改进:改成多签,要多数人同意才能换指向。风险二:持有人自己作恶,用户来不及反应。改进:加时间锁,升级先公布、等一段时间才生效,用户可以提前撤出。

闪卡自测

1. 生命周期五阶段按顺序是哪五个?

Design → Implementation → Testing & Auditing → Deployment → Upgrades(p.30–p.34)。

2. 安全审计为什么是区块链独有的一层?

代码部署后不可改,代码和状态全部公开,合约里直接放着钱。三条叠在一起,漏洞一被发现就能立刻变现(p.32)。

3. 部署后的监控靠什么"看见"合约里发生了什么?

靠合约 emit 的事件。监控服务读交易日志里的事件,遇到异常或大额交易就告警(p.33)。

4. 为什么生命周期要单独有一个 Upgrades 阶段?

合约代码部署后无法直接修改,升级只能靠代理模式另起一层间接,这需要专门的设计和治理(p.34)。

5. delegatecall 的特性是什么?

用别人的代码、改自己的存储。代理合约借实现合约的逻辑,改的是代理自己的数据。

6. 升级权为什么通常交给多签或时间锁?

谁能换实现合约,谁就能改写全部用户资产的逻辑。多签防一个人说了算,时间锁给用户留出撤出的时间(p.34)。

下一讲

合约语言本身怎么写,从一个水龙头合约和版本声明开始,见 L04b-1 第一份合约:Faucet 与 pragma 版本。

下一讲 →
L04b-1 L04b-1 第一份合约:Faucet 与 pragma 版本

个人整理的学习笔记,不是官方材料;数字与结论以课件和讲师为准。