transaction_entry

transaction_entry 메소드는 특정 원장 버전에서 단일 트랜잭션에 대한 정보를 검색합니다. (반면 tx 메소드는 지정된 트랜잭션에 대해 모든 원장을 검색합니다. 이 메소드를 대신 사용하는 것이 좋습니다.)

요청 형식

요청 형식의 예입니다:

{
  "id": 4,
  "command": "transaction_entry",
  "tx_hash": "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9",
  "ledger_index": 56865245
}

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

Field

유형

설명

ledger_hash

(선택 사항) 사용할 원장 버전에 대한 20바이트 16진수 문자열입니다. (원장 지정 참조)

ledger_index

문자열 또는 부호 없는 정수

(선택) 사용할 원장의 원장 인덱스 또는 자동으로 원장을 선택하는 단축 문자열입니다. (원장 지정 참조)

tx_hash

찾고 있는 거래의 고유 해시

Note:

이 메소드는 현재 진행 중인 ledger의 정보 검색을 지원하지 않습니다. ledger_index 또는 ledger_hash에 ledger 버전을 지정해야 합니다.

응답 형식

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

응답은 표준 형식을 따르며, 성공적인 결과에는 다음 필드가 포함됩니다:

Field

유형

설명

ledger_index

번호 - 원장 색인

거래가 발견된 원장 버전의 원장 인덱스입니다. 이는 요청한 내용과 동일합니다.

ledger_hash

문자열 - 해시

(생략 가능) 거래가 발견된 원장 버전의 식별 해시입니다. 이는 요청한 내용과 동일합니다.

metadata

객체

거래의 정확한 결과를 자세히 보여주는 거래 메타데이터입니다.

tx_json

객체

Transaction 객체의 JSON 표현.

서버가 트랜잭션을 찾지 못할 수 있는 몇 가지 이유가 있습니다:

  • 트랜잭션이 존재하지 않습니다.

  • 트랜잭션이 존재하지만 지정된 ledger 버전이 아닙니다.

  • 서버에 지정된 ledger 버전을 사용할 수 없습니다. 올바른 버전을 보유하고 있는 다른 서버에서 다른 응답을 받을 수 있습니다.

발생 가능한 오류

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

  • fieldNotFoundTransaction - 요청에서 tx_hash 필드가 생략되었습니다.

  • notYetImplemented - 요청에 ledger 버전이 지정되지 않았습니다.

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

  • transactionNotFound - 요청에 지정된 트랜잭션을 지정된 ledger에서 찾을 수 없습니다. (다른 ledger 버전에 있거나 아예 사용할 수 없을 수도 있습니다.)

Last updated