语法指南 | 发明者量化

exchange.IO("fromUnits", ...)

将链上整数值换算为可读数量，整个换算过程基于字符串进行精确计算，不经过浮点数运算，避免精度损失。


    
    
    
exchange.IO(k, amount, decimals)

示例

USDC与ETH的数量换算。


    javascript
    
    
function main() {
    var USDC = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
    // 可读数量 -> 链上整数，精度可以传数字，也可以传代币地址（自动读取 decimals）
    Log(exchange.IO("toUnits", "1.5", 6))
    // 输出：1500000
    Log(exchange.IO("toUnits", "1.5", USDC))
    // 输出：1500000
    Log(exchange.IO("toUnits", "0.01", 18))
    // 输出：10000000000000000
    // 链上整数 -> 可读数量
    Log(exchange.IO("fromUnits", "1500000", 6))
    // 输出：1.5
    var raw = exchange.IO("api", USDC, "balanceOf", exchange.IO("address"))
    Log("USDC余额:", exchange.IO("fromUnits", raw, USDC))
    // 小数位多于精度时报错，不会静默截断
    Log(exchange.IO("toUnits", "1.0000001", 6), GetLastError())
}

返回值

类型	描述
string	返回可读数量（十进制字符串，已去除末尾多余的0）。

参数

名称	类型	必填	描述
k	string	是	固定为`fromUnits`，用于将链上整数值换算为可读数量。
amount	string / number	是	待换算的链上整数值，可以是十进制字符串、以`0x`开头的十六进制字符串或数值。
decimals	number / string	是	精度，可以传入数值（例如USDC为6，ETH为18），也可以传入代币合约地址，此时将自动调用该代币合约的`decimals()`方法读取精度。

参考

Web3 exchange.IO exchange.IO("toUnits") 以太坊/波场RPC调用 exchange.IO("api")

备注

与exchange.IO("toUnits", ...)互为逆运算。