[Transaction] klay_getTransactionReceiptBySenderTxHash

Returns the receipt of a transaction by sender transaction hash.

NOTE: The receipt is not available for pending transactions. Please note that this API returns correct result only if indexing feature is enabled by --sendertxhashindexing. This can be checked by call klay_isSenderTxHashIndexingEnabled.

JSONRPC: klay_getTransactionReceiptBySenderTxHash

Request

application/json

Body

params 32-byte DATA[]required

Hash of a transaction before signing of feePayer(senderTransactionHash).

Responses

200

Returns the receipt of a transaction by sender transaction hash.

application/json

Schema

Schema

error

object

code int64required

A Number that indicates the error type that occurred. This MUST be an integer.

code	message	description
-32700	Parse error	invalid JSON was received by the server. An error occurred on the server while parsing the JSON text.
-32602	Invalid params	Invalid method parameter(s).

message string

A String providing a short description of the error. The message SHOULD be limited to a concise single sentence.

data string

A Primitive or Structured value that contains additional information about the error. This may be omitted. The value of this member is defined by the Server (e.g. detailed error information, nested errors etc.).

result

object

blockHash 32-byte DATArequired

Hash of the block where this transaction was in.

blockNumber hexrequired

The block number where this transaction was in.

codeFormat string

(optional) The code format of smart contract code.

contractAddress DATArequired

The contract address created, if the transaction was a contract creation, otherwise null.

feePayer 20-byte DATArequired

Address of the fee payer.

feePayerSignatures

object[]

required

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.

Array [

V stringrequired

R stringrequired

S stringrequired

]

feeRatio hex

(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 DATArequired

Address of the sender.

gas hexrequired

Gas provided by the sender.

gasPrice hexrequired

Gas price provided by the sender in peb.

gasUsed hexrequired

The amount of gas used by this specific transaction alone.

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.

logs object[]required

Array of log objects, which this transaction generated.

logsBloom 256-byte DATArequired

Bloom filter for light clients to quickly retrieve related logs.

nonce hexrequired

The number of transactions made by the sender prior to this one.

senderTxHash (optional) 32-byte DATArequired

Hash of the tx without the fee payer's address and signature. This value is always the same as the value of transactionHash for non fee-delegated transactions.

signature

object[]

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.

Array [

V stringrequired

R stringrequired

S stringrequired

]

status hexrequired

Either 1 (success) or 0 (failure).

txError hex

(optional) detailed error code if status is equal to zero.

to 20-byte DATArequired

Address of the receiver. null when it is a contract creation transaction.

transactionHash 32-byte DATArequired

Hash of the transaction.

transactionIndex hexrequired

Integer of the transaction index position in the block.

type stringrequired

A string representing the type of the transaction.

typeInt numberrequired

An integer representing the type of the transaction.

value hexrequired

Value transferred in peb.

Example (from schema)

{
  "jsonrpc": "2.0",
  "id": 0,
  "error": {
    "code": -32700,
    "message": "Parse error",
    "data": "string"
  },
  "result": {
    "blockHash": "0x4d97cf1f686a925ed4f1ad42c635cedb54974fe23a2941c7825e1ed3163c0e41",
    "blockNumber": "0x7008",
    "contractAddress": null,
    "feePayer": "0xa9d2cc2bb853163b6eadfb6f962d72f7e00bc2e6",
    "feePayerSignatures": [
      {
        "V": "0x4e44",
        "R": "0xa665e17d92e1c671c8b062cecb19790d49138a21854fc15c460c91035b1884e",
        "S": "0x17165688acc01736f1221a39399e3aac7e1ece14731fcab31631e3e4a59b7441"
      }
    ],
    "from": "0xab0833d744a8943fe3c783f9cc70c13cbd70fcf4",
    "gas": "0xdbba0",
    "gasPrice": "0x5d21dba00",
    "gasUsed": "0x7918",
    "logs": [],
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "nonce": "0x26",
    "senderTxHash": "0x18fe9e1007da7d20aad77778557fb8acc58c80054daba65124c8c843aadd3478",
    "signatures": [
      {
        "V": "0x4e44",
        "R": "0x1b6bb3d996d903d0528565d13e8d9d122b2220ed09c5baf384114193a6977027",
        "S": "0x20c506ce9f1bdd42183c40c44f414a3930f339f856e8be3cfcdf5ca0852fd378"
      }
    ],
    "status": "0x1",
    "to": "0x15a9119104e1bf0ec6d408b3cc188685e4402a2c",
    "transactionHash": "0xaca5d9a1ed8b86b1ef61431b2bedfc99a66eaefc3a7e1cffdf9ff53653956a67",
    "transactionIndex": "0x0",
    "type": "TxTypeFeeDelegatedValueTransfer",
    "typeInt": 9,
    "value": "0x1"
  }
}

Loading...