engine_newPayloadV2

Runs execution payload validation

Parameters (by position)

Execution payload object or object required

---

Show Option 1 Execution payload object V1 object

Execution payload object V1 fields

Execution payload object required

Execution payload object V1

---

Show Execution payload object

Execution payload fields

• parentHash string required

  Parent block hash

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• feeRecipient string required

  Recipient of transaction priority fees

  Match pattern: ^0x[0-9a-fA-F]{40}$

  ---

• stateRoot string required

  State root

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• receiptsRoot string required

  Receipts root

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• logsBloom string required

  Bloom filter

  Match pattern: ^0x[0-9a-f]{512}$

  ---

• prevRandao string required

  Previous randao value

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• blockNumber string required

  Block number

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

  ---

• gasLimit string required

  Gas limit

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

  ---

• gasUsed string required

  Gas used

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

  ---

• timestamp string required

  Timestamp

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

  ---

• extraData string required

  Extra data

  Match pattern: ^0x[0-9a-f]{0,64}$

  ---

• baseFeePerGas string required

  Base fee per gas

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$

  ---

• blockHash string required

  Block hash

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• transactions array<string> required

  hex encoded bytes

  Match pattern: ^0x[0-9a-f]*$

  ---

• additionalProperties true

  ---

Show Option 2 Execution payload object V2 object

Execution payload object V2 fields

Execution payload object required

Execution payload object V2

---

Show Execution payload object

Execution payload fields

• parentHash string required

  Parent block hash

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• feeRecipient string required

  Recipient of transaction priority fees

  Match pattern: ^0x[0-9a-fA-F]{40}$

  ---

• stateRoot string required

  State root

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• receiptsRoot string required

  Receipts root

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• logsBloom string required

  Bloom filter

  Match pattern: ^0x[0-9a-f]{512}$

  ---

• prevRandao string required

  Previous randao value

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• blockNumber string required

  Block number

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

  ---

• gasLimit string required

  Gas limit

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

  ---

• gasUsed string required

  Gas used

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

  ---

• timestamp string required

  Timestamp

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

  ---

• extraData string required

  Extra data

  Match pattern: ^0x[0-9a-f]{0,64}$

  ---

• baseFeePerGas string required

  Base fee per gas

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$

  ---

• blockHash string required

  Block hash

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• transactions array<string> required

  hex encoded bytes

  Match pattern: ^0x[0-9a-f]*$

  ---

• withdrawals array<object> required

  Withdrawal object V1

  ---

  Show withdrawals object

  withdrawals fields

  • index string required

    Withdrawal index

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

    ---

  • validatorIndex string required

    Validator index

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

    ---

  • address string required

    Withdrawal address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • amount string required

    Withdrawal amount

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

    ---

  • additionalProperties true

    ---

• additionalProperties true

  ---

Result

Payload status object

Payload status object deprecating INVALID_BLOCK_HASH status

---

Show Payload status object

Payload status fields

• status string required

  Payload validation status

  Allowed values: VALID INVALID SYNCING ACCEPTED

  ---

• latestValidHash string

  The hash of the most recent valid block

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• validationError string

  Validation error message

  ---

• additionalProperties true

  ---

Errors

Error code: -32602

• code

  -32602

• message

  Invalid params

Examples

engine_newPayloadV2 example

Request

{
  "params": [
    {
      "parentHash": "0x3b8fb240d288781d4aac94d3fd16809ee413bc99294a085798a589dae51ddd4a",
      "feeRecipient": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
      "stateRoot": "0xca3149fa9e37db08d1cd49c9061db1002ef1cd58db2210f2115c8c989b2bdf45",
      "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
      "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "prevRandao": "0xc130d5e63c61c935f6089e61140ca9136172677cf6aa5800dcc1cf0a02152a14",
      "blockNumber": "0x112720f",
      "gasLimit": "0x1c9c380",
      "gasUsed": "0xbad2e8",
      "timestamp": "0x64e7785b",
      "extraData": "0x",
      "baseFeePerGas": "0x7",
      "blockHash": "0x3559e851470f6e7bbed1db474980683e8c315bfce99b2a6ef47c057c04de7858",
      "transactions": [
        "0x03f88f0780843b9aca008506fc23ac00830186a09400000000000000000000000000000000000001008080c001e1a0010657f37554c781402a22917dee2f75def7ab966d7b770905398eba3c44401401a0840650aa8f74d2b07f40067dc33b715078d73422f01da17abdbd11e02bbdfda9a04b2260f6022bf53eadb337b3e59514936f7317d872defb891a708ee279bdca90",
        "0x03f88f0701843b9aca008506fc23ac00830186a09400000000000000000000000000000000000001008080c001e1a001521d528ad0c760354a4f0496776cf14a92fe1fb5d50e959dcea1a489c7c83101a0a86c1fd8c2e74820686937f5c1bfe836e2fb622ac9fcbebdc4ab4357f2dbbc61a05c3b2b44ff8252f78d70aeb33f8ba09beaeadad1b376a57d34fa720bbc4a18ee",
        "0x03f88f0702843b9aca008506fc23ac00830186a09400000000000000000000000000000000000001008080c001e1a001453362c360fdd8832e3539d463e6d64b2ee320ac6a08885df6083644a063e701a037a728aec08aefffa702a2ca620db89caf3e46ab7f25f7646fc951510991badca065d846f046357af39bb739b161233fce73ddfe0bb87f2d28ef60dfe6dbb0128d"
      ],
      "withdrawals": [
        {
          "index": "0xf0",
          "validatorIndex": "0xf0",
          "address": "0x00000000000000000000000000000000000010f0",
          "amount": "0x1"
        },
        {
          "index": "0xf1",
          "validatorIndex": "0xf1",
          "address": "0x00000000000000000000000000000000000010f1",
          "amount": "0x1"
        }
      ]
    }
  ]
}

Response

{
  "status": "VALID",
  "latestValidHash": "0x3559e851470f6e7bbed1db474980683e8c315bfce99b2a6ef47c057c04de7858",
  "validationError": null
}

Request

Server URL:

{ "jsonrpc": "2.0", "method": "engine_newPayloadV2", "params": [ { "parentHash": "0x3b8fb240d288781d4aac94d3fd16809ee413bc99294a085798a589dae51ddd4a", "feeRecipient": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b", "stateRoot": "0xca3149fa9e37db08d1cd49c9061db1002ef1cd58db2210f2115c8c989b2bdf45", "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "prevRandao": "0xc130d5e63c61c935f6089e61140ca9136172677cf6aa5800dcc1cf0a02152a14", "blockNumber": "0x112720f", "gasLimit": "0x1c9c380", "gasUsed": "0xbad2e8", "timestamp": "0x64e7785b", "extraData": "0x", "baseFeePerGas": "0x7", "blockHash": "0x3559e851470f6e7bbed1db474980683e8c315bfce99b2a6ef47c057c04de7858", "transactions": [ "0x03f88f0780843b9aca008506fc23ac00830186a09400000000000000000000000000000000000001008080c001e1a0010657f37554c781402a22917dee2f75def7ab966d7b770905398eba3c44401401a0840650aa8f74d2b07f40067dc33b715078d73422f01da17abdbd11e02bbdfda9a04b2260f6022bf53eadb337b3e59514936f7317d872defb891a708ee279bdca90", "0x03f88f0701843b9aca008506fc23ac00830186a09400000000000000000000000000000000000001008080c001e1a001521d528ad0c760354a4f0496776cf14a92fe1fb5d50e959dcea1a489c7c83101a0a86c1fd8c2e74820686937f5c1bfe836e2fb622ac9fcbebdc4ab4357f2dbbc61a05c3b2b44ff8252f78d70aeb33f8ba09beaeadad1b376a57d34fa720bbc4a18ee", "0x03f88f0702843b9aca008506fc23ac00830186a09400000000000000000000000000000000000001008080c001e1a001453362c360fdd8832e3539d463e6d64b2ee320ac6a08885df6083644a063e701a037a728aec08aefffa702a2ca620db89caf3e46ab7f25f7646fc951510991badca065d846f046357af39bb739b161233fce73ddfe0bb87f2d28ef60dfe6dbb0128d" ], "withdrawals": [ { "index": "0xf0", "validatorIndex": "0xf0", "address": "0x00000000000000000000000000000000000010f0", "amount": "0x1" }, { "index": "0xf1", "validatorIndex": "0xf1", "address": "0x00000000000000000000000000000000000010f1", "amount": "0x1" } ] } ], "id": 1 }