Add eth_config API definitions for EIP-7910

src/eth/client.yaml

@@ -70,3 +70,52 @@
       result:
         name: Block number
         value: '0x2377'
+- name: eth_config
+  summary: Returns the client's current configuration including fork information.
+  externalDocs:
+    description: EIP-7910 specification
+    url: https://eips.ethereum.org/EIPS/eip-7910
+  params: []
+  result:
+    name: Configuration
+    schema:
+      $ref: '#/components/schemas/ConfigurationResponse'
+  examples:
+    - name: eth_config example
+      params: []
+      result:
+        name: Configuration
+        value:
+          current:
+            activationTime: 1746612311
+            blobSchedule:
+              baseFeeUpdateFraction: 5007716
+              max: 9
+              target: 6
+            chainId: '0x1'
+            precompiles:
+              - '0x0000000000000000000000000000000000000001': 'ECREC'
+              - '0x0000000000000000000000000000000000000002': 'SHA256'
+              - '0x0000000000000000000000000000000000000003': 'RIPEMD160'
+              - '0x0000000000000000000000000000000000000004': 'ID'
+              - '0x0000000000000000000000000000000000000005': 'MODEXP'
+              - '0x0000000000000000000000000000000000000006': 'BN254_ADD'
+              - '0x0000000000000000000000000000000000000007': 'BN254_MUL'
+              - '0x0000000000000000000000000000000000000008': 'BN254_PAIRING'
+              - '0x0000000000000000000000000000000000000009': 'BLAKE2F'
+              - '0x000000000000000000000000000000000000000a': 'KZG_POINT_EVALUATION'
+              - '0x000000000000000000000000000000000000000b': 'BLS12_G1ADD'
+              - '0x000000000000000000000000000000000000000c': 'BLS12_G1MSM'
+              - '0x000000000000000000000000000000000000000d': 'BLS12_G2ADD'
+              - '0x000000000000000000000000000000000000000e': 'BLS12_G2MSM'
+              - '0x000000000000000000000000000000000000000f': 'BLS12_PAIRING_CHECK'
+              - '0x0000000000000000000000000000000000000010': 'BLS12_MAP_FP_TO_G1'
+              - '0x0000000000000000000000000000000000000011': 'BLS12_MAP_FP2_TO_G2'
+            systemContracts:
+              - 'BEACON_ROOTS_ADDRESS': '0x000f3df6d732807ef1319fb7b8bb8522d0beac02'
+              - 'CONSOLIDATION_REQUEST_PREDEPLOY_ADDRESS': '0x0000bbddc7ce488642fb579f8b00f3a590007251'
+              - 'DEPOSIT_CONTRACT_ADDRESS': '0x00000000219ab540356cbb839cbe05303d7705fa'
+              - 'HISTORY_STORAGE_ADDRESS': '0x0000f90827f1c53a10cb7a02335b175320002935'
+              - 'WITHDRAWAL_REQUEST_PREDEPLOY_ADDRESS': '0x00000961ef480eb55e80d19ad83579a64c007002'
+          currentHash: '0xc376cf8b'
+          currentForkId: '0x3ff0e375'

src/schemas/base-types.yaml

@@ -19,6 +19,10 @@ bytesMax32:
   title: 32 hex encoded bytes
   type: string
   pattern: ^0x[0-9a-f]{0,64}$
+bytes4:
+  title: 4 hex encoded bytes
+  type: string
+  pattern: ^0x[0-9a-f]{8}$
 bytes8:
   title: 8 hex encoded bytes
   type: string

src/schemas/client.yaml

@@ -17,3 +17,112 @@ SyncingStatus:
     - title: Not syncing
       description: Should always return false if not syncing.
       type: boolean
+ConfigurationResponse:
+  title: Configuration response
+  description: Response object for eth_config method containing current, next, and last fork configurations
+  type: object
+  additionalProperties: false
+  properties:
+    current:
+      title: Current configuration
+      $ref: '#/components/schemas/ConfigObject'
+    currentHash:
+      title: Current configuration hash
+      description: CRC-32 hash of the canonical JSON of the current configuration
+      $ref: '#/components/schemas/bytes4'
+    currentForkId:
+      title: Current fork ID
+      description: Fork identifier for the current configuration
+      $ref: '#/components/schemas/bytes4'
+    next:
+      title: Next configuration
+      description: Configuration for the next scheduled fork, absent if no future forks scheduled
+      $ref: '#/components/schemas/ConfigObject'
+    nextHash:
+      title: Next configuration hash
+      description: CRC-32 hash of the the canonical JSON of the next configuration, absent if no future forks scheduled
+      $ref: '#/components/schemas/bytes4'
+    nextForkId:
+      title: Next fork ID
+      description: Fork identifier for the next configuration, absent if no future forks scheduled
+      $ref: '#/components/schemas/bytes4'
+    last:
+      title: Last configuration
+      description: Configuration for the last configured fork, absent if no future forks scheduled
+      $ref: '#/components/schemas/ConfigObject'
+    lastHash:
+      title: Last configuration hash
+      description: CRC-32 hash of the the canonical JSON of the last configured fork, absent if no future forks scheduled
+      $ref: '#/components/schemas/bytes4'
+    lastForkId:
+      title: Last fork ID
+      description: Fork identifier for the last configured fork, absent if no future forks scheduled
+      $ref: '#/components/schemas/bytes4'
+  required:
+    - current
+    - currentHash
+    - currentForkId
+ConfigObject:
+  title: Configuration object
+  description: Represents a specific fork configuration
+  type: object
+  additionalProperties: false
+  properties:
+    activationTime:
+      title: Activation time
+      description: Unix timestamp when this configuration becomes active
+      type: number
+    blobSchedule:
+      title: Blob schedule
+      description: Configuration for blob fee schedule
+      $ref: '#/components/schemas/BlobSchedule'
+    chainId:
+      title: Chain ID
+      description: The chain ID for this configuration
+      $ref: '#/components/schemas/uint'
+    precompiles:
+      title: Precompiles
+      description: Mapping of precompile addresses to their names
+      type: object
+      additionalProperties:
+        type: string
+      patternProperties:
+        '^0x[0-9a-fA-F]{40}$':
+          type: string
+    systemContracts:
+      title: System contracts
+      description: Mapping of system contract names to their addresses
+      type: object
+      additionalProperties:
+        $ref: '#/components/schemas/address'
+  required:
+    - activationTime
+    - blobSchedule
+    - chainId
+    - precompiles
+    - systemContracts
+BlobSchedule:
+  title: Blob schedule
+  description: Configuration parameters for blob fee scheduling
+  type: object
+  additionalProperties: false
+  properties:
+    baseFeeUpdateFraction:
+      title: Base fee update fraction
+      description: Fraction used for updating blob base fees
+      type: integer
+      minimum: 0
+    max:
+      title: Maximum blobs
+      description: Maximum number of blobs per block
+      type: integer
+      minimum: 0
+    target:
+      title: Target blobs
+      description: Target number of blobs per block
+      type: integer
+      minimum: 0
+  required:
+    - baseFeeUpdateFraction
+    - max
+    - target

tests/eth_config/get-config-with-next-fork.io

@@ -0,0 +1,3 @@
+// retrieves configuration when a fork is scheduled (EIP-7910 example with expanded next config)
+>> {"jsonrpc":"2.0","id":1,"method":"eth_config"}
+<< {"jsonrpc":"2.0","id":1,"result":{"current":{"activationTime":0,"blobSchedule":{"baseFeeUpdateFraction":3338477,"max":6,"target":3},"chainId":"0x88bb0","precompiles":{"0x0000000000000000000000000000000000000001":"ECREC","0x0000000000000000000000000000000000000002":"SHA256","0x0000000000000000000000000000000000000003":"RIPEMD160","0x0000000000000000000000000000000000000004":"ID","0x0000000000000000000000000000000000000005":"MODEXP","0x0000000000000000000000000000000000000006":"BN254_ADD","0x0000000000000000000000000000000000000007":"BN254_MUL","0x0000000000000000000000000000000000000008":"BN254_PAIRING","0x0000000000000000000000000000000000000009":"BLAKE2F","0x000000000000000000000000000000000000000a":"KZG_POINT_EVALUATION"},"systemContracts":{"BEACON_ROOTS_ADDRESS":"0x000f3df6d732807ef1319fb7b8bb8522d0beac02"}},"currentHash":"0x2eedf329","currentForkId":"0xbef71d30","next":{"activationTime":1742999832,"blobSchedule":{"baseFeeUpdateFraction":5007716,"max":9,"target":6},"chainId":"0x88bb0","precompiles":{"0x0000000000000000000000000000000000000001":"ECREC","0x0000000000000000000000000000000000000002":"SHA256","0x0000000000000000000000000000000000000003":"RIPEMD160","0x0000000000000000000000000000000000000004":"ID","0x0000000000000000000000000000000000000005":"MODEXP","0x0000000000000000000000000000000000000006":"BN254_ADD","0x0000000000000000000000000000000000000007":"BN254_MUL","0x0000000000000000000000000000000000000008":"BN254_PAIRING","0x0000000000000000000000000000000000000009":"BLAKE2F","0x000000000000000000000000000000000000000a":"KZG_POINT_EVALUATION","0x000000000000000000000000000000000000000b":"BLS12_G1ADD","0x000000000000000000000000000000000000000c":"BLS12_G1MSM","0x000000000000000000000000000000000000000d":"BLS12_G2ADD","0x000000000000000000000000000000000000000e":"BLS12_G2MSM","0x000000000000000000000000000000000000000f":"BLS12_PAIRING_CHECK","0x0000000000000000000000000000000000000010":"BLS12_MAP_FP_TO_G1","0x0000000000000000000000000000000000000011":"BLS12_MAP_FP2_TO_G2"},"systemContracts":{"BEACON_ROOTS_ADDRESS":"0x000f3df6d732807ef1319fb7b8bb8522d0beac02","CONSOLIDATION_REQUEST_PREDEPLOY_ADDRESS":"0x0000bbddc7ce488642fb579f8b00f3a590007251","DEPOSIT_CONTRACT_ADDRESS":"0x00000000219ab540356cbb839cbe05303d7705fa","HISTORY_STORAGE_ADDRESS":"0x0000f90827f1c53a10cb7a02335b175320002935","WITHDRAWAL_REQUEST_PREDEPLOY_ADDRESS":"0x00000961ef480eb55e80d19ad83579a64c007002"}},"nextHash":"0x0d82a81f","nextForkId":"0x0929e24e","last":{"activationTime":1742999832,"blobSchedule":{"baseFeeUpdateFraction":5007716,"max":9,"target":6},"chainId":"0x88bb0","precompiles":{"0x0000000000000000000000000000000000000001":"ECREC","0x0000000000000000000000000000000000000002":"SHA256","0x0000000000000000000000000000000000000003":"RIPEMD160","0x0000000000000000000000000000000000000004":"ID","0x0000000000000000000000000000000000000005":"MODEXP","0x0000000000000000000000000000000000000006":"BN254_ADD","0x0000000000000000000000000000000000000007":"BN254_MUL","0x0000000000000000000000000000000000000008":"BN254_PAIRING","0x0000000000000000000000000000000000000009":"BLAKE2F","0x000000000000000000000000000000000000000a":"KZG_POINT_EVALUATION","0x000000000000000000000000000000000000000b":"BLS12_G1ADD","0x000000000000000000000000000000000000000c":"BLS12_G1MSM","0x000000000000000000000000000000000000000d":"BLS12_G2ADD","0x000000000000000000000000000000000000000e":"BLS12_G2MSM","0x000000000000000000000000000000000000000f":"BLS12_PAIRING_CHECK","0x0000000000000000000000000000000000000010":"BLS12_MAP_FP_TO_G1","0x0000000000000000000000000000000000000011":"BLS12_MAP_FP2_TO_G2"},"systemContracts":{"BEACON_ROOTS_ADDRESS":"0x000f3df6d732807ef1319fb7b8bb8522d0beac02","CONSOLIDATION_REQUEST_PREDEPLOY_ADDRESS":"0x0000bbddc7ce488642fb579f8b00f3a590007251","DEPOSIT_CONTRACT_ADDRESS":"0x00000000219ab540356cbb839cbe05303d7705fa","HISTORY_STORAGE_ADDRESS":"0x0000f90827f1c53a10cb7a02335b175320002935","WITHDRAWAL_REQUEST_PREDEPLOY_ADDRESS":"0x00000961ef480eb55e80d19ad83579a64c007002"}},"lastHash":"0x0d82a81f","lastForkId":"0x0929e24e"}}

tests/eth_config/get-current-config.io

@@ -0,0 +1,3 @@
+// retrieves the client's current fork configuration
+>> {"jsonrpc":"2.0","id":1,"method":"eth_config"}
+<< {"jsonrpc":"2.0","id":1,"result":{"current":{"activationTime":1746612311,"blobSchedule":{"baseFeeUpdateFraction":5007716,"max":9,"target":6},"chainId":"0x1","precompiles":{"0x0000000000000000000000000000000000000001":"ECREC","0x0000000000000000000000000000000000000002":"SHA256","0x0000000000000000000000000000000000000003":"RIPEMD160","0x0000000000000000000000000000000000000004":"ID","0x0000000000000000000000000000000000000005":"MODEXP","0x0000000000000000000000000000000000000006":"BN254_ADD","0x0000000000000000000000000000000000000007":"BN254_MUL","0x0000000000000000000000000000000000000008":"BN254_PAIRING","0x0000000000000000000000000000000000000009":"BLAKE2F","0x000000000000000000000000000000000000000a":"KZG_POINT_EVALUATION","0x000000000000000000000000000000000000000b":"BLS12_G1ADD","0x000000000000000000000000000000000000000c":"BLS12_G1MSM","0x000000000000000000000000000000000000000d":"BLS12_G2ADD","0x000000000000000000000000000000000000000e":"BLS12_G2MSM","0x000000000000000000000000000000000000000f":"BLS12_PAIRING_CHECK","0x0000000000000000000000000000000000000010":"BLS12_MAP_FP_TO_G1","0x0000000000000000000000000000000000000011":"BLS12_MAP_FP2_TO_G2"},"systemContracts":{"BEACON_ROOTS_ADDRESS":"0x000f3df6d732807ef1319fb7b8bb8522d0beac02","CONSOLIDATION_REQUEST_PREDEPLOY_ADDRESS":"0x0000bbddc7ce488642fb579f8b00f3a590007251","DEPOSIT_CONTRACT_ADDRESS":"0x00000000219ab540356cbb839cbe05303d7705fa","HISTORY_STORAGE_ADDRESS":"0x0000f90827f1c53a10cb7a02335b175320002935","WITHDRAWAL_REQUEST_PREDEPLOY_ADDRESS":"0x00000961ef480eb55e80d19ad83579a64c007002"}},"currentForkId":"0xc376cf8b","currentHash":"0x3ff0e375"}}

wordlist.txt

@@ -80,3 +80,9 @@ txs
 UX
 simulateV
 EOA's
+BLS
+BN
+FP
+MSM
+MUL
+CRC