merge from docs private

Author: dev-dist

public/samples/DataStreams/ClientReportsVerifier.sol

@@ -100,16 +100,17 @@ contract ClientReportsVerifier {
     }
 
     /**
-     * @dev Data Streams report schema v4 (RWA streams).
+     * @dev Data Streams report schema v8 (RWA streams).
      */
-    struct ReportV4 {
+    struct ReportV8 {
         bytes32 feedId;
         uint32 validFromTimestamp;
         uint32 observationsTimestamp;
         uint192 nativeFee;
         uint192 linkFee;
         uint32 expiresAt;
-        int192 price;
+        uint64 lastUpdateTimestamp;
+        int192 midPrice;
         uint32 marketStatus;
     }
 
@@ -140,11 +141,11 @@ contract ClientReportsVerifier {
     // ----------------- Public API -----------------
 
     /**
-     * @notice Verify a Data Streams report (schema v3 or v4).
+     * @notice Verify a Data Streams report (schema v3 or v8).
      *
      * @dev Steps:
      *  1. Decode the unverified report to get `reportData`.
-     *  2. Read the first two bytes → schema version (`0x0003` or `0x0004`).
+     *  2. Read the first two bytes → schema version (`0x0003` or `0x0008`).
      *     - Revert if the version is unsupported.
      *  3. Fee handling:
      *     - Query `s_feeManager()` on the proxy.
@@ -155,7 +156,7 @@ contract ClientReportsVerifier {
      *  5. Decode the verified report into the correct struct and emit the price.
      *
      *  @param unverifiedReport Full payload returned by Streams Direct.
-     *  @custom:reverts InvalidReportVersion when schema ≠ v3/v4.
+     *  @custom:reverts InvalidReportVersion when schema ≠ v3/v8.
      */
     function verifyReport(bytes memory unverifiedReport) external {
         // ─── 1. & 2. Extract reportData and schema version ──
@@ -166,7 +167,7 @@ contract ClientReportsVerifier {
 
         uint16 reportVersion = (uint16(uint8(reportData[0])) << 8) |
             uint16(uint8(reportData[1]));
-        if (reportVersion != 3 && reportVersion != 4)
+        if (reportVersion != 3 && reportVersion != 8)
             revert InvalidReportVersion(reportVersion);
 
         // ─── 3. Fee handling ──
@@ -204,7 +205,7 @@ contract ClientReportsVerifier {
             lastDecodedPrice = price;
             emit DecodedPrice(price);
         } else {
-            int192 price = abi.decode(verified, (ReportV4)).price;
+            int192 price = abi.decode(verified, (ReportV8)).midPrice;
             lastDecodedPrice = price;
             emit DecodedPrice(price);
         }

src/config/sidebar.ts

@@ -321,7 +321,7 @@ export const SIDEBAR: Partial<Record<Sections, SectionEntry[]>> = {
           children: [
             {
               title: "Report Schema v3",
-              url: "data-streams/reference/report-schema",
+              url: "data-streams/reference/report-schema-v3",
             },
           ],
         },
@@ -330,8 +330,8 @@ export const SIDEBAR: Partial<Record<Sections, SectionEntry[]>> = {
           url: "data-streams/rwa-streams",
           children: [
             {
-              title: "Report Schema v4",
-              url: "data-streams/reference/report-schema-v4",
+              title: "Report Schema v8",
+              url: "data-streams/reference/report-schema-v8",
             },
           ],
         },

src/content/data-streams/architecture.mdx

@@ -10,7 +10,8 @@ whatsnext:
     "Learn more about the Standard API Implementation": "/data-streams/tutorials/api-go",
     "Learn more about the Streams Trade Implementation": "/data-streams/streams-trade",
     "Find the list of available Stream IDs": "/data-streams/crypto-streams",
-    "Find the schema of data to expect from Data Streams reports": "/data-streams/reference/report-schema",
+    "Find the schema of data to expect from Data Streams reports: Crypto": "/data-streams/reference/report-schema-v3",
+    "Find the schema of data to expect from Data Streams reports: RWA": "/data-streams/reference/report-schema-v8",
   }
 ---
 

src/content/data-streams/billing.mdx

@@ -10,7 +10,8 @@ whatsnext:
   {
     "Learn the basics about how to retrieve Data Streams reports in the Getting Started guide.": "/data-streams/getting-started",
     "Find the list of available Stream IDs.": "/data-streams/crypto-streams",
-    "Find the schema of data to expect from Data Streams reports.": "/data-streams/reference/report-schema",
+    "Find the schema of data to expect from Data Streams reports: Crypto": "/data-streams/reference/report-schema-v3",
+    "Find the schema of data to expect from Data Streams reports: RWA": "/data-streams/reference/report-schema-v8",
   }
 ---
 

src/content/data-streams/concepts/liquidity-weighted-prices.mdx

@@ -8,15 +8,16 @@ metadata:
 whatsnext:
   {
     "Find the list of available Stream IDs.": "/data-streams/crypto-streams",
-    "Find the schema of data to expect from Data Streams reports.": "/data-streams/reference/report-schema",
+    "Find the schema of data to expect from Data Streams reports: Crypto": "/data-streams/reference/report-schema-v3",
+    "Find the schema of data to expect from Data Streams reports: RWA": "/data-streams/reference/report-schema-v8",
   }
 ---
 
 import DataStreams from "@features/data-streams/common/DataStreams.astro"
 
 <DataStreams section="dsNotes" />
 
-Chainlink Data Streams provides [reports](/data-streams/reference/report-schema) with a _Mid_ and _Liquidity-Weighted Bid and Ask (LWBA)_ prices. These three prices form a pricing spread that offers protocols insight into market activity based on the current state of the order books.
+Chainlink Data Streams provides [reports](/data-streams/reference/report-schema-v3) with a _Mid_ and _Liquidity-Weighted Bid and Ask (LWBA)_ prices. These three prices form a pricing spread that offers protocols insight into market activity based on the current state of the order books.
 
 **Note**: At the moment, only [Crypto streams](/data-streams/crypto-streams) provide LWBA prices.
 

src/content/data-streams/developer-responsibilities.mdx

@@ -8,7 +8,8 @@ metadata:
 whatsnext:
   {
     "Find the list of available Stream IDs": "/data-streams/crypto-streams",
-    "Find the schema of data to expect from Data Streams reports": "/data-streams/reference/report-schema",
+    "Find the schema of data to expect from Data Streams reports: Crypto": "/data-streams/reference/report-schema-v3",
+    "Find the schema of data to expect from Data Streams reports: RWA": "/data-streams/reference/report-schema-v8",
     "Learn the basics about how to retrieve Data Streams reports using the Streams Trade implementation": "/data-streams/getting-started",
     "Learn how to fetch and decode Data Streams reports using the Data Streams API": "/data-streams/tutorials/api-go",
   }

src/content/data-streams/index.mdx

@@ -10,7 +10,8 @@ whatsnext:
   {
     "Learn how to fetch and decode Data Streams reports with the API": "/data-streams/tutorials/api-go",
     "Find the list of available Stream IDs": "/data-streams/crypto-streams",
-    "Find the schema of data to expect from Data Streams reports": "/data-streams/reference/report-schema",
+    "Find the schema of data to expect from Data Streams reports: Crypto": "/data-streams/reference/report-schema-v3",
+    "Find the schema of data to expect from Data Streams reports: RWA": "/data-streams/reference/report-schema-v8",
   }
 ---
 
@@ -85,7 +86,7 @@ Access data directly through REST APIs or WebSocket connections using our SDKs:
 
 1. Understand the Architecture: Review the [system components and data flow](/data-streams/architecture) to understand how Data Streams works.
 
-1. Explore Available Data: Browse [available Stream IDs](/data-streams/crypto-streams) and [report schemas](/data-streams/reference/report-schema) to see what data is available.
+1. Explore Available Data: Browse [available Stream IDs](/data-streams/crypto-streams) and [report schemas](/data-streams/reference/report-schema-v3) to see what data is available.
 
 1. Try the API: Follow our [hands-on tutorial](/data-streams/tutorials/api-go) to fetch and decode your first report.
 

src/content/data-streams/market-hours.mdx

@@ -10,7 +10,8 @@ whatsnext:
   {
     "Find the list of available Crypto streams": "/data-streams/crypto-streams",
     "Find the list of available RWA streams": "/data-streams/rwa-streams",
-    "Find the schema of data to expect from Data Streams reports": "/data-streams/reference/report-schema",
+    "Find the schema of data to expect from Data Streams reports: Crypto": "/data-streams/reference/report-schema-v3",
+    "Find the schema of data to expect from Data Streams reports: RWA": "/data-streams/reference/report-schema-v8",
   }
 ---
 
@@ -26,4 +27,4 @@ Markets for several assets are actively traded only during certain hours. Listed
 
 ## Real World Asset market status
 
-Reports for Real World Asset (RWA) streams include the `marketStatus` value, which reflects the DON'S consensus on whether the market is currently open. For additional information, refer to the [RWA report schema](/data-streams/reference/report-schema-v4) page.
+Reports for Real World Asset (RWA) streams include the `marketStatus` value, which reflects the DON'S consensus on whether the market is currently open. For additional information, refer to the [RWA report schema](/data-streams/reference/report-schema-v8) page.

src/content/data-streams/reference/go-sdk.mdx

@@ -267,7 +267,7 @@ Where `ID` is the unique identifier for the stream.
 
 #### `FeedVersion` uint16
 
-Represents the stream [report schema](/data-streams/reference/report-schema) version.
+Represents the stream [report schema](/data-streams/reference/report-schema-v3) version.
 
 ```go
 type FeedVersion uint16
@@ -329,7 +329,7 @@ import report "github.com/smartcontractkit/data-streams-sdk/go/report"
 
 ```go
 type Data interface {
-    v1.Data | v2.Data | v3.Data | v4.Data
+    v1.Data | v2.Data | v3.Data | v4.Data | v8.Data | v9.Data
     Schema() abi.Arguments
 }
 ```

…data-streams/reference/report-schema.mdx …a-streams/reference/report-schema-v3.mdxsrc/content/data-streams/reference/report-schema.mdx renamed to src/content/data-streams/reference/report-schema-v3.mdx src/content/data-streams/reference/report-schema.mdx renamed to src/content/data-streams/reference/report-schema-v3.mdx

@@ -16,17 +16,19 @@ import { PageTabs } from "@components"
 
 <PageTabs
   pages={[
+
     {
       name: "Cryptocurrency Report Schema (v3)",
-      url: "/data-streams/reference/report-schema",
+      url: "/data-streams/reference/report-schema-v3",
     },
     {
-      name: "Real World Asset (RWA) Report Schema (v4)",
-      url: "/data-streams/reference/report-schema-v4",
+      name: "RWA Report Schema (v8)",
+      url: "/data-streams/reference/report-schema-v8",
     },
-  ]}
-  headerTitle="Available Report Schemas"
-  headerDescription="Choose the schema version you want to explore."
+
+]}
+headerTitle="Available Report Schemas"
+headerDescription="Choose the schema version you want to explore."
 />
 
 Cryptocurrency streams adhere to the report schema outlined below.
@@ -41,7 +43,7 @@ Cryptocurrency streams adhere to the report schema outlined below.
 | `nativeFee`             | `uint192` | Verification cost in native blockchain tokens     |
 | `linkFee`               | `uint192` | Verification cost in LINK tokens                  |
 | `expiresAt`             | `uint32`  | Timestamp when this report expires                |
-| `price`                 | `int192`  | DON consensus median price (18 decimal places)    |
+| `price`                 | `int192`  | DON consensus median price                        |
 | `bid`                   | `int192`  | Simulated buy impact price at X% liquidity depth  |
 | `ask`                   | `int192`  | Simulated sell impact price at X% liquidity depth |