From 3ab8cd9c9bf95ce670569d7a71b4c6df77abe719 Mon Sep 17 00:00:00 2001
From: Alexandra Tran <alexandra.tran@consensys.net>
Date: Fri, 4 Oct 2024 15:44:15 -0700
Subject: [PATCH] Document engine_getBlobsV1

Signed-off-by: Alexandra Tran <alexandra.tran@consensys.net>
---
 .../reference/engine-api/index.md             | 58 +++++++++++++++++++
 1 file changed, 58 insertions(+)

diff --git a/docs/public-networks/reference/engine-api/index.md b/docs/public-networks/reference/engine-api/index.md
index 7ff03ab380a..b382c235a12 100644
--- a/docs/public-networks/reference/engine-api/index.md
+++ b/docs/public-networks/reference/engine-api/index.md
@@ -224,6 +224,64 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"engine_forkchoiceUpdatedV1","par
 
 </Tabs>
 
+### `engine_getBlobsV1`
+
+Returns the blobs corresponding to the specified blob versioned hashes.
+
+#### Parameters
+
+`blobHashes`: *array* of *strings* - Array of blob versioned hashes
+
+#### Returns
+
+`engineGetBlobsResultV1`: *array* of *objects* - Array of blob and proof objects
+
+<Tabs>
+
+<TabItem value="curl HTTP" label="curl HTTP" default>
+
+```bash
+curl -X POST --data '{"jsonrpc":"2.0","method":"engine_getBlobsV1","params":[["0x000657f37554c781402a22917dee2f75def7ab966d7b770905398eba3c444014"]],"id":1}' http://127.0.0.1:8550
+```
+
+</TabItem>
+
+<TabItem value="wscat WS" label="wscat WS">
+
+```json
+{
+  "jsonrpc": "2.0",
+  "method": "engine_getPayloadBodiesByHashV1",
+  "params": [
+    [
+      "0x000657f37554c781402a22917dee2f75def7ab966d7b770905398eba3c444014"
+    ]
+  ],
+  "id": 67
+}
+```
+
+</TabItem>
+
+<TabItem value="JSON result" label="JSON result">
+
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 67,
+  "result": [
+    {
+      "blob": "0x722662154e6d76b2b2b92e70c0cac3ccf534f9b74eb5b89819ec509083d00a503ae5c198d17634e79059c2cd735491...",
+      "proof": "0x80c5f2e1eb23939cf3600f61872e3e9964d0acafb440634e530d6139a193b889c56a0c07d737729dbe0626706fc9f25f"
+    }
+  ]
+}
+```
+
+</TabItem>
+
+</Tabs>
+
 ### `engine_getPayloadBodiesByHashV1`
 
 Returns the bodies of the execution payloads corresponding to the specified block hashes.