Show / Hide Table of Contents

getwalletbalance 方法

根据指定的资产编号,返回钱包中对应资产的余额信息。该方法适用于符合 NEP-17 标准的合约资产。

  • 执行此命令前需要 RPC 调用 openwallet 方法来打开钱包。

  • 此方法由插件提供,需要安装 RpcServer 插件才可以调用。

参数说明

asset_id:资产 ID(资产标识符),即合约的 Script Hash。

如 NeoToken 为:0xef4073a0f2b305a38ec4050e4d3d28bc40ea63f5

GasToken 为:0xd2a4cff31913016155e38e474a2c06d08be276cf

资产 ID 可以通过 CLI 命令 中的 list asset 命令查询,也可以在区块链浏览器中查询。

调用示例

当区块未完全同步时,返回的资产余额可能不是最新的,请确保使用该 API 时区块已经同步到最新高度。

示例:查询 NEP-17 资产的余额

请求正文:

{
  "jsonrpc": "2.0",
  "method": "getwalletbalance",
  "params": ["0xd2a4cff31913016155e38e474a2c06d08be276cf"],
  "id": 1
}

响应正文:

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "balance": "3000014661474560"
    }
}

响应说明:

balance:钱包中该资产的余额,因为 NEP-17 资产是余额系统,而非 UTXO 系统,所以返回结果中没有 confirmed,balance 即实际可用的余额。

  • 当未同步到发布合约的区块时,执行该 API 会报错,只有当区块同步到发布该合约资产的区块时,才会返回正确的结果。

  • 当输入的参数为非 NEP-17 标准的智能合约的 Script Hash 时,执行该 API 会报错。