SKILL

evm-token-decimals

防止跨 EVM 链出现未被察觉的代币小数位不匹配错误。涵盖运行时小数位查询、按链缓存、跨链代币精度漂移，以及机器人、仪表板和 DeFi 工具中的安全归一化。适用于跨 EVM 链处理代币数量，或余额、价格、转账金额出现数量级偏差的情况。

译文已校对

查看英文原文

Prevent silent decimal mismatch bugs across EVM chains. Covers runtime decimal lookup, chain-aware caching, bridged-token precision drift, and safe normalization for bots, dashboards, and DeFi tools. Use when handling token amounts across EVM chains, or when a balance, price, or transfer amount is off by orders of magnitude.

适用对象：对象待分类。自动收录 · 待核查。

原作者说明节选

从固定版本的 SKILL.md 提取，保留原文语言。以下内容属于作者说明，本站尚未验证安装、兼容或运行结果。

查看英文原文

原文涵盖的主题

EVM Token Decimals
When to Use
How It Works
Examples
Query decimals at runtime
Cache by chain and token
Handle odd tokens defensively
Normalize to 18-decimal WAD in Solidity

Silent decimal mismatches are one of the easiest ways to ship balances or USD values that are off by orders of magnitude without throwing an error. Reading ERC-20 balances in Python, TypeScript, or Solidity Calculating fiat values from on-chain balances Comparing token amounts across multiple EVM chains Handling bridged assets Building portfolio trackers, bots, or aggregators Never assume stablecoins use the same decimals everywhere. Query decimals() at runtime, cache by (chainid, tokenaddress), and use decimal-safe math for value calculations. Do not hardcode 1000000 because a symbol usually has 6 decimals somewhere else. Log the fallback and keep it visible. Old or non-standard tokens still exist. Always query decimals() at runtime Cache by chain plus token address, not symbol Use Decimal, BigInt, or equivalent exact math, not float Re-query decimals after bridging or wrapper changes Normalize internal accounting consistently before comparison or pricing

来源仓库: affaan-m/ECC
源文件: skills/evm-token-decimals/SKILL.md
固定版本: d2ef2680594f9a17526a6e1a2e18b3d242c5d17b

阅读完整原作者说明 ↗