add comments

packages/beacon-node/src/chain/seenCache/seenGossipBlockInput.ts

@@ -29,6 +29,15 @@ const MAX_GOSSIPINPUT_CACHE = 5;
 // ssz.deneb.BlobSidecars.elementType.fixedSize, 131256 is size for mainnet preset;
 const BLOBSIDECAR_FIXED_SIZE = ssz.deneb.BlobSidecars.elementType.fixedSize ?? 131256;
 
+/**
+ * SeenGossipBlockInput tracks and caches the live blobs and blocks on the network to solve data availability
+ * for the blockInput. If no block has been seen yet for some already seen blobs, it responds will null, but
+ * on the first block or the consequent blobs it responds with blobs promise till all blobs become available.
+ *
+ * One can start processing block on blobs promise blockInput response and can await on the promise before
+ * fully importing the block. The blobs promise is gets resolved as soon as all blobs corresponding to that
+ * block are seen by SeenGossipBlockInput
+ */
 export class SeenGossipBlockInput {
   private blockInputCache = new Map<RootHex, BlockInputCacheType>();