Update docs from nexus-sdk (commit: dbd3cc843a086ea70b524cd2f623e46deaadb0f2)

Author: afarukcali

nexus-sdk/guides/math-branching-with-chat.md

@@ -621,5 +621,5 @@ This extended DAG demonstrates how to combine mathematical computation with natu
 
 <!-- List of references -->
 
-[math-branching-entry-guide]: ./math-branching-dag-entry.md
+[math-branching-entry-guide]: ./math_branching-dag-entry.md
 [llm-openai-chat-prep-tool]: ./llm-openai-chat-prep-tool.md

tools/storage-walrus/README.md

@@ -1,4 +1,4 @@
-# `xyz.taluslabs.storage.walrus.upload-json`
+# `xyz.taluslabs.storage.walrus.upload-json@1`
 
 Standard Nexus Tool that uploads a JSON file to Walrus and returns the blob ID.
 
@@ -54,3 +54,140 @@ The blob upload failed.
 - **`err.status_code`: [`Option<u16>`]** - HTTP status code if available (for network errors)
 
 ---
+
+# `xyz.taluslabs.storage.walrus.upload-file@1`
+
+Standard Nexus Tool that uploads a file to Walrus and returns the blob ID.
+
+## Input
+
+**`file_path`: [`String`]**
+
+The path to the file to upload.
+
+_opt_ **`publisher_url`: [`Option<String>`]** _default_: [`None`]
+
+The walrus publisher URL.
+
+_opt_ **`epochs`: [`u64`]** _default_: [`1`]
+
+Number of epochs to store the file.
+
+_opt_ **`send_to`: [`Option<String>`]** _default_: [`None`]
+
+Optional address to which the created Blob object should be sent.
+
+## Output Variants & Ports
+
+**`newly_created`**
+
+A new blob was created and uploaded successfully.
+
+- **`newly_created.blob_id`: [`String`]** - The unique identifier for the uploaded blob
+- **`newly_created.end_epoch`: [`u64`]** - The epoch at which the blob will expire
+- **`newly_created.sui_object_id`: [`String`]** - Sui object ID of the newly created blob
+
+**`already_certified`**
+
+The blob was already certified in the blockchain.
+
+- **`already_certified.blob_id`: [`String`]** - The unique identifier for the blob
+- **`already_certified.end_epoch`: [`u64`]** - The epoch at which the blob will expire
+- **`already_certified.tx_digest`: [`String`]** - Transaction digest of the certified blob
+
+**`err`**
+
+The file upload failed.
+
+- **`err.reason`: [`String`]** - A detailed error message describing what went wrong
+- **`err.kind`: [`UploadErrorKind`]** - Type of error that occurred
+  - Possible kinds:
+    - `network` - Error during HTTP requests or network connectivity issues
+    - `validation` - Invalid file data or file validation failures
+
+# `xyz.taluslabs.storage.walrus.read-json@1`
+
+Standard Nexus Tool that reads a JSON file from Walrus and returns the JSON data. The tool can also validate the JSON data against a provided schema.
+
+## Input
+
+**`blob_id`: [`String`]**
+
+The blob ID of the JSON file to read.
+
+_opt_ **`aggregator_url`: [`Option<String>`]** _default_: [`None`]
+
+The URL of the Walrus aggregator to read the JSON from.
+
+_opt_ **`json_schema`: [`Option<WalrusJsonSchema>`]** _default_: [`None`]
+
+Optional JSON schema to validate the data against.
+
+### WalrusJsonSchema Structure
+
+- **`name`: [`String`]** - The name of the schema. Must match `[a-zA-Z0-9-_]`, with a maximum length of 64.
+- **`schema`: [`schemars::Schema`]** - The JSON schema for the expected output.
+- **`description`: [`Option<String>`]** - A description of the expected format.
+- **`strict`: [`Option<bool>`]** - Whether to enable strict schema adherence when validating the output.
+
+## Output Variants & Ports
+
+**`ok`**
+
+The JSON data was read successfully.
+
+- **`ok.json`: [`Value`]** - The JSON data as a structured value
+
+**`err`**
+
+The JSON read operation failed.
+
+- **`err.reason`: [`String`]** - A detailed error message describing what went wrong
+- **`err.kind`: [`ReadErrorKind`]** - Type of error that occurred
+  - Possible kinds:
+    - `network` - Error during HTTP requests or network connectivity issues
+    - `validation` - Invalid JSON data format or parsing failures
+    - `schema` - Error validating the JSON against the provided schema
+- **`err.status_code`: [`Option<u16>`]** - HTTP status code if available (for network errors)
+
+---
+
+# `xyz.taluslabs.storage.walrus.verify-blob@1`
+
+Standard Nexus Tool that verifies a blob in Walrus.
+
+## Input
+
+**`blob_id`: [`String`]**
+
+The ID of the blob to verify.
+
+_opt_ **`aggregator_url`: [`Option<String>`]** _default_: [`None`]
+
+The URL of the Walrus aggregator to verify the blob against.
+
+## Output Variants & Ports
+
+**`verified`**
+
+The blob exists and is verified.
+
+- **`verified.blob_id`: [`String`]** - The ID of the verified blob
+
+**`unverified`**
+
+The blob does not exist or could not be verified.
+
+- **`unverified.blob_id`: [`String`]** - The ID of the unverified blob
+
+**`err`**
+
+An error occurred during verification.
+
+- **`err.reason`: [`String`]** - A detailed error message describing what went wrong
+- **`err.kind`: [`UploadErrorKind`]** - Type of error that occurred
+  - Possible kinds:
+    - `server` - Server-side errors during verification
+- **`err.status_code`: [`Option<u16>`]** - HTTP status code if available (for API errors)
+
+---