このページは英語からの機械翻訳を使用しており、誤りや不明瞭な表現が含まれている可能性があります。最も正確な情報については、オリジナルの英語版をご覧ください。頻繁な更新のため、一部のコンテンツはオリジナルの英語になっている可能性があります。Crowdinでの取り組みに参加して、このページの翻訳改善にご協力ください。 (Crowdin translation page, Contributing guide)

[Block] klay_getRewards

Returns the reward distribution result about a block by block number, including the rewardees and their shares. If the parameter is not set, it returns the reward distribution at the latest block.

JSONRPC: klay_getRewards

Request

application/json

Body

params

object[]

Array [

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

]

Responses

200

block rewards information

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

burntFee int64required

the amount burnt

kgf int64required

the amount allocated to KGF

kir int64required

the amount allocated to KIR

minted doublerequired

the amount newly minted

proposer doublerequired

the amount allocated to the block proposer

rewards

object

required

mapping from reward recipient to amounts

property name* double

stakers int64required

total amount allocated to stakers

totalFee int64required

total tx fee spent

Example (from schema)

{
  "jsonrpc": "2.0",
  "id": 0,
  "error": {
    "code": -32700,
    "message": "Parse error",
    "data": "string"
  },
  "result": {
    "burntFee": 0,
    "kgf": 0,
    "kir": 0,
    "minted": 9600000000000000000,
    "proposer": 9600000000000000000,
    "rewards": {
      "1.0278187497989767e+48": 9600000000000000000
    },
    "stakers": 0,
    "totalFee": 0
  }
}

• curl
• python
• nodejs
• java

• Curl

curl -X 'POST' \
  'https://public-en-kairos.node.kaia.io' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "method": "klay_getRewards",
  "id": 1,
  "jsonrpc": "2.0",
  "params": [
    "latest"
  ]
}'

• CURL

curl -L 'https://public-en-kairos.node.kaia.io/' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
  "method": "klay_getRewards",
  "id": 1,
  "jsonrpc": "2.0",
  "params": [
    0,
    "string",
    "string"
  ]
}'

Request Collapse all

Base URL

https://public-en-kairos.node.kaia.io

Body

{
  "method": "klay_getRewards",
  "id": 1,
  "jsonrpc": "2.0",
  "params": [
    0,
    "string",
    "string"
  ]
}

ResponseClear

Click the Send API Request button above and see the response here!