智能合约与以太坊 / 系统课时

验证精度换算和舍入方向

验证精度换算和舍入方向

代币的 decimals 不一致、整数除法截断和连续兑换,可能让合约少付用户、超额发放份额,甚至允许攻击者反复提取舍入残差。本篇使用 Solidity 和 Foundry 构造可运行测试,检查 6 位与 18 位代币换算、极小金额以及往返兑换,最终建立可审计的舍入规则与资产守恒约束。

学习目标

  • 区分代币显示精度、原始整数单位和实际换算比例。
  • 使用 Math.mulDiv 明确向上或向下舍入,并测试极小金额边界。
  • 通过往返兑换与模糊测试验证不会凭空增加用户资产。

理解 decimals 与整数除法

ERC-20 的 decimals() 主要用于显示单位,转账数量仍然是整数。6 位代币的 1 个完整单位对应 1000000 个最小单位,18 位代币则对应 1000000000000000000 个最小单位。

假设两个资产价值按 1:1 兑换,不计手续费,6 位资产换成 18 位资产时,原始数量需要乘以 101210^{12}。反向兑换则需要除以 101210^{12},余数会被舍弃。

输入 换算方向 整数输出 说明
1000000 6 位到 18 位 1000000000000000000 1 个完整单位
1 6 位到 18 位 1000000000000 最小输入仍有输出
999999999999 18 位到 6 位 0 不足一个 6 位最小单位
1000000000001 18 位到 6 位 1 余数 1 被舍弃

上述计算只适用于价格相等的假设。真实协议还需要考虑价格预言机的精度、资产兑换率与份额价格,不能仅通过 decimals 判断资产价值。

整数截断并不一定构成漏洞。危险在于两条方向相反的路径采用了不一致的舍入方式,或先进行多次除法,导致误差被放大。

为不同操作指定舍入方向

Solidity 0.8.x 的整数除法对非负整数向零截断,相当于向下取整。OpenZeppelin Contracts 5.x 的 Math.mulDiv(x, y, denominator, rounding) 可以先进行完整精度的乘除运算,再按指定方向舍入。

以资产与份额的兑换为例,假设份额总供应量为 3,资产总价值为 10 个最小单位:

  • 用户存入 4 单位资产,按比例最多应得到 4×3/10=1.24 \times 3 / 10 = 1.2 份额,向下舍入后铸造 1 份额。
  • 用户希望精确获得 2 份额,理论需要 2×10/32 \times 10 / 3 单位资产,向上舍入后必须支付 7 单位。
  • 用户销毁 2 份额赎回资产,理论对应 2×10/32 \times 10 / 3 单位资产,向下舍入后支付 6 单位。
  • 用户要求精确提取 4 单位资产,所需销毁份额必须向上舍入为 2。

这也符合 ERC-4626 的常见方向约定:previewDeposit 和 previewRedeem 向下舍入,previewMint 和 previewWithdraw 向上舍入。协议可以收取额外费用,但不能把预览函数和真实结算的语义混淆。

资产与份额兑换的四种舍入方向

编写可运行的精度换算实现

以下示例使用 Solidity ^0.8.24 与 OpenZeppelin Contracts 5.x,独立封装十进制精度换算。这里的换算只改变原始整数表示,不包含价格变化或真实代币转账。

在 Foundry 工程中安装依赖:

bash
forge install OpenZeppelin/openzeppelin-contracts --no-commit

预期结果:依赖安装成功,工程出现 lib/openzeppelin-contracts 目录;具体安装日志随环境变化。

将以下完整合约保存为 src/DecimalConverter.sol:

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";

contract DecimalConverter {
    error UnsupportedDecimals();

    function convert(
        uint256 amount,
        uint8 fromDecimals,
        uint8 toDecimals,
        Math.Rounding rounding
    ) public pure returns (uint256) {
        // 限制指数,避免构造不能表示的 10 的幂。
        if (fromDecimals > 77 || toDecimals > 77) {
            revert UnsupportedDecimals();
        }

        if (fromDecimals == toDecimals) return amount;

        if (fromDecimals < toDecimals) {
            uint256 factor = 10 ** uint256(toDecimals - fromDecimals);
            // 高精度方向为精确乘法;溢出时必须回滚。
            return Math.mulDiv(amount, factor, 1);
        }

        uint256 divisor = 10 ** uint256(fromDecimals - toDecimals);
        // 降精度时由调用者选择余数处理方向。
        return Math.mulDiv(amount, 1, divisor, rounding);
    }
}

本例限制 decimals 不超过 77,是为了保证 10 ** decimals 可以在 uint256 中表示;这不是 ERC-20 标准规定的 decimals 上限。超出范围直接拒绝,比静默使用错误比例安全。

如果创建的是普通 Foundry 工程,需要确保 foundry.toml 中有正确的导入映射。以下为配置片段示例,依赖前述已安装的 OpenZeppelin 包:

toml
[profile.default]
solc_version = "0.8.24"
remappings = ["@openzeppelin/=lib/openzeppelin-contracts/"]

验证方法是在工程根目录执行 forge build,预期结果为编译成功。若项目还有其他依赖映射,应合并而不是直接覆盖全部 remappings。

测试极小输入和往返兑换

将测试保存为 test/DecimalConverter.t.sol。示例不依赖真实 ERC-20 部署,重点验证精度换算函数的纯数学行为。

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import {Test} from "forge-std/Test.sol";
import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";
import {DecimalConverter} from "../src/DecimalConverter.sol";

contract DecimalConverterTest is Test {
    DecimalConverter internal converter;

    function setUp() public {
        converter = new DecimalConverter();
    }

    function testSixToEighteen() public view {
        uint256 result = converter.convert(1, 6, 18, Math.Rounding.Floor);
        assertEq(result, 1e12);
    }

    function testTinyInputRounding() public view {
        uint256 amount = 1e12 - 1;
        assertEq(converter.convert(amount, 18, 6, Math.Rounding.Floor), 0);
        assertEq(converter.convert(amount, 18, 6, Math.Rounding.Ceil), 1);
    }

    function testRoundTripNeverCreatesUnits(uint128 raw) public view {
        // 限定测试域,使本次乘法不会溢出。
        uint256 amount = uint256(raw);
        uint256 low = converter.convert(amount, 18, 6, Math.Rounding.Floor);
        uint256 back = converter.convert(low, 6, 18, Math.Rounding.Floor);
        assertLe(back, amount);
        assertLt(amount - back, 1e12);
    }

    function testRepeatedRoundTripCannotProfit() public view {
        uint256 amount = 3e12 + 7;
        for (uint256 i = 0; i < 20; ++i) {
            uint256 low = converter.convert(amount, 18, 6, Math.Rounding.Floor);
            amount = converter.convert(low, 6, 18, Math.Rounding.Floor);
        }
        assertEq(amount, 3e12);
    }
}

运行测试:

bash
forge test --match-contract DecimalConverterTest

预期输出的关键汇总如下,执行时间与 Gas 数据会随环境不同:

text
Ran 4 tests for test/DecimalConverter.t.sol:DecimalConverterTest
[PASS] testSixToEighteen()
[PASS] testTinyInputRounding()
[PASS] testRoundTripNeverCreatesUnits(uint128)
[PASS] testRepeatedRoundTripCannotProfit()
Suite result: ok. 4 passed; 0 failed

Foundry 会对带参数的 testRoundTripNeverCreatesUnits 执行模糊测试。这里的断言包含两个性质:往返结果不能超过原始数量,单次向下换算造成的差额必须小于 101210^{12} 个 18 位最小单位。

审计兑换路径中的舍入套利

单个换算函数测试通过,不代表协议整体安全。审计时还要检查真实兑换顺序:用户输入、份额计算、余额更新、代币转账以及再次兑换是否采用一致的价格与舍入规则。

往返兑换与会计不变量检查流程

审计时应把以下风险纳入测试数据:

风险输入 需要检查的情况 预期约束
0 与 1 个最小单位 零产出与极小输入 不得无偿获得资产
6、8、18 位精度组合 放大和缩小精度 不发生静默溢出
连续兑换 20 次 余数反复积累 用户不能零成本获利
资产池仅有 1 单位 极低流动性 不得无偿铸造份额
总份额为 0 初始兑换比例 必须有明确初始化规则

对于实际资产池,应优先检查以下会计性质:同一计价基准下,没有外部补贴和真实市场价格变化时,用户执行完整往返操作后的净资产价值不得因舍入而增加;协议支付资产不能超过其按规则应付金额;铸造指定份额时不能少收资产。

对含有手续费、价格变化或不同代币的真实系统,不能直接比较两种代币的原始整数余额。应先统一价值单位,使用可信价格和明确的误差上界。对于 ERC-4626,还应测试空池、捐赠、首笔存款与通胀攻击;精度换算正确不能单独防止份额价格操纵。

特别要检查 amountOut == 0 时的业务行为:精度换算函数可以合法返回零,但真实存款或兑换入口通常应拒绝用户支付正数而获得零产出的交易,除非产品明确支持且用户主动接受。

修正典型的精度与舍入错误

常见错误是先除后乘,例如计算 amount / denominator * numerator。当 amount 小于分母时,中间结果提前变成零,即使数学上的最终结果应大于零也无法恢复。应使用 Math.mulDiv(amount, numerator, denominator, rounding),并确保分母非零。

另一个错误是把所有操作统一向上取整。对于用户赎回资产,这可能让协议多付最小单位;攻击者在允许拆单的路径中反复调用,可能把单次微小误差放大成可提取资产。正确做法是针对资产流向分别设定舍入方向,并测试拆单兑换与一次性兑换是否存在可以获利的差异。

在生产合约里,还需要明确 ERC-20 的转账行为。对于收取转账手续费的代币,用户请求转入 100 单位不等于合约实际收到 100 单位。应按协议支持策略计算真实到账差额或直接拒绝不支持的代币,不能仅依赖请求参数铸造份额。

最终验收不应只看一次兑换金额正确,而要同时满足精度映射、极小输入、反向舍入、重复操作和真实余额核对。只要存在能够通过拆单或循环兑换获得无成本净收益的路径,就应先修复舍入和会计规则,再考虑部署。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

验证精度换算和舍入方向

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通