最終更新:
編集

account_info

[ソース]

account_infoコマンドは、アカウントとそのアクティビティおよびXRP残高についての情報を取得します。取得されたすべての情報は、特定バージョンのレジャーに関連付けられています。

リクエストのフォーマット

account_infoリクエストの例:

{
  "id": 2,
  "command": "account_info",
  "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
  "ledger_index": "current",
  "queue": true
}

試してみる>

リクエストには以下のパラメーターが含まれます。

Field必須?説明
account文字列 - アドレスはい検索するアカウント。更新: rippled 1.11.0
ledger_hash文字列いいえ使用するレジャーバージョンの20バイトの16進文字列。(レジャーの指定をご覧ください。)
ledger_index文字列または整数いいえ使用するレジャーのシーケンス番号、またはレジャーを自動的に選択するためのショートカット文字列。(レジャーの指定をご覧ください。)
queue真偽値いいえtrueの場合、このアカウントに関連するキューに入れられたトランザクションについてのステータスも返されます。これを使用するのは、現在のオープンレジャーのデータを問い合わせる場合のみです。
signer_lists真偽値いいえtrueの場合、このアカウントに関連するすべてのSignerListオブジェクトも返されます。

次のフィールドは廃止予定のため、指定しないでください。identledger,strict

レスポンスのフォーマット

処理が成功したレスポンスの例:

{
    "id": 5,
    "status": "success",
    "type": "response",
    "result": {
        "account_data": {
            "Account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
            "Balance": "999999999960",
            "Flags": 8388608,
            "LedgerEntryType": "AccountRoot",
            "OwnerCount": 0,
            "PreviousTxnID": "4294BEBE5B569A18C0A2702387C9B1E7146DC3A5850C1E87204951C6FDAA4C42",
            "PreviousTxnLgrSeq": 3,
            "Sequence": 6,
            "index": "92FA6A9FC8EA6018D5D16532D7795C91BFB0831355BDFDA177E86C8BF997985F"
        },
        "ledger_current_index": 4,
        "queue_data": {
            "auth_change_queued": true,
            "highest_sequence": 10,
            "lowest_sequence": 6,
            "max_spend_drops_total": "500",
            "transactions": [
                {
                    "auth_change": false,
                    "fee": "100",
                    "fee_level": "2560",
                    "max_spend_drops": "100",
                    "seq": 6
                },
                ...(trimmed for length) ...
                {
                    "LastLedgerSequence": 10,
                    "auth_change": true,
                    "fee": "100",
                    "fee_level": "2560",
                    "max_spend_drops": "100",
                    "seq": 10
                }
            ],
            "txn_count": 5
        },
        "validated": false
    }
}

レスポンスは標準フォーマットに従い、リクエストされたアカウントとそのデータ、アカウントの適用先レジャーが結果として表示されます。以下のフィールドが含まれます。

Field説明
account_dataオブジェクトこのアカウントの情報を含むAccountRootレジャーオブジェクトがレジャーに保管されているとおりに表示されます。
account_flagsオブジェクトアカウントのFlagsフィールドに基づく、アカウントのフラグ情報(下記参照)。 新規: rippled 1.11.0
signer_lists配列(リクエストにsigner_listsが指定されていて、少なくとも1つのSignerListがアカウントに関連する場合を除いて省略)マルチシグ用にアカウントに関連付けられたSignerListレジャーオブジェクトの配列。アカウントが所有できるSignerListは最大1つであるため、この配列のメンバーは存在するとすれば、1メンバーのみです。
ledger_current_index整数(ledger_indexが代わりに指定されている場合は省略) この情報を取得したときに使用されていた最新のレジャーのシーケンス番号。この情報には、これより新しいレジャーの変更は一切含まれません。
ledger_index整数(ledger_current_indexが代わりに指定されている場合は省略) この情報を取得したときに使用されていたレジャーのシーケンス番号。この情報には、これより新しいレジャーの変更は一切含まれません。
queue_dataオブジェクト(queuetrueと指定され、現在開いているレジャーを問い合わせている場合を除いて省略) このアカウントによって送信されたキューに入れられたトランザクションについての情報。この情報にはローカルrippledサーバの状態が示されますが、コンセンサスネットワーク内の他のサーバとは異なる場合があります。示される値はキューメカニズムによって「大まかに」計算されるため、一部のフィールドは省略される場合があります。
validated真偽値このデータが検証済みのレジャーバージョンのものである場合はTrueです。省略されているかFalseが設定されている場合、このデータは最終のものではありません。新規: rippled 0.26.0

account_flagsフィールドは以下のネストしたフィールドを含みます:

Field説明
defaultRipple真偽値trueの場合、アカウントはデフォルトでトラストラインのripplingを許可します。
depositAuth真偽値trueの場合、このアカウントはDeposit Authorizationを使用しており、未知の第三者からの入金を受け付けていません。
disableMasterKey真偽値trueの場合、アカウントのマスターキーペアが無効になっています。
disallowIncomingCheck真偽値trueの場合、このアカウントは第三者からのCheckの送信を許可してません。 (DisallowIncoming amendmentが必要です)
disallowIncomingNFTokenOffer真偽値trueの場合、このアカウントは第三者からのNFT売買オファーの作成を許可してません。 (DisallowIncoming amendmentが必要です)
disallowIncomingPayChan真偽値trueの場合、このアカウントは第三者からのペイメントチャンネルの作成を許可していません。 (DisallowIncoming amendmentが必要です)
disallowIncomingTrustline真偽値trueの場合、このアカウントは第三者がトラストラインを作ることを許可していません。 (DisallowIncoming amendmentが必要です)
disallowIncomingXRP真偽値trueの場合、このアカウントは他者からXRPを受け取りたくありません。(これは参考情報であり、プロトコルレベルでは強制されません)
globalFreeze真偽値trueの場合、このアカウントによって発行されたすべてのトークンは現在凍結されています。
noFreeze真偽値trueの場合、このアカウントは個々のトラストラインを凍結したり、グローバル凍結を行う機能を永久に放棄しています。詳細はNo Freezeをご覧ください。
passwordSpent真偽値falseの場合、このアカウントはトランザクションコスト0の特別なキーリセットトランザクションを送信できます。プロトコルはこのフラグを自動的にオン/オフします。
requireAuthorization真偽値trueの場合、このアカウントは認可トラストラインを使って、発行するトークンを保持できる人を制限しています。
requireDestinationTag真偽値trueの場合、このアカウントは受け取るすべての支払いに宛先タグをリクエストしています。

queue_dataパラメーターが存在する場合、以下のフィールドが含まれます。

Field説明
txn_count整数このアドレスからキューに入れられたトランザクションの数。
auth_change_queued真偽値(省略される場合があります)キュー内のトランザクションがこのアドレスのトランザクションの承認方法を変更するかどうかを示します。trueの場合、トランザクションが実行されているかキューから除外されるまで、このアドレスはトランザクションをこれ以上キューに入れることができません。
lowest_sequence整数(省略される場合があります)このアドレスによってキューに入れられたトランザクションのうち最も低いシーケンス番号
highest_sequence整数(省略される場合があります)このアドレスによってキューに入れられたトランザクションのうち最も高いシーケンス番号
max_spend_drops_total文字列(省略される場合があります)キュー内のすべてのトランザクションが利用可能なXRPを最大限消費する場合に、このアドレスから差し引くことができるXRPのdrop数を示す整数の金額。
transactions配列(省略される場合があります)このアドレスからキューに入れられた各トランザクションについての情報。

queue_datatransactions配列内の各オブジェクト(存在する場合)には、以下のフィールドのいずれかまたはすべてが含まれます。

Field説明
auth_change真偽値このトランザクションがこのアドレスのトランザクション承認の方法を変更するかどうかを示します。
fee文字列このトランザクションのトランザクションコストXRPのdrop数)。
fee_level文字列このタイプのトランザクションの最少コストと比較した、このトランザクションのトランザクションコスト(手数料レベル)。
max_spend_drops文字列このトランザクションで送信または消却できるXRPのdrop数の最高額。
seq整数このトランザクションのシーケンス番号

考えられるエラー

  • いずれかの汎用エラータイプ
  • invalidParams - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。例えば、リクエストでqueuetrueと指定したが、現在開いているレジャーではないledger_indexを指定した場合です。
  • actNotFound - リクエストのaccountフィールドに指定したアドレスが、レジャー内のアカウントに対応していません。
  • lgrNotFound - ledger_hashまたはledger_indexで指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。