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

L04a-3 众筹合约:把托管资金的中间人换成代码

众筹为什么需要去中心化,四条规则怎么写,以及为什么退款要让任何人都能触发。

一句话版

众筹的钱放在谁手里,捐助者就得信谁。把“托管资金、按规则放款或退款”写成合约,发起人和中间人都不用再被信任。合约到期不会自己动,所以退款要设计成“到期后谁都能触发”。

这一页用课件的众筹例子,把前两页讲的 DApp 部件串成一个具体应用。

先认识这几个词

词 全称 / 读法 一句人话
众筹 crowdfunding 一个人向很多人筹钱做一件事
发起人 fundraiser 要筹钱的那个人
捐助者 donor 出钱的人,这里也是产品的潜在客户
中间人 intermediary 众筹网站这类替双方托管资金的第三方
托管 escrow 钱先放在第三方手里,条件满足才放出去
交易 transaction 外部账户签名发出的一笔操作,合约代码只在它触发时运行
cron 读“克朗” 服务器上按时间自动执行任务的定时器

一个类比:班费交给谁

班里要凑钱买一台投影仪,目标两千块,月底前凑不齐就退钱。

钱交给班长,你得信班长月底真会退。交给学校财务处,你得信财务处。两种做法里总有一个人必须被信任。

现在换成一个透明的自动保险箱:规则贴在箱子上,谁都能看,凑够了箱子自动对班长打开,凑不够就把钱按原数退回。没人能私自打开它。

类比在哪里失效:

  • 真的保险箱可以装一个闹钟,到点自己开。合约没有闹钟,到点什么都不会发生,得有人去按一下按钮。
  • 保险箱坏了可以找锁匠。合约写错了,通常没人能修。

从零讲起

1. 钱在谁手里,就得信谁

它解决什么问题

众筹要解决一个信任问题:捐助者先把钱交出去,钱却要等条件满足才该给发起人。在这段时间里,钱由谁保管?保管的人会不会卷款跑掉,或者不按规则退款?

直觉

传统上只有两个选择,钱要么在发起人手里,要么在中间人手里。无论选哪个,捐助者都得信任拿着钱的那一方。

中间人唯一在做的事,就是托管资金并按规则放出去。这件事的规则很简单:金额、期限、达标与否。简单到可以完全写成代码。

一步一步看

目标:比较钱交给发起人、交给网站和锁进合约三种方案,看每种方案里捐助者最终要信任谁。

  1. 方案一:捐助者把钱交给发起人,钱在发起人手里,你得信任发起人。

  2. 方案二:捐助者把钱交给众筹网站,钱在中间人手里,你得信任中间人。

  3. 合约方案:捐助者把钱转进合约,钱锁在合约里。

    三栏对比图:方案一发起人自己收,钱在发起人手里,信任发起人;方案二众筹网站收,钱在中间人手里,信任中间人;合约方案用青绿色标出,钱锁在合约里,信任的是公开的代码

  4. 合约方案里,捐助者要信任的只剩合约代码本身。代码公开,出钱前可以读一遍。

怎么判断

判断一个场景值不值得上合约,问一句:是不是有一个第三方,唯一的作用就是托管资金、按明确规则放出去?是,这一环就能交给代码。规则含糊、需要人来裁量的,写不成代码,合约帮不上忙。

常见误解

用了合约就什么都不用信了

信任对象换成了代码。代码写错了,钱一样会出事,而且合约部署后很难改。所以合约要公开、要审计,捐助者最好自己读一遍规则。

试一下

一个租房押金平台:租客把押金交给平台,退租时由平台判断房子有没有损坏再决定退多少。这一环能直接换成合约吗?

很难。“房子有没有损坏”要人来判断,规则写不死。合约只能处理金额、期限、是否达标这类明确条件,需要裁量的部分仍然要靠人或外部数据。

2. 众筹合约的四条规则

它解决什么问题

有了“让代码托管资金”的想法,还要把它写成一份能实现的规格。课件给了一份很短的规格,四条规则就把放款和退款的所有情况都覆盖了。

直觉

规格本身很朴素:用 Solidity 写,跑在以太坊上。发起人要筹 100 ETH 做一个产品,潜在客户愿意先付钱。

四条规则分别管“怎么收钱”“达标怎么办”“没达标怎么办”“谁来触发退款”。

一步一步看

目标:按四条规则走一遍众筹从收钱到截止后的分岔,看放款和退款怎样覆盖所有情况,退款又由谁启动。

  1. 规则①:每个捐助者出任意金额,合约记下谁出了多少。

  2. 截止时间没到,合约就继续收钱。

  3. 截止时间到了,看总额有没有达到目标 100 ETH。

    众筹规则流程图:从规则一捐款开始,判断截止时间到了吗,到了再判断总额是否达到目标 100 ETH;达到则规则二钱给发起人;没达到则走青绿色的规则四,任何人都可以发交易触发退款,再到规则三钱按原数退回每位捐助者

  4. 达标,走规则②:钱给发起人。

  5. 没达标,走规则③:钱退回捐助者。

  6. 退款这一步由谁来启动?规则④:任何人都可以在超时未达标后触发全额退款。

怎么判断

检查一份众筹规格完不完整,就看它是否回答了四个问题:怎么收、达标给谁、没达标怎么办、由谁触发。少答哪一个,合约就会在那种情况下卡住。

常见误解

规则③写了"未达标退回捐助者",规则④就是多余的

规则③只说了退款这个结果,没说由谁启动。合约不会自己执行,必须有一笔交易来调用退款函数,规则④回答的正是这件事。

试一下

截止时总额是 120 ETH。按四条规则会发生什么?还需要有人触发退款吗?

120 ETH 达到了 100 ETH 的目标,走规则②,钱给发起人,不触发退款。

3. 合约不能自己醒来

它解决什么问题

为什么规则④写成“任何人都可以触发退款”,不写“合约到期自动退款”?答案揭示了以太坊合约一个根本限制,这也是一道常见的简答题。

直觉

以太坊上没有定时器,也没有 cron。合约代码只有在被一笔交易调用时才会执行,而每笔交易都源自一个外部账户。

所以“到期自动退款”写不出来。能写的是:到期后开放一个退款函数,谁调用都行。

一步一步看

目标:按时间顺序看合约在每笔交易进来和截止那一刻各做了什么,看出没有交易触发合约就不会自己执行。

  1. 捐款交易进来,合约执行一次,记账。

  2. 又一笔捐款交易进来,合约再执行一次。

  3. 截止时间到了。这时没有交易进来,合约什么都不做,钱继续锁着。

    时间轴示意图:两笔捐款交易各让合约执行一次;截止时间点上没有交易,什么都不发生;之后一段灰底区间合约一行代码都没跑;直到青绿色的“有人发退款交易”,合约才执行退款

  4. 过了一段时间,某位捐助者发了一笔调用退款函数的交易。

  5. 这笔交易触发合约,合约这才按记账把钱退回去。

怎么判断

设计合约时,凡是“到某个时间自动做某件事”的需求,都要改写成“到某个时间之后,允许某些人调用某个函数”。再想清楚:谁最有动机去调用?把调用权开放给他。

众筹里最想拿回钱的是捐助者,所以规则④对任何人开放,捐助者自己发一笔交易就行。

常见误解

退款交易的 gas 由合约付

谁发交易谁付 gas。调用退款的那个人要自己出手续费,这是“合约不能自己醒来”的直接代价。

只许发起人触发退款,效果一样

发起人没有动机去退款。他拖着不调,钱就一直锁在合约里,信任又交回给了发起人。

试一下

一个合约要"每月 1 号自动给会员发积分"。这个需求在以太坊上要怎么改写?

改成:每月 1 号之后,允许会员自己调用一个领取函数,合约检查本月有没有领过,没领就发。触发的人是最想要积分的会员,gas 也由他付。

把它们串起来

把前两页的部件拼起来,就是课件那张以太坊 DApp 架构图。每个用户各有一套:浏览器在最上面;中间是前端层,HTML、CSS、JavaScript 加 web3.js,放在 Apache 或 Nginx 这样的 Web 服务器上;最下面经 RPC 连到 EVM 和区块链。

图里有一行注释指着区块链:Replaces the database/cache and server code,区块链替代了数据库、缓存和服务器代码。众筹合约就是那段“服务器代码”,捐款记录就是那份“数据库”。

图里还画着两件事。两个用户的实例各有一份完整的链,中间靠 P2P 同步,这就是“每个用户自带后端”。Apache 和 Nginx 也还在,前端仍然挂在传统服务器上。

现实中绝大多数用户不跑全节点,用的是 MetaMask 加 Infura、Alchemy 这样的共享节点,这又是一个中心化的点。工具这一层下一页细讲。

课件里的坑

  • p.17 的结论句是“两种情况下,发起人和中间人都必须被信任”。答题时两种方案要分开写,各自信任谁要点名。
  • p.18 只给了四条规则,没解释第④条为什么写“任何人”。答案要落到“合约不能自己醒来”这条根本限制上,只说“方便”拿不到分。
  • p.16 的架构图画的是每个用户都跑全节点的理想情况。图里的 Apache/Nginx 说明前端仍挂在传统服务器上,别把这张图当成“完全去中心化”的证据。

课后 10 分钟

这 10 分钟怎么用:合上页面,默写众筹的四条规则,再用两句话解释第④条为什么写“任何人”,最后做下面的变式题。

必背

  1. 众筹的两种传统方案都需要信任:发起人自己收钱要信发起人,中间人收钱要信中间人
  2. 中间人唯一在做的事是托管资金、按规则放款或退款;这件事能写成代码,中间人就没有存在理由
  3. 众筹合约规格:目标 100 ETH,捐助者出任意金额,达标钱给发起人,未达标钱退回捐助者,任何人都可在超时未达标后触发全额退款
  4. 以太坊合约不能自己醒来:没有定时器和 cron,合约代码只在被一笔交易调用时执行,所以到期退款只能写成到期后任何人都可调用
  5. 以太坊 DApp 架构:浏览器 → 前端(HTML/CSS/JS + web3.js + Web 服务器)→ 经 RPC → EVM 与区块链;区块链替代了数据库、缓存和服务器代码

课件例题

例 1(课件 p.17):众筹为什么需要 DApp

题面:一个发起人想从一群捐助者那里筹钱。传统上有两种做法:发起人自己收钱,按条件退款;或者交给众筹网站这样的中间人收钱,再按条件转给发起人或退给捐助者。两种做法各自要求捐助者信任谁?

提示

看钱在每种方案里落在谁手上。拿着钱的人,就是捐助者必须信任的人。

解答
  1. 方案一:钱在发起人手里,捐助者得信任发起人会按条件退款。
  2. 方案二:钱在中间人手里,捐助者得信任中间人会按条件转账或退款。
  3. 课件的结论句:两种情况下,发起人和中间人都必须被信任。
  4. 中间人唯一在做的事是托管资金、按规则释放;这件事交给合约,中间人就没有存在理由了。

例 2(课件 p.18):众筹 DApp 的四条规则

题面:用 Solidity 在以太坊上写一个众筹 DApp,发起人要筹 100 ETH,规则四条:① 每个捐助者出任意金额;② 达标则钱给发起人;③ 未达标则钱退回捐助者;④ 任何人都可以在超时未达标后触发全额退款。第④条为什么写“任何人都可以触发”?

提示

以太坊合约能不能在某个时间点自己开始运行?

解答

合约没有定时器,只在被交易调用时执行,“到期自动退款”写不出来。只能在到期后开放退款函数,把触发的义务交给最有动机的人,也就是想拿回钱的捐助者。完整分析和数字情境见下方完整例题。

完整例题

题面(课件 p.18):用 Solidity 在以太坊上写一个众筹 DApp。发起人要筹 100 ETH 做一个产品,规则四条:① 每个捐助者出任意金额;② 达标则钱给发起人;③ 未达标则钱退回捐助者;④ 任何人都可以在超时未达标后触发全额退款。问:(a) 这份规格去掉了哪一方的信任?(b) 第 ④ 条为什么写「任何人都可以触发」,不写「合约到期自动退款」?(c) 设截止时有 3 个捐助者共捐了 80 ETH,接下来会发生什么?

  1. (a) 对照 p.17 的两种传统方案:钱不再进发起人或众筹网站的口袋,直接锁在合约里。放款还是退款由规则②③决定,发起人和中间人都不用再被信任。
  2. 捐助者要信任的只剩合约代码本身。代码公开,可以在出钱前读一遍。
  3. (b) 以太坊合约没有定时器,也没有 cron。合约代码只在被一笔交易调用时执行,而每笔交易都源自一个外部账户。
  4. 所以「到期自动退款」写不出来。能写的是:到期后开放一个退款函数,谁调用都行。
  5. 规则写「任何人」,是把触发义务交给最有动机的人。捐助者想拿回钱,自己发一笔交易就行,不用等发起人配合。
  6. 要是只允许发起人触发,发起人拖着不调,钱就一直锁在合约里。规则④就是为了堵这个口子。
  7. (c) 80 ETH < 100 ETH,未达标。超时后任意一方调用退款函数,合约按记账把每人的钱原数退回,三人合计 80 ETH,发起人拿不到钱。
  8. 调用退款的那笔交易要付 gas,由发交易的人付。这是「合约不能自己醒来」的直接代价。

要点:(b) 问要写出“合约只在被交易调用时执行”这一句,再落到“把触发权交给有动机的人”。

变式题(先自己做)

自编情境:(1) 把规则④改成「只有发起人可以在超时后触发退款」,会出什么问题?(2) 目标改成 50 ETH,截止时 4 个捐助者各捐了 15 ETH。按原来的四条规则会发生什么?还需要有人发退款交易吗?

提示

第一问想想发起人有没有动机去退款。第二问先算总额,再和目标比。

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

判分点:① 第一问落到“合约不能自己醒来”和“发起人没有动机”两点;② 第二问算出总额并判断达标;③ 指出达标时走规则②,不触发退款。

(1) 合约到期不会自己退款,要有一笔交易来触发。只许发起人触发,他就可以一直不调,捐助者的钱锁死在合约里拿不回来。等于又把信任交回给发起人,p.17 要去掉的那一环原样回来了。

(2) 总额 4 × 15 = 60 ETH,达到 50 ETH 的目标,走规则②,钱给发起人。没有未达标的情况,不需要退款交易。

闪卡自测

1. 众筹的两种传统方案各自要求信任谁?

发起人自己收钱,信任发起人;中间人收钱,信任中间人(p.17)。

2. 合约消除了众筹里的哪一环?

托管资金、按规则放款或退款的那一环。这件事交给代码,中间人就不需要了(p.17)。

3. 众筹规格的目标金额和四条规则是什么?

目标 100 ETH。① 任意金额;② 达标给发起人;③ 未达标退回捐助者;④ 任何人可在超时未达标后触发全额退款(p.18)。

4. 为什么不能写"合约到期自动退款"?

以太坊合约不能自己醒来,没有定时器和 cron,代码只在被交易调用时执行(p.18)。

5. p.16 架构图里,前端通过什么连到链?

通过 RPC 连到节点,节点里是 EVM 和区块链(p.16)。

6. "Replaces the database/cache and server code" 指的是图里哪一部分?

区块链。它替代了传统应用的数据库、缓存和服务器代码(p.16)。

下一讲

写合约、跑合约、连上链要用哪些工具,见 L04a-4 开发工具链:三个环境和七类工具。

下一讲 →
L04a-4 L04a-4 开发工具链:三个环境、七类工具和一条 JSON-RPC

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