# 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"
            }
        }
    }
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.u2u.xyz/services/rpc/dag-api-methods/eth_getepochstats.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.