engine_newPayloadV3

Runs execution payload validation

Params

(3)

1. Execution payload (required)

parentHash

string

required

Match pattern:

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

feeRecipient

string

required

Match pattern:

^0x[0-9,a-f,A-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([1-9a-f]+[0-9a-f]{0,15})|0$

gasLimit

string

required

Match pattern:

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

gasUsed

string

required

Match pattern:

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

timestamp

string

required

Match pattern:

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

extraData

string

required

Match pattern:

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

baseFeePerGas

string

required

Match pattern:

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

blockHash

string

required

Match pattern:

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

transactions

array[string]

required

withdrawals

array[Withdrawal object V1]

required

index

string

required

Match pattern:

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

validatorIndex

string

required

Match pattern:

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

address

string

required

Match pattern:

^0x[0-9,a-f,A-F]{40}$

amount

string

required

Match pattern:

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

dataGasUsed

string

required

Match pattern:

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

excessDataGas

string

required

Match pattern:

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

2. Expected blob versioned hashes (required)

array[string]

3. Root of the parent beacon block (required)

string

Match pattern:

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

Result

(Payload status)

status

string

required

Allowed values:

VALIDINVALIDSYNCINGACCEPTED

latestValidHash

string

Match pattern:

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

validationError

string

Errors

Code	Message
-32602	Invalid params
-38005	Unsupported fork

Install MetaMask for your platform and refresh the page. The interactive features in this documentation require installing MetaMask.

Params

Execution payload

Expected blob versioned hashes

Root of the parent beacon block

Request

await window.ethereum.request({
  "method": "engine_newPayloadV3",
  "params": [
    null,
    null,
    null
  ]
});