ledger
공개 ledger에 대한 정보를 검색합니다.
요청 형식
요청 형식의 예입니다:
{
"id": 14,
"command": "ledger",
"ledger_index": "validated",
"full": false,
"accounts": false,
"transactions": false,
"expand": false,
"owner_funds": false
}요청에는 다음 매개변수가 포함될 수 있습니다:
Field
유형
필수 여부
설명
full
Boolean
아니요
관리자만 참이면 전체 원장에 대한 전체 정보를 반환합니다. 원장 버전을 지정하지 않으면 무시됩니다. 기본값은 거짓입니다. (트랜잭션, 계정, 확장을 활성화하는 것과 동일합니다.) C클리오 서버는 이 필드를 지원하지 않습니다. 주의: 메인넷에서는 기가바이트 상당의 데이터가 될 수 있으므로 요청이 시간 초과될 수 있습니다.
accounts
Boolean
아니요
관리자 전용입니다. 참이면 원장의 전체 상태 데이터를 반환합니다. 원장 버전을 지정하지 않으면 무시됩니다. 기본값은 false입니다. 주의: 메인넷에서는 이 데이터가 기가바이트에 달할 수 있으므로 요청이 시간 초과될 수 있습니다. 페이지가 지정된 여러 요청에 걸쳐 상태 데이터를 가져오려면 ledger_data를 대신 사용하세요.
transactions
Boolean
아니요
true이면 지정된 원장 버전의 트랜잭션에 대한 정보를 반환합니다. 기본값은 거짓입니다. 원장 버전을 지정하지 않으면 무시됩니다.
expand
Boolean
아니요
트랜잭션/계정 정보에 대해 해시 대신 전체 JSON 형식의 정보를 제공합니다. 기본값은 거짓입니다. 트랜잭션, 계정 또는 둘 다 요청하지 않으면 무시됩니다.
owner_funds
Boolean
아니요
true이면 오퍼 크리에이트 트랜잭션의 메타데이터에 소유자_자금 필드를 응답에 포함시킵니다. 기본값은 false입니다. 트랜잭션이 포함되지 않고 expand가 true인 경우 무시됩니다.
binary
Boolean
아니요
true이고 트랜잭션과 확장도 모두 true인 경우 트랜잭션 정보를 JSON 형식 대신 이진 형식(16진수 문자열)으로 반환합니다.
queue
Boolean
아니요
true이고 명령이 현재 원장을 요청하는 경우, 대기 중인 트랜잭션 배열을 결과에 포함합니다.
type
문자열
아니요
원장 항목 유형으로 필터링합니다. 유효한 유형은 account, amendments, amm , check, deposit_preauth, directory, escrow, fee, hashes, nft_offer, offer, payment_channel, signer_list, state (신뢰선), 과 ticket. 계정(상태 데이터)을 요청하지 않으면 무시됩니다.
ledger 필드는 더 이상 사용되지 않으며 추가 공지 없이 제거될 수 있습니다.
응답 형식
성공적인 응답의 예입니다:
{
"id": 14,
"result": {
"ledger": {
"accepted": true,
"account_hash": "53BD4650A024E27DEB52DBB6A52EDB26528B987EC61C895C48D1EB44CEDD9AD3",
"close_flags": 0,
"close_time": 638329241,
"close_time_human": "2020-Mar-24 01:40:41.000000000 UTC",
"close_time_resolution": 10,
"closed": true,
"hash": "1723099E269C77C4BDE86C83FA6415D71CF20AA5CB4A94E5C388ED97123FB55B",
"ledger_hash": "1723099E269C77C4BDE86C83FA6415D71CF20AA5CB4A94E5C388ED97123FB55B",
"ledger_index": "54300932",
"parent_close_time": 638329240,
"parent_hash": "DF68B3BCABD31097634BABF0BDC87932D43D26E458BFEEFD36ADF2B3D94998C0",
"seqNum": "54300932",
"totalCoins": "99991024049648900",
"total_coins": "99991024049648900",
"transaction_hash": "50B3A8FE2C5620E43AA57564209AEDFEA3E868CFA2F6E4AB4B9E55A7A62AAF7B"
},
"ledger_hash": "1723099E269C77C4BDE86C83FA6415D71CF20AA5CB4A94E5C388ED97123FB55B",
"ledger_index": 54300932,
"validated": true
},
"status": "success",
"type": "response"
}응답은 표준 형식을 따르며, 성공적인 결과에는 다음 필드를 포함하여 ledger에 대한 정보가 포함됩니다:
Field
유형
설명
ledger
객체
이 원장의 전체 헤더 데이터입니다.
ledger.account_hash
문자열
이 원장에 있는 모든 계정 상태 정보의 해시(16진수)
ledger.close_time_human
문자열
이 원장이 닫힌 시간으로, 사람이 읽을 수 있는 형식입니다. 항상 UTC 시간대를 사용합니다.
ledger.close_time_resolution
정수
원장 마감 시간은 이 초 이내로 반올림됩니다.
ledger.closed
Boolean
이 원장의 폐쇄 여부
ledger.ledger_hash
문자열
전체 원장의 고유 식별 해시입니다.
ledger.parent_close_time
정수
이전 원장이 마감된 시간입니다.
ledger.parent_hash
문자열
이 원장 바로 앞에 나온 원장의 고유 식별 해시입니다.
ledger.total_coins
문자열
네트워크의 총 XRP 드롭 수(인용된 정수) (이는 거래 비용이 XRP를 파괴함에 따라 감소합니다.)
ledger.transaction_hash
문자열
이 원장에 포함된 거래 정보의 해시(16진수)
ledger.transactions
배열
(요청하지 않으면 생략) 이 원장 버전에 적용된 거래입니다. 기본적으로 멤버는 트랜잭션을 식별하는 해시 문자열 입니다. 요청이 true로 지정된 경우 멤버는 요청이 true로 expand지정되었는지 여부에 따라 JSON 또는 binary로 트랜잭션의 전체 표현이 됩니다.
ledger_hash
문자열
전체 원장의 고유 식별 해시입니다.
validated
Boolean
(생략 가능) 인 경우 true검증된 원장 버전입니다. 생략하거나 로 설정하면 false이 원장의 데이터가 최종 데이터가 아닙니다.
queue_data
배열
(매개변수와 함께 요청하지 않는 한 생략 queue) 대기열과 동일한 순서로 대기 중인 트랜잭션을 설명하는 객체 배열입니다. 요청이 true로 지정된 경우 멤버에는 요청이 true로 expand지정되었는지 여부에 따라 JSON 또는 바이너리 형식으로 트랜잭션의 전체 표현이 포함됩니다. FeeEscalation 수정binary 안으로 추가되었습니다.
다음 필드는 더 이상 사용되지 않으며 추가 공지 없이 제거될 수 있습니다: accepted, hash(대신 ledger_hash 사용), seqNum(대신 ledger_index 사용), totalCoins(대신 total_coins 사용).
queue_data 배열의 각 멤버는 대기열에 있는 트랜잭션 하나를 나타냅니다. 이 객체의 일부 필드는 아직 계산되지 않았기 때문에 생략될 수 있습니다. 이 객체의 필드는 다음과 같습니다:
필드
값
설명
tx
문자열 또는 객체
retries_remaining
숫자
이 트랜잭션이 삭제되기 전까지 재시도할 수 있는 횟수입니다.
preflight_result
문자열
사전 거래 확인의 잠정 결과입니다. 이것은 항상 tesSUCCESS.
요청에 "owner_funds": true 및 확장 트랜잭션이 지정된 경우, 응답에는 각 OfferCreate 트랜잭션의 메타데이터 객체에 owner_funds 필드가 있습니다. 이 필드의 목적은 유효성이 검증된 새로운 ledger이 추가될 때마다 오퍼의 펀딩 상태를 더 쉽게 추적할 수 있도록 하기 위한 것입니다. 이 필드는 오더북 가입 스트림의 이 필드 버전과 약간 다르게 정의됩니다:
Field
값
설명
owner_funds
문자열
이 원장의 모든 트랜잭션이 실행된 후 이 OfferCreate 트랜잭션을 보내는 TakerGets통화 의 숫자 금액입니다. Account통화 금액이 동결 되었는지 여부는 확인하지 않습니다
발생 가능한 오류
일반적인 오류 유형입니다.
invalidParams - 하나 이상의 필드가 잘못 지정되었거나 하나 이상의 필수 필드가 누락되었습니다.
lgrNotFound - ledger_hash 또는 ledger_index로 지정한 ledger이 존재하지 않거나, 존재하지만 서버에 없습니다.
noPermission - 전체 또는 계정을 true로 지정했지만 관리자로 서버에 연결되어 있지 않은 경우(일반적으로 관리자는 로컬 포트에 연결해야 함).
Last updated