# eth\_getEpochStats

### Parameters

`QUANTITY|TAG` - integer of a block number, or the string ", "latest" or "pending", as in the [default block parameter](https://eth.wiki/json-rpc/API#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

```bash
curl --location 'https://rpc-mainnet.u2u.xyz' \
--header 'Content-Type: application/json' \
--data '{
 "jsonrpc":"2.0",
 "method":"eth_getEpochStats",
 "params":[
        "latest"
    ],
 "id":83
}'
```

Result

```javascript
{
    "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"
            }
        }
    }
}
```