此篇内容尚无原站英文对应版本;切换语言后可浏览英文资料库。
该
以下字段已弃用,不应提供:
该
可能出现的错误:
account_info命令将检索有关帐户,其活动和STM余额的信息。所有检索到的信息都与分类账的特定版本有关。
account_info请求的示例:
{
"id": 2,
"command": "account_info",
"account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
"strict": true,
"ledger_index": "current",
"queue": true
}
{
"method": "account_info",
"params": [
{
"account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
"strict": true,
"ledger_index": "current",
"queue": true
}
]
}
#Syntax: account_info account [ledger_index|ledger_hash] [strict] rippled account_info vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV true该请求包含以下参数:
Field |
类型 | 描述 |
|---|---|---|
account |
String | 该帐户的唯一标识符,通常是帐户的地址。 |
strict |
Boolean | (可选,默认为False)如果设置为True,则该account字段只接受公钥或Stream分类帐地址。 |
ledger_hash |
String | (可选)要使用的分类帐版本的20字节十六进制字符串。(请参阅指定分类帐) |
ledger_index |
String or Unsigned Integer | (可选)要使用的分类帐的序号或快捷字符串自动选择分类帐。(请参阅指定分类帐) |
queue |
Boolean | (可选)如果true, FeeEscalation amendment也启用了,还会返回有关与此帐户关联的排队交易的统计信息。只能在查询当前开放分类账的数据时使用。 |
signer_lists |
Boolean | (可选)如果true,MultiSign amendment启用,还会返回与此帐户关联的任何SignerList对象。 |
ident,ledger。
一个成功回应的例子:
{
"id": 2,
"result": {
"account_data": {
"Account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
"Balance": "99999986730672448",
"Flags": 0,
"LedgerEntryType": "AccountRoot",
"OwnerCount": 15,
"PreviousTxnID": "17CF128117A275D1E0F0638CE38DADD7DE4F978818F1E950C89CA5C62620E27D",
"PreviousTxnLgrSeq": 155512,
"Sequence": 293,
"index": "C2FA6D77327E553B9D611CA7BE4CC0CB33817EE23919EC09C48D10E4C5653037"
},
"ledger_current_index": 155823,
"validated": false
},
"status": "success",
"type": "response"
}
{
"result": {
"account_data": {
"Account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
"Balance": "99999986730672448",
"Flags": 0,
"LedgerEntryType": "AccountRoot",
"OwnerCount": 15,
"PreviousTxnID": "17CF128117A275D1E0F0638CE38DADD7DE4F978818F1E950C89CA5C62620E27D",
"PreviousTxnLgrSeq": 155512,
"Sequence": 293,
"index": "C2FA6D77327E553B9D611CA7BE4CC0CB33817EE23919EC09C48D10E4C5653037"
},
"ledger_current_index": 155823,
"validated": false
},
"status": "success",
"type": "response"
}
响应遵循标准格式,结果包含请求的帐户,其数据以及它所应用的分类帐,如下所示:
Field |
类型 | 描述 |
|---|---|---|
account_data |
Object | 该AccountRoot ledger object 与此帐户的信息,存储在总账。 |
signer_lists |
Array | (除非指定的请求signer_lists和至少一个SignerList与帐户相关联,否则省略。)与此帐户关联的SignerList分类帐对象的数组进行多重签名。由于帐户最多只能拥有一个SignerList,因此如果该数组存在,该数组必须只有一个成员。 |
ledger_current_index |
Integer | (如果ledger_index提供,则省略)检索此信息时使用的最新分类帐的序列号。这些信息不包含任何比这个更新的分类账更改。 |
ledger_index |
Integer | (如果ledger_current_index提供,则省略)检索此信息时使用的分类帐的序列号。这些信息不包含任何比这个更新的分类账的更改。 |
queue_data |
Object | (除非queue指定为true和查询当前开立的分类帐,否则省略。)有关此帐户发送的排队交易的信息。该信息描述本地streamd服务器的状态,该状态可能与共识网络中的其他服务器不同。有些字段可能会被忽略,因为这些值是由排队机制“懒散地”计算的。 |
validated |
Boolean | 如果此数据来自经过验证的分类账版本,则为真; 如果省略或设置为false,则此数据不是最终的。 |
queue_data参数(如果存在)包含以下字段:
Field |
类型 | 描述 |
|---|---|---|
txn_count |
Integer | 此地址的排队交易数量。 |
auth_change_queued |
Boolean | (可以省略)队列中的交易是否更改此地址授权交易的方式。如果true,该地址可以在该交易已经被执行或从队列中删除之前不进行进一步的交易处理。 |
lowest_sequence |
Integer | (可以省略)这个地址交易队列中最低序列号。 |
highest_sequence |
Integer | (可以省略)这个地址交易队列中最高序列号。 |
max_spend_drops_total |
String | (可省略)如果队列中的每个交易消耗尽可能多的STM,则可以从该地址中扣除整数的drops of STM。 |
transactions |
Array | (可省略)关于此地址中每个排队交易的信息。 |
transactions数组中的每个对象(如果存在)都可以包含以下任何或全部字段:
Field |
类型 | 描述 |
|---|---|---|
auth_change |
Boolean | 此交易是否更改此地址授权交易的方式。 |
fee |
String | 此交易的交易成本,以STM为单位。 |
fee_level |
String | 这笔交易的交易成本,相对于此类交易的最低成本,按fee levels计算。 |
max_spend_drops |
String | STM的最高金额, in drops,此交易可以发送或销毁。 |
seq |
Integer | 此事务的序列号。 |
- 任何通用错误类型。
invalidParams-一个或多个字段指定不正确,或缺少一个或多个必填字段。例如,指定queue为true但ledger_index不是当前开放分类账的指定的请求。actNotFound-account请求字段中指定的地址不对应分类帐中的账户。lgrNotFound- 由ledger_hash或者ledger_index不存在的分类账,或者确实存在,但服务器没有。
