[Transaction] 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.

JSONRPC: klay_getTransactionBySenderTxHash

Request

application/json

Body

method stringrequired

Default value: klay_getTransactionBySenderTxHash

Method name

id int64required

Default value: 1

Request ID, Random or Auto incrementation

jsonrpc stringrequired

Default value: 2.0

JSON-RPC Version (2.0)

params 32-byte DATA[]required

Hash of a transaction that is signed only by the sender.

Responses

200

Returns information about a transaction by block number and transaction index position.

application/json

Schema

Schema

jsonrpc stringrequired

Default value: 2.0

id int64required

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

Transaction object

blockHash 32-byte DATArequired

Hash of the block where this transaction was in. null when it is pending.

blockNumber hexrequired

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

(optional) Address of the fee payer.

feePayerSignatures

object[]

(optional) 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.

hash 32-byte DATArequired

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 hexrequired

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

senderTxHash 32-byte DATArequired

Hash of a transaction that is signed only by the sender. See SenderTxHash. This value is always the same as hash for non fee-delegated transactions.

signatures

object[]

required

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

]

to 20-byte DATArequired

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

transactionIndex hexrequired

Integer of the transactions index position in the block. null when it is pending.

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",
    "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"
  }
}

Loading...