Skip to main content

engine_newPayloadV1

Runs execution payload validation

Parameters (by position)​

Execution payload object required

Execution payload object V1

Show Execution payload object

Execution payload fields​

  • parentHash string

    Parent block hash

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

  • feeRecipient string

    Recipient of transaction priority fees

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

  • stateRoot string

    State root

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

  • receiptsRoot string

    Receipts root

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

  • logsBloom string

    Bloom filter

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

  • prevRandao string

    Previous randao value

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

  • blockNumber string

    Block number

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

  • gasLimit string

    Gas limit

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

  • gasUsed string

    Gas used

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

  • timestamp string

    Timestamp

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

  • extraData string

    Extra data

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

  • baseFeePerGas string

    Base fee per gas

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

  • blockHash string

    Block hash

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

  • transactions array<string>

    hex encoded bytes

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

  • additionalProperties true

Result​

Payload status object

Payload status object V1

Show Payload status object

Payload status fields​

  • status string required

    Payload validation status

    Allowed values: VALID INVALID SYNCING ACCEPTED INVALID_BLOCK_HASH

  • latestValidHash string

    The hash of the most recent valid block

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

  • validationError string

    Validation error message

  • additionalProperties true

Examples​

engine_newPayloadV1 example

Request​

{
  "params": [
    {
      "parentHash": "0x3b8fb240d288781d4aac94d3fd16809ee413bc99294a085798a589dae51ddd4a",
      "feeRecipient": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
      "stateRoot": "0xca3149fa9e37db08d1cd49c9061db1002ef1cd58db2210f2115c8c989b2bdf45",
      "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
      "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "prevRandao": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "blockNumber": "0x1",
      "gasLimit": "0x1c9c380",
      "gasUsed": "0x0",
      "timestamp": "0x5",
      "extraData": "0x",
      "baseFeePerGas": "0x7",
      "blockHash": "0x3559e851470f6e7bbed1db474980683e8c315bfce99b2a6ef47c057c04de7858",
      "transactions": []
    }
  ]
}

Response​

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

engine_newPayloadV1 invalid example

Request​

{
  "params": [
    {
      "parentHash": "0x3b8fb240d288781d4aac94d3fd16809ee413bc99294a085798a589dae51ddd4a",
      "feeRecipient": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
      "stateRoot": "0xca3149fa9e37db08d1cd49c9061db1002ef1cd58db2210f2115c8c989b2bdf45",
      "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
      "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "prevRandao": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "blockNumber": "0x1",
      "gasLimit": "0x1c9c380",
      "gasUsed": "0x0",
      "timestamp": "0x5",
      "extraData": "0x",
      "baseFeePerGas": "0x7",
      "blockHash": "0x3559e851470f6e7bbed1db474980683e8c315bfce99b2a6ef47c057c04de7858",
      "transactions": []
    }
  ]
}

Response​

{
  "status": "INVALID",
  "latestValidHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "validationError": "New payload is invalid"
}
Request