Update the docs

Author: TarikGul

docs-v2/dist/bundle.js

@@ -24,6 +24,15 @@ The `useRcBlock` parameter is a boolean parameter that works in conjunction with
 
 **Block Finalization Note**: The `useRcBlock` parameter does not make any assumptions about whether the block you pass is finalized or a best block. It is recommended to ensure the block you are passing is finalized if block finalization is important for your use case.
 
+### useRcBlockFormat Parameter
+The `useRcBlockFormat` parameter controls the response format when using `useRcBlock=true`. This parameter is only valid when `useRcBlock=true` is specified.
+
+**Values:**
+- `array` (default): Returns the standard array format with enhanced metadata
+- `object`: Wraps the response in an object containing relay chain block info and the parachain data array
+
+**Validation**: Using `useRcBlockFormat` without `useRcBlock=true` will return a `400 Bad Request` error.
+
 ## Implementation: useRcBlock Query Parameter
 
 ### Core Functionality
@@ -40,6 +49,10 @@ GET /pallets/staking/progress?at=1000000&useRcBlock=true
 GET /accounts/{accountId}/balance-info?at=0x123abc&useRcBlock=true
 GET /blocks/head?useRcBlock=true
 GET /blocks/12345?at=12345&useRcBlock=true
+
+# With useRcBlockFormat=object for wrapped response format
+GET /pallets/staking/progress?at=1000000&useRcBlock=true&useRcBlockFormat=object
+GET /accounts/{accountId}/balance-info?at=0x123abc&useRcBlock=true&useRcBlockFormat=object
 ```
 
 ### Response Format Changes
@@ -52,7 +65,7 @@ Returns single response object (unchanged):
 }
 ```
 
-**With useRcBlock=true:**
+**With useRcBlock=true (default array format):**
 Returns array format with additional metadata:
 ```json
 [{
@@ -65,6 +78,38 @@ Returns array format with additional metadata:
 
 Or empty array `[]` if no corresponding Asset Hub block exists.
 
+**With useRcBlock=true&useRcBlockFormat=object:**
+Returns object format wrapping the data with relay chain block info:
+```json
+{
+  "rcBlock": {
+    "hash": "0x1234567890abcdef...",
+    "parentHash": "0xabcdef1234567890...",
+    "number": "1000000"
+  },
+  "parachainDataPerBlock": [
+    {
+      // ... existing endpoint response data
+      "rcBlockHash": "0x1234567890abcdef...",
+      "rcBlockNumber": "1000000",
+      "ahTimestamp": "1642694400"
+    }
+  ]
+}
+```
+
+Or with empty `parachainDataPerBlock` array if no corresponding Asset Hub block exists:
+```json
+{
+  "rcBlock": {
+    "hash": "0x1234567890abcdef...",
+    "parentHash": "0xabcdef1234567890...",
+    "number": "1000000"
+  },
+  "parachainDataPerBlock": []
+}
+```
+
 ## Supported Endpoints
 
 ### Block Endpoints Supporting useRcBlock:
@@ -90,7 +135,8 @@ When `useRcBlock=true` is used, responses include additional context fields:
 - `rcBlockHash`: The relay chain block hash
 - `rcBlockNumber`: The relay chain block number
 - `ahTimestamp`: The Asset Hub block timestamp
-- Array format prepares for future elastic scaling scenarios
+- Array format (default) prepares for future elastic scaling scenarios
+- Object format (`useRcBlockFormat=object`) provides relay chain block metadata wrapper with `rcBlock` info (hash, parentHash, number) and `parachainDataPerBlock` array
 
 ### Backward Compatibility
 - Defaults to `false`, maintaining existing functionality when not specified
@@ -104,9 +150,11 @@ When `useRcBlock=true` is used, responses include additional context fields:
 
 ### Validation Logic
 The `validateUseRcBlock` middleware ensures:
-1. **Boolean validation**: Must be "true" or "false" string
+1. **Boolean validation**: `useRcBlock` must be "true" or "false" string
 2. **Asset Hub requirement**: Only works when connected to Asset Hub
 3. **Relay chain availability**: Requires relay chain API configuration via `SAS_SUBSTRATE_MULTI_CHAIN_URL`
+4. **useRcBlockFormat dependency**: `useRcBlockFormat` requires `useRcBlock=true` to be specified
+5. **useRcBlockFormat values**: Must be either "array" or "object" string
 
 ## Multi-Block and Elastic Scaling Scenarios