exchange.IO("api", blockChain, ...)

The exchange.IO("api", "eth", ...) function call is used to invoke Ethereum RPC methods (requires selecting eth when configuring the Web3 exchange object).

exchange.IO("api", "tron", ...) function call is used to invoke TRON RPC methods (requires selecting tron when configuring the Web3 exchange object).

    
    
    
exchange.IO(k, blockChain, rpcMethod)

    
    
    
exchange.IO(k, blockChain, rpcMethod, ...args)

Examples

• Query ETH balance in wallet:

  
      javascript
      
      
  function main() {
      // "owner" needs to be replaced with the actual wallet address
      // Parameter label at "latest" string position: 'latest', 'earliest' or 'pending', refer to https://eth.wiki/json-rpc/API#the-default-block-parameter
      // Return value ethBalance is a hexadecimal string: 0x9b19ce56113070
      var ethBalance = exchange.IO("api", "eth", "eth_getBalance", "owner", "latest")
  
      // ETH precision unit is 1e18
      var ethDecimal = 18
  
      // Due to JavaScript language precision limitations, need to use system-level encapsulated functions BigInt, BigDecimal for processing
      // Convert ethBalance to readable amount, 0x9b19ce56113070 converts to 0.043656995388076145
      Log(Number((BigDecimal(BigInt(ethBalance))/BigDecimal(Math.pow(10, ethDecimal))).toString()))
  }
  

• ETH transfer, you can set {gasPrice: 11, gasLimit: 111, nonce: 111} parameters according to specific requirements, this parameter is set as the last parameter of the exchange.IO() function. You can omit nonce to use system default value, or not set gasLimit/gasPrice/nonce to use all system default values.

  
      javascript
      
      
  function mian() {
      // ETH precision unit is 1e18
      var ethDecimal = 18
  
      // Transfer amount, readable amount for example: 0.01 ETH
      var sendAmount = 0.01
  
      // Due to JavaScript language precision limitations, need to use system-level encapsulated functions BigInt, BigDecimal for processing, and convert readable amount to on-chain processing data
      var toAmount = (BigDecimal(sendAmount)*BigDecimal(Math.pow(10, ethDecimal))).toFixed(0)
  
      // "toAddress" is the recipient's ETH wallet address for the transfer, needs to be specifically filled in, toAmount is the transfer amount
      exchange.IO("api", "eth", "send", "toAddress", toAmount)
  }

• Query gasPrice:

  
      javascript
      
      
  function toAmount(s, decimals) {
      return Number((BigDecimal(BigInt(s))/BigDecimal(Math.pow(10, decimals))).toString())
  }
  
  function main() {
      var gasPrice = exchange.IO("api", "eth", "eth_gasPrice")
      Log("gasPrice:", toAmount(gasPrice, 0))   // 5000000000 , in wei (5 gwei)
  }
  

• Query eth_estimateGas:

  
      javascript
      
      
  function toAmount(s, decimals) {
      // toAmount函数可以将十六进制编码的数值转换为十进制数值
      return Number((BigDecimal(BigInt(s))/BigDecimal(Math.pow(10, decimals))).toString())
  }
  
  function main() {
      // 编码approve（授权）方法的调用
      var data = exchange.IO("encode", "0x111111111117dC0aa78b770fA6A738034120C302", "approve", "0xe592427a0aece92de3edee1f18e0157c05861564", "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
      Log("data:", data)
      var gasPrice = exchange.IO("api", "eth", "eth_gasPrice")
      Log("gasPrice:", toAmount(gasPrice, 0))
      var obj = {
          "from" : "0x0xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",   // walletAddress
          "to"  : "0x111111111117dC0aa78b770fA6A738034120C302",
          "gasPrice" : gasPrice,
          "value" : "0x0",
          "data" : "0x" + data,
      }
  
      var gasLimit = exchange.IO("api", "eth", "eth_estimateGas", obj)
      Log("gasLimit:", toAmount(gasLimit, 0))
      Log("gas fee", toAmount(gasLimit, 0) * toAmount(gasPrice, 0) / 1e18)
  }
  

Returns

Arguments

See Also

Remarks

When the second parameter of the exchange.IO() function is "eth", you can directly call RPC methods available on Ethereum node servers.