Gas

klay_feeHistory

Returns base fee per gas and transaction effective priority fee per gas history for the requested block range if available.

NOTE: This API is effective after Klaytn v1.8.0

Parameters

Name	Type	Description
blockCount	QUANTITY	Number of blocks in the requested range in hexadecimal. Between 1 (0x1) and 1024 (0x400) blocks can be requested in a single query. Less than requested may be returned if not all blocks are available.
lastBlock	QUANTITY | TAG	Highest numbered block of the requested range as block number or block tag.
rewardPercentiles	Array of FLOAT	An array of floating point values between 0 and 100.

Return Value

Name	Type	Description
oldestBlock	QUANTITY	Lowest numbered block of the returned range in hexadecimal.
baseFeePerGas	Array of QUANTITY	An array of block base fees per gas. This includes the next block after the newest of the returned range, because this value can be derived from the newest block.
gasUsedRatio	Array of FLOAT	An array of the ratios of gas used per block. These are calculated as the ratio of gasUsed and gasLimit.
reward	Array of QUANTITY	An array of effective priority fee per gas data points from a single block. All zeroes are returned if the block is empty.

Example

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"klay_feeHistory","params":["0x10", "latest", [0.1, 0.2, 0.3]],"id":1}' http://localhost:8551
// Result
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "oldestBlock": "0xa5b",
    "reward": [
      [ "0x0", "0x0", "0x0" ],
      ...
      [ "0x5d21dba00", "0x5d21dba00", "0x5d21dba00" ]
    ],
    "baseFeePerGas": [ "0x0", ..., "0x0" ],
    "gasUsedRatio": [ 0, ..., 0.0002963777000002964 ]
  }
}

klay_maxPriorityFeePerGas

Returns a suggestion for a gas tip cap for dynamic fee transactions in peb.

NOTE: This API is effective after Klaytn v1.8.0

Parameters

None

Return Value

Type	Description
QUANTITY	Integer of the current gas price in peb.

Example

// Request
curl -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"klay_maxPriorityFeePerGas","params":[],"id":1}' http://localhost:8551
// Result
{
  "jsonrpc": "2.0",
  "id":1,
  "result": "0xAE9F7BCC00" // 250,000,000,000 peb = 250 Ston
}