Get Transaction By Hash

post https://web3.nodit.io/v1/{protocol}/{network}/blockchain/getTransactionByHash

특정 트랜잭션의 정보를 조회합니다.

🚧
decodeInput 사용 시 주의사항
decodeInput 필드는 트랜잭션의 input 필드를 해석하여 결과를 제공합니다. 그러나 서로 다른 함수가 같은 함수 선택자(function selector)를 사용할 수 있기 때문에, 제공된 결과가 실제로 호출된 함수와 일치하지 않을 가능성이 있습니다. 따라서, ERC 표준 규격과 다른 함수의 경우 추가적인 검증 과정을 거치는 것을 권장 드립니다.

🚧
Kaia를 사용하시나요? 사용 전 꼭 확인하세요!
Kaia는 Klaytn과 Finschia의 합병으로 탄생한 체인으로, 기존 Klaytn에서 하드포크된 체인입니다. 본 API는 하드포크 이후 데이터에 대한 정합성을 보장하지만, 하드포크 이전의 Klaytn 데이터는 조회 및 정합성을 보장하지 않습니다.
Kaia 네트워크의 하드포크 블록은 아래와 같습니다.

Mainnet: 162,900,480 (Aug 29, 2024 11:08:01 UTC+9)

Kairos(Testnet): 156,660,000 (June 13, 2024 10:15:19 UTC+9)

예를 들어, 다음과 같은 동작은 정상 동작으로 간주됩니다.

하드포크 시점 이전에 발생한 블록은 조회되지 않을 수 있습니다.

time	status	user agent
Retrieving recent requests…

Loading…

Path Params

protocol

string

required

Defaults to kaia

조회 대상 체인의 프로토콜을 지정하기 위한 파라미터입니다.

network

string

required

Defaults to mainnet

조회 대상 체인의 네트워크를 지정하기 위한 파라미터입니다. 프로토콜에 따라 지원되는 네트워크가 다를 수 있습니다.

Body Params

transactionHash

string

required

Defaults to 0x1632ac1627903e586c8ea0b1c134908c34ee95e84face9a303abd63686eb2022

조회하고자 하는 트랜잭션의 해시를 지정하는 파라미터입니다. 0x로 시작하는 64자리 16진수 문자열 형태로 입력할 수 있습니다.

withLogs

boolean

Defaults to false

응답에 logs 필드의 포함 여부를 지정하는 파라미터입니다. 이 파라미터에 true를 입력한 경우, 응답속도가 느려질 수 있습니다.

withDecode

boolean

Defaults to false

응답에 decodedInput, decodedLog 필드의 포함 여부를 지정하는 파라미터입니다. 이 파라미터에 true를 입력한 경우, 응답속도가 느려질 수 있습니다.

decodedLog는 logs에 포함되어 있기 때문에 withDecode가 true라도 withLogs가 false인 경우 decodedLog는 응답에 포함되지 않습니다.

Responses

Response body

object

transactionHash

string

required

트랜잭션의 해시를 나타내는 필드입니다. 0x로 시작하는 64자리 16진수 문자열 형태로 제공됩니다.

transactionIndex

string

required

트랜잭션의 인덱스를 나타내는 필드입니다. 블록 내에서의 순서를 나타냅니다. 10진수 문자열 형태로 제공됩니다.

blockHash

string

required

블록의 해시를 나타내는 필드입니다. 0x로 시작하는 64자리 16진수 문자열 형태로 제공됩니다.

blockNumber

integer

required

블록 번호를 나타내는 필드입니다.

from

string

required

트랜잭션을 발생시킨 주소를 나타내는 필드입니다. 0x로 시작하는 40자리의 16진수 문자열 형태로 제공됩니다.

string

required

트랜잭션의 수신 주소를 나타내는 필드입니다. 컨트랙트 생성 트랜잭션의 경우 이 필드는 null을 반환합니다.0x로 시작하는 40자리의 16진수 문자열 형태로 제공됩니다.

value

string

required

트랜잭션에서 전송한 토큰의 수량을 나타내는 필드입니다. 10진수 문자열 형태로 제공됩니다.

input

string

required

트랜잭션의 데이터를 나타내는 필드입니다. Native Token(ETH, MATIC 등) 전송의 경우 이 필드는 비어 있습니다. 0x로 시작하는 16진수 문자열 형태로 제공됩니다.

decodedInput

object

트랜잭션의 데이터를 디코딩한 결과를 나타내는 필드입니다. withDecodedInput 파라미터에 true를 입력한 경우에만 응답에 포함됩니다.

type

string

트랜잭션의 함수 타입을 나타내는 필드입니다.

name

string

트랜잭션의 함수 이름을 나타내는 필드입니다.

signature

string

트랜잭션의 함수 시그니처를 나타내는 필드입니다.

args

array of objects

args

object

name

string

인자의 이름을 나타내는 필드입니다.

type

string

인자의 타입을 나타내는 필드입니다.

value

string

인자의 값을 나타내는 필드입니다.

functionSelector

string

required

트랜잭션에서 호출한 함수의 selector를 나타내는 필드입니다. 0x로 시작하는 8자리 16진수 문자열 형태로 제공됩니다.

nonce

string

required

트랜잭션의 nonce 값을 나타내는 필드입니다. 트랜잭션의 중복 방지 및 순서를 결정하는 데 사용됩니다. 10진수 문자열 형태로 제공됩니다.

gas

string

required

트랜잭션 실행을 위해 사용자가 할당하고자 하는 가스의 최대 양을 나타내는 필드입니다. 10진수 문자열 형태로 제공됩니다.

gasPrice

string

required

사용자가 단위 가스당 지불할 의향이 있는 금액을 나타내는 필드입니다. EIP-1559(London Hard fork) 적용 이전의 트랜잭션 모델(고정된 수수료)에서 사용되는 필드이며, 네트워크 혼잡도에 따라 사용자가 수동으로 가격을 설정할 수 있습니다. 10진수 문자열 형태로 제공됩니다.

maxFeePerGas

string

사용자가 단위 가스당 지불할 의향이 있는 최대 수수료를 나타내는 필드입니다. 이는 baseFeePerGas와 MaxPriorityFeePerGas의 합보다 크거나 같아야 합니다. EIP-1559(London Hard fork)에서 도입된 변동적인 수수료 모델의 일부입니다. 따라서 도입 이전 트랜잭션에서는 해당 필드가 제공되지 않습니다. 10진수 문자열 형태로 제공됩니다.

maxPriorityFeePerGas

string

사용자가 블록 생성자에게 직접 지불하길 원하는 단위 가스당 최대 수수료입니다. 이 값이 클수록 블록 생성자는 해당 트랜잭션을 우선적으로 처리하게 됩니다. EIP-1559(London Hard fork)에서 도입된 변동적인 수수료 모델의 일부입니다. 따라서 도입 이전 트랜잭션에서는 해당 필드가 제공되지 않습니다. 10진수 문자열 형태로 제공됩니다.

gasUsed

string

required

트랜잭션 실행에서 실제로 사용된 가스의 양을 나타내는 필드입니다. 10진수 문자열 형태로 제공됩니다.

cumulativeGasUsed

string

required

현재 트랜잭션까지 포함하여, 블록 내에서 처리된 모든 트랜잭션들에 사용된 가스의 총합을 나타내는 필드입니다. 10진수 문자열 형태로 제공됩니다.

effectGasPrice

string

트랜잭션이 실제로 단위 가스당 지불한 평균 가격을 나타내는 필드입니다. EIP-1559(London Hard fork)에서 도입된 변동적인 수수료 모델의 일부입니다. 따라서 도입 이전 트랜잭션에서는 해당 필드가 제공되지 않습니다. 10진수 문자열 형태로 제공됩니다.

contractAddress

string

required

트랜잭션이 컨트랙트 생성 트랜잭션인 경우, 생성된 컨트랙트 주소를 나타내는 필드입니다. 0x로 시작하는 40자리의 16진수 문자열 형태로 제공됩니다.

type

string

트랜잭션의 타입을 나타내는 필드이며, 블록 시점에 따라 이 필드가 제공되지 않을 수 있습니다. 10진수 문자열 형태로 제공됩니다.
0: Legacy transaction, EIP-1559 이전의 트랜잭션
1: Access List transaction, EIP-2930에 의해 도입된 접근 목록 트랜잭션
2: Fee market transaction, EIP-1559에 의해 도입된 수수료 시장 트랜잭션

status

string

트랜잭션의 상태를 나타내는 필드입니다. 1이면 성공, 0이면 실패를 나타냅니다. Byzantium Hard Fork 이전의 트랜잭션에서는 해당 필드가 제공되지 않습니다. 10진수 문자열 형태로 제공됩니다.

logsBloom

string

required

트랜잭션에 포함된 모든 로그 블룸을 나타내는 필드입니다. 0x로 시작하는 512자리 16진수 문자열 형태로 제공됩니다.

accessList

array of objects

트랜잭션의 접근 목록을 나타내는 필드입니다.

accessList

object

address

string

required

트랜잭션에서 접근한 컨트랙트 주소를 나타내는 필드입니다. 0x로 시작하는 40자리의 16진수 문자열 형태로 제공됩니다.

storageKeys

array of strings

required

트랜잭션에서 접근한 컨트랙트의 storage key 목록을 나타내는 필드입니다.

storageKeys*

timeStamp

integer

트랜잭션이 생성된 시간을 나타내는 필드입니다. 이 필드는 UNIX 타임스탬프로 제공됩니다.

logs

object

contractAddress

string

required

로그를 생성한 컨트랙트 주소를 나타내는 필드입니다. 0x로 시작하는 40자리의 16진수 문자열 형태로 제공됩니다.

transactionHash

string

required

로그를 생성한 트랜잭션의 해시를 나타내는 필드입니다. 0x로 시작하는 64자리 16진수 문자열 형태로 제공됩니다.

transactionIndex

string

required

로그를 생성한 트랜잭션의 인덱스를 나타내는 필드입니다. 블록 내에서의 순서를 나타냅니다. 10진수 문자열 형태로 제공됩니다.

blockHash

string

required

로그를 생성한 블록의 해시를 나타내는 필드입니다. 0x로 시작하는 64자리 16진수 문자열 형태로 제공됩니다.

blockNumber

integer

required

로그를 생성한 블록 번호를 나타내는 필드입니다.

data

string

required

로그의 데이터를 나타내는 필드입니다. 0x로 시작하는 16진수 문자열 형태로 제공됩니다. 이 필드는 로그의 이벤트 데이터를 나타냅니다.

logIndex

string

required

로그의 인덱스를 나타내는 필드입니다. 트랜잭션에서 발생한 이벤트의 순서를 의미합니다. 10진수 문자열 형태로 제공됩니다.

removed

boolean

required

로그가 제거되었는지 여부를 나타내는 필드입니다. 체인의 재구성(Reorg)으로 인해 로그가 제거된 경우 true를 반환합니다.

topics

array of strings

required

인덱스된 로그의 인자를 나타내는 필드입니다. 최대 4개의 토픽을 가질 수 있습니다.

topics*

decodedLog

object

xxxxxxxxxx
curl --request POST \
     --url https://web3.nodit.io/v1/kaia/mainnet/blockchain/getTransactionByHash \
     --header 'X-API-KEY: nodit-demo' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "transactionHash": "0x1632ac1627903e586c8ea0b1c134908c34ee95e84face9a303abd63686eb2022",
  "withLogs": false,
  "withDecode": false
}
'

Get Transaction By Hash

🚧
decodeInput 사용 시 주의사항

🚧
Kaia를 사용하시나요? 사용 전 꼭 확인하세요!

200Successful Response

400Bad Request

401Unauthorized

403Forbidden

404Not Found

429Too Many Requests