docs

Author: balogh.adam@icloud.com

docs/opengradient/client/llm.md

@@ -101,13 +101,17 @@ Perform inference on an LLM model using chat via TEE.
 **Returns**
 
 Union[TextGenerationOutput, AsyncGenerator[StreamChunk, None]]:
-    - If stream=False: TextGenerationOutput with chat_output, transaction_hash, finish_reason, and payment_hash
+    - If stream=False: TextGenerationOutput with chat_output, data settlement metadata, finish_reason, and payment_hash
     - If stream=True: Async generator yielding StreamChunk objects
 
 **`TextGenerationOutput` fields:**
 
-* **`transaction_hash`**: Blockchain transaction hash.  Set to
-        ``"external"`` for TEE-routed providers.
+* **`data_settlement_transaction_hash`**: Blockchain transaction hash for
+        the data settlement transaction. ``None`` when the provider
+        does not return data settlement metadata.
+* **`data_settlement_blob_id`**: Walrus blob ID for individual data
+        settlement. ``None`` for private/batch settlement or when the
+        provider does not return it.
 * **`finish_reason`**: Reason the model stopped generating
         (e.g. ``"stop"``, ``"tool_call"``, ``"error"``).
         Only populated for chat requests.
@@ -174,8 +178,12 @@ TextGenerationOutput: Generated text results including:
 
 **`TextGenerationOutput` fields:**
 
-* **`transaction_hash`**: Blockchain transaction hash.  Set to
-        ``"external"`` for TEE-routed providers.
+* **`data_settlement_transaction_hash`**: Blockchain transaction hash for
+        the data settlement transaction. ``None`` when the provider
+        does not return data settlement metadata.
+* **`data_settlement_blob_id`**: Walrus blob ID for individual data
+        settlement. ``None`` for private/batch settlement or when the
+        provider does not return it.
 * **`finish_reason`**: Reason the model stopped generating
         (e.g. ``"stop"``, ``"tool_call"``, ``"error"``).
         Only populated for chat requests.

docs/opengradient/client/twins.md

@@ -55,8 +55,12 @@ TextGenerationOutput: Generated text results including chat_output and finish_re
 
 **`TextGenerationOutput` fields:**
 
-* **`transaction_hash`**: Blockchain transaction hash.  Set to
-        ``"external"`` for TEE-routed providers.
+* **`data_settlement_transaction_hash`**: Blockchain transaction hash for
+        the data settlement transaction. ``None`` when the provider
+        does not return data settlement metadata.
+* **`data_settlement_blob_id`**: Walrus blob ID for individual data
+        settlement. ``None`` for private/batch settlement or when the
+        provider does not return it.
 * **`finish_reason`**: Reason the model stopped generating
         (e.g. ``"stop"``, ``"tool_call"``, ``"error"``).
         Only populated for chat requests.

docs/opengradient/index.md

@@ -6,7 +6,7 @@ opengradient
 
 # Package opengradient
 
-**Version: 1.0.0**
+**Version: 1.0.1**
 
 OpenGradient Python SDK for decentralized AI inference with end-to-end verification.
 

docs/opengradient/types.md

@@ -347,6 +347,10 @@ usage information.
 * **`tee_id`**: On-chain TEE registry ID of the enclave that served this request (final chunk only)
 * **`tee_endpoint`**: Endpoint URL of the TEE that served this request (final chunk only)
 * **`tee_payment_address`**: Payment address registered for the TEE (final chunk only)
+* **`data_settlement_transaction_hash`**: Transaction hash for the data settlement
+        transaction, present on the final chunk when available.
+* **`data_settlement_blob_id`**: Walrus blob ID for individual data settlement,
+        present on the final chunk when available.
 
 #### Constructor
 
@@ -360,7 +364,9 @@ def __init__(
     tee_timestamp: Optional[str] = None,
     tee_id: Optional[str] = None,
     tee_endpoint: Optional[str] = None,
-    tee_payment_address: Optional[str] = None
+    tee_payment_address: Optional[str] = None,
+    data_settlement_transaction_hash: Optional[str] = None,
+    data_settlement_blob_id: Optional[str] = None
 )
 ```
 
@@ -393,6 +399,10 @@ StreamChunk instance
 * **`tee_id`**: On-chain TEE registry ID of the enclave that served this request (final chunk only)
 * **`tee_endpoint`**: Endpoint URL of the TEE that served this request (final chunk only)
 * **`tee_payment_address`**: Payment address registered for the TEE (final chunk only)
+* **`data_settlement_transaction_hash`**: Transaction hash for the data settlement
+        transaction, present on the final chunk when available.
+* **`data_settlement_blob_id`**: Walrus blob ID for individual data settlement,
+        present on the final chunk when available.
 
 ### `StreamDelta`
 
@@ -491,8 +501,12 @@ performed inside a TEE enclave.
 
 **Attributes**
 
-* **`transaction_hash`**: Blockchain transaction hash.  Set to
-        ``"external"`` for TEE-routed providers.
+* **`data_settlement_transaction_hash`**: Blockchain transaction hash for
+        the data settlement transaction. ``None`` when the provider
+        does not return data settlement metadata.
+* **`data_settlement_blob_id`**: Walrus blob ID for individual data
+        settlement. ``None`` for private/batch settlement or when the
+        provider does not return it.
 * **`finish_reason`**: Reason the model stopped generating
         (e.g. ``"stop"``, ``"tool_call"``, ``"error"``).
         Only populated for chat requests.
@@ -510,7 +524,8 @@ performed inside a TEE enclave.
 
 ```python
 def __init__(
-    transaction_hash: str,
+    data_settlement_transaction_hash: Optional[str] = None,
+    data_settlement_blob_id: Optional[str] = None,
     finish_reason: Optional[str] = None,
     chat_output: Optional[Dict] = None,
     completion_output: Optional[str] = None,