Merge remote-tracking branch 'origin/main' into dx-upgrade

Author: acolytec3

package-lock.json

@@ -6,16 +6,14 @@
   "scripts": {
     "build": "npm run build:spec",
     "build:spec": "node scripts/build.js",
-    "build:test": "which go > /dev/null 2>&1 || (echo 'Error: Go binary not found. Please install Go first.' && exit 1) && go install github.com/lightclient/rpctestgen/cmd/speccheck@latest",
     "build:docs": "npm run generate-clients && npm run build:docs:gatsby",
     "build:docs:gatsby": "cp README.md docs/reference/quickstart.md && cd build/docs/gatsby && npm install && gatsby build --prefix-paths",
     "lint": "node scripts/build.js && node scripts/validate.js && node scripts/graphql-validate.js",
     "clean": "rm -rf build && mkdir -p build",
     "generate-clients": "mkdir -p build && open-rpc-generator generate -c open-rpc-generator-config.json",
     "graphql:schema": "node scripts/graphql.js",
     "graphql:validate": "node scripts/graphql-validate.js",
-    "serve": "cd build/docs/gatsby && gatsby develop",
-    "test": "speccheck -v"
+    "serve": "cd build/docs/gatsby && gatsby develop"
   },
   "repository": {
     "type": "git",

package.json

@@ -108,8 +108,9 @@ Consensus layer clients **MAY** use this method to fetch blobs from the executio
 Refer to the specification for [`engine_getBlobsV1`](./cancun.md#engine_getblobsv1) with changes of the following:
 
 1. Given an array of blob versioned hashes client software **MUST** respond with an array of `BlobAndProofV2` objects with matching versioned hashes, respecting the order of versioned hashes in the input array.
-1. Given an array of blob versioned hashes, if client software has every one of the requested blobs, it **MUST** return an array of `BlobAndProofV2` objects whose order exactly matches the input array. For instance, if the request is `[A_versioned_hash, B_versioned_hash, C_versioned_hash]` and client software has `A`, `B` and `C` available, the response **MUST** be `[A, B, C]`.
-2. If one or more of the requested blobs are unavailable, the client **MUST** return either `null` or an array of the same length and order, inserting `null` only at the positions of the missing blobs. For instance, if the request is `[A_versioned_hash, B_versioned_hash, C_versioned_hash]` and client software has data for blobs `A` and `C`, but doesn't have data for `B`, the response **MUST** be either `null` or `[A, null, C]`.
+2. Client software **MUST** return `null` in case of any missing or older version blobs. For instance, 
+   1. if the request is `[A_versioned_hash, B_versioned_hash, C_versioned_hash]` and client software has data for blobs `A` and `C`, but doesn't have data for `B`, the response **MUST** be `null`.
+   2. if the request is `[A_versioned_hash_for_blob_with_blob_proof]`, the response **MUST** be `null` as well.
 3. Client software **MUST** support request sizes of at least 128 blob versioned hashes. The client **MUST** return `-38004: Too large request` error if the number of requested blobs is too large.
 4. Client software **MUST** return `null` if syncing or otherwise unable to serve blob pool data.
 5. Callers **MUST** consider that execution layer clients may prune old blobs from their pool, and will respond with `null` if a blob has been pruned.

src/engine/osaka.md

@@ -111,3 +111,42 @@
     name: Result of calls
     schema:
       $ref: '#/components/schemas/EthSimulateResult'
+  errors:
+    - code: -32000
+      message: Invalid request
+    - code: -32602
+      message: Missing or invalid parameters
+    - code: -32005
+      message: Transactions maxFeePerGas is too low
+    - code: -32015
+      message: Execution error
+    - code: -32016
+      message: Timeout
+    - code: -32603
+      message: The Ethereum node encountered an internal error
+    - code: -38010
+      message: Transactions nonce is too low
+    - code: -38011
+      message: Transactions nonce is too high
+    - code: -38012
+      message: Transactions baseFeePerGas is too low
+    - code: -38013
+      message: Not enough gas provided to pay for intrinsic gas for a transaction
+    - code: -38014
+      message: Insufficient funds to pay for gas fees and value for a transaction
+    - code: -38015
+      message: Block gas limit exceeded by the block's transactions
+    - code: -38020
+      message: Block number in sequence did not increase
+    - code: -38021
+      message: Block timestamp in sequence did not increase or stay the same
+    - code: -38022
+      message: MovePrecompileToAddress referenced itself in replacement
+    - code: -38023
+      message: Multiple MovePrecompileToAddress referencing the same address to replace
+    - code: -38024
+      message: Sender is not an EOA
+    - code: -38025
+      message: Max init code size exceeded
+    - code: -38026
+      message: Client adjustable limit exceeded

src/eth/execute.yaml

@@ -20,7 +20,6 @@ Block:
     - size
     - transactions
     - uncles
-  additionalProperties: false
   properties:
     hash:
       title: Hash

src/schemas/block.yaml

@@ -1,5 +1,5 @@
 EthSimulatePayload:
-  title: Arguments for multi call
+  title: Arguments for eth_simulate
   required:
     - blockStateCalls
   properties:
@@ -149,7 +149,7 @@ Withdrawals:
   description: This array can have a maximum length of 16.
   type: array
   items:
-    - $ref: '#/components/schemas/Withdrawal'
+    $ref: '#/components/schemas/Withdrawal'
 Withdrawal:
   title: A withdrawal made by a validator
   type: object
@@ -167,13 +167,7 @@ Withdrawal:
       title: Amount
       $ref: '#/components/schemas/uint64'
 EthSimulateResult:
-  title: Full results of multi call
-  type: object
-  oneOf:
-    - $ref: '#/components/schemas/EthSimulateBlockResultInvalid'
-    - $ref: '#/components/schemas/EthSimulateBlockResultSuccess'
-EthSimulateBlockResultSuccess:
-  title: Full results of multi call
+  title: Full results of eth_simulate
   type: array
   items:
     $ref: '#/components/schemas/EthSimulateBlockResultSingleSuccess'
@@ -182,62 +176,16 @@ EthSimulateBlockResultSingleSuccess:
   type: object
   allOf:
     - $ref: '#/components/schemas/Block'
-    - title: Eth Simulate call results
+    - type: object
+      title: Eth Simulate call results
       required:
         - calls
       properties:
         calls:
           title: Call Results
           $ref: '#/components/schemas/CallResults'
-EthSimulateBlockResultInvalid:
-  title: Result of eth_simulate not being valid
-  description: The error messages are suggestions and a client might decide to return a different errror message than specified here. However, the error codes are enforced by this specification.
-  type: object
-  required:
-    - error
-  properties:
-    error:
-      oneOf:
-        - code: -32000
-          message: Invalid request
-        - code: -32602
-          message: Missing or invalid parameters
-        - code: -32005
-          message: Transactions maxFeePerGas is too low
-        - code: -32015
-          messagE: Execution error
-        - code: -32016
-          message: Timeout
-        - code: -32603
-          message: The Ethereum node encountered an internal error
-        - code: -38010
-          message: Transactions nonce is too low
-        - code: -38011
-          message: Transactions nonce is too high
-        - code: -38012
-          message: Transactions baseFeePerGas is too low
-        - code: -38013
-          message: Not enough gas provided to pay for intrinsic gas for a transaction
-        - code: -38014
-          message: Insufficient funds to pay for gas fees and value for a transaction
-        - code: -38015
-          message: Block gas limit exceeded by the block's transactions
-        - code: -38020
-          message: Block number in sequence did not increase
-        - code: -38021
-          message: Block timestamp in sequence did not increase or stay the same
-        - code: -38022
-          message: MovePrecompileToAddress referenced itself in replacement
-        - code: -38023
-          message: Multiple MovePrecompileToAddress referencing the same address to replace
-        - code: -38024
-          message: Sender is not an EOA
-        - code: -38025
-          message: Max init code size exceeded
-        - code: -38026
-          message: Client adjustable limit exceeded
 CallResults:
-  title: Results of multi call within block
+  title: Results of eth_simulate within block
   type: array
   items:
     oneOf:
@@ -265,10 +213,21 @@ CallResultFailure:
       $ref: '#/components/schemas/uint64'
     error:
       oneOf:
-        - code: -32000
-          message: 'Execution reverted'
-        - code: -32015
-          message: 'VM execution error'
+      - type: object
+        properties:
+          code:
+            const: -32000
+          message:
+            type: string
+            pattern: "^execution reverted.*"
+        required: [code, message]
+      - type: object
+        properties:
+          code:
+            const: -32015
+          message:
+            type: string
+            pattern: "^vm execution error.*"
 CallResultSuccess:
   title: Result of call success
   type: object
@@ -298,7 +257,7 @@ CallResultLog:
   type: object
   required:
     - logIndex
-    - blockhash
+    - blockHash
     - blockNumber
     - transactionHash
     - transactionIndex

src/schemas/execute.yaml

@@ -467,7 +467,6 @@ TransactionInfo:
         - from
         - hash
         - transactionIndex
-      unevaluatedProperties: false
       properties:
         blockHash:
           title: block hash