跳到正文
Financial Context Wiki

如何核对代币的小数位数

从正确的合约和区块核对 ERC-20 代币的 decimals，并在不引入浮点误差的前提下复核原始余额、转账、授权与跨链换算。

更新于

仅供教育参考，不构成投资或安全建议。小数位数不能证明代币的身份、价值、储备或安全性。

直接答案

对于 ERC-20 代币，decimals() 是可选元数据，用来告诉界面如何显示整数形式的代币单位。如果返回 d，惯常的显示金额是 raw / 10^d。它不会改变合约运算，也不能认证代币身份。信任结果前，应核对链、准确合约地址、代码或代理实现以及区块。

通过独立 RPC 在指定区块直接读取 decimals()，按 ABI 将返回值解码为 uint8，再与发行方官方合约名录和可信区块浏览器比较。随后用原始 balanceOf、转账、授权、收据与事件值检验该比例。调用不存在、回退、返回畸形数据或与其他证据冲突时，不要悄悄假定为 18。

工作原理

ERC-20 存储和转移的是无符号整数金额。显示层负责插入小数点，合约接收的仍是整数。转换用户输入时应使用十进制字符串或任意精度整数运算，绝不能使用二进制浮点数。只有乘以 10^d 后得到整数的数量才可表示。

因为 decimals() 是可选项，合规代币可以不实现它。自定义或可升级实现也可能返回意外值，或在升级后改变行为。对于 ERC-1967 代理，应检查代理地址、实现或信标、管理员和升级事件；代币状态要在代理地址读取，并将所有比较固定在同一区块。

授权额度和 ERC-2612 permit 的值也是原始整数。转账显示正确，并不能证明授权、路由器最低金额、跨链金额或会计数据库采用了相同比例。跨链桥两端合约可能使用不同小数位，应按桥的书面换算与舍入规则，分别比较两端的人类可读价值和原始单位。

按以下流程核对：

  1. 固定链 ID 或域、代币合约、区块号、RPC 端点和观察时间。
  2. 通过发行方官方名录确认地址；名称、符号、图标和搜索结果均不能作为权威证据。
  3. 检查已部署代码以及地址是否为代理；记录实现或信标、管理员和近期升级。
  4. 调用 decimals() 并按 ABI 解码 uint8；如实记录成功、回退、空值或畸形输出，不要填入默认值。
  5. 在兼容区块读取原始 balanceOf、totalSupply、授权额、交易 calldata、收据和事件，再按观察到的比例格式化。
  6. 用整数运算重算转账、授权、报价和跨链金额，并计入费用、舍入、零头、变基或转账税。
  7. 先模拟并发送小额交易，再核对交易前后的原始余额；界面、RPC、事件或余额只要有一处不一致就停止。

示例

  • 同一原始值，两种比例。 当 raw = 123456789 时，d = 6 显示为 123.456789；d = 18 则显示为 0.000000000123456789，两者相差 10^12 倍。
  • 必须考虑可表示性。 当 d = 6 时，1.25 个代币换算为 1250000 个原始单位。0.0000001 个代币小于一个原始单位，必须拒绝，或按明确规则舍入。
  • 授权比例不匹配。 当 d = 6 时，100 个代币的授权额是 100000000。若按 d = 18 编码，会得到 100000000000000000000，比预期大 10^12 倍。
  • 跨链重新缩放。 若书面规定的 1:1 路由把 d = 6 的源代币转换为 d = 18 的目标表示，源端原始值 2500000 表示 2.5 个代币，目标端原始值 2500000000000000000 也表示 2.5。费用、上限、零头和实际到账余额仍须核对。

风险

  • 在错误的链上查询了正确地址。
  • 复制的名称、符号或图标掩盖了另一个合约。
  • 代理实现或信标在早先检查后发生变化。
  • RPC 或浏览器提供过时、未最终确认或相互矛盾的状态。
  • 缺失或畸形元数据被悄悄替换为 18。
  • 二进制浮点换算对大额或高精度金额产生舍入。
  • 钱包正确格式化转账，却错误格式化授权或 permit。
  • 数据库混用了原始单位和人类可读金额。
  • 跨链桥假定两端小数位相同，或未披露零头舍入。
  • 转账扣费、变基、铸造、销毁、暂停或冻结行为破坏简单对账。
  • 交易 calldata、事件、收据和实际余额变化不一致。
  • 将小数位核对误当成发行方、储备、流动性或安全性的证明。

常见误区

  • 所有 ERC-20 代币都有 18 位小数。 该元数据是可选的，实现可以返回其他值。
  • 小数位是 EVM 使用的精度位数。 它是十进制显示约定；代币运算仍是整数运算。
  • 浏览器格式化的余额是独立确认。 它可能依赖同一次元数据调用，因而共享同一错误。
  • 相同符号和小数位可确定同一资产。 还必须核对正确链、准确合约和发行方证据。
  • 小额转账成功就验证了所有集成。 授权、路由器、跨链桥、交易所和会计系统可能分别缩放金额。

相关主题

来源

导航

搜索知识库...