Skip to main content

Try It Now Dialog

engine_getPayloadV6


Method

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

Parameters

NameTypeRequiredDescription
Payload idstringyes

Parameter schema

{
"Payload id": {
"required": true,
"schema": {
"title": "8 hex encoded bytes",
"type": "string",
"pattern": "^0x[0-9a-f]{16}$"
}
}
}

Result

  • Name: Response object
  • Type: object

Result schema

{
"type": "object",
"required": [
"executionPayload",
"blockValue",
"blobsBundle",
"shouldOverrideBuilder",
"executionRequests"
],
"properties": {
"executionPayload": {
"title": "Execution payload object V4",
"type": "object",
"required": [
"parentHash",
"feeRecipient",
"stateRoot",
"receiptsRoot",
"logsBloom",
"prevRandao",
"blockNumber",
"gasLimit",
"gasUsed",
"timestamp",
"extraData",
"baseFeePerGas",
"blockHash",
"transactions",
"withdrawals",
"blobGasUsed",
"excessBlobGas",
"blockAccessList"
],
"properties": {
"parentHash": {
"title": "Parent block hash",
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
},
"feeRecipient": {
"title": "Recipient of transaction priority fees",
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"stateRoot": {
"title": "State root",
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
},
"receiptsRoot": {
"title": "Receipts root",
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
},
"logsBloom": {
"title": "Bloom filter",
"type": "string",
"pattern": "^0x[0-9a-f]{512}$"
},
"prevRandao": {
"title": "Previous randao value",
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
},
"blockNumber": {
"title": "Block number",
"type": "string",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
},
"gasLimit": {
"title": "Gas limit",
"type": "string",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
},
"gasUsed": {
"title": "Gas used",
"type": "string",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
},
"timestamp": {
"title": "Timestamp",
"type": "string",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
},
"extraData": {
"title": "Extra data",
"type": "string",
"pattern": "^0x[0-9a-f]{0,64}$"
},
"baseFeePerGas": {
"title": "Base fee per gas",
"type": "string",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$"
},
"blockHash": {
"title": "Block hash",
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
},
"transactions": {
"title": "Transactions",
"type": "array",
"items": {
"title": "hex encoded bytes",
"type": "string",
"pattern": "^0x[0-9a-f]*$"
}
},
"withdrawals": {
"title": "Withdrawals",
"type": "array",
"items": {
"title": "Withdrawal object V1",
"type": "object",
"required": [
"index",
"validatorIndex",
"address",
"amount"
],
"properties": {
"index": {
"title": "Withdrawal index",
"type": "string",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
},
"validatorIndex": {
"title": "Validator index",
"type": "string",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
},
"address": {
"title": "Withdrawal address",
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"amount": {
"title": "Withdrawal amount",
"type": "string",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
}
}
}
},
"blobGasUsed": {
"title": "Blob gas used",
"type": "string",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
},
"excessBlobGas": {
"title": "Excess blob gas",
"type": "string",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
},
"blockAccessList": {
"title": "Block access list",
"type": "string",
"pattern": "^0x[0-9a-f]*$"
}
}
},
"blockValue": {
"title": "hex encoded 256 bit unsigned integer",
"type": "string",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$"
},
"blobsBundle": {
"title": "Blobs bundle object V2",
"type": "object",
"required": [
"commitments",
"proofs",
"blobs"
],
"properties": {
"commitments": {
"title": "Commitments",
"type": "array",
"items": {
"title": "48 hex encoded bytes",
"type": "string",
"pattern": "^0x[0-9a-f]{96}$"
}
},
"proofs": {
"title": "Proofs",
"type": "array",
"items": {
"title": "48 hex encoded bytes",
"type": "string",
"pattern": "^0x[0-9a-f]{96}$"
}
},
"blobs": {
"title": "Blobs",
"type": "array",
"items": {
"title": "hex encoded bytes",
"type": "string",
"pattern": "^0x[0-9a-f]*$"
}
}
}
},
"shouldOverrideBuilder": {
"type": "boolean"
},
"executionRequests": {
"type": "array",
"items": {
"title": "hex encoded bytes",
"type": "string",
"pattern": "^0x[0-9a-f]*$"
}
}
}
}

Positional parameters

Parameter order:

  1. Payload id

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.