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'