Merge pull request #135 from mkalinin/engine-api-validation-error

Engine API: inform CL with details on validation error

Author: lightclient

src/engine/specification.md

@@ -180,7 +180,7 @@ This structure contains the attributes required to initiate a payload build proc
 * result: `object`
     - `status`: `enum` - `"VALID" | "INVALID" | "SYNCING"`
     - `latestValidHash`: `DATA|null`, 32 Bytes - the hash of the most recent *valid* block in the branch defined by payload and its ancestors
-    - `message`: `STRING|null` - the message providing additional details on the response to the method call if needed
+    - `validationError`: `String|null` - a message providing additional details on the validation error if the payload is deemed `INVALID`
 * error: code and message set in case an exception happens while executing the payload.
 
 #### Specification
@@ -193,7 +193,7 @@ This structure contains the attributes required to initiate a payload build proc
 
 3. Client software **MUST** return `{status: SYNCING, latestValidHash: null}` if the sync process is already in progress or if requisite data for payload validation is missing. In the event that requisite data to validate the payload is missing (e.g. does not have payload identified by `parentHash`), the client software **SHOULD** initiate the sync process.
 
-4. Client software **MAY** provide additional details on the payload validation by utilizing `message` field in the response object. For example, particular error message occurred during the payload execution may accompany a response with `INVALID` status.
+4. Client software **MAY** provide additional details on the validation error if the payload is deemed `INVALID` by assigning the corresponding message to the `validationError` field.
 
 5. Client software **MUST** return `-32002: Invalid terminal block` error if the parent block is a PoW block that doesn't satisfy terminal block conditions according to [EIP-3675](https://eips.ethereum.org/EIPS/eip-3675#definitions). This check maps on the Transition block validity section of [EIP-3675](https://eips.ethereum.org/EIPS/eip-3675#transition-block-validity).