Lab7 稳定币:押 ETH 借 LABUSD,崩盘时被人清算
用一个 CDP 稳定币合约走完开仓、超额铸币被拒、ETH 跌 20% 后被清算、RWA 金库收益抬高健康因子四个场景,附常量、错误名和每个函数的前置条件速查。
一句话版
把 ETH 押进合约,借出一种叫 LABUSD 的稳定币;只要抵押价值不低于债的 1.5 倍,你可以一直借着。ETH 一跌,别人就能替你还债,顺手拿走你一部分抵押外加 10% 奖励。
先认识这几个词
| 词 | 全称 / 读法 | 一句人话 |
|---|---|---|
| 稳定币 | stablecoin | 设计成一枚约等于 1 美元的代币 |
| CDP | Collateralized Debt Position,抵押债仓 | 你押了多少、欠了多少的一本账 |
| HF | Health Factor,健康因子 | 抵押够不够的分数,低于 1 就危险 |
| 清算 | liquidation | 外人替你还债,按折扣拿走你的抵押 |
| 预言机 | oracle,本 lab 是 MockPriceFeed | 把链外价格喂进合约的那个合约 |
| WETH | Wrapped ETH,包装 ETH | 写成 ERC-20 代币的 ETH,1 比 1 兑换 |
| ERC-4626 / RWA | 金库标准 / Real-World Assets,现实资产 | 存资产换份额的金库;份额背后是国债这类资产 |
题目地图
整节是观察型实验:代码都写好了,你跑测试、看输出、对数字。一共四个合约。StableToken 是稳定币本身,StableEngine 管抵押、记债、清算。MockPriceFeed 由老师手动设价,MockRwaVault 是一个 ERC-4626 金库。
| 场景 | 跑哪个测试 | 看什么 | 主要失分点 |
|---|---|---|---|
| 开仓铸币 | test_normal_stablecoin_minting | 存 0.5 ETH 借 1000,HF 正好 1 | 以为 HF 要大于 1 才能借 |
| 超额铸币 | test_reject_excessive_borrowing | 借 1001 被拒,账本不变 | 以为债已经记上了 |
| 崩盘清算 | test_market_crash_and_liquidation | 跌 20% 后 Bob 清算 Alice | 以为 Alice 的 1000 LABUSD 被收走 |
| RWA 收益 | npm run test:rwa | 份额不变、HF 上升 | 以为多发了份额 |
| 跌 30% | test_insufficient_collateral_after_30_percent_crash | 抵押不够付奖励,清算失败 | 以为 HF 越低越容易被清算 |
前三个在 01-cdp,RWA 在 02-rwa,后面那个和一大堆边界检查在 03-guards。命令格式是 npm run test:core -- --grep <测试名>,guards 换成 test:guards。本页没有在本机跑这些测试;数字取自课件截图和仓库测试断言,已逐项手算核对。
概念卡
1. 三种稳定币:靠什么撑住 1 美元
人话定义:它回答「凭什么这枚币值 1 美元」。法币抵押型由公司在银行里存美元,代表是 USDT、USDC,发行方能冻结地址。加密资产抵押型把 ETH 之类押在链上,押得比借得多,代表是早期 DAI、LUSD,本 lab 做的就是这种。算法型靠增发和回收调节价格,代表是 UST,一旦信心崩了会死亡螺旋。
例子:本 lab 的 LABUSD 没有一分钱美元储备,撑住它的是合约里锁着的 WETH 和金库份额,加上「抵押不够就会被清算」这条规矩。
常见误解
以为三种模型是同一回事的不同包装。区别在风险落在谁身上:法币型信任发行方,抵押型信任清算机制和价格,算法型信任市场情绪。
回讲义:L10a 以太坊与智能合约
2. CDP 与 150% 最低抵押率
人话定义:它解决「不卖 ETH 也想拿到美元」。你把 ETH 押进合约,合约按你押的价值给你印稳定币,同时记你一笔债。合约要求抵押价值至少是债的 150%,留出价格下跌的缓冲。
例子:ETH 价 $3,000,存 0.5 ETH 就是 $1,500,最多借 1000 LABUSD。借完后 Alice 钱包有 1000 LABUSD,账上欠 1000,抵押锁在合约里。
常见误解
以为借出的币是「卖掉 ETH 换来的」。ETH 还是你的,只是锁着;还清债才能全部取回。
回讲义:L10a 以太坊与智能合约
3. 健康因子 HF
人话定义:它把「抵押够不够」压成一个数。HF = 抵押价值 / (债 × 1.5)。大于等于 1 是安全的,低于 1 就可以被清算。
例子:$1,500 抵押、1000 债,HF = 1500 / 1500 = 1。ETH 跌到 $2,400 后抵押只值 $1,200,HF = 1200 / 1500 = 0.80。
常见误解
以为没欠债的人 HF 是 0。合约里债为 0 时 HF 返回 uint256 的最大值,演示脚本打印成 N/A (no debt)。另外分母债 × 1.5 是向上取整算的,所以边界情况会差几个 wei。
4. 清算与 10% 奖励
人话定义:它解决「仓位变危险时谁来收拾」。任何外人都可以调 liquidate,自己掏 LABUSD 替借款人还债,合约把这些 LABUSD 烧掉,再把价值为还款 × 1.1 的抵押转给清算人。多出的 10% 是奖励,补偿清算人的执行成本、价格风险和抢单竞争。
例子:Alice 欠 1000、HF 0.80。Bob 还 1000,拿走值 $1,100 的 WETH。Alice 的债清零,她钱包里那 1000 LABUSD 照旧留着。
常见误解
以为清算会从 Alice 钱包里收回稳定币。合约只碰 Alice 的债和抵押,烧掉的是 Bob 付进来的币。余额和债是两本账。
回讲义:L10a 以太坊与智能合约
5. StableToken:只有 engine 能印钱
人话定义:它解决「谁有权凭空造币」。LABUSD 是一个 ERC-20,mint 和 burn 都加了 onlyEngine。只有 StableEngine 合约能调,连部署它的 owner 也不行。owner 唯一能做的是调一次 setEngine 指定 engine,之后再也改不了。
例子:owner 直接调 mint 会 revert OnlyEngine。第二次调 setEngine 会 revert EngineAlreadySet;指向零地址或普通钱包地址会 revert InvalidEngine。
常见误解
以为 owner 权限最大,什么都能干。这里 owner 只负责一次性接线,造币权交给了按规则办事的合约。
回讲义:Lab3 ERC-20 与 Hardhat:亲手发一枚只有你能增发的代币
6. revert 与原子性
人话定义:它保证「一笔交易要么全做完,要么像没发生过」。合约里任何一步 revert,这笔交易之前改过的账全部撤销。StableEngine 敢先记账再检查,靠的就是这一点。
例子:Alice 调 mint(1001),合约先把债加到 1001,再查 HF 发现 0.999001,revert。结果债、总供应、锁定的 WETH 都和调用前一样。
常见误解
以为「先记账再检查」有漏洞,检查失败时账已经改了。revert 会把这笔交易里所有状态改动一起撤回。
回讲义:Lab2 Web3.js 与 Hardhat:把 Remix 那个按钮拆开
7. ERC-4626 金库份额
人话定义:它解决「怎样把会生息的资产做成可以转手的代币」。你把资产存进金库,拿到份额;份额代表你在金库总资产里占多少。金库赚到收益时,份额数不变,每份对应的资产变多。
例子:Alice 存 1500 mUSD 拿 1500 份额,每份 1.00。金库进账 75 后总资产 1575,每份变成 1.05,Alice 还是 1500 份。
常见误解
以为收益会以「多发份额」的形式到账。份额只在存取时增减,收益体现在每份的价格上,所以拿份额当抵押的人 HF 会自己往上走。
回讲义:Lab3 ERC-20 与 Hardhat:亲手发一枚只有你能增发的代币
逐题拆解
环境。Hardhat 3,OpenZeppelin 5.6.1,solidity 0.8.30,要求 Node 24。先 npm ci,再 npx hardhat compile。所有金额都是 18 位小数,测试里 units("1") 就是 1e18。部署脚本把 WETH 价设成 3000、底层资产 mUSD 设成 1,并给 Alice 1500 mUSD。
开仓铸币
Alice 先把 0.5 ETH 包成 WETH,approve engine,然后 depositCollateral(weth, 0.5),再 mint(1000)。终端打印抵押 $1,500、债 1000、钱包 1000、HF 1.0000。事件依次是 WETH 的 Transfer、CollateralDeposited,然后是 LABUSD 的 Transfer(从零地址铸出)和 TokensMinted。
一步一步看
目标:跟着 Alice 抵押 0.5 WETH 再铸 1000,看出铸币前要先检查健康因子不低于 1。
-
depositCollateral 先检查 token 是 WETH 或金库份额、数量不为 0。然后记账,再把 0.5 WETH 从 Alice 转进 engine。
-
mint(1000) 先把 userDebt 和 totalDebt 加上 1000,钱包还没有币。
-
算 HF = 1500 / (1000 × 1.5) = 1.00,不低于 1,检查通过。engine 调 StableToken.mint 给 Alice 1000 LABUSD。
超额铸币被拒
这个测试里 Alice 只存了 0.5 ETH,没有先借 1000,直接 mint(1001)。预测 HF = 1500 / (1001 × 1.5) = 1500 / 1501.5 ≈ 0.999001。
一步一步看
目标:把铸币量多加 1 再试,看出健康因子跌破 1 时整笔交易回滚,债和抵押都回到原样。
-
engine 先把债暂记成 1001。
-
HF 0.999001 低于 1,revert BreachesLiquidationThreshold()。
-
整笔回滚:债 0 → 0,供应 0 → 0,锁定的 WETH 0.5 → 0.5。
崩盘与清算
开局 Alice 存 0.5 ETH 借 1000。Bob 另外存 1 ETH 借了 1000,并 approve engine 1000,他手里的 LABUSD 就是这么来的,所以崩盘前总供应是 2000。然后 owner 调 setPrice(weth, 2400),Bob 调 liquidate(alice, weth, 1000)。
一步一步看
目标:让 ETH 价格跌 20% 后跟着 Bob 清算,看出 Alice 的债怎样清零,她亏的 $400 各来自哪里。
-
崩盘前:Alice 抵押 $1,500、债 1000、HF 1.00;Bob 钱包有 1000 LABUSD。
-
价格改成 $2,400,跌 20%。0.5 ETH 只值 $1,200,HF = 1200 / 1500 = 0.80。
-
Bob 清算 1000:他的 1000 LABUSD 转进 engine 被烧掉,Alice 债清零。合约算要给 1000 × 1.1 = $1,100 的 WETH,按 $2,400 是 0.45833333 WETH,转给 Bob。
-
结果:Alice 剩 0.04166667 WETH(约 $100),还有钱包里没动过的 1000 LABUSD。她的净值是 $1,100,总供应 2000 → 1000。Bob 自己那笔 1000 的债还在,按 $2,400 他的 HF 是 1.6。
Alice 亏的 $400 分两块:ETH 跌价 1500 − 1200 = 300,清算奖励 1200 − 1100 = 100。清算后她的债为 0,可以把剩下的 WETH 全部提走。
RWA 金库收益
Alice 把 1500 mUSD 存进 MockRwaVault 拿 1500 份额,再把份额存进 engine 当抵押,借 900。然后 owner 先 approve 金库,再调 accrueYield(75) 往金库里打 75 mUSD,模拟 5% 收益。
一步一步看
目标:把金库份额当抵押铸币再计入收益,看出份额升值让健康因子变高,预言机价格一降又会跌破 1。
-
份额锁进 engine,engine 用 convertToAssets 把份额折成资产,再乘 mUSD 的价格 $1,抵押值 $1,500。
-
mint(900):要求抵押 1350,HF = 1500 / 1350 = 1.1111。
-
accrueYield(75):金库总资产 1575,份额仍是 1500,每份 1.05。
-
没人追加抵押,HF = 1575 / 1350 ≈ 1.1667。测试允许 1 wei 误差,来自 OpenZeppelin 金库的取整。
链上份额值多少钱,靠的是预言机报的 mUSD 价格和金库的账。底层资产真出事时,这两个数可能还没反应过来。guards 测试把 mUSD 改成 0.8:抵押变成 1575 × 0.8 = 1260,HF = 1260 / 1350 ≈ 0.9333,低于 1。这时 Bob 清算 900,拿到价值约 990 的份额,赎回得到约 1237.5 mUSD。
跌 30%:清算反而做不成
价格改成 $2,100。Alice 的 0.5 ETH 只值 $1,050,HF = 1050 / 1500 = 0.7。全额清算要给 Bob 1100 / 2100 ≈ 0.5238 ETH,可她只有 0.5,revert InsufficientCollateral。只清算 500 也不行。拿走 550 美元后剩 $500,债 500,HF = 500 / 750 ≈ 0.6667,比 0.7 还低。合约 revert LiquidationDoesNotImproveHealth。合约注释写明本 lab 没有坏账处理机制。
把这个推到一般情况:部分清算 d 之后 HF 上升,等价于抵押价值 C 大于 1.1 倍债 D,也就是 HF 大于 1.1 / 1.5 ≈ 0.7333。HF 0.80 时清算能做,HF 0.7 时清多少都不行。同样在 $2,400 只清算 500 是可以的,HF 从 0.80 升到 650 / 750 ≈ 0.8667。
开卷速查:常量、错误、前置条件
常量(StableEngine)
| 名字 | 值 | 含义 |
|---|---|---|
| PRECISION | 1e18 | 18 位小数的 1 |
| MIN_COLLATERAL_RATIO | 1.5e18 | 150% |
| MIN_HEALTH_FACTOR | 1e18 | HF 门槛 1 |
| LIQUIDATION_BONUS_BPS | 1000 | 10% 奖励 |
| BPS | 10000 | 基点分母,private |
公式
- HF = 抵押价值 × 1e18 / ceil(债 × 1.5e18 / 1e18);债为 0 时返回 type(uint256).max
- WETH 抵押价值 = 数量 × 价格 / 1e18;金库份额抵押价值 = convertToAssets(份额) × mUSD 价格 / 1e18
- 清算要拿的美元 = ceil(还款 × 11000 / 10000)
- 折成 WETH 数量 = ceil(美元 × 1e18 / 价格)
- 折成金库份额 = previewWithdraw(ceil(美元 × 1e18 / mUSD 价格))
StableEngine 的函数(按代码里的检查顺序)
| 函数 | 前置条件和会报的错 |
|---|---|
| depositCollateral(token, amount) | token 是 WETH 或金库份额,否则 UnsupportedCollateral(token);amount 为 0 报 ZeroAmount;要先 approve,否则 ERC20InsufficientAllowance |
| mint(amount) | ZeroAmount;先记债,HF 低于 1 报 BreachesLiquidationThreshold |
| repay(amount) | ZeroAmount;超过自己的债报 RepaymentExceedsDebt;要先 approve LABUSD |
| withdrawCollateral(token, amount) | UnsupportedCollateral;ZeroAmount;超过已存报 InsufficientCollateral;先扣账,HF 低于 1 报 BreachesLiquidationThreshold |
| liquidate(user, token, debtToCover) | UnsupportedCollateral → ZeroAmount → 清算自己报 CannotLiquidateSelf → HF 不低于 1 报 PositionIsHealthy → 超过对方债报 RepaymentExceedsDebt → 要拿的抵押超过对方存的报 InsufficientCollateral → 还有剩债且 HF 没上升报 LiquidationDoesNotImproveHealth;清算人要先 approve |
| constructor | 四个地址都要是合约,WETH 和金库不能相同,三种代币都要 18 位小数,否则 InvalidConfiguration |
其他合约的错误
| 合约 | 函数 | 前置条件和会报的错 |
|---|---|---|
| StableToken | mint / burn | 调用者必须是 engine,否则 OnlyEngine |
| StableToken | setEngine | onlyOwner(OwnableUnauthorizedAccount);已设过报 EngineAlreadySet;目标没有合约代码报 InvalidEngine |
| MockPriceFeed | setPrice(token, newPrice) | onlyOwner;零地址或价格 0 报 InvalidPrice |
| MockPriceFeed | getPrice(token) | 没设过价报 PriceNotSet(token) |
| MockRwaVault | accrueYield(assets) | onlyOwner;0 报 ZeroAmount;owner 要先 approve 金库 |
事件
- CollateralDeposited(user, token, amount)
- CollateralWithdrawn(user, token, amount)
- TokensMinted(user, amount)
- DebtRepaid(user, payer, amount)
- Liquidated(liquidator, user, token, debtRepaid, collateralSeized)
课件里的坑
- [课件有误] p.17:Test 2 的副标题 “Can Alice mint stablecoins with sufficient collateral?” 照抄了 p.16。这页讲的是抵押不够时铸币被拒。
- [课件有误] p.20:流程图第 1 步写 “ETH price drops 30%: $3,000 → $2,400”,应为 20%。跌 30% 是 $2,100,那是 guards 里清算失败的另一个场景。同页 Key State Changes 表把 Alice 抵押的变化写成 −0.45863333,应为 −0.45833333。
- [课件有误] p.5、p.11:p.5 配图写 “STAY NEAR S$1”,多了个 S;p.11 标题 “Contract that Create Money” 应为 Creates。
- [读图提醒] 文件名:课件文件名和仓库包名都写 lab8,标题和仓库名是 Lab 7,是同一次实验。
- [读图提醒] p.13、p.14:只说 HF < 1 可清算。代码判断是 HF 不低于 1 就拒绝,所以 HF 恰好等于 1 的仓位清算会 revert PositionIsHealthy。另外债为 0 时 HF 是 uint256 最大值,课件公式里分母为 0 的情况没讲。
- [读图提醒] p.18–20:Bob 手里的 1000 LABUSD 来自他自己押 1 ETH 借的仓位,课件没交代,所以崩盘前总供应是 2000。Bob 也得先 approve engine,否则清算整笔 revert。
- [读图提醒] p.19:「Alice 剩 $100 的 ETH」是约数。WETH 数量按向上取整算给 Bob,Alice 剩的比 $100 少几个 wei。
- [课件没讲] 坏账:课件说清算会给 10% 奖励,没说抵押不够付奖励时怎么办。仓库 guards 测试里 ETH 跌 30% 后清算直接失败,合约注释写明没有坏账处理机制。
课后 10 分钟:考点复习
这 10 分钟怎么用:先默写必背,再合上页面自己算一遍崩盘清算的四个数(抵押价值、HF、给 Bob 的 WETH、Alice 剩多少),然后做完整例题和变式题。开卷时直接翻「开卷速查」。
必背
- 健康因子 HF = 抵押价值 / (债 × 1.5);HF < 1 可被清算,HF 恰好等于 1 不能清算;没有债时 HF 返回 uint256 最大值
- mint 先把债记上再查 HF,HF < 1 就 revert BreachesLiquidationThreshold,整笔回滚,债和供应都不变
- 0.5 ETH 按 $3,000 值 $1,500,最多铸 1500 / 1.5 = 1000;铸 1001 时 HF = 1500 / 1501.5 ≈ 0.999 被拒
- 清算人自己付 LABUSD 替借款人还债,被烧掉;拿走价值 债 × 1.1 的抵押(LIQUIDATION_BONUS_BPS 1000 / BPS 10000);借款人钱包里的稳定币不会被收走
- ETH 跌到 $2,400:抵押 $1,200,HF 0.80;Bob 还 1000,拿 1100 / 2400 = 0.45833333 WETH,Alice 剩约 $100,总供应 2000 → 1000
- 抵押不够付 债 × 1.1 时清算 revert InsufficientCollateral;部分清算必须让 HF 上升,否则 LiquidationDoesNotImproveHealth;本 lab 没有坏账处理
- ERC-4626 金库:存资产拿份额,收益进来后份额数不变、每份资产变多;1500 份额加 75 收益后 HF 从 1.1111 升到 1.1667
完整例题
Carol 存 2 ETH,ETH 价 $3,000,借 3000 LABUSD。随后 ETH 跌到 $2,000。Dave 手里有足够的 LABUSD 并已 approve。问:(1) 开仓时 HF 是多少?Carol 最多能借多少?(2) 跌价后 HF 是多少,能不能被清算?(3) Dave 全额清算 3000,拿到多少 ETH?Carol 剩多少 ETH?(4) Dave 只清算 1000 呢?
- 抵押 2 × 3000 = 6000。HF = 6000 / (3000 × 1.5) = 6000 / 4500 ≈ 1.3333。最多借 6000 / 1.5 = 4000。
- 抵押 2 × 2000 = 4000。HF = 4000 / 4500 ≈ 0.8889,低于 1,可以清算。
- 要拿 3000 × 1.1 = 3300 美元,3300 / 2000 = 1.65 ETH。Carol 剩 2 − 1.65 = 0.35 ETH,值 $700,债 0。
- 拿 1100 美元 = 0.55 ETH,Carol 剩 1.45 ETH 值 $2,900,债 2000。新 HF = 2900 / 3000 ≈ 0.9667,比 0.8889 高,清算成功,但仍低于 1,别人还能接着清算。
判分点:HF 分母乘 1.5;清算拿走的是还款 × 1.1 的美元价值,再按当前价折成 ETH;部分清算要检查 HF 是否上升。
变式题(先自己做)
Erin 存 1 ETH(价 $3,000),借 1800 LABUSD。ETH 跌到 $1,800。(1) HF 是多少?(2) Frank 想全额清算 1800,会成功吗?报什么?(3) Frank 改成只清算 600,会成功吗?
提示
先算抵押价值和 1.1 倍债谁大。部分清算能不能做,看 HF 是否大于 1.1 / 1.5 ≈ 0.7333,或者直接把清算后的抵押和债代进去重算 HF。
判分点与答案(非官方评分标准)
(1) 抵押 1800,HF = 1800 / (1800 × 1.5) = 1800 / 2700 ≈ 0.6667。(2) 全额要 1800 × 1.1 = 1980 美元,即 1980 / 1800 = 1.1 ETH,Erin 只有 1 ETH,revert InsufficientCollateral。(3) 拿 660 美元 = 0.3667 ETH,剩 0.6333 ETH 值 1140,债 1200,HF = 1140 / 1800 ≈ 0.6333,比 0.6667 低,revert LiquidationDoesNotImproveHealth,整笔回滚。判分点:(2) 写对错误名;(3) 算出清算后 HF 下降并写对错误名;能指出 HF 低于 0.7333 时任何额度都清不了。
闪卡自测
1. 本 lab 的最低抵押率是多少?对应哪个常量?
150%,MIN_COLLATERAL_RATIO = 1.5e18(p.6、p.13)。
2. 0.5 ETH 按 $3,000 最多能借多少 LABUSD?
1500 / 1.5 = 1000,此时 HF 正好 1(p.16)。
3. mint(1001) 失败后,Alice 的债是多少?
0。合约先记债再检查,revert 把这笔交易的改动全部撤回(p.17)。
4. ETH 从 $3,000 跌到 $2,400,Alice 的 HF 变成多少?
1200 / 1500 = 0.80(p.18)。
5. Bob 清算 1000 拿到多少 WETH?为什么是这个数?
0.45833333 WETH。1000 × 1.1 = 1100 美元,按 $2,400 折算(p.19)。
6. 清算后 Alice 钱包里的 1000 LABUSD 怎么样了?
还在。清算烧掉的是 Bob 付的币,Alice 只是债清零、抵押少了(p.19)。
7. 为什么清算前总供应是 2000?
Bob 自己押 1 ETH 也借了 1000,加上 Alice 的 1000。清算后变 1000(p.19)。
8. HF 恰好等于 1 时 Bob 能清算吗?
不能,revert PositionIsHealthy。代码判断 HF 不低于 1 就拒绝(p.14)。
9. 谁能调 StableToken 的 mint?
只有 engine。owner 也不行,会报 OnlyEngine;setEngine 只能设一次(p.11)。
10. 金库收到 75 收益后,Alice 的份额数变了吗?HF 呢?
份额仍 1500,每份从 1.00 变 1.05;HF 从 1.1111 升到 1.1667(p.23)。
11. RWA 抵押有哪些链上看不到的风险?
托管人或发行方出事、赎回受限和流动性不足、估值过期、法律执行和监管干预(p.24)。
12. ETH 跌到 $2,100 时为什么没人能清算 Alice?
抵押只值 1050,付不起 1000 × 1.1 = 1100;部分清算又会让 HF 下降。合约没有坏账处理(课件没讲,见仓库 guards 测试)。
下一步
照 README 依次跑三个核心测试,对照本页数字看终端输出;再跑 npm run test:rwa 和 npm run test:guards,guards 里那一长串失败场景正好对应「开卷速查」的错误表,逐条找到它们是哪个检查拦下的。合约语法和部署流程回看L10a 以太坊与智能合约,ERC-20 的 approve 和 transferFrom 回看Lab3 ERC-20 与 Hardhat。
个人整理的学习笔记,不是官方材料;数字与结论以课件和讲师为准。