eth_getEpochStats
Returns the latest epoch statistics
Parameters
QUANTITY|TAG
- integer of a block number, or the string ", "latest" or "pending", as in the default block parameter.
Returns
Object
- An epoch statistics object with the following fields:
epoch
: QUANTITY - The epoch number.start
: QUANTITY - Unix timestamp (in nanoseconds) indicating when the epoch started.end
: QUANTITY - Unix timestamp (in nanoseconds) indicating when the epoch ended.epochStateRoot
: DATA, 32 Bytes - Hexadecimal hash of the epoch's state root.hash
: DATA, 32 Bytes - Hexadecimal hash identifying the epoch.rules
: Object - Network rules and configuration parameters for this epoch:blocks
: Object - Block configuration parameters:maxBlockGas
: QUANTITY - Maximum gas limit per block.maxEmptyBlockSkipPeriod
: QUANTITY - Maximum time period (in nanoseconds) to skip empty blocks.
dag
: Object - DAG configuration parameters:maxExtraData
: QUANTITY - Maximum size of extra data in bytes.maxFreeParents
: QUANTITY - Maximum number of free parent blocks.maxParents
: QUANTITY - Maximum number of parent blocks.
economy
: Object - Economic configuration parameters:blockMissedSlack
: QUANTITY - Tolerance for missed blocks.minGasPrice
: QUANTITY - Minimum gas price in wei.gas
: Object - Gas configuration parameters:blockVoteGas
: QUANTITY - Gas cost for block voting.blockVotesBaseGas
: QUANTITY - Base gas cost for block votes.epochVoteGas
: QUANTITY - Gas cost for epoch voting.eventGas
: QUANTITY - Gas cost for events.extraDataGas
: QUANTITY - Gas cost per byte of extra data.maxEventGas
: QUANTITY - Maximum gas per event.misbehaviourProofGas
: QUANTITY - Gas cost for misbehavior proofs.parentGas
: QUANTITY - Gas cost for parent references.
longGasPower
: Object - Long gas power configuration:allocPerSec
: QUANTITY - Gas power allocation per second.maxAllocPeriod
: QUANTITY - Maximum allocation period in nanoseconds.minStartupGas
: QUANTITY - Minimum startup gas.startupAllocPeriod
: QUANTITY - Startup allocation period in nanoseconds.
shortGasPower
: Object - Short gas power configuration:allocPerSec
: QUANTITY - Gas power allocation per second.maxAllocPeriod
: QUANTITY - Maximum allocation period in nanoseconds.minStartupGas
: QUANTITY - Minimum startup gas.startupAllocPeriod
: QUANTITY - Startup allocation period in nanoseconds.
epochs
: Object - Epoch configuration parameters:maxEpochDuration
: QUANTITY - Maximum epoch duration in nanoseconds.maxEpochGas
: QUANTITY - Maximum gas per epoch.
name
: String - Network name (e.g., "main").networkID
: QUANTITY - Network identifier.upgrades
: Object - Network upgrade status:berlin
: Boolean - Whether Berlin upgrade is active.llr
: Boolean - Whether LLR upgrade is active.london
: Boolean - Whether London upgrade is active.
validatorProfiles
: Object - Detailed information about validators in this epoch, keyed by validator ID:pubKey
: Object - Validator's public key information:raw
: DATA - Hexadecimal representation of the validator's public key.type
: QUANTITY - Type identifier for the public key format.
weight
: QUANTITY - Validator's weight in the network (as a string to handle large numbers).
validatorStates
: Array - Array of validator state information:gasRefund
: QUANTITY - Amount of gas refunded to the validator.prevEpochEvent
: Object - Previous epoch event information:gasPowerLeft
: Object - Remaining gas power:gas
: Array - Array of remaining gas power values.
id
: String - Unique identifier for the previous epoch event.time
: QUANTITY - Timestamp of the previous epoch event.
validators
: Object - Validator values and weights:values
: Object - Mapping of validator IDs to their respective values.
Example
Request
curl --location 'https://rpc-mainnet.u2u.xyz' \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc":"2.0",
"method":"eth_getEpochStats",
"params":[
"latest"
],
"id":83
}'
Result
{
"jsonrpc": "2.0",
"id": 83,
"result": {
"end": 1695118619622089816,
"epoch": 4880,
"epochStateRoot": "0x8a7325378c271fa6b67bbc2df46b9bae9f66d3a39f7437e33f0427bde0701d1f",
"hash": "0xfb1f5a6f07e075225911a2128ed5367108f646fa957848f3464fe5b8cd763fdb",
"rules": {
"blocks": {
"maxBlockGas": 20500000,
"maxEmptyBlockSkipPeriod": 1000000000
},
"dag": {
"maxExtraData": 128,
"maxFreeParents": 3,
"maxParents": 10
},
"economy": {
"blockMissedSlack": 50,
"gas": {
"blockVoteGas": 512,
"blockVotesBaseGas": 1024,
"epochVoteGas": 1536,
"eventGas": 28000,
"extraDataGas": 25,
"maxEventGas": 10028000,
"misbehaviourProofGas": 71536,
"parentGas": 2400
},
"longGasPower": {
"allocPerSec": 2800000,
"maxAllocPeriod": 3600000000000,
"minStartupGas": 560000,
"startupAllocPeriod": 5000000000
},
"minGasPrice": "112492273717",
"shortGasPower": {
"allocPerSec": 5600000,
"maxAllocPeriod": 300000000000,
"minStartupGas": 560000,
"startupAllocPeriod": 2500000000
}
},
"epochs": {
"maxEpochDuration": 420000000000,
"maxEpochGas": 300000000
},
"name": "main",
"networkID": 39,
"upgrades": {
"berlin": true,
"llr": true,
"london": true
}
},
"start": 1695118198150223626,
"validatorProfiles": {
"1": {
"pubKey": {
"raw": "0x044523eb222afcf9d734c24d11d313cd1bb01ea178c0f78067faac2af6a6f8780e3d8c507d319b5d9677c7519bb6514791a75c9ed568bf0883f56867333e34ef41",
"type": 192
},
"weight": "15011625500104973816751471"
}
},
"validatorStates": [
{
"gasRefund": 0,
"prevEpochEvent": {
"gasPowerLeft": {
"gas": [
240131300,
1440926000
]
},
"id": "4879:3048:4b1c18",
"time": 1695118619622089816
}
}
],
"validators": {
"values": {
"1": "208328153",
"2": "208167136",
"3": "208166955",
"4": "208166817",
"5": "208166817",
"6": "208166817",
"7": "208166886"
}
}
}
}
Last updated