← COMP5521 全部讲次
R01

Lab Test 复习资料|当前材料版(11-07)

现有材料范围内的非官方复习,含英文术语、成立条件与自拟练习解析。

手机上宽表格可左右滑动;自测答案默认收起,点击题目下方按钮查看。

2026-11-07 · 当前材料版(Lab 1–3、HTLC、Lab 5–7)· 操作推演与英文自测

测验类型与范围边界

非官方 Lab Test 复习资料,不是 Midterm 真题。 现有课程信息列 Lab 9 Test:11-13,20:20-21:20,一小时、开卷、占 10%。最新考试安排、可携带资料和范围以讲师通知为准;“开卷”不自动等于允许联网、使用 AI 或相互讨论。

当前覆盖 Lab 1、Lab 2、Lab 3 及 HTLC 项目说明中的基础:部署与调用、回执与状态、ERC-20 授权、哈希锁与时间锁;11-07 补入 Lab 5(密码算法与应用)、Lab 6(Bitcoin Regtest)、Lab 7(Stablecoin,11-06 上课)的开卷速查:命令、函数签名、公式、常量、错误名与易错点。项目用于机制练习,不据此断言项目全部内容进入 Lab Test。讲师尚未正式公布范围,Lab 5–7 按可能考到整理,正式范围以讲师通知为准。

资料是定位索引,不是把操作截图背下来。每个实验都练“输入是什么、哪一步改状态、失败在哪里、用什么证据确认”。只用本地链或课程指定测试环境,使用独立测试账户,不公开密钥,不把测试脚本指向主网。

从源码到状态变化

对象 English 它能说明什么
ABI Application Binary Interface 描述如何编码调用、解码返回值和事件;不是可执行字节码。
创建代码 Creation bytecode 部署时执行,产生运行时代码;普通 EOA 创建交易无普通目的地址。
合约地址 Contract address 要连同 chain ID 判断;同样格式的地址不代表同一条链上的同一资产。
交易哈希 Transaction hash 标识已提交请求,不证明已入块或执行成功。
收据 Transaction receipt 查看纳入情况、status、gas、logs;成功也不自动等于最终性。
状态查询 State query 读取所选链与区块状态;RPC、网络和地址必须匹配。

正确操作链:核对网络/账户 → 编译器与依赖版本匹配 → 编译 → 部署 → 等待回执 → 核对合约代码和初始状态 → 写调用 → 再查回执与状态。编译成功只证明通过编译阶段,不保证业务正确。

eth_call 在指定状态上模拟,不发送链上交易,也不产生这次调用的链上手续费。view 是状态修改限制,不是“永远免费”的收费标签;交易中的 view 调用仍耗 gas。真实交易在稍后的状态执行,模拟成功不能保证届时成功。

版本提醒:Lab 1 的 ^0.8.0 对应 >=0.8.0 <0.9.0。后续课件采用的 Hardhat 流程可能不同;包名回显不是依赖实际版本。按给定样例和锁定依赖判断,不把不同大版本配置混在一起。

Solidity 调用与失败边界

msg.sender 是当前调用的发送者,可能是另一个合约,不总是最外层钱包。msg.value 是随当前调用附带的原生币数量,单位 wei;ERC-20 代币转账不会自动成为 msg.value。

空 calldata 的普通调用,有 receive 时优先走 receive;没有 receive 时才尝试 fallback。非空 calldata 匹配不到函数时走 fallback,带 ETH 还要求被选中的入口 payable。Payable 允许附带 ETH,不自动转账给某个收款人。

在题设普通 EOA 模型中,顶层交易已入块后 revert:执行内的存储、转账、日志回滚,但交易 nonce 消耗和已用 gas 费用保留。Invalid before inclusion 和 included but reverted 不同;未被纳入的无效候选没有本题中的链上执行费。

补充·自拟状态例:counter=4,三笔已纳入交易依次为 increment(3) 成功、increment(9) 后顶层 revert、reset() 成功。各笔后的 counter 为 7、7、0。第二笔不是“先变成 16,再永久留下”,它的执行效果被撤销。

ERC-20 与 HTLC

Allowance(授权额度)与 balance(余额)不同。标准 approve 设定 spender 可使用的额度,本身不搬走代币;后续 transferFrom 还需余额、额度和业务条件满足。补充例:Alice 有 100,approve 某合约 30 后余额仍 100、额度 30;该合约成功转走 20 后,按普通有限额度规则余额 80、剩余额度 10。

Native ETH 锁使用 msg.value;ERC-20 锁使用授权和代币转账。钱包“添加代币显示”只影响界面,不是铸币,也不是修改 totalSupply。Decimals 是显示换算约定,不保证所有代币都是同一个精度。

本项目 HTLC 的 claim 同时检查 caller、preimage、time、state:指定接收者、哈希匹配、期限内、仍 active。Preimage 是原像,attacker 是攻击者;知道秘密不等于自动拥有领取权限。

状态只能从 active 变为 claimed 或 refunded。为练习明确约定:claim 用 t<T,refund 用 t≥T;等号归退款侧。正式说明只写到期前后,比较符应在实现中明确并测试,这里不把自定符号冒充原代码。

Alice 先在 A 链锁代币给 Bob,Bob 在 B 链锁原生 ETH 给 Alice;Alice 在 B 链领取公开秘密,Bob 随后在 A 链领取。因此通常要求 T_A>T_B,并留足观察、确认和包含缓冲。两份普通合约不会直接跨链调用,链外协调端负责观察与提交。

补充反例:两边都在逻辑时间 100 到期,Alice 在 B 链 99 领取,Bob 的交易到 A 链 101 才包含,已经错过 A 链领取窗口。相同哈希不能弥补时间不足。Atomic swap 也不是两链同一瞬间提交;保障依赖监控、网络和时间假设。

Lab 5 密码原语速查

Lab 5 是六段 Python:hash、aes、rsa、ecdsa、proof_of_work、merkle_tree。hashlib 是标准库;AES、RSA、ECDSA 用 cryptography 库的 hazmat 层,需要 pip 安装。开卷时带补全后的完整代码,照抄课件有两处会出错(p.7、p.19)。逐段代码和实测输出见 Lab5 页面。

原语 关键调用 长度与参数 易错点
哈希 hashlib.sha256() → update(msg) → hexdigest() 十六进制字符数:MD5 32,SHA-1 40,SHA-224 56,SHA-256 64 课件标 SHA-1 的那行调用的是 sha224();hashlib.sha3_256 算的是 NIST 版,对不上 Solidity 的 keccak256
AES Cipher(algorithms.AES(key), modes.OFB(iv)) key 32 字节(AES-256),IV 16 字节,密文与明文等长 解密要同一把 key 和同一个 IV;错 key 或错 IV 得到乱码,不报错
RSA rsa.generate_private_key(public_exponent=65537, key_size=2048);padding.OAEP(MGF1(SHA256), SHA256, None) 密文 256 字节(512 个十六进制字符),明文上限 190 字节 191 字节报 ValueError: Encryption failed;加密用接收方公钥
ECDSA sk.sign(msg, ec.ECDSA(hashes.SHA256())),曲线 SECP384R1 DER 签名 102–104 字节 课件 verify 返回 0 表示通过、1 表示失败;签名防篡改,不保密

PoW 判定写成整数比较:int(hash_res, 16) < 2**(256 - bits),等价于二进制前 bits 位全为 0,平均尝试 2^bits 次,MAX_NONCE 是 2**32。十六进制一位对应二进制四位,前导 0 要换成二进制数:难度 10 位时,前缀 003f 写成二进制是 0000 0000 0011 1111,有 10 个前导 0,满足;前缀 0040 是 0000 0000 0100 0000,只有 9 个,不满足;平均尝试 2^10 即 1024 次。难度 12 位时 target 是 2^244,平均 4096 次。

Merkle 树:叶子先补到 2 的幂,补 2 × reduced_size − size 个空串(reduced_size 是不超过叶子数的最大 2 的幂);父节点是两个子节点十六进制哈希串拼接后再做一次 SHA-256。补齐后 n 个叶子,成员证明要 log₂n 个兄弟哈希,并写明兄弟在左还是在右。例:6 个叶子补 2 个空串,共 8 个,7 次父节点哈希;5 个叶子时 reduced_size 为 4,补 2 × 4 − 5 = 3 个空串,同样 8 个叶子、7 次父节点哈希,证明要 log₂8 = 3 个兄弟哈希。p.19 课件那行 leaves 有弯引号,照抄报 SyntaxError,‘Togethe’ 还少一个 r。比特币用二进制拼接、双 SHA-256、奇数复制最后一个,和本代码算出的根不能互比。

Lab 6 Bitcoin Regtest 命令速查

全程 Bitcoin Core 的 regtest:bitcoin.conf 写 regtest=1;用 CLI 时每条命令加 bitcoin-cli -regtest,钱包命令再加 -rpcwallet=<钱包名>;GUI 控制台(Window → Console)直接输命令。逐页讲解见 Lab6 页面。

步骤 命令 看什么
查链 getblockchaininfo chain 应为 regtest,显示 main 说明配置没生效
钱包与地址 createwallet "<名>"、getnewaddress "<标签>" 地址前缀 bcrt1;testnet 是 tb1,主网是 bc1
挖初始币 generatetoaddress 101 <地址> coinbase 满 101 个确认,第 1 块的 50 BTC 才可花
余额 getbalances、listunspent trusted 50、immature 5000;每个 UTXO 由 txid + vout 定位
钱包转账 sendtoaddress <地址> <金额> "" "" false true null "unset" null <fee_rate> 第 10 位是 fee_rate,单位 sat/vB;返回 txid
确认 getrawmempool → generatetoaddress 1 <地址> → getrawmempool 进块前在 mempool,挖块后返回空列表
原始交易 createrawtransaction '[{"txid":"<txid>","vout":0}]' '{"<收款地址>":9,"<找零地址>":2.999}' 输入只写 txid 和 vout,不写金额
签名、广播 signrawtransactionwithwallet <hex> → sendrawtransaction <签名后的 hex> complete 为 true 才广播
查块与交易 getblockcount、getblockhash <高度>、getblock <hash> 1、getrawtransaction <txid> true <blockhash> tx 列表第一项是 coinbase

公式:手续费 = 输入总额 − 输出总额,协议里没有单独的手续费字段;费率 = 手续费(sat)÷ vsize(vB);1 BTC = 100000000 sat。课件钱包转账:50 − 12 − 37.99998590 = 0.00001410 BTC = 1410 sat,vsize 141,1410 ÷ 141 = 10 sat/vB,正好是填的 fee_rate。课件原始交易:12 − 9 − 2.999 = 0.001 BTC 是手续费;忘写找零,剩下的 3 BTC 全成手续费,sendrawtransaction 默认拒绝费率高于 0.1 BTC/kvB 的交易。

课件四处要改:p.8 的 -testnet 应为 -regtest;p.15 getaddressesbylabel 的参数应是标签 “miningaddr”;p.21 问句的 1.999 和 2 应为 2.999 和 3;p.23 sendrawtransaction 要传签名结果里的 hex。按课件做完 p.23 再挖一块,getblockcount 返回 103:12 BTC 那笔在第 102 块,原始交易在第 103 块。挖完 101 块再挖 1 块(无其他交易),第 2 块的 coinbase 也成熟,trusted 变成 100,immature 仍是 5000(第 3–102 块共 100 块)。

Lab 7 Stablecoin 速查

三类稳定币:法币储备型(USDT、USDC,链下储备、中心化发行、可冻结地址)、加密资产超额抵押型(早期 DAI、LUSD)、算法型(UST,部分设计会死亡螺旋)。本 lab 做的是 CDP(Collateralized Debt Position):存抵押品,借出稳定币,同时欠下同额债务;最低抵押率 150%。课件例子:0.5 ETH 按 $3,000 值 $1,500,借出 1,000 个稳定币。完整讲解见 Lab7 页面。

合约 关键函数 错误名
StableToken(LABUSD) mint(to, amount)、burn(amount) 只有 engine 能调;setEngine(engine_) 只有 owner 能调且只能设一次 OnlyEngine、EngineAlreadySet、InvalidEngine
MockPriceFeed setPrice(token, newPrice) 只有 owner;getPrice(token) InvalidPrice、PriceNotSet、OwnableUnauthorizedAccount
StableEngine depositCollateral、mint、repay、withdrawCollateral、liquidate、healthFactor、quoteLiquidation 见下一张表
MockRwaVault(份额 mTBILL) ERC-4626 的 deposit、convertToAssets、previewWithdraw、redeem;accrueYield(assets) 只有 owner ZeroAmount

常量(代币和美元价格都是 18 位小数):PRECISION 1e18,MIN_COLLATERAL_RATIO 1.5e18(150%),MIN_HEALTH_FACTOR 1e18,LIQUIDATION_BONUS_BPS 1000(10%),BPS 10000。初始价格 ETH $3,000,RWA 底层 mUSD $1。

  • 抵押价值 = 数量 × 价格 ÷ 1e18;RWA 份额先 convertToAssets 换成底层数量再乘底层价格
  • HF = 抵押价值 ÷(债务 × 1.5),所需抵押向上取整;债务为 0 时返回 uint256 最大值,打印 N/A (no debt)
  • 最多可借 = 抵押价值 ÷ 1.5;mint 后 HF < 1 才 revert,HF 恰好等于 1 允许
  • 只有 HF < 1 才能清算;扣押美元 = 偿还额 × 1.1(向上取整),扣押 WETH = 扣押美元 ÷ ETH 价格(向上取整到 wei)
调用 依次检查 失败时的错误名
depositCollateral(token, amount) 抵押品受支持 → 数量非零 → transferFrom UnsupportedCollateral、ZeroAmount、没 approve 时 ERC20InsufficientAllowance
mint(amount) 非零 → 加上债务后 HF 不低于 1 ZeroAmount、BreachesLiquidationThreshold
repay(amount) 非零 → 不超过债务 → transferFrom 后 burn ZeroAmount、RepaymentExceedsDebt、ERC20InsufficientAllowance
withdrawCollateral(token, amount) 不超过已存数量 → 取出后 HF 不低于 1 InsufficientCollateral、BreachesLiquidationThreshold
liquidate(user, token, debtToCover) 受支持、非零 → 不能清算自己 → 对方 HF < 1 → 不超过对方债务 → 对方该抵押品够付含奖励的扣押量 → transferFrom 清算人的 LABUSD → 部分清算后 HF 必须提高 CannotLiquidateSelf、PositionIsHealthy、RepaymentExceedsDebt、InsufficientCollateral、ERC20InsufficientAllowance、LiquidationDoesNotImproveHealth
课上测试 输入 结果
Test 1 正常借 0.5 ETH($1,500),mint 1,000 HF 1.0000;事件 CollateralDeposited、TokensMinted;总供应 +1,000
Test 2 超借 同样抵押,mint 1,001 1500 ÷ 1501.5 ≈ 0.999001,revert BreachesLiquidationThreshold;债务、供应、锁定的 0.5 WETH 不变
Test 3 暴跌清算 ETH 从 $3,000 跌到 $2,400 抵押 $1,200,HF 0.80;Bob 用自己借来的 1,000 LABUSD 偿还,得 0.458333333333333334 WETH(约 $1,100,含 10% 奖励)

Test 3 清算后:Alice 剩约 0.041666666666666666 WETH(约 $100),债务 0,HF 显示 N/A,钱包里原来的 1,000 LABUSD 没被拿走;总供应 2,000 → 1,000(Bob 自己用 1 ETH 借的 1,000 债务还在,他的 HF 是 1.6)。Alice 净资产 $1,100,损失 $400:$300 来自 ETH 贬值,$100 是清算奖励。剩余的 WETH 仍归 Alice,可以 withdrawCollateral 取回。

03-guards 里的边界(README 只把第一条列为课堂讨论命令):ETH 跌 30% 到 $2,100 时 HF 0.7,全额清算要 1100 ÷ 2100 ≈ 0.5238 WETH,超过 0.5,revert InsufficientCollateral,本模型没有坏账兜底;同价位只清算 500,剩余抵押约 $500 对债务 500,HF 约 0.6667,低于原来的 0.7,revert LiquidationDoesNotImproveHealth;$2,400 时清算 500,HF 升到约 0.8667,仍小于 1 也允许;$2,400 时 Alice 先 approve 再自己 repay 200,债务 800,HF 回到 1;HF 恰好 1 时清算,revert PositionIsHealthy。多种抵押合并算:$1,500 份额加 0.5 ETH($1,500),总债务 2,000,HF 1。

RWA(ERC-4626):Alice 把 1,500 mUSD 存进金库得 1,500 份额,锁进 engine,借 900,HF 1500 ÷ 1350 ≈ 1.1111。owner 注入 75 mUSD(模拟 5% 收益)后,份额仍是 1,500,底层 1,575,HF ≈ 1.1667,债务不变(OpenZeppelin 虚拟份额带来 1 wei 误差)。底层价格再跌到 $0.8:抵押约 $1,260,HF ≈ 0.9333,低于 1;Bob 清算 900 拿走约 $990 的份额,赎回约 1237.5 mUSD,自己借的 1,000 剩 100 LABUSD。课件列的 RWA 风险:托管方或发行方失败、赎回限制与流动性不足、估值滞后、法律执行与监管干预;链上份额价值可能和底层资产的真实可变现价值不同。

运行命令(仓库 README):npm run test:core -- --grep test_normal_stablecoin_minting,另两项把名字换成 test_reject_excessive_borrowing、test_market_crash_and_liquidation;讨论项 npm run test:guards -- --grep test_insufficient_collateral_after_30_percent_crash;RWA 是 npm run test:rwa。依赖 Hardhat 3.21.2、solc 0.8.30、ethers 6.17.0,README 要求 Node 24。

易错点:清算人偿还用的是自己的 LABUSD,借款人钱包里的稳定币不会被自动扣走;清算前清算人要 approve engine,否则整笔 revert,偿还和扣押一起回滚;任何一笔 revert 后债务、抵押、总供应都不变,失败交易的 gas 照付。

课件与仓库差异:课件文件名和 package.json 的 name 写 lab8,标题是 Lab 7;Test 2 的副标题照抄了 Test 1 的问句;课件文字里 Test 2 的 Projected Health Factor 后面没有数值,测试脚本打印 0.999001;课件写 Bob 得到 $1,100 的 ETH,合约向上取整,实际多出不到 1 wei 的 WETH。

实验复习的证据清单

每个用例记录前状态、调用者、参数、预期成功/失败、回执、后状态。要覆盖正常路径和至少一个反例,而不只截“绿色成功”。本册提供练习设计,未声称已经运行课程工程。

场景 应观察什么 易误判之处
正常部署与 increment 地址、状态初值、成功回执、新 counter 把编译成功当部署成功
错网络或错地址 chain ID、该地址代码、预期接口 把余额零直接当丢币
失败交易 失败回执、状态未变、gas 已付 声称所有结果都回到交易前
ERC-20 锁定 allowance、实际代币余额变化、交换状态 把 approve 当完成交换
HTLC 失败路径 错秘密、错调用者、过早退款、过期领取、重复操作 只测正确秘密

建议按一小时练习时段安排:10 分钟定位资料,20 分钟部署与读写推演,20 分钟失败场景,10 分钟英文解释。此为练习分配,不是正式题型或评分规则。英文答题可用 “The call fails because…; therefore the state remains…, while…”。

先做题再看答案

英文自测 1

回查与后续补齐

Lab 1 p.19-25(合约入口)、Lab 2 p.15-19、p.30-42(编译调用与 counter)、Lab 3 p.12、p.20(ERC-20)、HTLC 项目 p.2-3(状态与协调)。页码为 PDF 页序,补充条件以对应注解校订段为准。

11-07 已补:Lab 5 p.6–19(哈希、AES、RSA、ECDSA、PoW、Merkle)、Lab 6 p.5–26(Regtest 命令链、找零与手续费、四处课件错误)、Lab 7 Stablecoin 全部幻灯片与课程仓库的合约和测试(HF、借款上限、清算、错误名、RWA),英文自测 S11–S22。Lab 4 是项目说明第二部分,HTLC 部分已在上文覆盖。

补充核验:Regtest 每 150 块减半,出自 Bitcoin Core chainparams.cpp;Lab 7 数字出自课程仓库合约与测试,按公式手算验算。Solidity 合约文档用于 view 与入口边界。仍未覆盖:讲师的正式测验范围、可携带资料与可用工具要求;不要拿期末范围替代 Lab Test 范围。

下一页 →
R02 期末复习(上)|讲师划的范围与 2025 卷面

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