Lab1b 连上测试网、只拿 ABI 调陌生合约,再写一个会记账的水龙头
Task 4–6 分步走:MetaMask 接 Sepolia、用 + Add Contract 调一份没有源码的合约并识破它的函数名,最后给 Faucet 补上提款记录、事件和排序。附完整题解合约与 Remix 实测截图。
一句话版
Task 4–6 把 Remix 里的模拟链换成真实的测试网,再让你面对两种「看不见源码」的处境。一份是只给 ABI 的陌生合约,函数名说的和它做的完全两样。另一份是往年留下的水龙头合约,注释和代码互相打架,要你在上面补出提款记录、事件和按累计额排序。Task 1–3 的 Remix 基本操作在 Lab1a。
先认识这几个词
| 词 | 全称 / 读法 | 一句人话 |
|---|---|---|
| MetaMask | 读「Meta Mask」,浏览器钱包插件 | 替你保管私钥、在网页上签名发交易的钱包 |
| 测试网 | testnet,本页用 Sepolia | 和以太坊主网一样运作的公共链,币不值钱,专供练习 |
| EOA | Externally Owned Account,外部账户 | 由私钥控制的普通用户账户,区别于合约账户 |
| wei | 读「wei」 | 以太币的最小单位,1 ETH 是 1 后面跟 18 个 0 的 wei |
| mapping | 映射 | Solidity 的键值表,给一个键立刻查出对应的值 |
| 水龙头 | faucet | 谁来要就发一点币的合约或网站 |
| ABI | Application Binary Interface | 合约对外的接口清单,写着有哪些函数、各要什么参数 |
| revert | 回滚 | 交易中途检查不过,所有改动撤销,报错退出 |
题目地图
| Task | 在考什么 | 主要失分点 |
|---|---|---|
| 4 MetaMask 与 Sepolia | 拿到账户、切网络、领测试币 | 照抄课件那行 RPC,连不上 |
| 5 只拿 ABI 调链上合约 | ABI 能做什么、不能保证什么 | 相信函数名;Environment 没切 |
| 6 水龙头提款记录与排序 | struct / mapping / array 分工 | 忘了先充值;参数单位当成 ETH |
Task 6 的讲义页眉是 2024/25 学年,是往年讲义原样沿用的。它的代码风格和前面不一样,还带着一处注释与代码的矛盾,下面题解会处理。
概念卡
1. EOA 与 Remix 的 Environment
人话定义:它解决「我的交易到底发去了哪条链」。MetaMask 里建出来的是 EOA,由私钥控制;Remix 的 Environment(运行环境)决定交易发到哪条链上。
例子:Environment 选 Browser Extension,右边会显示 Sepolia Testnet - MetaMask。这时 Remix 通过钱包把交易发到 Sepolia。每笔交易都要在钱包里确认。选 Remix VM 时一切只发生在浏览器内存里,刷新就没了。
常见误解
在 Remix VM 下粘贴课件给的地址去 Add Contract → 能「加」上,但那个地址在模拟链上什么都没有,调什么都不对。要调测试网上的真合约,先切 Environment。
回讲义:L04a-5 网络与 Ganache:同一份合约先在哪条链上试
2. ABI 能告诉你什么
人话定义:它回答「拿到一份 ABI,能信多少」。ABI 告诉你怎么调,不告诉你调了会发生什么。
例子:faucet2.abi 里列着 gettwiceyourmoneyback、secretfunction、sendyourmoney 三个函数和一个 receive。每项只有名字、参数和 stateMutability(这个函数能不能改状态、能不能收钱)。函数名是部署者随手起的字符串,可以写任何东西。
常见误解
把 stateMutability 当成无关信息跳过 → 它是 ABI 里少数能交叉验证函数名的字段。一个 nonpayable(不能收钱)的函数调用时根本带不进钱,却叫「退你双倍」,名字和能力已经对不上了。
回讲义:L04c-3 调用其他合约:new、地址强转、call 与 delegatecall
3. mapping 不能遍历
人话定义:它解释了「为什么排序还得另存一份名单」。mapping 能按键一步查到值(O(1)),但它不知道自己存过哪些键,没法从头到尾走一遍。
例子:totalWithdrawn 能立刻查出任一地址提了多少。要「把所有地址按累计额排序」,就必须另存一份地址数组 withdrawers。再配一个 seen 记录谁已经进过名单,防止重复 push(追加进数组)。
常见误解
用 totalWithdrawn[msg.sender] == 0 代替 seen 判断「是否首次提款」 → 提 0 wei 时累计额仍是 0,同一个地址会被反复塞进名单,见变式题(一)。
4. checks-effects-interactions
人话定义:它防的是重入(reentrancy),即对方在你没记完账时回头再调你一次。做法是先检查条件,再改自己的账,最后才和外部打交道。
例子:题解的 withdraw 里,两个 require 在最前,记账和 emit 在中间,transfer 放在最后一行。转账会把控制权交给接收方。接收方若是合约,可以在 receive 里回头再调 withdraw。账已经记完,重入读到的就是新状态。
常见误解
以为用了只转发 2300 gas 的 transfer 就不用管顺序 → 一旦换成 call,2300 gas 的天然限制就没了。顺序写对的成本是零。
逐题拆解
Task 4:连上真的测试网。 操作步骤:
- Chrome 网上应用店装 MetaMask → Create a new wallet → 设密码。课件说测试账户可以跳过备份助记词(恢复钱包用的一串单词)。这只对一次性账户成立,放真钱的钱包助记词丢了就等于钱丢了。
- 网络选择里打开显示测试网络的开关,直接选 Sepolia。新版 MetaMask 已内置它。课件那套 Add a custom network 只在找不到时才需要,填法见下一节的坑。
- 去 Google Cloud 的 Sepolia 水龙头,填自己的地址领 0.05 ETH。领不到就换一个水龙头或找同学转一点,测试币没有市场价值。
- 回到 Remix,Deploy & run transactions → Environment 选 Browser Extension。确认右侧显示 Sepolia Testnet - MetaMask,Account 一栏出现钱包地址和余额。
Task 5:手里只有 ABI 和一个地址。 操作步骤:
- 新建
faucet2.abi,粘贴课件给的 ABI。报「Failed to parse the current file as JSON ABI」时,是从 PDF 复制混进了不可见字符。先粘进任何纯文本编辑器,再复制一次。 - 保持
faucet2.abi在编辑器里打开,Environment 切到 Browser Extension。 - 切到 Deployed contracts 标签 → 点 + Add Contract → 在 Add a deployed contract 表单里粘贴地址
0x7a1652710EF83b13997BC113692Cb481C714037d→ Add。 - 合约卡片出现后逐个调用,每次都在 MetaMask 里确认,然后看控制台的报错和 logs(事件日志)。
题目问「所有函数都名副其实吗」。对照链上的实际行为和历史事件:
| 函数 | 名字说的 | 实际做的 |
|---|---|---|
gettwiceyourmoneyback() |
退你双倍 | nonpayable,带不进钱;把合约里的 1 gwei(10 的 9 次方 wei)转给部署者,emit transfered money to owner |
secretfunction() |
秘密功能 | 非 owner 调用 revert,报 you are not the owner;owner 调用只 emit nothinghappen |
sendyourmoney() |
寄出你的钱 | payable,收下你的 ETH 后什么都不做 |
receive |
接收转账 | 名副其实 |
链上那 27 条历史事件全是 transfered money to owner。每个来调它的同学,都在替出题人把合约里的钱转回他自己的账户。题目教的是一套方法:对一份没验证源码的合约,调用之前先看三样证据。一是它 revert 时的报错字符串,二是它 emit 的事件,三是调用前后各账户余额的变化。
Task 6:唯一的编程题
题目要在原始 Faucet 上补三件事。① withdraw 里记录提款地址和金额。② 每次提款 emit 事件。③ 写 getAllAddresses() 按累计提款额升序返回地址。Hint 指向 struct(结构体)存单笔记录、mapping 存金额、array 存地址。完整题解:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.15;
contract Faucet {
address public Owner;
// 一笔提款记录(Hint 1:struct)
struct Withdrawal {
address who;
uint256 amount;
uint256 timestamp;
}
Withdrawal[] public history; // 每一笔提款,按时间顺序
mapping(address => uint256) public totalWithdrawn; // 每个地址累计提了多少(Hint 2:mapping)
mapping(address => bool) private seen; // 这个地址是否已经进过名单
address[] private withdrawers; // 提过款的地址名单,不重复(Hint 2:array)
event Withdrawn(address indexed to, uint256 amount, uint256 total);
constructor() {
Owner = msg.sender;
}
modifier onlyOwner() {
require(msg.sender == Owner, "Not Owner");
_;
}
// Give out ether to anyone who asks
function withdraw(uint256 withdraw_amount) public {
// Limit withdrawal amount
require(withdraw_amount <= 1 ether, "Max 1 ether per withdrawal");
require(address(this).balance >= withdraw_amount, "Faucet is empty");
// 先记账,再转钱(checks-effects-interactions)
if (!seen[msg.sender]) {
seen[msg.sender] = true;
withdrawers.push(msg.sender);
}
totalWithdrawn[msg.sender] += withdraw_amount;
history.push(Withdrawal(msg.sender, withdraw_amount, block.timestamp));
emit Withdrawn(msg.sender, withdraw_amount, totalWithdrawn[msg.sender]);
// Send the amount to the address that request it
payable(msg.sender).transfer(withdraw_amount);
}
function transfer(address payable _to, uint256 _amount) public onlyOwner {
_to.transfer(_amount);
}
// 按累计提款额从小到大返回地址;金额相同时先提款的排前面
function getAllAddresses() public view returns (address[] memory) {
uint256 n = withdrawers.length;
address[] memory result = new address[](n);
for (uint256 i = 0; i < n; i++) {
result[i] = withdrawers[i];
}
// 插入排序:在内存里排,不改链上存储
for (uint256 i = 1; i < n; i++) {
address key = result[i];
uint256 keyTotal = totalWithdrawn[key];
uint256 j = i;
while (j > 0 && totalWithdrawn[result[j - 1]] > keyTotal) {
result[j] = result[j - 1];
j--;
}
result[j] = key;
}
return result;
}
function getHistoryLength() public view returns (uint256) {
return history.length;
}
receive() external payable {}
}
几处设计要能说出理由。withdraw 上原有的 onlyOwner 去掉了,否则名单里永远只有部署者一个地址,排序无从谈起。排序放在 view 函数里,在内存数组上做插入排序,结果不写回存储,链下调用不花 gas。但它是 O(n²),地址多到几百上千时应把统计交给链下。比较用严格大于号,累计额相同的地址保持首次提款的先后。多加的余额检查让余额不足时报 Faucet is empty,比 transfer 失败时的报错好懂。事件的 to 标了 indexed(可索引),前端可以按地址过滤。
编译会出两条黄色警告,说 transfer 已弃用,分别指向 withdraw 和 transfer 函数里的两次转账。
transfer 只给接收方转发 2300 gas,接收方是合约且 receive 里多做点事就会失败。题解保留它只为少改题目给的代码。自己写新合约时改成 (bool ok, ) = payable(msg.sender).call{value: withdraw_amount}(""); require(ok, "Transfer failed");。
部署和充值的步骤如下。Environment 回到 Remix VM,用 Account 1 部署。顶部 Value 填 3000000000000000000 wei。到合约卡片最底部 Low level interactions,CALLDATA 留空,点 Transact,卡片 Balance 变成 3 ETH。最后 Value 改回 0。不先充值,第一次提款就会撞上 Faucet is empty。
一步一步看
目标:跟着四笔提款和一次 getAllAddresses,看出名单只在新地址第一次来时追加,最后按累计额排成 A2、A1、A3。
充值 3 ETH 后,Account 1、2、1、3 依次提 0.5、0.3、0.4、1 ETH,再调一次 getAllAddresses。下表 A1–A3 是三个账户。
-
A1 提 0.5。它第一次来,名单追加 A1,累计记 0.5,history 记一笔,然后才转钱。
-
A2 提 0.3。也是第一次来,名单变成 [A1, A2]。
-
A1 再提 0.4。seen 已是 true,名单不动,只把累计额加到 0.9。
-
A3 提 1。没超单笔上限,余额剩 0.8,history 长度 4。
-
排序 i = 1,拿出 A2(0.3)。前面 A1 的 0.9 大于 0.3,A1 后移,A2 落到最前。
-
排序 i = 2,拿出 A3(1.0)。前面的 0.9 不大于 1.0,A3 不动,结果是 A2 → A1 → A3。
课件里的坑
- [课件有误] p.8 开头说切到 Holesky,步骤 6 却是 Sepolia。以 Sepolia 为准,Holesky 已在 2025 年 9 月退役,接替它的是 Hoodi(p.8)。
- [课件有误] p.9 的 RPC 地址
https://sepolia.infura.io缺 API key,这样填连不上;Infura 要在后面接/v3/加自己注册的 key。直接用 MetaMask 内置的 Sepolia 可以绕过整个手动添加(p.9)。 - [课件有误] p.9 的区块浏览器地址
https://sepolia.etherscan.in拼错了,应为https://sepolia.etherscan.io(p.9)。 - [课件有误] p.11 正文说把地址粘进「At address」框,新版 Remix 已经没有这个框,换成 Deployed contracts 标签下的 + Add Contract。课件截图倒是新界面,照图操作即可(p.11)。
- [课件有误] p.12 的注释和代码打架:
withdraw上方写着「Give out ether to anyone who asks」,函数声明上却挂着onlyOwner。题解按注释的意图去掉了它;老师要求保留时加回去,其余代码照样能编译运行(p.12)。 - [课件留白] 课件没说部署后要先充值。合约余额是 0,直接调
withdraw一定失败(p.12)。 - [课件留白] 课件没说
withdraw参数单位是 wei,也没提醒 Value 和函数参数是两回事。require里的1 ether是 Solidity 的单位写法,编译后就是1000000000000000000;在输入框填1提走的只是 1 wei,顶部 Value 的单位下拉管不到函数参数(p.12)。 - [补充] 原始合约的
address Owner;没写public,部署后没有 Owner 按钮。题解补上了,方便核对谁是部署者(p.12)。
课后 10 分钟:考点复习
这 10 分钟怎么用:合上页面,先默写 Faucet 题解里四个存储变量各管什么、withdraw 里五段代码的先后顺序;再把下面的完整例题算一遍,四笔提款之后的余额、排序和事件参数都先自己写出来;最后回查两处最容易错的地方:输入框里的 wei 位数、Value 有没有清零。
必背
- Remix 的 Environment 选 Browser Extension 才会经 MetaMask 连到测试网;Remix VM 是浏览器里的模拟链,在那里找不到测试网上的合约
- ABI 只有函数名和参数类型,看不出函数体;判断未开源合约真实行为的证据只有报错字符串、事件和余额变化
- withdraw 的参数单位是 wei,提 1 ETH 要填 1 后面 18 个 0;新部署的合约余额为 0,要先充值才能提款
- mapping 不能遍历,要按累计额排序必须另存一份不重复的地址数组,排序在 view 函数里用内存数组做,链下调用不花 gas
- 先记账再转钱:状态更新和 emit 放在外部转账之前,这是 checks-effects-interactions 顺序,防止重入读到旧状态
- 把空存储槽第一次写成非零值是 EVM 里最贵的存储操作,所以首次提款比第二次贵六万多 gas
- transfer 只给接收方转发 2300 gas 且已弃用,新代码用 call{value: …}(“”) 并检查返回值
完整例题
题解部署到 Remix VM、充值 3 ETH 之后,按顺序提四次款(每次先在 Account 下拉切账户,再在 withdraw 输入框填 wei 数点 Transact):
| 次序 | 账户 | 输入框填的 wei | 金额 |
|---|---|---|---|
| 1 | Account 1 | 500000000000000000 |
0.5 ETH |
| 2 | Account 2 | 300000000000000000 |
0.3 ETH |
| 3 | Account 1 | 400000000000000000 |
0.4 ETH |
| 4 | Account 3 | 1000000000000000000 |
1 ETH |
问合约余额、getHistoryLength、getAllAddresses 的返回顺序、第 3 笔提款那条事件的三个参数,以及第 3、4 笔为什么 gas 差很多。
余额:3 − 0.5 − 0.3 − 0.4 − 1 = 0.8 ETH。getHistoryLength 返回 4,四笔都记下了。
排序:累计额分别是 Account 2 的 0.3、Account 1 的 0.9、Account 3 的 1.0,升序就是 Account 2 → Account 1 → Account 3。Account 1 的两笔被归并成一条,名单里不重复。
事件:展开第 3 笔交易看 logs,Withdrawn 的三个参数依次是 Account 1 的地址、400000000000000000(这次的 0.4)、900000000000000000(累计 0.9)。第三个参数给的是累计额,前端不用再查一次。
gas:第 3 笔是 Account 1 的第二次提款,transaction cost 109928;第 4 笔是 Account 3 的首次提款,174556。首次提款要做三次「把空存储槽第一次写成非零值」:seen 置 true、withdrawers 追加新元素、totalWithdrawn 从 0 变非零。第二次时这些槽已经有值,只需更新。
变式题
(一)去掉 seen,改用 totalWithdrawn[msg.sender] == 0 判断「是不是第一次提款」,会出什么问题?(二)把插入排序里的 > 改成 >=,返回结果怎样变?(三)把 history.push 和 emit 挪到 transfer 之后,有什么风险?
提示
(一)找一种提款,执行完 totalWithdrawn[msg.sender] 仍是 0。(二)累计额互不相同时有区别吗?相同时呢?想想稳定排序的定义。(三)转账把控制权交给接收方,接收方若是合约,它的 receive 里能做什么?
参考答案与自检(非官方评分标准)
自检要点:① 说出「提 0 wei」和名单膨胀;② 说出并列时顺序反转、排序变得不稳定;③ 说出重入时读到旧状态。
(一) 提 0 wei。上限检查和余额检查都过得去,转 0 也不失败,累计额加完还是 0,于是这个地址每提一次就被 push 进 withdrawers 一次。名单无限膨胀,O(n²) 的插入排序很快跑不动。补法是保留 seen,或在开头加 require(withdraw_amount > 0, "Zero withdrawal");前者更稳,它不依赖「金额一定大于零」这个可能被改掉的前提。
(二) 累计额互不相同时结果一样。出现并列时,>= 让后来的元素继续往前挪、越过与它相等的那些,并列地址变成按首次提款的倒序排列,排序从稳定变成不稳定。题目只要求升序,两种都算对,写出并列规则是加分项。
(三) 接收方是合约时,可以在 receive 里回头再调 withdraw。账还没记,重入读到的是旧的累计额和旧的名单状态,记账顺序会错乱;换成 call 转账后还可能被反复提款。现在用的 transfer 只转发 2300 gas,重入很难成功,但顺序写对没有任何成本。
闪卡自测
在 Remix VM 下 Add Contract 粘贴 Task 5 的地址,能调到那份合约吗?
调不到。Remix VM 是浏览器里的模拟链,那个地址上什么都没有;要先把 Environment 切到 Browser Extension 连 Sepolia。gettwiceyourmoneyback 的 stateMutability 是 nonpayable,只凭这一点能推出什么?
调用它时根本不能附带 ETH。一个收不了钱的函数声称要把你的钱翻倍返还,名字和能力对不上。只有 ABI 没有源码为什么就能调合约?反过来为什么不行?
发交易只需要函数签名和参数编码方式,这些全在 ABI 里。ABI 不上链,只有地址时没有现成的接口描述,很难拼出正确的 calldata。原始水龙头合约部署完直接调 withdraw(1) 会成功吗?
不会。参数 1 是 1 wei;更关键的是合约余额为 0,转账那一步失败,要先充值。为什么题解要多一个 seen,不直接看 totalWithdrawn 是否为 0?
提 0 wei 后累计额仍是 0,同一个地址会被重复记进名单。seen 是不依赖金额的显式标记。事件 Withdrawn 的 to 为什么要加 indexed?
indexed 参数进入 topic,前端可以按地址过滤出「某人的全部提款」,不用把所有事件拉下来再筛。同一个 withdraw,首次提款为什么比第二次贵六万多 gas?
首次要把三个空存储槽第一次写成非零值,这是 EVM 里最贵的存储操作;第二次只是更新已有的值。下一步
先在 Remix VM 上把题解原样部署,照完整例题四笔提款点一遍,余额、排序、事件参数和两个 gas 数字都对上了再往下走。然后动手改:把两处 transfer 换成 call{value: …}("") 加返回值检查,重跑同一组提款,看编译警告是否消失、gas 怎么变;再写一个 getHistory(uint256 i) 返回第 i 笔的三个字段,和编译器给 history 自动生成的 getter 比较接口差异。最后试一次只用 Withdrawn 事件的 logs 手工还原每个地址的累计额,体会链上发事件、链下做统计的分工。Task 4 建的 Sepolia 账户留着,后面把合约部署到测试网、在区块浏览器上验证源码都要用它。
个人整理的学习笔记,不是官方材料;数字与结论以课件和讲师为准。