/ apis / validator / block.v2.yaml
block.v2.yaml
 1  get:
 2    tags:
 3      - ValidatorRequiredApi
 4      - Validator
 5    operationId: "produceBlockV2"
 6    summary: "Produce a new block, without signature."
 7    description: |
 8      Requests a beacon node to produce a valid block, which can then be signed by a validator.
 9  
10      Metadata in the response indicates the type of block produced, and the supported types of block
11      will be added to as forks progress.
12    parameters:
13      - name: slot
14        in: path
15        required: true
16        description: "The slot for which the block should be proposed."
17        schema:
18          $ref: "../../beacon-node-oapi.yaml#/components/schemas/Uint64"
19      - name: randao_reveal
20        in: query
21        required: true
22        description: "The validator's randao reveal value."
23        schema:
24          $ref: '../../beacon-node-oapi.yaml#/components/schemas/Signature'
25      - name: graffiti
26        in: query
27        required: false
28        description: "Arbitrary data validator wants to include in block."
29        schema:
30          $ref: '../../beacon-node-oapi.yaml#/components/schemas/Graffiti'
31    responses:
32      "200":
33        description: Success response
34        content:
35          application/json:
36            schema:
37              title: ProduceBlockV2Response
38              type: object
39              properties:
40                version:
41                  type: string
42                  enum: [ phase0, altair ]
43                  example: "phase0"
44                data:
45                  oneOf:
46                   - $ref: '../../beacon-node-oapi.yaml#/components/schemas/BeaconBlock'
47                   - $ref: "../../beacon-node-oapi.yaml#/components/schemas/Altair.BeaconBlock"
48      "400":
49        description: "Invalid block production request"
50        content:
51          application/json:
52            schema:
53              $ref: "../../beacon-node-oapi.yaml#/components/schemas/ErrorMessage"
54            examples:
55              InvalidRequest:
56                value:
57                  code: 400
58                  message: "Invalid request to produce a block"
59      "500":
60        $ref: '../../beacon-node-oapi.yaml#/components/responses/InternalError'
61      "503":
62        $ref: '../../beacon-node-oapi.yaml#/components/responses/CurrentlySyncing'