Try It Now Dialog

engine_exchangeTransitionConfigurationV1

---

Method

• JSON-RPC method name: engine_exchangeTransitionConfigurationV1
• JSON-RPC version: 2.0

Parameters

Name	Type	Required	Description
Consensus client configuration	object	yes

Parameter schema

{
  "Consensus client configuration": {
    "required": true,
    "schema": {
      "title": "Transition configuration object",
      "type": "object",
      "required": [
        "terminalTotalDifficulty",
        "terminalBlockHash",
        "terminalBlockNumber"
      ],
      "properties": {
        "terminalTotalDifficulty": {
          "title": "Terminal total difficulty",
          "type": "string",
          "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$"
        },
        "terminalBlockHash": {
          "title": "Terminal block hash",
          "type": "string",
          "pattern": "^0x[0-9a-f]{64}$"
        },
        "terminalBlockNumber": {
          "title": "Terminal block number",
          "type": "string",
          "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
        }
      }
    }
  }
}

Result

• Name: Execution client configuration
• Type: object

Result schema

{
  "title": "Transition configuration object",
  "type": "object",
  "required": [
    "terminalTotalDifficulty",
    "terminalBlockHash",
    "terminalBlockNumber"
  ],
  "properties": {
    "terminalTotalDifficulty": {
      "title": "Terminal total difficulty",
      "type": "string",
      "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$"
    },
    "terminalBlockHash": {
      "title": "Terminal block hash",
      "type": "string",
      "pattern": "^0x[0-9a-f]{64}$"
    },
    "terminalBlockNumber": {
      "title": "Terminal block number",
      "type": "string",
      "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
    }
  }
}

Positional parameters

Parameter order:

1. Consensus client configuration

---

Errors

This method may return JSON-RPC standard errors (e.g. -32600, -32601, -32602, -32603) as well as application-specific errors.

TODO: Document method-specific error codes and conditions.

Named Parameters

{
  "jsonrpc": "2.0",
  "method": "engine_exchangeTransitionConfigurationV1",
  "params": {
    "Consensus client configuration": {
      "terminalTotalDifficulty": "string",
      "terminalBlockHash": "string",
      "terminalBlockNumber": "string"
    }
  },
  "id": 1
}

Successful Response

{
  "jsonrpc": "2.0",
  "result": {
    "terminalTotalDifficulty": "string",
    "terminalBlockHash": "string",
    "terminalBlockNumber": "string"
  },
  "id": 1
}

Positional Parameters

{
  "jsonrpc": "2.0",
  "method": "engine_exchangeTransitionConfigurationV1",
  "params": [
    {
      "terminalTotalDifficulty": "string",
      "terminalBlockHash": "string",
      "terminalBlockNumber": "string"
    }
  ],
  "id": 2
}

Successful Response

{
  "jsonrpc": "2.0",
  "result": {
    "terminalTotalDifficulty": "string",
    "terminalBlockHash": "string",
    "terminalBlockNumber": "string"
  },
  "id": 2
}