From 2f3c877b9246a67535c57d70b87560b24603b4fb Mon Sep 17 00:00:00 2001 From: bgravenorst Date: Mon, 13 Oct 2025 10:26:14 +1000 Subject: [PATCH 1/4] Add eth_config method documentation. Signed-off-by: bgravenorst --- docs/public-networks/reference/api/index.md | 102 ++++++++++++++++++++ 1 file changed, 102 insertions(+) diff --git a/docs/public-networks/reference/api/index.md b/docs/public-networks/reference/api/index.md index 631727a423..417d056f20 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -2498,6 +2498,108 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":51 +### `eth_config` + +Returns the client's current configuration including fork information for the current, next, and last known forks. + +:::info + +This method is defined in [EIP-7910](https://eips.ethereum.org/EIPS/eip-7910) and enables node operators to verify client readiness for upcoming forks and debug configuration mismatches. + +::: + +#### Parameters + +None + +#### Returns + +`result`: _object_ - Configuration information containing: + +- `current`: _object_ - Current fork configuration: + - `activationTime`: _number_ - Fork activation timestamp (Unix epoch seconds) + - `blobSchedule`: _object_ - Blob configuration parameters: + - `baseFeeUpdateFraction`: _number_ - Base fee update fraction + - `max`: _number_ - Maximum number of blobs per block + - `target`: _number_ - Target number of blobs per block + - `chainId`: _string_ - Chain ID in hexadecimal + - `forkId`: _string_ - Fork hash as defined in EIP-6122 + - `precompiles`: _object_ - Active precompiled contracts with names and addresses + - `systemContracts`: _object_ - System contract addresses +- `next`: _object_ or _null_ - Next fork configuration (null if no future fork scheduled) +- `last`: _object_ or _null_ - Last known fork configuration (null if no future fork scheduled) + + + + + +```bash +curl -X POST --data '{"jsonrpc":"2.0","method":"eth_config","params":[],"id":1}' http://127.0.0.1:8545/ -H "Content-Type: application/json" +``` + + + + + +```json +{ "jsonrpc": "2.0", "method": "eth_config", "params": [], "id": 1 } +``` + + + + + +```json +{ + "jsonrpc": "2.0", + "id": 1, + "result": { + "current": { + "activationTime": 1746612311, + "blobSchedule": { + "baseFeeUpdateFraction": 5007716, + "max": 9, + "target": 6 + }, + "chainId": "0x1", + "forkId": "0x3ff0e375", + "precompiles": { + "BLS12_G1ADD": "0x000000000000000000000000000000000000000b", + "BLS12_G1MSM": "0x000000000000000000000000000000000000000c", + "BLS12_G2ADD": "0x000000000000000000000000000000000000000d", + "BLS12_G2MSM": "0x000000000000000000000000000000000000000e", + "BLS12_MAP_FP2_TO_G2": "0x0000000000000000000000000000000000000011", + "BLS12_MAP_FP_TO_G1": "0x0000000000000000000000000000000000000010", + "BLS12_PAIRING_CHECK": "0x000000000000000000000000000000000000000f", + "BLAKE2F": "0x0000000000000000000000000000000000000009", + "BN254_ADD": "0x0000000000000000000000000000000000000006", + "BN254_MUL": "0x0000000000000000000000000000000000000007", + "BN254_PAIRING": "0x0000000000000000000000000000000000000008", + "ECREC": "0x0000000000000000000000000000000000000001", + "ID": "0x0000000000000000000000000000000000000004", + "KZG_POINT_EVALUATION": "0x000000000000000000000000000000000000000a", + "MODEXP": "0x0000000000000000000000000000000000000005", + "RIPEMD160": "0x0000000000000000000000000000000000000003", + "SHA256": "0x0000000000000000000000000000000000000002" + }, + "systemContracts": { + "BEACON_ROOTS_ADDRESS": "0x000f3df6d732807ef1319fb7b8bb8522d0beac02", + "CONSOLIDATION_REQUEST_PREDEPLOY_ADDRESS": "0x0000bbddc7ce488642fb579f8b00f3a590007251", + "DEPOSIT_CONTRACT_ADDRESS": "0x00000000219ab540356cbb839cbe05303d7705fa", + "HISTORY_STORAGE_ADDRESS": "0x0000f90827f1c53a10cb7a02335b175320002935", + "WITHDRAWAL_REQUEST_PREDEPLOY_ADDRESS": "0x00000961ef480eb55e80d19ad83579a64c007002" + } + }, + "next": null, + "last": null + } +} +``` + + + + + ### `eth_coinbase` Returns the client coinbase address. The coinbase address is the account to pay mining rewards to. From 4ee22b53fa11bec3bcd0a64300bc80511308e01b Mon Sep 17 00:00:00 2001 From: bgravenorst Date: Mon, 13 Oct 2025 13:08:47 +1000 Subject: [PATCH 2/4] Add result. Signed-off-by: bgravenorst --- docs/public-networks/reference/api/index.md | 34 ++++++++++----------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/public-networks/reference/api/index.md b/docs/public-networks/reference/api/index.md index 417d056f20..009c81b0c2 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -2500,7 +2500,7 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":51 ### `eth_config` -Returns the client's current configuration including fork information for the current, next, and last known forks. +Returns the client's fork information for the current, next, and last known forks. :::info @@ -2514,20 +2514,20 @@ None #### Returns -`result`: _object_ - Configuration information containing: - -- `current`: _object_ - Current fork configuration: - - `activationTime`: _number_ - Fork activation timestamp (Unix epoch seconds) - - `blobSchedule`: _object_ - Blob configuration parameters: - - `baseFeeUpdateFraction`: _number_ - Base fee update fraction - - `max`: _number_ - Maximum number of blobs per block - - `target`: _number_ - Target number of blobs per block - - `chainId`: _string_ - Chain ID in hexadecimal - - `forkId`: _string_ - Fork hash as defined in EIP-6122 - - `precompiles`: _object_ - Active precompiled contracts with names and addresses - - `systemContracts`: _object_ - System contract addresses -- `next`: _object_ or _null_ - Next fork configuration (null if no future fork scheduled) -- `last`: _object_ or _null_ - Last known fork configuration (null if no future fork scheduled) +`result`: _object_ - configuration information containing: + +- `current`: _object_ - current fork configuration: + - `activationTime`: _number_ - fork activation timestamp (Unix epoch seconds) + - `blobSchedule`: _object_ - blob configuration parameters: + - `baseFeeUpdateFraction`: _number_ - base fee update fraction + - `max`: _number_ - maximum number of blobs per block + - `target`: _number_ - target number of blobs per block + - `chainId`: _string_ - chain ID in hexadecimal + - `forkId`: _string_ - fork hash as defined in [EIP-6122](https://eips.ethereum.org/EIPS/eip-6122) + - `precompiles`: _object_ - active precompiled contracts with names and addresses + - `systemContracts`: _object_ - system contract addresses +- `next`: _object_ or _null_ - next fork configuration (`null` if no future fork is scheduled) +- `last`: _object_ or _null_ - last known fork configuration (`null` if no future fork is scheduled) @@ -2562,8 +2562,9 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_config","params":[],"id":1}' "target": 6 }, "chainId": "0x1", - "forkId": "0x3ff0e375", + "forkId": "0xc376cf8b", "precompiles": { + "BLAKE2F": "0x0000000000000000000000000000000000000009", "BLS12_G1ADD": "0x000000000000000000000000000000000000000b", "BLS12_G1MSM": "0x000000000000000000000000000000000000000c", "BLS12_G2ADD": "0x000000000000000000000000000000000000000d", @@ -2571,7 +2572,6 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_config","params":[],"id":1}' "BLS12_MAP_FP2_TO_G2": "0x0000000000000000000000000000000000000011", "BLS12_MAP_FP_TO_G1": "0x0000000000000000000000000000000000000010", "BLS12_PAIRING_CHECK": "0x000000000000000000000000000000000000000f", - "BLAKE2F": "0x0000000000000000000000000000000000000009", "BN254_ADD": "0x0000000000000000000000000000000000000006", "BN254_MUL": "0x0000000000000000000000000000000000000007", "BN254_PAIRING": "0x0000000000000000000000000000000000000008", From ce7d68d932374d1590269e1d4e75d992262d1fcb Mon Sep 17 00:00:00 2001 From: bgravenorst Date: Wed, 15 Oct 2025 10:32:05 +1000 Subject: [PATCH 3/4] Address reviewer feedback. Signed-off-by: bgravenorst --- docs/public-networks/reference/api/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/public-networks/reference/api/index.md b/docs/public-networks/reference/api/index.md index 009c81b0c2..27b8bae49c 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -2526,8 +2526,9 @@ None - `forkId`: _string_ - fork hash as defined in [EIP-6122](https://eips.ethereum.org/EIPS/eip-6122) - `precompiles`: _object_ - active precompiled contracts with names and addresses - `systemContracts`: _object_ - system contract addresses -- `next`: _object_ or _null_ - next fork configuration (`null` if no future fork is scheduled) -- `last`: _object_ or _null_ - last known fork configuration (`null` if no future fork is scheduled) +- `next`: _object_ or _null_ - next fork configuration. `null` if no future fork is scheduled. +- `last`: _object_ or _null_ - the furthest configured future fork configuration (the future fork with + the largest `activationTime` among the client’s configured forks). If only one future fork is configured, `next` and `last` are the same object. `null` if no future fork is scheduled. From d59e5bcc51ad55fb9945ee03dc6fa46dde76d5ea Mon Sep 17 00:00:00 2001 From: Byron Gravenorst <50852695+bgravenorst@users.noreply.github.com> Date: Mon, 20 Oct 2025 07:04:33 +1000 Subject: [PATCH 4/4] Update docs/public-networks/reference/api/index.md Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> Signed-off-by: Byron Gravenorst <50852695+bgravenorst@users.noreply.github.com> --- docs/public-networks/reference/api/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/public-networks/reference/api/index.md b/docs/public-networks/reference/api/index.md index 27b8bae49c..c403b9a79f 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -2526,9 +2526,9 @@ None - `forkId`: _string_ - fork hash as defined in [EIP-6122](https://eips.ethereum.org/EIPS/eip-6122) - `precompiles`: _object_ - active precompiled contracts with names and addresses - `systemContracts`: _object_ - system contract addresses -- `next`: _object_ or _null_ - next fork configuration. `null` if no future fork is scheduled. -- `last`: _object_ or _null_ - the furthest configured future fork configuration (the future fork with - the largest `activationTime` among the client’s configured forks). If only one future fork is configured, `next` and `last` are the same object. `null` if no future fork is scheduled. +- `next`: _object_ - next fork configuration, or `null` if no future fork is scheduled. +- `last`: _object_ - the furthest configured future fork configuration (the future fork with + the largest `activationTime` among the client's configured forks). If only one future fork is configured, `next` and `last` are the same object. `null` if no future fork is scheduled.