语法指南 | 发明者量化

exchange.IO("receipt", ...)

查询本链任意交易（不限本交易所对象发出的下单、转账等）的回执，可以等待交易上链。


    
    
    
exchange.IO(k, txHash)


    
    
    
exchange.IO(k, txHash, waitMs)

示例

等待一笔交易上链。


    javascript
    
    
function main() {
    var txHash = "TX_HASH"     // 要查询的交易哈希
    var rc = exchange.IO("receipt", txHash, 120000)
    if (rc.pending) {
        Log("2分钟内未上链，节点", rc.known ? "查得到" : "查不到", "这笔交易")
        return
    }
    Log("状态:", rc.status, "区块:", rc.blockNumber, "gasUsed:", rc.gasUsed, "手续费:", rc.fee)
}

返回值

类型	描述
object	已上链返回`{txHash, status, blockNumber, gasUsed, fee}`：`status`为`success`或`reverted`，`fee`为实际花费的手续费（原生币，可读单位）。等待时间内未上链返回`{txHash, pending: true, known}`，`known`表示节点是否查得到这笔交易（查不到通常是交易已被丢弃或哈希错误）。

参数

名称	类型	必填	描述
k	string	是	固定为`receipt`，用于查询交易回执。
txHash	string	是	交易哈希（`0x`开头的32字节十六进制字符串），例如`exchange.IO("transfer", ...)`返回的`txHash`。查询订单的交易时，传订单ID（形如`ETH_USDC,0x…`）中逗号后面的部分。
waitMs	number	否	最长等待时间（毫秒），交易未上链时每1.5秒查询一次，最多等待10分钟。不传或为0时只查询一次。

参考

Uniswap / PancakeSwap Aerodrome / Velodrome KyberSwap 1inch exchange.IO exchange.IO("transfer") exchange.IO("cancelWait") exchange.IO("wrap") exchange.IO("unwrap")

备注

订单的成交情况用exchange.GetOrder()查询即可，exchange.IO("receipt", ...)主要用于转账等非下单交易。