← COMP5565 全部讲次
L04c-1 · 第 4 周

L04c-1 合约的一头一尾:构造器、selfdestruct 与修饰器

构造器为什么只跑一次,selfdestruct 在 Dencun 升级之后还剩什么,修饰器里的 _; 怎样把检查代码套在函数外面。

一句话版

构造器管合约的出生,只在创建那笔交易里跑一次;selfdestruct 原本管合约的死亡,Dencun 升级之后只剩把余额转走这一半;修饰器把同一段前置检查套在许多函数外面,_; 标出函数体插进来的位置。

上一页 L04b-5 讲完了一次调用里的分派、报错和事件。这一页换个尺度,看一份合约从部署到退场的两端,再看最常用的语法糖修饰器。

先认识这几个词

词 白话意思
构造器 constructor 部署时自动执行一次的初始化函数
部署代码 / 运行时代码 部署交易里跑完就丢的一段,和留在链上供以后调用的一段
selfdestruct 把合约余额全部转给指定地址的指令
EIP-6780 改写 selfdestruct 语义的以太坊提案
修饰器 modifier 贴在函数声明上的一段可复用检查代码
_; 修饰器里的占位符,原函数体插在这里

一个类比:开店、关店和门口的保安

构造器像开张那天的剪彩。剪彩只办一次,办完把店主名字写进营业执照,之后谁也不能再剪一次。剪彩用的彩带和剪刀当天就收走了,店里只留下日常营业的柜台。

selfdestruct 原本像关门清算,把钱箱交给指定的人,再把店面拆掉。Dencun 升级之后,它变成只把钱箱交出去,店面、货架和账本原样留在那里。

修饰器像门口的保安。每个房间门口都站一个保安太浪费,于是写好一份「先查证件」的规程,哪个房间要用就贴上去。规程里写明「查完证件,放人进门」,这个「放人进门」就是 _;。

类比在哪里失效:

  • 现实里关店的人可以拒收别人的钱,selfdestruct 转账却是强制塞进对方账户,接收方连拒绝的机会都没有。
  • 保安规程是贴在门外的,修饰器却在编译时就把检查代码直接展开进函数体,链上看不到「修饰器」这个东西。

从零讲起

1. 构造器

它解决什么问题

合约部署出来,总要先把一些状态定下来,比如谁是主人、初始参数是多少。这些事只该做一次,做完就不能被别人重做,否则主人身份就能被抢走。

从哪来(补充)

0.4.22 之前,构造器是一个与合约同名的函数。合约名或函数名打错一个字母,这个「构造器」就变成谁都能调的普通 public 函数,主人身份可以被任意重置。于是 0.4.22 引入 constructor 关键字,0.5.0 起干脆禁止函数与合约同名。语言规则参考 Solidity 文档:Constructors。

直觉

构造器和创建合约在同一笔交易里运行。部署交易携带的字节码分两段:前一段是部署代码,构造器就在里面,跑完即丢;后一段是运行时代码,被永久存到合约地址上。所以构造器只能跑一次,也不能被任何人再次调用。

构造器里的 msg.sender 是发出创建交易的那个账户,也就是部署者。Faucet 里 constructor() { Owner = msg.sender; } 就靠这一点把部署者登记成主人。

一步一步看

目标:跟着一笔创建交易走完部署,看出构造器只在部署那一刻跑一次,之后链上只剩运行时代码。

  1. 部署者发出一笔创建交易,交易里带着整份字节码,构造器参数按 ABI 编码附在末尾。

  2. EVM 执行部署代码,也就是构造器,把主人、初始值等写进存储。

  3. 构造器返回运行时代码,这段代码被存到新合约地址上。

  4. 之后每次调用合约,执行的都是运行时代码,构造器早已不在链上。

    构造器时间线:创建交易发出后先执行 constructor 并被青绿高亮,接着只把运行时代码留在链上,之后每次调用都只跑运行时代码,图注说明 0.4.22 之前用同名函数当构造器

怎么判断

看到一段构造器代码,按版本查两件事:

  • 有没有一个和合约同名的函数?0.5.0 起直接编译报错。
  • constructor(...) 后面有没有写 public、internal 之类的可见性?0.7.0 起不允许,删掉即可。

常见误解

「子合约部署时,父合约的构造器不会跑」对吗?

不对。父合约的构造器会在子合约的创建交易里一起执行,Faucet 继承 Owned 后照样有主人。只是谁都不能在部署之后再次运行它。父合约构造器需要参数时,要在继承语法里显式传。

「selfdestruct 会把构造器一起删掉」对吗?

构造器根本不在链上,部署时跑完就丢了。旧规则下 selfdestruct 删的是运行时代码和存储。

试一下

pragma solidity = 0.4.21; 下的 function Parents() public {} 写在 contract Parents 里,它是什么?

它就是构造器。0.4.22 之前与合约同名的函数即构造器。这里的 pragma 用 = 锁死版本,因为这段代码在更高版本里根本编译不了。

2. selfdestruct 与 EIP-6780

它解决什么问题

合约部署后代码不能改,有了漏洞或者不再需要时,开发者希望能把它撤下来,顺便把里面的钱取回。selfdestruct 就是当初为此设计的指令。

从哪来(补充)

EIP-6780 随 Dencun 升级在 2024 年 3 月 13 日生效。它规定:selfdestruct 若不在合约创建的同一笔交易里执行,只把全部余额转给目标,不删存储、代码和账户本身。出处:EIP-6780、ethereum.org 升级历史。

直觉

改规则的原因有两条。一是单笔交易就能删掉任意多的状态,给后续的状态树设计添了大麻烦。二是它配合 CREATE2 能在同一个地址先删后建、换上另一份代码,是一类攻击的基础。EIP-6780 在不弄坏太多现有合约的前提下,尽量把它废掉。

所以课件开头说合约可以被删除,后面又说它不删代码和存储,两处分别站在这次升级的两边。

一步一步看

目标:按 EIP-6780 之后的规则走一遍 selfdestruct,看出余额总会被转走,代码和存储删不删取决于合约是否刚创建。

  1. 调用 selfdestruct(recipient),参数是接收余额的地址,类型要求是 address payable。

  2. 合约的全部余额被强制转给 recipient,不触发对方的 receive 或 fallback。

  3. 判断这个合约是不是在当前这笔交易里刚创建的。

  4. 不是,代码和存储原样保留,状态变量照样能读。

  5. 是,按旧规则把代码和存储一起删掉。

    selfdestruct 升级前后对照表:升级前代码和存储都被删除,Dencun 升级后的旧合约只转走余额、代码和存储保留,这一行被青绿高亮,同一交易内刚创建的合约仍会被完整删除

怎么判断

被问「selfdestruct 做什么」,先答两个口径下都成立的那句:把剩余 ether 转给指定地址。再补一句:EIP-6780 之后不再删除代码和存储,除非合约在同一笔交易里创建。被问合约的生命周期,照课件开头的旧口径答,同时注明升级后的变化。

常见误解

「调用了 selfdestruct,合约就从链上消失了」对吗?

升级之后不对。代码和存储都在,状态变量照样能读,只是余额变成 0。之后有人再往这个地址转账,钱还会留在里面。

「接收方合约没写 receive,selfdestruct 就转不进去」对吗?

不对。selfdestruct 的转账是强制的,不经过接收方的任何函数,拒收的合约也会被塞进钱。这是强制给合约打钱的三种方式之一,所以合约不该用余额等于某个精确值做判断。

试一下

一个合约在构造器里就调用了 selfdestruct,部署交易结束后它还在吗?

不在。它是在同一笔交易里刚创建的,按 EIP-6780 的例外规则仍会完整删除。

3. 修饰器

它解决什么问题

「只有主人能调」这类前置条件,一份合约里可能有十几个函数都要检查。每个函数开头都抄一遍 require,抄漏一处就是漏洞。修饰器把这类条件写成一个有名字的单元,贴到哪个函数上就在哪里生效,代码更好读,也更好审计。

直觉

修饰器是一段模板,_; 是原函数体的插入点。编译时,编译器把函数体塞进 _; 的位置,再把整段当成函数执行。_; 写在最后,就是先检查后执行;写在中间,就能在函数体前后各做一段事,重入锁就靠这一点。

一步一步看

目标:看 onlyOwner 贴到 changeOwner 上之后怎样被编译器展开,看出 require 失败时函数体一行都不跑。

  1. 定义修饰器:modifier onlyOwner() { require(msg.sender == owner); _; }。

  2. 贴到函数上:function changeOwner(address _newOwner) external onlyOwner { owner = _newOwner; },修饰器写在可见性之后。

  3. 编译器展开:先放 _; 之前的 require,再放原函数体,最后放 _; 之后的部分(这里为空)。

  4. 调用时按展开后的顺序执行,require 失败则函数体一行都不跑。

  5. 一个函数挂多个修饰器时,从左到右层层嵌套。

    修饰器展开竖向流程:先执行 onlyOwner 前半段的 require 检查,再到被青绿高亮的下划线分号处插入函数体,最后执行修饰器后半段,图注说明多个修饰器从左到右嵌套

怎么判断

读一个挂了修饰器的函数,就在纸上手动展开:把每个修饰器 _; 之前的代码依次写在前面,函数体放中间,各修饰器 _; 之后的代码倒序写在后面。展开后的顺序就是执行顺序。

常见误解

「修饰器只能做检查,不能改状态」对吗?

不对。修饰器里可以写任何语句。重入锁就在 _; 前把 locked 设为 true,在 _; 后改回 false,是一个会改状态的修饰器。

「有了 onlyOwner,changeOwner 就安全了」对吗?

还差一点。它允许主人把所有权转给任意地址,包括 address(0)。手滑传了零地址,合约就永远没了主人,所有 onlyOwner 函数全部锁死。OpenZeppelin 的 Ownable 把放弃所有权单独做成 renounceOwnership(),就是为了不让它被误触发。

试一下

modifier m() { _; require(x > 0); } 贴在一个把 x 改成 0 的函数上,调用结果如何?

函数体先执行,把 x 改成 0;接着跑 _; 之后的 require,条件为假,整次调用回滚,x 的修改也撤销。

把它们串起来

一份合约的一生从创建交易开始:构造器在这笔交易里跑一次,把主人登记成部署者,然后只把运行时代码留在链上。此后每一次调用,修饰器都在函数体前后执行它的检查,比如确认调用者是主人。到了退场时,selfdestruct 把余额强制转走;Dencun 之后,代码和存储还留在原地。

三件事都和权限有关。构造器决定主人是谁,修饰器守住主人才能做的操作,selfdestruct 一旦漏了权限检查,任何人都能把余额卷走。课件里那个 DeleteContract 就是缺了修饰器的反例。

课件里的坑

  • [前后矛盾] 开头说合约可以被 SELFDESTRUCT 删除,讲析构时又说它不删代码和存储。两页分别站在 EIP-6780(2024-03-13 Dencun 升级)的两侧,升级后只转走余额(p.5、p.41)
  • [过时语法] constructor(uint _data) public 带可见性,0.7.0 起不合法,去掉 public 即可(p.40)
  • [大小写不一致] onlyOwner 检查的是 Owner(大写),changeOwner 的函数体却写 owner = _newOwner(小写),照抄会编译失败或改错变量(p.43、p.44)
  • [缺权限检查] deleteContract() 没有任何修饰器,任何人都能调用并卷走余额,只能当教学示例看(p.42)
  • [没讲边界] changeOwner 能把所有权转给 address(0),转了就再也找不回主人(p.44)

课后 10 分钟:考点复习

这 10 分钟怎么用:先默写构造器的三条性质和两个版本断点;再把 selfdestruct 升级前后的对照表画出来;最后做课件例 1,并把完整例题里的修饰器在纸上展开一遍。

必背

  1. 构造器只运行一次、与合约创建在同一笔交易里;0.5.0 起禁止函数与合约同名,0.7.0 起构造器不能写可见性。
  2. 构造器代码不会存上链,部署后只留下运行时代码;构造器里的 msg.sender 就是部署者。
  3. selfdestruct 在 EIP-6780(2024 年 3 月 Dencun 升级)之后不再删除合约代码与存储,只转走余额;仅当合约在同一笔交易内被创建时才仍执行完整销毁。
  4. selfdestruct 的转账是强制的,不触发接收方的 receive 或 fallback,拒收的合约也会被塞进钱。
  5. 修饰器里的 _; 是被修饰函数体的占位符,可放在中间实现前后各执行一段(重入锁);多个修饰器从左到右嵌套。

课件例题

例 1(课件 p.42):调用 deleteContract 之后合约还剩什么

题面:DeleteContract 有状态变量 uint public value = 10;,构造器和 receive 都是 payable,部署时附带了一些 ether。deleteContract() 是 external,函数体只有 selfdestruct(payable(msg.sender));。在 Dencun 升级之后的链上,一个陌生账户调用 deleteContract(),然后再读 value 和 getBalance(),各得到什么?这段代码有什么安全问题?

提示

先判断这个合约是不是在这笔交易里创建的,再套 EIP-6780 的规则。getBalance() 读的是什么,看它的函数体。

解答
  1. 合约不是在这笔交易里创建的,按 EIP-6780 只转余额、不删代码和存储:全部余额强制转给调用者,也就是那个陌生账户。
  2. 再读 value 仍得 10,代码和存储都还在。
  3. getBalance() 返回 0,它读的是 address(this).balance,钱已经转走。
  4. 安全问题:deleteContract() 没有任何权限检查,谁都能调用并卷走余额。真实代码应加 Faucet 那样的 onlyOwner。

完整例题

题面:合约 Owned 在构造器里写 owner = msg.sender;,有修饰器 onlyOwner(require(msg.sender == owner); _;)和函数 changeOwner(address _newOwner) external onlyOwner { owner = _newOwner; }。账户 A 部署合约,随后账户 B 调 changeOwner(B),接着 A 调 changeOwner(B),最后 A 再调 changeOwner(A)。写出每一步 owner 的值和调用结果。

  1. 部署:构造器在 A 发出的创建交易里运行,msg.sender 是 A,owner = A。
  2. 展开函数:changeOwner 展开后是 require(msg.sender == owner); owner = _newOwner;。
  3. B 调 changeOwner(B):msg.sender 是 B,owner 是 A,require 失败,整次调用回滚,owner 仍是 A。
  4. A 调 changeOwner(B):require 通过,owner 改成 B。
  5. A 再调 changeOwner(A):此时 owner 已是 B,A 不再是主人,require 失败,owner 仍是 B。
  6. 反过来检查:如果第 4 步传的是 address(0),之后任何账户的 msg.sender 都不可能等于零地址,所有 onlyOwner 函数永久锁死。
  7. 要点:修饰器每次调用都现读一次 owner,所以主人一换,权限立刻跟着换。

答题格式:每一步写「调用者 → 展开后的 require 是否通过 → owner 的新值」。

变式题(先自己做)

两个修饰器 a 和 b:a 写成 emit L("a1"); _; emit L("a2");,b 写成 emit L("b1"); _; emit L("b2");。函数 f() public a b { emit L("f"); }。(1) 调用 f() 后,五条日志依次是什么?(2) 如果把 b 改成 require(false); _;,调用结果和日志各是什么?

提示

先展开 a,再把 b 的整段塞进 a 的 _;,最后把函数体塞进 b 的 _;。第二问想一想回滚会撤销什么。

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

判分点:① 写出从左到右嵌套的展开顺序;② 后半段倒序;③ 第二问指出日志随回滚一起撤销。

(1) 展开后是 a1 → b1 → f → b2 → a2。先进 a,在 a 的 _; 处进入 b,在 b 的 _; 处执行函数体;返回时先跑完 b 剩下的部分,再跑完 a 剩下的部分。

(2) 执行到 b 的 require(false) 时整次调用回滚。a1 虽然已经 emit,但日志和状态改动一起撤销,最终一条日志都没有,函数体也没执行。

闪卡自测

1. selfdestruct 现在还能删掉合约吗?

一般不能了。EIP-6780 之后它只把余额转给指定地址,代码和存储原样留在链上,唯一例外是合约在同一笔交易内被创建(p.5、p.41 + 补充)。

2. 为什么 0.5.0 起禁止函数与合约同名?

旧版本里同名函数就是构造器。名字打错一个字母,它就变成谁都能调的普通函数,等于把初始化权限公开了。0.4.22 引入 constructor 关键字,0.5.0 再把同名函数整个禁掉(p.39)。

3. 函数上挂了两个修饰器 f() a b,执行顺序是什么?

从左到右嵌套:先进 a,a 的 _; 处进入 b,b 的 _; 处才是函数体;返回时反过来,先跑完 b 剩下的部分,再跑完 a 剩下的部分(p.43)。

4. 构造器里的 msg.sender 是谁?

部署者。构造器就在创建交易里执行,发出这笔交易的账户就是 msg.sender(p.38)。

5. 修饰器写在函数声明的哪个位置?

可见性和行为修饰词之后、returns 之前,比如 external onlyOwner(p.44)。

下一讲

下一页 L04c-2 把 Owned 抽成父合约,讲继承、virtual / override,以及 abstract 和 interface 这两种不完整的合约。

下一讲 →
L04c-2 L04c-2 继承:is、virtual / override,以及 abstract 与 interface

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