@obelyzk/sdk 1.5.0 → 1.6.0

package/README.md

@@ -176,11 +176,11 @@ const client = createProverClient({
 });
 ```
 
-See the [Self-Hosting Guide](../../libs/stwo-ml/scripts/pipeline/GETTING_STARTED.md#option-3-self-host-a-gpu-prover) for setup instructions.
+See the [Self-Hosting Guide](../../libs/obelyzk.rs/scripts/pipeline/GETTING_STARTED.md#option-3-self-host-a-gpu-prover) for setup instructions.
 
 ## Links
 
-- [GitHub](https://github.com/obelyzk/stwo-ml)
+- [GitHub](https://github.com/Bitsage-Network/obelyzk.rs)
 - [npm](https://www.npmjs.com/package/@obelyzk/sdk)
-- [Getting Started](../../libs/stwo-ml/scripts/pipeline/GETTING_STARTED.md)
-- [On-Chain Docs](../../libs/stwo-ml/docs/ON_CHAIN_VERIFICATION.md)
+- [Getting Started](../../libs/obelyzk.rs/scripts/pipeline/GETTING_STARTED.md)
+- [On-Chain Docs](../../libs/obelyzk.rs/docs/ON_CHAIN_VERIFICATION.md)

package/dist/index.d.mts

@@ -692,6 +692,34 @@ declare class StwoProverClient {
     /**
      * Generate proof for AI/ML inference
      */
+    /**
+     * Verifiable chat inference — send a prompt, get a response with on-chain proof.
+     *
+     * @example
+     * ```typescript
+     * const result = await prover.chat("What is 2+2?", { model: "local", maxTokens: 1 });
+     * console.log(result.text);           // model output
+     * console.log(result.txHash);         // Starknet TX hash
+     * console.log(result.explorerUrl);    // Starkscan link
+     * console.log(result.calldataFelts);  // ~950 felts
+     * console.log(result.modelId);        // weight commitment hash
+     * ```
+     */
+    chat(prompt: string, options?: {
+        model?: string;
+        maxTokens?: number;
+        sessionId?: string;
+    }): Promise<{
+        text: string;
+        txHash?: string;
+        proofHash?: string;
+        modelId?: string;
+        ioCommitment?: string;
+        calldataFelts?: number;
+        explorerUrl?: string;
+        proveTimeSecs?: number;
+        trustModel: string;
+    }>;
     proveInference(modelId: string, inputs: bigint[], outputs: bigint[], options?: {
         priority?: ProofJobPriority;
         requireTee?: boolean;

package/dist/index.d.ts

@@ -692,6 +692,34 @@ declare class StwoProverClient {
     /**
      * Generate proof for AI/ML inference
      */
+    /**
+     * Verifiable chat inference — send a prompt, get a response with on-chain proof.
+     *
+     * @example
+     * ```typescript
+     * const result = await prover.chat("What is 2+2?", { model: "local", maxTokens: 1 });
+     * console.log(result.text);           // model output
+     * console.log(result.txHash);         // Starknet TX hash
+     * console.log(result.explorerUrl);    // Starkscan link
+     * console.log(result.calldataFelts);  // ~950 felts
+     * console.log(result.modelId);        // weight commitment hash
+     * ```
+     */
+    chat(prompt: string, options?: {
+        model?: string;
+        maxTokens?: number;
+        sessionId?: string;
+    }): Promise<{
+        text: string;
+        txHash?: string;
+        proofHash?: string;
+        modelId?: string;
+        ioCommitment?: string;
+        calldataFelts?: number;
+        explorerUrl?: string;
+        proveTimeSecs?: number;
+        trustModel: string;
+    }>;
     proveInference(modelId: string, inputs: bigint[], outputs: bigint[], options?: {
         priority?: ProofJobPriority;
         requireTee?: boolean;

package/dist/index.js

@@ -6418,6 +6418,53 @@ var StwoProverClient = class {
   /**
    * Generate proof for AI/ML inference
    */
+  /**
+   * Verifiable chat inference — send a prompt, get a response with on-chain proof.
+   *
+   * @example
+   * ```typescript
+   * const result = await prover.chat("What is 2+2?", { model: "local", maxTokens: 1 });
+   * console.log(result.text);           // model output
+   * console.log(result.txHash);         // Starknet TX hash
+   * console.log(result.explorerUrl);    // Starkscan link
+   * console.log(result.calldataFelts);  // ~950 felts
+   * console.log(result.modelId);        // weight commitment hash
+   * ```
+   */
+  async chat(prompt, options) {
+    const response = await fetch(`${this.config.baseUrl}/v1/chat/completions`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...this.config.apiKey ? { Authorization: `Bearer ${this.config.apiKey}` } : {}
+      },
+      body: JSON.stringify({
+        model: options?.model ?? "local",
+        messages: [{ role: "user", content: prompt }],
+        max_tokens: options?.maxTokens ?? 1,
+        stream: false,
+        session_id: options?.sessionId
+      })
+    });
+    if (!response.ok) {
+      const err = await response.text();
+      throw new Error(`Chat failed (${response.status}): ${err}`);
+    }
+    const data = await response.json();
+    const choice = data.choices?.[0];
+    const meta = data.obelyzk ?? {};
+    return {
+      text: choice?.message?.content ?? "",
+      txHash: meta.tx_hash,
+      proofHash: meta.proof_hash,
+      modelId: meta.model_id,
+      ioCommitment: meta.io_commitment,
+      calldataFelts: meta.calldata_felts,
+      explorerUrl: meta.explorer_url,
+      proveTimeSecs: meta.prove_time_secs,
+      trustModel: meta.trust_model ?? "unknown"
+    };
+  }
   async proveInference(modelId, inputs, outputs, options) {
     const job = await this.submitProofJob({
       proofType: "ai_inference",

package/dist/index.mjs

@@ -1,3 +1,7 @@
+import "./chunk-DGYMDV5X.mjs";
+import {
+  AgentFirewallSDK
+} from "./chunk-Y4PBMUWM.mjs";
 import {
   BatchClient,
   BitSageClient,
@@ -65,10 +69,6 @@ import {
   toFelt,
   verifyTransferProof
 } from "./chunk-LXJT3QK6.mjs";
-import "./chunk-DGYMDV5X.mjs";
-import {
-  AgentFirewallSDK
-} from "./chunk-Y4PBMUWM.mjs";
 import {
   AssetId,
   CURVE_ORDER,
@@ -500,6 +500,53 @@ var StwoProverClient = class {
   /**
    * Generate proof for AI/ML inference
    */
+  /**
+   * Verifiable chat inference — send a prompt, get a response with on-chain proof.
+   *
+   * @example
+   * ```typescript
+   * const result = await prover.chat("What is 2+2?", { model: "local", maxTokens: 1 });
+   * console.log(result.text);           // model output
+   * console.log(result.txHash);         // Starknet TX hash
+   * console.log(result.explorerUrl);    // Starkscan link
+   * console.log(result.calldataFelts);  // ~950 felts
+   * console.log(result.modelId);        // weight commitment hash
+   * ```
+   */
+  async chat(prompt, options) {
+    const response = await fetch(`${this.config.baseUrl}/v1/chat/completions`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...this.config.apiKey ? { Authorization: `Bearer ${this.config.apiKey}` } : {}
+      },
+      body: JSON.stringify({
+        model: options?.model ?? "local",
+        messages: [{ role: "user", content: prompt }],
+        max_tokens: options?.maxTokens ?? 1,
+        stream: false,
+        session_id: options?.sessionId
+      })
+    });
+    if (!response.ok) {
+      const err = await response.text();
+      throw new Error(`Chat failed (${response.status}): ${err}`);
+    }
+    const data = await response.json();
+    const choice = data.choices?.[0];
+    const meta = data.obelyzk ?? {};
+    return {
+      text: choice?.message?.content ?? "",
+      txHash: meta.tx_hash,
+      proofHash: meta.proof_hash,
+      modelId: meta.model_id,
+      ioCommitment: meta.io_commitment,
+      calldataFelts: meta.calldata_felts,
+      explorerUrl: meta.explorer_url,
+      proveTimeSecs: meta.prove_time_secs,
+      trustModel: meta.trust_model ?? "unknown"
+    };
+  }
   async proveInference(modelId, inputs, outputs, options) {
     const job = await this.submitProofJob({
       proofType: "ai_inference",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@obelyzk/sdk",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "ObelyZK SDK — verifiable ML inference on Starknet with recursive STARK proofs",
   "main": "dist/index.js",
   "module": "dist/index.mjs",