← COMP5521 全部讲次
Lab2 · 第 3 周

Lab 2 Web3.js 与 Hardhat:把 Remix 那个按钮拆开

同一件事在命令行做两遍,学的是「源码 → 编译产物 → 交易 → 节点 → 链上状态」每一环归谁。

一句话版

Lab 1 在浏览器里点按钮把合约部署上链,这份 Lab 用命令行把同一件事做两遍(先 Web3.js 后 Hardhat,要敲的命令不到十条),看清流水线上每一环归谁管。

先认识这几个词

读之前最好先做过 Lab 1(钱包、测试网、部署合约)。

词 全称 / 读法 一句人话
solc Solidity compiler,Solidity 编译器 把合约源码翻译成机器能执行的东西
bytecode 字节码 编译后的机器码,部署时随交易上链
ABI Application Binary Interface,应用二进制接口 合约有哪些函数、参数怎么编码的说明书,留在本地
RPC 节点 Remote Procedure Call,远程过程调用 替你的程序跟区块链网络打交道的那台服务器
Web3.js 一组 JavaScript 库 让脚本连上节点、发交易、读合约
Hardhat 一套命令行开发工具 把编译、测试、部署打包成几条命令
view 只读函数的修饰符 承诺这个函数不改合约状态
ERC-721 以太坊 NFT 标准 每枚代币独一无二、可转让的那种代币规范

题目地图

整份 Lab 分四段,命令都封在 Docker 镜像(打包好的运行环境)里,不用自己装 Node、solc 和 Hardhat。末页划了考试边界:Lab test 不要求写智能合约,要求知道怎么编译和执行合约。

段落 学什么 主要失分点
Lab 1 回顾 合约的不可变性、交易原子性(要么全做完、要么全不算) 把「不可变」理解成状态也不能改
Web3.js 原理 编译产物、节点、三步流程 说不清 ABI 和 bytecode 各去哪
Web3.js 实操 四条命令 + 浏览器对账 以为查 counter 也算一笔交易
Hardhat 工程化工具链 + ERC-721 不知道 8 行合约的逻辑从哪来

前两段回答「编译」,后两段回答「执行」,正好覆盖考试边界的两个词。

概念卡

1. 编译产物:ABI 与 bytecode

人话定义:它解决「写好的合约怎么变成链能跑、别人能调的东西」。本 Lab 主要用 solc 的两类输出:bytecode 与 ABI;编译器还能输出其他信息。

例子:bytecode 是 EVM(以太坊虚拟机)真正执行的低级代码,随创建交易上链。ABI 告诉调用方合约有哪些函数、参数怎么编码、返回值怎么解码,它留在本地。Remix 把这一步藏在一个按钮后面,所以 Lab 1 做完你也不知道产物长什么样。命令行这一遍会把两样东西都摆到你面前。

从合约源码到链上的流水线:Incrementer.sol 经 solc 编译,产出 ABI 接口说明书(留在本地不上链)和 bytecode 机器码(部署时随交易上链);本机 Web3.js 脚本拿 bytecode 和 ABI 组交易并用私钥签名,私钥不出本机,通过 JSON-RPC 交给 Infura 代管的 RPC 节点,节点只转发已签名交易到 Sepolia 测试链,验证者打包后合约拿到地址

常见误解

以为 ABI 文件必须随合约上链 → ABI 供客户端编码、解码,部署时不必存上链。补充:知道函数签名和参数类型也能手工编码,不必有完整 ABI 文件。Etherscan 源码验证是核对源码与字节码,不是调用前协议强制的步骤。

回讲义:L10c 合约的一生:部署、算地址、调用、自毁

2. Web3.js 与 RPC 节点(JSON-RPC)

人话定义:它解决「我的脚本怎么跟区块链说上话」。Web3.js 是一组 JavaScript 库,通过 HTTP、IPC 或 WebSocket 连上一个以太坊节点,按通用 JSON-RPC 规范(一种请求/应答的消息格式)说话。

例子:链路是「你的脚本 → RPC 节点 → 以太坊 P2P 网络」。P2P 网络就是所有节点互相转发消息的那张网。脚本从不直接接触它,广播由节点代劳。节点可以自己搭,也可以用 Infura 这类公共服务。自己搭要同步链数据,硬盘和时间都不便宜。Lab 1 里 MetaMask 扮演的就是节点这个角色,它内置了节点地址,你没感觉到这一环。

常见误解

以为 Lab 1 没用过 Infura → MetaMask 默认走的就是它,这次只是要你自己注册一个 key。注册时网络类别选 Web3 API 而非 IPFS。拿到的端点形如 https://sepolia.infura.io/v3/<key>,末尾那 32 位就是配置命令的第一个参数。

回讲义:L10a 以太坊:一台世界计算机和两种账户

3. view 函数与「什么才算一笔交易」

人话定义:它解决「哪些操作要花钱上链」。要让状态变化写入链上,就提交 transaction(交易);只想看结果,用 call(调用)模拟。view 不等于免费开关:它限制状态修改,不决定调用是否上链(补充)。

例子:Incrementer 合约里 increment 和 reset 会改 counter,各产生一笔交易和一个交易哈希。getCounter 标了 view,节点用 eth_call 本地执行,不上链、不花 gas。所以做完「一次 increment、两次查询、一次 reset」,浏览器的交易列表里只有 2 笔。

Lab 2 里哪些操作产生交易:上排 deploy 写入 counter = 4142、increment(1222) 后 5364、reset(5521) 后 5521,三个都上链、花 gas、改状态;中间一条是 Etherscan 看到的顺序,Reset 在区块 11708700,Increment 在区块 11708683,相隔 17 个块约 4 分钟;下排 getCounter 走 eth_call 不花 gas 不上链

常见误解

以为 failed 等于「没发生交易」 → 已上链但顶层调用失败的交易仍消耗 nonce(账户的交易计数)、支付已用 gas,只有合约状态回滚。REVERT 保留未用 gas,out of gas 耗尽所供 gas。提交前就因 intrinsic gas(交易起步费)不足被拒,则根本没上链(补充)。

回讲义:L10b 交易字段、gas 与原子性:一笔交易怎么收费、怎么失败

4. Hardhat 工程与继承(Inheritance)

人话定义:它解决「合约项目怎么像正经软件一样管理」。Hardhat 是命令行的合约开发环境,把生命周期管理(编译、部署等各阶段)、自动测试、脚本化部署、网络管理、交互控制台、外部脚本执行整合成一套脚手架。

例子:CompCoin 合约正文只有 8 行,却是一个完整的 ERC-721 代币。所有权、转账、授权、枚举的逻辑全部继承自 OpenZeppelin(一个开源合约库)的 ERC721Enumerable。本合约只做两件事:给父类传名字 CompCoin 和符号 COMP,再用 _safeMint(msg.sender, 4142) 给部署者铸一枚 token。Remix 也能解析它支持的 npm 导入;Hardhat 的价值在于可复现的依赖、测试和部署。

常见误解

把 _safeMint 和 _mint 当同一个 → _safeMint 多一步检查。接收方若是合约,必须通过 onERC721Received 接收检查,否则拒绝铸造。这降低误转风险,但不保证接收合约有正确的取出逻辑。

回讲义:L10c 合约的一生:部署、算地址、调用、自毁

逐题拆解

回顾部分有两条比 Lab 1 更精确的定义。第一条是「部署后不可变」后面补的 (At the bytecode level)。意思是字节码改不了,但合约存的状态一直在变,本 Lab 的 counter 就是活例子。第二条是合约能读取执行上下文,也能调用其他合约。历史块哈希只能在有限范围内查询。它不能自己访问网页,block.timestamp(区块时间戳)也不是任意精度的外部时钟。所以真实项目需要预言机(oracle,把链外数据送上链的服务)。

Web3.js 那一段把 Remix 的一个按钮拆成三步。solc 在本地编译,出 ABI 和 bytecode。Web3.js 把字节码和交易发给节点;部署时带创建字节码和构造参数,调用已有合约时才填地址和编码数据。最后公共节点把交易广播到网络,轮到链来处理。

实操那一段是考区

四条命令:deploy 返回一个链上地址,后面三条命令的第一个参数都是它。increment <地址> <值> 返回交易哈希。counter <地址> 只打印一个数,没有哈希。reset <地址> <值> 又是一个哈希。演示数是初值 4142,increment 1222 之后查得 5364,再 reset 成 5521。配置那一步要交两样东西:Infura 的 API key(32 位)和 MetaMask 导出的私钥(64 位十六进制,不带 0x)。脚本要私钥,是因为部署和调用都要签名。Lab 1 里签名由 MetaMask 弹窗完成,现在脚本得自己签。

一步一步看

目标:依次跑 deploy、increment、counter、reset 四条命令,看出哪些会产生交易哈希,counter 每步变成多少。

  1. npm run deploy:构造函数把 counter 设成 4142,输出合约地址。

    命令第 1 帧:链上 counter 为 4142 并青绿标出,合约页交易表还没有调用记录,下方是 deploy 输出的合约地址

  2. npm run increment <地址> 1222:counter 变成 4142 + 1222 = 5364,输出交易哈希,合约页交易表多出一笔 Increment。

    命令第 2 帧:counter 从 4142 变成 5364 并青绿标出,交易表多了一笔 Increment,输出是交易哈希

  3. npm run counter <地址>:只打印 5364,没有哈希。getCounter 是 view 函数,走 eth_call,交易表还是 1 笔。

    命令第 3 帧:输出一行青绿标出,只打印 5364、没有交易哈希,counter 和交易表都没变

  4. npm run reset <地址> 5521:counter 被覆盖成 5521,又出一个交易哈希。交易表一共 2 笔:Reset 和 Increment。

    命令第 4 帧:交易表变成 Reset 和 Increment 两笔并青绿标出,counter 变成 5521

Hardhat 那一段

同一条流水线换一套工具再走一遍。npm run build 实际是 hardhat compile,输出编译器版本 0.8.29 和 EVM 目标 cancun。npm run deploy 实际是 hardhat run script/deploy.js --network sepolia。那个 --network sepolia 说明 RPC 地址、Sepolia 的 chain ID(链编号)和签名私钥都写在配置文件里,由配置那一步注入。部署完去浏览器看合约页,会多出一栏 Token Tracker,显示 CompCoin (COMP)。浏览器检测到字节码实现了 ERC-721 接口,就把它认成代币合约;Incrementer 的页面没有这一栏。

Etherscan 上 CompCoin 合约页的顶部:Overview 栏余额 0 ETH,More Info 栏显示 Contract Creator 地址与 1 min ago,下方 Token Tracker 一行用红框圈出 CompCoin (COMP),Multichain Info 为 N/A
图片来源:COMP5521 Lab 2 Smart Contract Advanced, p.51

课件里的坑

  • [课件有误] 创建交易的 to 字段为空,不是零地址 0x000…000。答题应明确「contract creation: no recipient」,不要为了贴近课件而写成向零地址转账。
  • [课件留白] reset 函数没有任何权限检查,链上任何人都能把 counter 改成任意值。教学合约不管这个,真实合约这里必须加 onlyOwner 之类的访问控制。
  • [补充] counter 已经声明为 public,编译器会自动生成一个同名 getter,严格说 getCounter() 是多余的。课件保留它是为了演示 view 修饰符。
  • [补充] --rm 会在容器退出后删除容器及其可写层;挂载卷或宿主机文件不因此消失。若配置只存在容器内,重建容器后需重新配置;Docker 是否要 sudo 取决于本机权限配置。
  • [补充] 只用全新、无真实资产的测试账户私钥,绝不提交仓库、截图或发给他人。新建账户不等于撤销旧密钥;泄漏后应迁移旧账户资产和权限。64 位 hex 是私钥字节的文本表示;是否带 0x 按本 Lab 脚本要求,不是通用规则。
  • [课件有误] Mac 安装页的标题错写成 “Install Docker Desktop on Windows”,正文把 Docker.dmg 写成了 “Docer.img”;Windows 页的 “checkboxs”、重置脚本输出的 “Reseting” 也都少字母。都是笔误,按流程做即可,别以为自己下错了文件。
  • [补充] p.38 之后发交易的账户是 0x4F54…E071,和 p.10 Remix 里连着的 0x7223…FB1F1 不是同一个:TA 换了一个账户导出私钥。这不影响流程,但对照 Etherscan 时别拿 p.10 的地址去找那两笔交易,找不到不是你做错了。

课后 10 分钟:考点复习

这 10 分钟怎么用:合上页面,先默写三样——solc 的两样输出各去哪、生成一笔调用交易需要哪三个输入、哪些操作会上链;再做下面的「变式题」,重点是数清交易笔数;最后回查两处最爱错的地方——私钥不带 0x、查询不产生交易。

必背

  1. 本 Lab 使用 solc 的两类输出:bytecode 随创建交易上链交给 EVM 执行,ABI 不上链、留在本地供调用方编码参数和解码返回值。
  2. Web3.js 只跟一个 RPC 节点说话,由节点替你广播到 P2P 网络;三种连法是 HTTP、IPC、WebSocket,实现的是通用 JSON-RPC 规范。
  3. 本 Lab 用合约地址、ABI、方法参数构造调用;签名交易还需 nonce、gas、chain ID 等字段,部分由工具补齐。
  4. 本 Lab 查询通过 eth_call 模拟执行,不产生链上交易费;view 只约束不修改状态,被链上交易调用仍消耗 gas。
  5. 顶层执行失败回滚合约执行状态,但 nonce 与已用 gas 费用不回滚;REVERT 保留未用 gas,执行耗尽 gas 则消耗所供 gas。
  6. 配置命令的两个参数是 Infura API key 和私钥,前者 32 位、后者 64 位十六进制且不带 0x 前缀;私钥的用途是给交易签名。
  7. Incrementer 的 counter 初值 4142,increment 1222 之后是 5364;一次 increment 加一次 reset 在浏览器上是两笔交易,中间的查询不留痕迹。
  8. CompCoin 只有 8 行是因为继承了 OpenZeppelin 的 ERC721Enumerable;构造函数里的 _safeMint(msg.sender, 4142) 给部署者铸一枚 token ID 为 4142 的 NFT。

完整例题

把课件演示的那一轮从头对账一遍:部署 → increment 1222 → 查 counter → reset 5521 → 再查 counter,最后去浏览器核对。

  1. 部署。deploy 打印出合约地址 0x85bf…9ecd,构造函数收到 4142,所以 counter 初值是 4142。这一步是一笔创建交易,to 为空。
  2. increment 1222。脚本用 ABI 把 increment(1222) 编码进 data 字段,用私钥签名,经节点广播,等上链后打印交易哈希。counter 变成 4142 + 1222 = 5364。
  3. 查 counter。打印 “The current counter stored in the contract is: 5364”,没有交易哈希——getCounter 是 view 函数,节点本地算完就返回。
  4. reset 5521。又一笔交易,counter 直接被设成 5521。再查一次仍然没有哈希。
  5. 浏览器对账。合约页显示 “Latest 2 from a total of 2 transactions”:一笔 Reset 在区块 11708700,一笔 Increment 在区块 11708683。三处可验算——① 五步操作共三笔链上交易(部署、increment、reset),截图列表展示后两笔,两次查询无痕;② 两笔相隔 11708700 − 11708683 = 17 个区块,页面显示时间差约 4 分钟,17 × 12 s ≈ 3.4 min,与 12 秒 slot 的数量级相符;可能漏 slot,不能用区块差推精确耗时;③ 两笔的 Value 列都是 0 ETH,它们只带 data 不带钱。
Etherscan 合约页的 Transactions 标签,标题 Latest 2 from a total of 2 transactions。两行记录:Method 为 Reset 的一笔在区块 11708700、2 mins ago、手续费 0.00003692;Method 为 Increment 的一笔在区块 11708683、6 mins ago、手续费 0.00004235;两笔的 From 是同一个账户,To 都是 Incrementer 合约地址,Amount 都是 0 ETH
图片来源:COMP5521 Lab 2 Smart Contract Advanced, p.42

部署的创建交易也存在链上。课件截图列表只显示两笔调用,可从 Contract Creator 链接另查创建交易;不要把页面展示范围当协议规则。

变式题(先自己做)

换一串操作自己数:合约部署完 counter 初值仍是 4142,然后依次执行 increment 379 → 查 counter → reset 900 → increment 121 → 查 counter。

(1) 两次查询各打印什么数?(2) 浏览器的交易列表里会出现几笔交易,Value 列分别是多少?(3) 假设那两笔 increment 和一笔 reset 分别落在区块 X、X+9、X+26,假设没有漏 slot,最后一笔约比第一笔晚多久?(4) 如果第二笔 increment 已上链、顶层执行时耗尽 gas,counter 停在多少、这笔 gas 退不退?

提示

第 (1) 问注意 reset 是直接赋值而不是加减。第 (2) 问数清哪些操作改了状态——创建交易不在这个列表里。第 (3) 问用 Sepolia 12 秒一个块去乘。第 (4) 问回想交易的原子性那一条。

参考答案与自检(非官方评分标准)

自检要点:① reset 是赋值;② 本 Lab 查询走 eth_call;③ Value 与 gas fee 不同,0 ETH 也可能有手续费;④ 区分执行回滚、nonce 和费用。

(1) 第一次打印 4142 + 379 = 4521;reset 900 把 counter 直接设成 900,再加 121,第二次打印 1021。

(2) 3 笔:两笔 increment、一笔 reset,两次查询走 eth_call、不上链。三笔的 Value 列都是 0 ETH——它们只在 data 字段里带方法调用,没转任何币。此处不含已经完成的部署;算上部署总共 4 笔链上交易。

(3) 区块号差 (X+26) − X = 26,无漏 slot 时,26 × 12 s = 312 s ≈ 5.2 分钟;实际应读两个区块时间戳。

(4) counter 停在 900;已上链的第二笔 increment 顶层耗尽 gas,执行状态回滚、所供 gas 被消耗,nonce 不回滚。它仍显示 Failed,所以部署后的调用交易仍共 3 笔。若提交前被拒绝,则不能这样计数(补充)。

闪卡自测

1. 「合约部署后不可变」在哪个层面成立?

字节码层面。合约存储的状态照样变——counter 每次 increment 都在变,并不违反这条。工程上还可以用代理模式把逻辑地址指向新合约,不过那超出课件范围。

2. 合约能读到哪些上下文?它能去查一个网页吗?

可读自己的状态与交易、区块上下文,并能调用其他合约;不能直接访问网页。外部数据需通过预言机等机制输入链上,不能把「不能联网」误解为「不能读别的合约」(补充)。

3. solc 输出的两样东西各给谁用?

bytecode 给 EVM,随创建交易上链;ABI 给调用方(Web3.js、前端),不上链,用来编码调用参数和解码返回值。

4. Web3.js 和 P2P 网络之间隔着什么?

一个 RPC 节点。脚本通过 HTTP / IPC / WebSocket 按 JSON-RPC 规范跟它说话,由它把交易广播到 P2P 网络。节点要么自建,要么用 Infura 这类公共服务。

5. 为什么命令行脚本需要私钥,而 Remix 里不需要手动提供?

部署和调用都要对交易签名。Remix 里签名由钱包弹窗完成,钱包握着私钥;换成脚本之后没人替你签,本 Lab 将私钥交给脚本签名;真实工程也能用外部签名器。只用测试账户,结束后停止使用它。

6. 四条命令各返回什么?

deploy 返回合约地址;increment 和 reset 各返回一个交易哈希;counter 只打印当前值,没有哈希,因为这个脚本用 eth_call 查询,而不是发送交易。

7. CompCoin 只有 8 行,ERC-721 的转账和授权逻辑从哪来?

从 import 的 OpenZeppelin ERC721Enumerable 继承而来。合约自己只做两件事:给父构造函数传名字和符号、给部署者铸一枚 token。

8. 为什么 CompCoin 的合约页有 Token Tracker,Incrementer 的没有?

浏览器会检测字节码是否实现了 ERC-721 等代币接口,命中就自动识别成代币合约并读出名字和符号显示为 Token Tracker。Incrementer 不是代币,所以没有这一栏。

下一步

第 4 周公众假期停课,接下来两次 Lab 是 Project 介绍。这两周把两条流水线各自完整跑一遍,另外做三件课件没要求的事。

第一,去末页给的两个 GitHub 仓库把 deploy.js、increment.js、get_counter.js、reset.js 读一遍,找出三件事:ABI 从哪个文件读进来、web3.eth.Contract 的构造参数是什么、签名用的是哪个方法。考试说的「知道怎么执行」,边界就是这四个脚本。

第二,给 CompCoin 再铸一枚 token(改构造函数或加一个 mint 函数),重新编译部署,对比编译输出和 Token Tracker 有没有变化。

第三,在浏览器上找到 Incrementer 那笔创建合约的交易,看它的 to 字段和 Input Data,跟课件那句「目标地址 0x0」当面对质一次——这是全份材料里最值得自己验一遍的地方。

Project 大概率要在 Hardhat 这套工程结构上做,现在把镜像里的 contracts/、script/ 和配置文件看熟,十月初听 Project 介绍时就不会一头雾水。

下一讲 →
L04a L04a RSA 签名:私钥盖章、公钥验章

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