Add blob_sidecar event (#350)

Co-authored-by: Paul Harris <paul.harris@consensys.net>
ethereum · Sep 18, 2023 · ad9e9cf · ad9e9cf
1 parent 4cc8484
commit ad9e9cf
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 4 deletions.
diff --git a/CHANGES.md b/CHANGES.md
@@ -7,10 +7,11 @@ These endpoints have been added or updated since the last release.
 
 There are likely to be descriptions etc outside of the list below, but new query parameters, changes to headers, new endpoints should be listed.
 
-| Endpoint                                                                                                                    | [Lighthouse](https://github.com/sigp/lighthouse) | [Lodestar](https://github.com/ChainSafe/lodestar) | [Nimbus](https://github.com/status-im/nimbus-eth2) | [Prysm](https://github.com/prysmaticlabs/prysm) | [Teku](https://github.com/ConsenSys/teku) |
-|-----------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------|---------------------------------------------------|----------------------------------------------------|-------------------------------------------------|-------------------------------------------|
-| [#353](https://github.com/ethereum/beacon-APIs/pull/353) `/eth/v1/beacon/states/{state_id}` added                           |                                                  |                                                   |                                                    |                                                 |                                           |
-| [#339](https://github.com/ethereum/beacon-APIs/pull/339) `POST /eth/v3/beacon/blocks` added |                                                  |                                                   |                                                    |                                                 |                                           |
+| Endpoint                                                                                          | [Lighthouse](https://github.com/sigp/lighthouse) | [Lodestar](https://github.com/ChainSafe/lodestar) | [Nimbus](https://github.com/status-im/nimbus-eth2) | [Prysm](https://github.com/prysmaticlabs/prysm) | [Teku](https://github.com/ConsenSys/teku) |
+|---------------------------------------------------------------------------------------------------|--------------------------------------------------|---------------------------------------------------|----------------------------------------------------|-------------------------------------------------|-------------------------------------------|
+| [#353](https://github.com/ethereum/beacon-APIs/pull/353) `/eth/v1/beacon/states/{state_id}` added |                                                  |                                                   |                                                    |                                                 |                                           |
+| [#339](https://github.com/ethereum/beacon-APIs/pull/339) `POST /eth/v3/beacon/blocks` added       |                                                  |                                                   |                                                    |                                                 |                                           |
+| [#350](https://github.com/ethereum/beacon-APIs/pull/350) `blob_sidecar EVENT` added               |                                                  |                                                   |                                                    |                                                 |                                           |
 
 
 The Following are no longer in the Standard API, removed since the latest version.

diff --git a/apis/eventstream/index.yaml b/apis/eventstream/index.yaml
@@ -33,6 +33,7 @@ get:
             - light_client_finality_update
             - light_client_optimistic_update
             - payload_attributes
+            - blob_sidecar
   responses:
     "200":
       description: Opened SSE stream.
@@ -122,6 +123,11 @@ get:
               value: |
                 event: payload_attributes
                 data: {"version": "capella", "data": {"proposer_index": "123", "proposal_slot": "10", "parent_block_number": "9", "parent_block_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", "parent_block_hash": "0x9a2fefd2fdb57f74993c7780ea5b9030d2897b615b89f808011ca5aebed54eaf", "payload_attributes": {"timestamp": "123456", "prev_randao": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", "suggested_fee_recipient": "0x0000000000000000000000000000000000000000", "withdrawals": [{"index": "5", "validator_index": "10", "address": "0x0000000000000000000000000000000000000000", "amount": "15640"}]}}},
+            blob_sidecar:
+              description: The node has received a BlobSidecar (from P2P or API) that passes all gossip validations on the blob_sidecar_{subnet_id} topic
+              value: |
+                event: blob_sidecar
+                data: {"block_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", "index": "1", "slot": "1", "kzg_commitment": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505", "versioned_hash": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"}
     "400":
       description: "The topics supplied could not be parsed"
       content: