智能合约与以太坊 / 系统课时
模拟不同调用身份与资金余额
模拟不同调用身份与资金余额
智能合约的权限判断取决于实际调用者,支付操作还受到 ETH 余额和转入金额的影响。本课使用 Foundry 的 `prank`、`startPrank` 和 `deal` 构造管理员、普通用户及攻击者场景,并验证授权操作、余额不足和支付失败时的状态是否符合预期。
学习目标
- 区分 `vm.prank`、`vm.startPrank` 与 `vm.stopPrank` 的调用范围。
- 使用 `vm.deal` 设置测试账户 ETH 余额,验证支付前后的资金变化。
- 编写覆盖管理员、普通用户及攻击者的权限与资金测试。
理解调用身份与资金上下文
Solidity 中的 `msg.sender` 表示当前调用的直接发起者,`msg.value` 表示当前调用附带的 ETH 数量。两者互不替代:账户拥有 10 ETH,并不意味着调用函数时会自动转入 10 ETH。
Foundry 提供以下常用 cheatcodes:
| 方法 | 作用 | 适用场景 |
|---|---|---|
| `vm.prank(user)` | 修改下一次目标调用的 `msg.sender` | 单次用户操作 |
| `vm.startPrank(user)` | 持续模拟调用者直到停止 | 连续执行多次操作 |
| `vm.stopPrank()` | 结束持续身份模拟 | 恢复后续调用上下文 |
| `vm.deal(user, amount)` | 将账户 ETH 余额直接设置为指定 wei 数量 | 富余额、零余额测试 |
| `vm.expectRevert(selector)` | 断言下一次调用以指定错误回滚 | 权限或资金失败测试 |
这里的 `vm.deal` 是覆盖余额,不是向原余额追加资金,也不会触发普通 ETH 转账逻辑。`vm.prank` 只修改调用身份,不负责提供资金。
构造可测试的权限与支付合约
以下示例适用于已安装 Foundry、`forge-std` 且使用 Solidity 0.8.20 或兼容编译器的项目。在项目根目录创建 `test/IdentityBalance.t.sol`。文件包含一个示例金库合约及完整测试,不依赖额外部署脚本。
金库规则明确为:管理员可以修改最小存款额,任何用户可支付 ETH 存款,但必须达到最低金额。这样能够分别检查身份验证和余额条件。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import {Test} from "forge-std/Test.sol";
contract PaymentVault {
error NotOwner();
error DepositTooSmall();
address public immutable owner;
uint256 public minimumDeposit = 1 ether;
mapping(address => uint256) public deposits;
constructor() {
owner = msg.sender;
}
function setMinimumDeposit(uint256 amount) external {
if (msg.sender != owner) revert NotOwner();
minimumDeposit = amount;
}
function deposit() external payable {
if (msg.value < minimumDeposit) revert DepositTooSmall();
deposits[msg.sender] += msg.value;
}
}
contract IdentityBalanceTest is Test {
PaymentVault vault;
address admin = makeAddr("admin");
address alice = makeAddr("alice");
address attacker = makeAddr("attacker");
function setUp() public {
// 部署时模拟管理员,使合约 owner 指向 admin。
vm.prank(admin);
vault = new PaymentVault();
// deal 设置绝对余额,不执行真实转账。
vm.deal(alice, 5 ether);
vm.deal(attacker, 0);
}
function testAdminCanChangeMinimum() public {
vm.prank(admin);
vault.setMinimumDeposit(2 ether);
assertEq(vault.owner(), admin);
assertEq(vault.minimumDeposit(), 2 ether);
}
function testAttackerCannotChangeMinimum() public {
vm.expectRevert(PaymentVault.NotOwner.selector);
vm.prank(attacker);
vault.setMinimumDeposit(0);
assertEq(vault.minimumDeposit(), 1 ether);
}
function testAliceCanDepositAndBalanceChanges() public {
uint256 beforeBalance = alice.balance;
vm.prank(alice);
vault.deposit{value: 2 ether}();
assertEq(vault.deposits(alice), 2 ether);
assertEq(address(vault).balance, 2 ether);
assertEq(alice.balance, beforeBalance - 2 ether);
}
function testAttackerWithoutFundsCannotDeposit() public {
assertEq(attacker.balance, 0);
// 用外部调用捕获余额不足导致的失败。
vm.prank(attacker);
(bool ok,) = address(vault).call{value: 1 ether}(
abi.encodeCall(PaymentVault.deposit, ())
);
assertFalse(ok);
assertEq(vault.deposits(attacker), 0);
assertEq(address(vault).balance, 0);
}
function testRepeatedCallsWithStartPrank() public {
vm.startPrank(alice);
vault.deposit{value: 1 ether}();
vault.deposit{value: 2 ether}();
vm.stopPrank();
assertEq(vault.deposits(alice), 3 ether);
assertEq(alice.balance, 2 ether);
}
}注意部署顺序:`vm.prank(admin)` 紧挨着 `new PaymentVault()`,因此构造函数中的 `msg.sender` 是管理员地址,而不是测试合约地址。`makeAddr` 负责生成稳定的测试地址,本身不会自动注资。
运行测试并检查资金变化
在包含 `foundry.toml` 和 `lib/forge-std` 的项目根目录执行:
forge test --match-contract IdentityBalanceTest -vv预期输出(省略编译信息和耗时,实际耗时可能不同):
[PASS] testAdminCanChangeMinimum()
[PASS] testAliceCanDepositAndBalanceChanges()
[PASS] testAttackerCannotChangeMinimum()
[PASS] testAttackerWithoutFundsCannotDeposit()
[PASS] testRepeatedCallsWithStartPrank()关键数值可以独立核对:
| 场景 | 调用前余额 | 转入 ETH | 调用后余额 | 结果 |
|---|---|---|---|---|
| Alice 单次存款 | 5 ETH | 2 ETH | 3 ETH | 存款记录增加 2 ETH |
| 攻击者零余额 | 0 ETH | 1 ETH | 0 ETH | 调用失败,存款记录不变 |
| Alice 连续存款 | 5 ETH | 1 + 2 ETH | 2 ETH | 存款记录累计 3 ETH |
每个测试函数通过 Foundry 的独立测试状态运行,因此单次存款测试不会影响连续存款测试。示例的余额断言成立,是因为调用由模拟账户发起,且没有设置非零 gas price;在涉及真实链上交易手续费的测试中,应单独计算 gas 成本。
零余额攻击者通过低级 `call` 检查失败状态。由于账户缺少转账所需 ETH,调用可能在金库业务代码执行之前失败,因此这里不应断言一定返回 `DepositTooSmall`。业务错误测试必须在账户有足够资金、调用能够进入合约后进行。
处理容易遗漏的身份与余额边界
连续身份模拟必须正确结束
`startPrank` 会持续影响后续目标调用。若测试已经完成 Alice 的两次存款,却没有执行 `stopPrank`,之后的管理员调用仍可能以 Alice 身份执行,导致意外的 `NotOwner` 回滚。
正确做法是缩短模拟范围,并在最后一次目标调用后立即恢复。对于只有一次外部调用的场景,优先使用 `vm.prank`,减少状态泄漏风险。
区分余额不足与存款金额不足
账户余额和转入金额是两个独立边界。可以在现有测试合约中增加以下测试,确认账户即使拥有 5 ETH,只发送 0.5 ETH 仍会因为业务门槛而被拒绝。
// 片段示例:添加到 IdentityBalanceTest 合约内部。
// 依赖 setUp() 已部署 vault 并给 alice 设置 5 ether。
function testDepositBelowMinimumReverts() public {
vm.expectRevert(PaymentVault.DepositTooSmall.selector);
vm.prank(alice);
vault.deposit{value: 0.5 ether}();
assertEq(alice.balance, 5 ether);
assertEq(vault.deposits(alice), 0);
}验证方式:重新运行 `forge test --match-test testDepositBelowMinimumReverts -vv`,预期该测试显示 `[PASS]`。这里 `expectRevert` 验证业务错误,后续断言确认失败交易没有扣除存款本金,也没有修改存款记录。
不要把模拟身份当作真实权限
cheatcodes 是 Foundry 测试环境提供的能力,并不能让普通用户在正式链上随意伪造 `msg.sender`。测试中的攻击者地址只是为了验证金库面对未授权调用时是否正确拒绝。
还应避免把 `tx.origin` 当作管理员权限依据:通过其他合约转发请求时,`tx.origin` 与当前直接调用者可能不同。一般访问控制应基于 `msg.sender` 或经过明确验证的授权机制。
当测试涉及 ERC-20 余额时,`vm.deal(address, amount)` 仍然只设置原生 ETH 余额,不能代替 ERC-20 的 `balanceOf`、`transfer` 和 `allowance` 行为测试。应使用标准库相应辅助方法或真实代币合约构造测试状态。
最终验收时,需要同时确认调用者身份、转入金额、账户剩余资金和合约状态。只检查函数有没有回滚,仍可能漏掉错误账户被记账或失败操作改变存款记录的问题。