updates per nico review

Author: shane-moore

apis/beacon/execution_payload/envelope_get.yaml

@@ -1,8 +1,8 @@
 get:
-  operationId: getExecutionPayloadEnvelopeByBlockId
-  summary: Get execution payload envelope
+  operationId: getSignedExecutionPayloadEnvelope
+  summary: Get signed execution payload envelope
   description: |
-    Retrieves execution payload envelope for a given block id.
+    Retrieves signed execution payload envelope for a given block id.
     Depending on `Accept` header it can be returned either as json or as bytes serialized by SSZ.
   tags:
     - Beacon

apis/beacon/pool/payload_attestations.yaml

@@ -30,7 +30,7 @@ get:
               data:
                 type: array
                 items:
-                  $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Gloas.PayloadAttestationMessage"
+                  $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Gloas.PayloadAttestation"
     "400":
       description: "The slot could not be parsed"
       content:

apis/validator/execution_payload_envelope.yaml

@@ -2,7 +2,7 @@ get:
   operationId: getExecutionPayloadEnvelope
   summary: Get execution payload envelope
   description: |
-    Retrieves execution payload envelope for a given slot and builder. The envelope contains the full
+    Retrieves execution payload envelope for a given slot and builder, which can then be signed by a validator. The envelope contains the full
     execution payload along with associated metadata. Depending on `Accept` header, it can be returned
     either as json or as bytes serialized by SSZ.
   tags:

types/gloas/execution_payload_bid.yaml

@@ -1,7 +1,7 @@
 Gloas:
   ExecutionPayloadBid:
     type: object
-    description: "The [`ExecutionPayloadBid`](https://github.com/ethereum/consensus-specs/blob/00d531949b1f30516979b60ddd2a411e7f388299/specs/gloas/beacon-chain.md#executionpayloadbid) object from the CL gloas spec."
+    description: "The [`ExecutionPayloadBid`](https://github.com/ethereum/consensus-specs/blob/00d531949b1f30516979b60ddd2a411e7f388299/specs/gloas/beacon-chain.md#executionpayloadbid) object from the CL Gloas spec."
     required: [parent_block_hash, parent_block_root, block_hash, fee_recipient, gas_limit, builder_index, slot, value, blob_kzg_commitments_root]
     properties:
       parent_block_hash:
@@ -25,7 +25,7 @@ Gloas:
 
   SignedExecutionPayloadBid:
     type: object
-    description: "The [`SignedExecutionPayloadBid`](https://github.com/ethereum/consensus-specs/blob/00d531949b1f30516979b60ddd2a411e7f388299/specs/gloas/beacon-chain.md#signedexecutionpayloadbid) object from the CL gloas spec."
+    description: "The [`SignedExecutionPayloadBid`](https://github.com/ethereum/consensus-specs/blob/00d531949b1f30516979b60ddd2a411e7f388299/specs/gloas/beacon-chain.md#signedexecutionpayloadbid) object from the CL Gloas spec."
     required: [message, signature]
     properties:
       message:

types/gloas/execution_payload_envelope.yaml

@@ -1,7 +1,7 @@
 Gloas:
   ExecutionPayloadEnvelope:
     type: object
-    description: "The [`ExecutionPayloadEnvelope`](https://github.com/ethereum/consensus-specs/blob/00d531949b1f30516979b60ddd2a411e7f388299/specs/gloas/beacon-chain.md#executionpayloadenvelope) object from the CL gloas spec."
+    description: "The [`ExecutionPayloadEnvelope`](https://github.com/ethereum/consensus-specs/blob/00d531949b1f30516979b60ddd2a411e7f388299/specs/gloas/beacon-chain.md#executionpayloadenvelope) object from the CL Gloas spec."
     required: [payload, execution_requests, builder_index, beacon_block_root, slot, blob_kzg_commitments, state_root]
     properties:
       payload:
@@ -30,7 +30,7 @@ Gloas:
 
   SignedExecutionPayloadEnvelope:
     type: object
-    description: "The [`SignedExecutionPayloadEnvelope`](https://github.com/ethereum/consensus-specs/blob/00d531949b1f30516979b60ddd2a411e7f388299/specs/gloas/beacon-chain.md#signedexecutionpayloadenvelope) object from the CL gloas spec."
+    description: "The [`SignedExecutionPayloadEnvelope`](https://github.com/ethereum/consensus-specs/blob/00d531949b1f30516979b60ddd2a411e7f388299/specs/gloas/beacon-chain.md#signedexecutionpayloadenvelope) object from the CL Gloas spec."
     required: [message, signature]
     properties:
       message:

types/gloas/payload_attestation.yaml

@@ -19,7 +19,7 @@ Gloas:
 
   PayloadAttestation:
     type: object
-    description: "The [`PayloadAttestation`](https://github.com/ethereum/consensus-specs/blob/00d531949b1f30516979b60ddd2a411e7f388299/specs/gloas/beacon-chain.md#payloadattestation) object from the CL gloas spec."
+    description: "The [`PayloadAttestation`](https://github.com/ethereum/consensus-specs/blob/00d531949b1f30516979b60ddd2a411e7f388299/specs/gloas/beacon-chain.md#payloadattestation) object from the CL Gloas spec."
     required: [aggregation_bits, data, signature]
     properties:
       aggregation_bits:

wordlist.txt

@@ -38,3 +38,7 @@ KZGCommitmentInclusionProof
 LMD
 fulu
 gloas
+PTC
+ptc
+PtcDuty
+produceBlockV