From 8b7e17dd739061a05618859dfe7b8f91992ff90a Mon Sep 17 00:00:00 2001 From: Mikhail Kalinin Date: Tue, 13 Jun 2023 12:08:42 +0600 Subject: [PATCH] Deprecate engine_exchangeTransitionConfigurationV1 --- src/engine/cancun.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/src/engine/cancun.md b/src/engine/cancun.md index 5e19c9b77..5b62aaf06 100644 --- a/src/engine/cancun.md +++ b/src/engine/cancun.md @@ -21,6 +21,7 @@ This specificaiton is based on and extends [Engine API - Shanghai](./shanghai.md - [Request](#request-1) - [Response](#response-1) - [Specification](#specification-1) + - [Deprecate `engine_exchangeTransitionConfigurationV1`](#deprecate-engine_exchangetransitionconfigurationv1) @@ -119,3 +120,13 @@ Refer to the specification for [`engine_getPayloadV2`](./shanghai.md#engine_getp 3. The call **MUST** return `blobs` and `proofs` that match the `commitments` list, i.e. `assert len(blobsBundle.commitments) == len(blobsBundle.blobs) == len(blobsBundle.proofs)` and `assert verify_blob_kzg_proof_batch(blobsBundle.blobs, blobsBundle.commitments, blobsBundle.proofs)`. 4. Client software **MUST** return `-38005: Unsupported fork` error if the `timestamp` of the built payload is less than the Cancun activation timestamp. + +### Deprecate `engine_exchangeTransitionConfigurationV1` + +This document introduces deprecation of [`engine_exchangeTransitionConfigurationV1`](./paris.md#engine_exchangetransitionconfigurationv1). The deprecation is specified as follows: + +1. Consensus layer clients **MUST NOT** call this method. + +2. Execution layer clients **MUST NOT** surface an error message to the user if this method is not called. + +3. Consensus and execution layer clients **MAY** remove support of this method. If no longer supported, this method **MUST** be removed from the [`engine_exchangeCapabilities`](./common.md#engine_exchangecapabilities) request or response list depending on whether it is consensus or execution layer client.