account_info

account_info 커맨드라인은 계정, 계정 활동, XRP 잔액에 대한 정보를 검색합니다. 검색된 모든 정보는 특정 버전의 원장을 기준으로 합니다.

요청 형식

account_info 요청의 예시입니다:

WebSocket

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

JSON-RPC

{
    "method": "account_info",
    "params": [
        {
            "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
            "ledger_index": "current",
            "queue": true
        }
    ]
}

요청에는 다음 매개변수가 포함됩니다:

Field	유형	필수 여부	설명
account	문자열 - 주소	예	조회할 계정입니다.
ledger_hash	배열	아니요	사용할 원장 버전에 대한 20바이트 16진수 문자열입니다. (Specifying Ledgers 참조)
ledger_index	숫자 또는 문자열	아니요	사용할 원장의 원장 인덱스 또는 자동으로 원장을 선택하는 단축 문자열입니다.(Specifying Ledgers 참조)
queue	Boolean	아니요	참이면 이 계정에서 보낸 대기 중인 트랜잭션에 대한 통계를 반환합니다. 현재 열려 있는 원장의 데이터를 쿼리할 때만 사용할 수 있습니다. 보고 모드의 서버에서는 사용할 수 없습니다.
signer_lists	Boolean	아니요	true이면 이 계정과 연결된 모든 서명자 목록 객체를 반환합니다.

다음 필드는 더 이상 사용되지 않으므로 제공해서는 안 됩니다: ident, ledger, strict.

응답 형식

성공적인 응답의 예입니다:

WebSocket

{
    "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
    }
}

JSON-RPC

{
    "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
        },
        "status": "success",
        "validated": false
    }
}

응답은 표준 형식을 따르며, 요청된 계정과 해당 데이터, 해당 계정이 적용되는 ledger이 다음 필드와 함께 포함됩니다:

Field	유형	설명
account_data	객체	원장에 저장된 이 계정 정보가 포함된 AccountRoot 원장 개체입니다.
account_flags	객체	Flags계정 필드 에 따른 계정의 플래그 상태(아래 참조)입니다.
signer_lists	배열	(요청이 지정되지 않고 signer_lists하나 이상의 SignerList가 계정과 연결되어 있지 않으면 생략됩니다.) 다중 서명을 위해 이 계정과 연결된 SignerList 원장 개체 의 배열입니다. 계정은 최대 하나의 SignerList를 소유할 수 있으므로 이 배열에는 멤버가 있는 경우 정확히 하나의 멤버가 있어야 합니다.
ledger_current_index	정수	ledger_index(대신 제공되는 경우 생략) 이 정보를 검색할 때 사용된 현재 진행 중인 원장의 원장 인덱스입니다.
ledger_index	정수	(ledger_current_index대신 제공되는 경우 생략) 이 정보를 검색할 때 사용된 원장 버전의 원장 인덱스입니다. 이 정보에는 이 버전보다 최신 원장 버전의 변경 사항이 포함되어 있지 않습니다.
queue_data	객체	(현재 공개 원장 queue으로 지정하여true 쿼리하지 않는 한 생략됩니다.) 이 계정에서 전송한 대기 중인 트랜잭션에 대한 정보입니다. 이 정보는 P2P XRP Ledger 네트워크rippled 의 다른 서버와 다를 수 있는 로컬 서버의 상태를 설명합니다. 대기열 메커니즘에 의해 값이 "느리게" 계산되므로 일부 필드는 생략될 수 있습니다.
validated	Boolean	이 데이터가 검증된 원장 버전에서 나온 경우 참입니다. 생략하거나 false로 설정하면 이 데이터는 최종 데이터가 아닙니다.

account_flags 필드에는 다음과 같은 중첩 필드가 포함됩니다:

queue_data 필드(있는 경우)에는 다음과 같은 중첩 필드가 포함됩니다:

Field	유형	설명
txn_count	정수	이 주소에서 대기 중인 트랜잭션 수 입니다.
auth_change_queued	Boolean	(생략될 수 있음) 대기열의 트랜잭션이 이 주소의 트랜잭션 승인 방식을 변경하는지 여부입니다. 이면 true이 주소는 해당 트랜잭션이 실행되거나 대기열에서 삭제될 때까지 더 이상 트랜잭션을 대기열에 넣을 수 없습니다.
lowest_sequence	정수	(생략 가능) 이 주소에 대기 중인 트랜잭션 중 가장 낮은 Sequence Number입니다.
highest_sequence	정수	(생략 가능) 이 주소에 대기 중인 트랜잭션 중 가장 높은 Sequence Number입니다.
max_spend_drops_total	문자열	(생략될 수 있음) 대기열의 모든 트랜잭션이 가능한 최대 XRP 금액을 소비하는 경우 이 주소에서 인출될 수 있는 XRP 드롭의 정수 금액입니다.
transactions	배열	(생략 가능) 이 주소에서 대기 중인 각 트랜잭션에 대한 정보입니다.

queue_data 트랜잭션 배열의 각 객체(있는 경우)에는 다음 필드 중 일부 또는 전부가 포함될 수 있습니다:

Field	유형	설명
auth_change	Boolean	이 거래가 이 주소의 거래 승인 방식을 변경하는지 여부입니다.
fee	문자열	이 거래의 거래 비용 (XRP 드롭단위.)
fee_level	문자열	해당 거래 유형의 최소 비용 대비 해당 거래의 거래 비용(수수료 수준입니다.)
max_spend_drops	문자열	이 거래가 보내거나 파괴할 수 있는 XRP의 최대 금액입니다.
seq	정수	이 거래의 시퀀스 번호입니다.

발생 가능한 오류

• 일반적인 오류 유형입니다.

• invalidParams - 하나 이상의 필드가 잘못 지정되었거나 하나 이상의 필수 필드가 누락되었습니다. 예를 들어, 요청에서 queue를 true로 지정했지만 현재 열려 있는 ledger이 아닌 ledger_index를 지정했습니다.

• actNotFound - 요청의 계정 필드에 지정된 주소가 ledger의 계정과 일치하지 않습니다.

• lgrNotFound - ledger_hash 또는 ledger_index로 지정한 ledger이 존재하지 않거나, 존재하지만 서버에 없습니다.