This page uses machine translation from English, which may contain errors or unclear language. For the most accurate information, please see the original English version. Some content may be in the original English due to frequent updates. Help us improve this page's translation by joining our effort on Crowdin. (Crowdin translation page, Contributing guide)

[Transaction] klay_getTransactionByBlockNumberAndIndex

Returns information about a transaction by block number and transaction index position. This API works only on RPC call, not on JavaScript console.

NOTE: In versions earlier than Kaia v1.7.0, only integer block number, the string "earliest" and "latest" are available.

JSONRPC: klay_getTransactionByBlockNumberAndIndex

Request

application/json

Body

params

undefined[]

required

Array [

BlockNumberOrTag

object

oneOf

IntegerBlockNumber

the block number with type integer

number

HexadecimalBlockNumber

the block number with type hexadecimal

string

BlockTag

the block tag [latest, pending, earliest]

string

TranssactionIndex hex

The transaction index position.

]

Responses

200

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

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

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...