engine_newPayloadV1

Runs execution payload validation

Params

(1)

1. Execution payload (required)

parentHash

string

required

Match pattern:

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

feeRecipient

string

required

Match pattern:

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

stateRoot

string

required

Match pattern:

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

receiptsRoot

string

required

Match pattern:

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

logsBloom

string

required

Match pattern:

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

prevRandao

string

required

Match pattern:

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

blockNumber

string

required

Match pattern:

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

gasLimit

string

required

Match pattern:

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

gasUsed

string

required

Match pattern:

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

timestamp

string

required

Match pattern:

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

extraData

string

required

Match pattern:

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

baseFeePerGas

string

required

Match pattern:

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

blockHash

string

required

Match pattern:

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

transactions

array[string]

required

Match pattern:

^0x[0-9a-f]*$

Result

(Payload status)

status

string

required

Allowed values:

VALIDINVALIDSYNCINGACCEPTEDINVALID_BLOCK_HASH

latestValidHash

string

Match pattern:

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

validationError

string

Examples

Request

await window.ethereum.request({
  "method": "engine_newPayloadV1",
  "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": []
    }
  ]
});

Result

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