ledger - 获取账本信息

ledger命令用来获取公共账本的信息。

API请求格式

WebSocket请求示例

{
    "id": 14,
    "command": "ledger",
    "ledger_index": "validated",
    "full": false,
    "accounts": false,
    "transactions": false,
    "expand": false,
    "owner_funds": false
}

JSON-RPC请求示例

{
    "method": "ledger",
    "params": [
        {
            "ledger_index": "validated",
            "accounts": false,
            "full": false,
            "transactions": false,
            "expand": false,
            "owner_funds": false
        }
    ]
}

命令行请求示例

#Syntax: ledger ledger_index|ledger_hash [full|tx]
# "full" is equivalent to "full": true
# "tx" is equivalent to "transactions": true
rippled ledger current

请求命令参数

ledger_hash：要使用的账本哈希值，字符串，可选
ledger_index：要使用的账本索引号或快捷选择符，数值或字符串，可选
full：是否返回全部信息，布尔值，可选，为true时将返回账本的所有信息，需要Admin权限。默认值：false
accounts：是否返回账本账户信息，布尔值，可选，为true时需要admin权限。默认值：false
transactions：是否返回账本交易，布尔值，可选，为true时将返回指定账本中的交易，默认值：false
expand：是否返回完整的交易/账户信息，布尔值，可选，为false时仅返回对应的哈希值，默认值：false
owner_funds：是否在响应中的OfferCreate交易中包含owner_funds字段，默认值：false
binary：返回结果是否为16进制字符串，布尔值，可选，默认值：false
queue：返回结果中是否包含排队中的交易，布尔值，可选

API响应格式

WebSocket响应示例

{
  "id": 4,
  "status": "success",
  "type": "response",
  "result": {
    "ledger": {
      "accepted": true,
      "account_hash": "FD2709F6C07284C3EE85EDE32AC452D9013A89D9B9E781D67D9784457E86A9BB",
      "close_flags": 0,
      "close_time": 508541181,
      "close_time_human": "2016-Feb-11 21:26:21",
      "close_time_resolution": 10,
      "closed": true,
      "hash": "F1433E9D15F33E746B8820DEEE4879F48181704364E459332561DF8E52E4EB7E",
      "ledger_hash": "F1433E9D15F33E746B8820DEEE4879F48181704364E459332561DF8E52E4EB7E",
      "ledger_index": "18851530",
      "parent_close_time": 508541180,
      "parent_hash": "8300B70AA5A865961DED7DAC5B88047028762D5946ECA887D09D32DE442E2305",
      "seqNum": "18851530",
      "totalCoins": "99998102799411646",
      "total_coins": "99998102799411646",
      "transaction_hash": "E0DB0471A1D198611E1C050ADA4AE74EEB38CEC26E0550663E0FCB1364212A3B"
    },
    "ledger_hash": "F1433E9D15F33E746B8820DEEE4879F48181704364E459332561DF8E52E4EB7E",
    "ledger_index": 18851530,
    "validated": true
  }
}

JSON-RPC响应示例

200 OK
{
    "result": {
        "ledger": {
            "accepted": true,
            "account_hash": "B089E7CD4F5167249951611AAEC863D4BF84FF098500E9CB50561F1A89EED825",
            "close_flags": 0,
            "close_time": 508541222,
            "close_time_human": "2016-Feb-11 21:27:02",
            "close_time_resolution": 10,
            "closed": true,
            "hash": "85E6D422F1A3AE0BEA315C4F09CD0B45022312A4BBF0D308246E901536B61157",
            "ledger_hash": "85E6D422F1A3AE0BEA315C4F09CD0B45022312A4BBF0D308246E901536B61157",
            "ledger_index": "18851543",
            "parent_close_time": 508541221,
            "parent_hash": "C382DB117F2D5AAECFBFB43EA509F8E56D6E1D1297CE00C0D02A3EE695ABB78F",
            "seqNum": "18851543",
            "totalCoins": "99998102795090646",
            "total_coins": "99998102795090646",
            "transaction_hash": "BEC71A3CAD11BFC4E4013CD109F220E0850E9A3808B15FAA6DAE4D898970EFAF"
        },
        "ledger_hash": "85E6D422F1A3AE0BEA315C4F09CD0B45022312A4BBF0D308246E901536B61157",
        "ledger_index": 18851543,
        "status": "success",
        "validated": true
    }
}

命令响应参数

ledger：账本头信息，JSON对象
ledger.account_hash：账本中所有的账户状态的哈希值，16进制字符串
ledger.accountState：账本中所有的账户状态信息，数组
ledger.close_flags：账本关闭状态位标志，整数
ledger.close_time：账本关闭时间，整数
ledger.close_time_resolution：账本关闭时间分辨率，整数
ledger.closed：账本是否已经关闭，布尔值
ledger.ledger_hash：账本唯一标识哈希
ledger.ledger_index：账本索引编号，字符串整数值
ledger.parent_close_time：前序账本关闭时间
ledger.parent_hash：前序账本哈希值
ledger.total_coins：网络中的全部XRP金额，字符串整数值，单位：drop
ledger.transaction_hash：账本交易哈希，16进制字符串
ledger.transactions：账本中的交易清单，数组
ledger_hash：账本唯一标识哈希，字符串
ledger_index：账本索引号，整数
queue_data：排队交易数组

queuq_data数组中的每个成员为排队中的交易对象，其主要字段如下：

account：交易发送地址，字符串
tx：交易数据，16进制字符串或JSON对象
retries_remaining：在交易被废弃之前还可尝试的次数，整数
preflight_result：交易预检结果，字符串，值总是为tesSUCCESS
last_result：
auth_change：交易是否修改了认证方式，布尔值
fee：交易手续费，字符串，单位：drop
fee_level：交易费等级，相对于该类型交易的最小成本而言，字符串
max_spend_drops：该交易可消费或销毁的最大金额，字符串，单位：drop

Rippled/XRP API手册

ledger - 获取账本信息

API请求格式

WebSocket请求示例

JSON-RPC请求示例

命令行请求示例

请求命令参数

API响应格式

WebSocket响应示例

JSON-RPC响应示例

命令响应参数