klay_getTransactionBySenderTxHash

Returns the information about a transaction requested by sender transaction hash.

This API works only on RPC call, not on JavaScript console.
Please note that this API returns correct result only if indexing feature is enabled by --sendertxhashindexing.
This can be checked by call klay_isSenderTxHashIndexingEnabled.

📘

Supported on Klaytn (mainnet) only.

Parameters

Request

TypeDescription
32-byte DATAHash of a transaction that is signed only by the sender.

Result

Object - A transaction object, or null when no transaction was found:

NameTypeDescription
blockHash32-byte DATAHash of the block where this transaction was in. null when it is pending.
blockNumberQUANTITYBlock number where this transaction was in. null when it is pending.
codeFormatString(optional) The code format of smart contract code.
feePayer20-byte DATAAddress of the fee payer.
feePayerSignaturesArrayAn array of fee payer's signature objects. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.
feeRatioQUANTITY(optional) Fee ratio of the fee payer. If it is 30, 30% of the fee will be paid by the fee payer. 70% will be paid by the sender.
from20-byte DATAAddress of the sender.
gasQUANTITYGas provided by the sender.
gasPriceQUANTITYGas price provided by the sender in peb.
hash32-byte DATAHash of the transaction.
humanReadableBoolean(optional) true if the address is humanReadable, false if the address is not humanReadable.
keyString(optional) Key of the newly created account.
inputDATA(optional) The data sent along with the transaction.
nonceQUANTITYThe number of transactions made by the sender prior to this one.
senderTxHash32-byte DATAHash of a transaction that is signed only by the sender. This value is always the same as hash for non fee-delegated transactions.
signaturesArrayAn array of signature objects. A signature object contains three fields (V, R, and S). V contains ECDSA recovery id. R contains ECDSA signature r while S contains ECDSA signature s.
to20-byte DATAAddress of the receiver. null when it is a contract creation transaction.
transactionIndexQUANTITYInteger of the transaction index position in the block. null when it is pending.
typeStringA string representing the type of the transaction.
typeIntQUANTITYAn integer representing the type of the transaction.
valueQUANTITYValue transferred in peb.

API Endpoint

The format of a Klaytn API endpoint is
https://open-platform.nodereal.io/{{apiKey}}/klaytn/

Here is an example:
https://open-platform.nodereal.io/4c0a1c23661a4e26bcbcwed461e34ea9/klaytn/

Example

// Request
curl https://open-platform.nodereal.io/{{apiKey}}/klaytn/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"klay_getTransactionBySenderTxHash","params":["0x18fe9e1007da7d20aad77778557fb8acc58c80054daba65124c8c843aadd3478"],"id":1}' 

// Result
{
  "jsonrpc":"2.0",
  "id":1,
  "result":{
    "blockHash":"0x4d97cf1f686a925ed4f1ad42c635cedb54974fe23a2941c7825e1ed3163c0e41",
    "blockNumber":"0x7008",
    "feePayer":"0xa9d2cc2bb853163b6eadfb6f962d72f7e00bc2e6",
    "feePayerSignatures":[
      {
        "V":"0x4e44",
        "R":"0xa665e17d92e1c671c8b062cecb19790d49138a21854fc15c460c91035b1884e",
        "S":"0x17165688acc01736f1221a39399e3aac7e1ece14731fcab31631e3e4a59b7441"
      }
    ],
    "from":"0xab0833d744a8943fe3c783f9cc70c13cbd70fcf4",
    "gas":"0xdbba0",
    "gasPrice":"0x5d21dba00",
    "hash":"0xaca5d9a1ed8b86b1ef61431b2bedfc99a66eaefc3a7e1cffdf9ff53653956a67",
    "nonce":"0x26",
    "senderTxHash":"0x18fe9e1007da7d20aad77778557fb8acc58c80054daba65124c8c843aadd3478",
    "signatures":[
      {
        "V":"0x4e44",
        "R":"0x1b6bb3d996d903d0528565d13e8d9d122b2220ed09c5baf384114193a6977027",
        "S":"0x20c506ce9f1bdd42183c40c44f414a3930f339f856e8be3cfcdf5ca0852fd378"
      }
    ],
    "to":"0x15a9119104e1bf0ec6d408b3cc188685e4402a2c",
    "transactionIndex":"0x0",
    "type":"TxTypeFeeDelegatedValueTransfer",
    "typeInt":9,
    "value":"0x1"
  }
}