ledger_data
ledger_data 메서드는 지정된 원장의 내용을 검색합니다. 여러 번의 호출을 반복하여 단일 ledger 버전의 전체 내용을 검색할 수 있습니다.
요청 형식
요청 형식의 예입니다:
{
"id": 2,
"ledger_hash": "842B57C1CC0613299A686D3E9F310EC0422C84D3911E5056389AA7E5808A93C8",
"command": "ledger_data",
"limit": 5,
"binary": true
}
요청에는 다음 필드가 포함될 수 있습니다:
Field
유형
필수 여부
설명
binary
Boolean
아니요
true
인 경우 원장 항목을 JSON 대신 16진수 문자열로 반환합니다. 기본값은 false
입니다.
limit
숫자
아니요
검색할 원장 항목 수를 제한합니다. 서버는 이 수보다 적은 수의 항목을 반환할 수 있습니다. 2048(바이너리 요청 시) 또는 256(JSON 요청 시)을 초과할 수 없습니다. 이 범위를 벗어나는 양수 값은 가장 가까운 유효한 옵션으로 대체됩니다. 기본값은 최대값입니다.
marker
marker
아니요
이전에 페이지를 매긴 응답의 값입니다. 해당 응답이 중단된 데이터 검색을 재개합니다.
type
Boolean
아니요
특정 유형의 원장 항목으로 결과를 필터링합니다. 유효한 유형은 , account
, amendments
, amm
, check
, deposit_preauth
, directory
, escrow
, fee
, hashes
, nft_offer
, offer
, payment_channel
, signer_list
, state
(신뢰선), 과 ticket
.
ledger 필드는 더 이상 사용되지 않으며 별도의 통지 없이 제거될 수 있습니다.
응답 형식
성공적인 응답의 예입니다:
{
"id": 2,
"result": {
"ledger_hash": "842B57C1CC0613299A686D3E9F310EC0422C84D3911E5056389AA7E5808A93C8",
"ledger_index": "6885842",
"marker": "0002A590029B53BE7857EFF9985F770EC792CE483720EB5E963C4D6A607D43DF",
"state": [
{
"data": "11006122000000002400000001250062FEA42D0000000055C204A65CF2542946289A3358C67D991B5E135FABFA89F271DBA7A150C08CA0466240000000354540208114C909F42250CFE8F12A7A1A0DFBD3CBD20F32CD79",
"index": "00001A2969BE1FC85F1D7A55282FA2E6D95C71D2E4B9C0FDD3D9994F3C00FF8F"
},
{
"data": "11006F22000000002400000003250035788533000000000000000034000000000000000055555B93628BF3EC318892BB7C7CDCB6732FF53D12B6EEC4FAF60DD1AEE1C6101F501071633D7DE1B6AEB32F87F1A73258B13FC8CC32942D53A66D4F038D7EA4C6800064D4838D7EA4C68000000000000000000000000000425443000000000035DD7DF146893456296BF4061FBE68735D28F3286540000000000F42408114A4B8F5F7B644AEDC3447F9459C132EEB016A133B",
"index": "000037C6659BB98F8D09F2F4CFEB27DE8EFEAFE54DD9E1C13AECDF5794B0C0F5"
},
{
"data": "11006F2200020000240000000A250067395C33000000000000000034000000000000000055A160BC41A45B6BB118DF23D77E4FF23C723431B917F50DCB41319ECC2821F34C5010DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4C1AA535D3D0C00064D554C88B43EFA00000000000000000000000000055534400000000000A20B3C85F482532A9578DBB3950B85CA06594D165400000B59B9F780081148366FB9ACD2A0FD822E31112D2EB6F98C317C2C1",
"index": "0000A8791F78CC9B39200E12A9BDAACCF40A72A512FA815525CFC9BA772990F7"
},
{
"data": "1100612200000000240000000125003E742F2D0000000055286498B513710CFEB2D723A554C7557983D1952DF4DEE342C40DCB43067C9A21624000000306DC42008114225BAB89C4A4B94624BB069D6DB3C819F934991C",
"index": "0000B717320558E2DE1A3B9FDB24E9A695BF05D1A44E4A4683212BB1DD0FBA23"
},
{
"data": "110072220002000025000B65783700000000000000003800000000000000005587591A63051645F37B85D1FBA55EE69B1C96BFF16904F5C99F03FB93D42D03756280000000000000000000000000000000000000004254430000000000000000000000000000000000000000000000000166800000000000000000000000000000000000000042544300000000000A20B3C85F482532A9578DBB3950B85CA06594D167D4C38D7EA4C680000000000000000000000000004254430000000000C795FDF8A637BCAAEDAD1C434033506236C82A2D",
"index": "000103996A3BAD918657F86E12A67D693E8FC8A814DA4B958A244B5F14D93E58"
}
]
},
"status": "success",
"type": "response"
}
응답은 표준 형식을 따르며, 성공적인 결과에는 다음 필드가 포함됩니다:
요청에 유형 필드가 언급된 경우, 배열 객체의 첫 번째 집합이 요청된 유형과 일치하지 않으면 상태 배열이 비어 있습니다. 이러한 경우 이 응답의 마커를 사용하여 페이지네이션을 하고 추가 데이터를 검색할 수 있습니다.
상태 배열의 각 객체 형식은 요청에서 바이너리가 참으로 설정되었는지 여부에 따라 달라집니다. 각 상태 객체에는 다음 필드가 포함될 수 있습니다:
발생 가능한 오류
모든 범용 오류 유형입니다.
invalidParams - 하나 이상의 필드가 잘못 지정되었거나 하나 이상의 필수 필드가 누락되었습니다.
lgrNotFound - ledger_hash 또는 ledger_index에 지정된 ledger이 존재하지 않거나, 존재하지만 서버에 없습니다.
Last updated