engine_getPayloadV2

Obtains execution payload from payload build process

Parameters (by position)

Payload id string required

---

Result

Response object object

---

Show Response object object

Response object fields

• executionPayload object or object required

  ---

  Show Option 1 Execution payload object V1 object

  Execution payload object V1 fields

  executionPayload object required

  Execution payload object V1

  ---

  Show executionPayload object

  executionPayload 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

  executionPayload object required

  Execution payload object V2

  ---

  Show executionPayload object

  executionPayload 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

    ---

• blockValue string required

  Expected fee value

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

  ---

• additionalProperties true

  ---

Errors

Error code: -38001

• code

  -38001

• message

  Unknown payload

Examples

engine_getPayloadV2 example

Request

{
  "params": [
    "0x0000000038fa5dd"
  ]
}

Response

{
  "executionPayload": {
    "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": "0x1256f99fb899c2de0aeac0c5aa6aad69de188b6a0f4ac29f2d075a53aa3ed0e4",
    "transactions": [
      "0x03f88f0780843b9aca008506fc23ac00830186a09400000000000000000000000000000000000001008080c001e1a0010657f37554c781402a22917dee2f75def7ab966d7b770905398eba3c44401401a0840650aa8f74d2b07f40067dc33b715078d73422f01da17abdbd11e02bbdfda9a04b2260f6022bf53eadb337b3e59514936f7317d872defb891a708ee279bdca90",
      "0x03f88f0701843b9aca008506fc23ac00830186a09400000000000000000000000000000000000001008080c001e1a001521d528ad0c760354a4f0496776cf14a92fe1fb5d50e959dcea1a489c7c83101a0a86c1fd8c2e74820686937f5c1bfe836e2fb622ac9fcbebdc4ab4357f2dbbc61a05c3b2b44ff8252f78d70aeb33f8ba09beaeadad1b376a57d34fa720bbc4a18ee",
      "0x03f88f0702843b9aca008506fc23ac00830186a09400000000000000000000000000000000000001008080c001e1a001453362c360fdd8832e3539d463e6d64b2ee320ac6a08885df6083644a063e701a037a728aec08aefffa702a2ca620db89caf3e46ab7f25f7646fc951510991badca065d846f046357af39bb739b161233fce73ddfe0bb87f2d28ef60dfe6dbb0128d"
    ],
    "withdrawals": [
      {
        "index": "0xf0",
        "validatorIndex": "0xf0",
        "address": "0x00000000000000000000000000000000000010f0",
        "amount": "0x1"
      },
      {
        "index": "0xf1",
        "validatorIndex": "0xf1",
        "address": "0x00000000000000000000000000000000000010f1",
        "amount": "0x1"
      }
    ]
  },
  "blockValue": "0x10a741a46278014d"
}

Request

Server URL:

{ "jsonrpc": "2.0", "method": "engine_getPayloadV2", "params": [ "0x0000000038fa5dd" ], "id": 1 }