Try It Now Dialog

engine_getPayloadBodiesByRangeV1

---

Method

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

Parameters

Name	Type	Required	Description
Starting block number	string	yes
Number of blocks to return	string	yes

Parameter schema

{
  "Starting block number": {
    "required": true,
    "schema": {
      "title": "hex encoded 64 bit unsigned integer",
      "type": "string",
      "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
    }
  },
  "Number of blocks to return": {
    "required": true,
    "schema": {
      "title": "hex encoded 64 bit unsigned integer",
      "type": "string",
      "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
    }
  }
}

Result

• Name: Execution payload bodies
• Type: object[]

Result schema

{
  "type": "array",
  "items": {
    "title": "Execution payload body object V1",
    "type": "object",
    "required": [
      "transactions"
    ],
    "properties": {
      "transactions": {
        "title": "Transactions",
        "type": "array",
        "items": {
          "title": "hex encoded bytes",
          "type": "string",
          "pattern": "^0x[0-9a-f]*$"
        }
      },
      "withdrawals": {
        "title": "Withdrawals",
        "type": [
          "array",
          "null"
        ],
        "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})$"
            }
          }
        }
      }
    }
  }
}

Positional parameters

Parameter order:

1. Starting block number
2. Number of blocks to return

---

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.

Named Parameters

{
  "jsonrpc": "2.0",
  "method": "engine_getPayloadBodiesByRangeV1",
  "params": {
    "Starting block number": "string",
    "Number of blocks to return": "string"
  },
  "id": 1
}

Successful Response

{
  "jsonrpc": "2.0",
  "result": [
    {
      "transactions": [
        "string"
      ],
      "withdrawals": "example"
    }
  ],
  "id": 1
}

Positional Parameters

{
  "jsonrpc": "2.0",
  "method": "engine_getPayloadBodiesByRangeV1",
  "params": [
    "string",
    "string"
  ],
  "id": 2
}

Successful Response

{
  "jsonrpc": "2.0",
  "result": [
    {
      "transactions": [
        "string"
      ],
      "withdrawals": "example"
    }
  ],
  "id": 2
}