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

Type	Description
32-byte DATA	Hash of a transaction that is signed only by the sender.

Result

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

Name	Type	Description
blockHash	32-byte DATA	Hash of the block where this transaction was in. `null` when it is pending.
blockNumber	QUANTITY	Block number where this transaction was in. `null` when it is pending.
codeFormat	String	(optional) The code format of smart contract code.
feePayer	20-byte DATA	Address of the fee payer.
feePayerSignatures	Array	An 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.
feeRatio	QUANTITY	(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.
from	20-byte DATA	Address of the sender.
gas	QUANTITY	Gas provided by the sender.
gasPrice	QUANTITY	Gas price provided by the sender in peb.
hash	32-byte DATA	Hash of the transaction.
humanReadable	Boolean	(optional) `true` if the address is humanReadable, `false` if the address is not humanReadable.
key	String	(optional) Key of the newly created account.
input	DATA	(optional) The data sent along with the transaction.
nonce	QUANTITY	The number of transactions made by the sender prior to this one.
senderTxHash	32-byte DATA	Hash of a transaction that is signed only by the sender. This value is always the same as `hash` for non fee-delegated transactions.
signatures	Array	An 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.
to	20-byte DATA	Address of the receiver. `null` when it is a contract creation transaction.
transactionIndex	QUANTITY	Integer of the transaction index position in the block. `null` when it is pending.
type	String	A string representing the type of the transaction.
typeInt	QUANTITY	An integer representing the type of the transaction.
value	QUANTITY	Value 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"
  }
}