@halot/sdk 1.0.2 → 1.0.3

package/README.md

@@ -45,7 +45,7 @@ against the Halot facilitator endpoints.
 
 ### Before you use it
 
-The route must use a real registered `serviceId`.
+The route must use a real registered `serviceId` and provider-signed report headers.
 
 The actual order is:
 
@@ -59,18 +59,37 @@ If you are using middleware for a service, you do not need `halot provider run`
 
 ```ts
 import express from 'express';
-import { halot } from '@halot/sdk';
+import { Wallet } from 'ethers';
+import { createActorAuthHeaders, halot, nowIso } from '@halot/sdk';
 
 const app = express();
 app.use(express.json());
 
+const providerId = process.env.HALOT_PROVIDER_ID!;
+const providerWallet = new Wallet(process.env.HALOT_PROVIDER_PRIVATE_KEY!);
+
+const providerHeaders = async (_req, context) => {
+  if (context.providerId !== providerId) {
+    throw new Error(`Assigned provider ${context.providerId} does not match configured provider ${providerId}`);
+  }
+
+  return createActorAuthHeaders(providerWallet, {
+    actorId: providerId,
+    role: 'provider',
+    method: 'POST',
+    path: '/facilitator/report',
+    timestamp: nowIso(),
+  });
+};
+
 app.post('/text', halot({
   serviceId: 'svc_text_gpt54',
+  providerHeaders,
 }), async (req, res) => {
-  const { jobId, providerId, requesterAddress } = req.halot;
+  const { jobId, providerId: assignedProviderId, requesterAddress } = req.halot;
   const text = await runProviderLogic(req.body.message, {
     jobId,
-    providerId,
+    providerId: assignedProviderId,
     requesterAddress,
   });
 
@@ -78,6 +97,8 @@ app.post('/text', halot({
 });
 ```
 
+`HALOT_PROVIDER_ID` is the provider ID returned by provider registration. `HALOT_PROVIDER_PRIVATE_KEY` is the private key for that provider actor authority. You can load those values from a secret manager or the CLI-generated authority file instead of env; the important part is that `/facilitator/report` is signed by the same provider actor that owns the registered service.
+
 ### One route, multiple services
 
 If one route fronts multiple registered services, resolve `serviceId` from the request:
@@ -90,47 +111,19 @@ app.post('/text', halot({
         return 'svc_text_gpt54';
       case 'gpt-5.4-mini':
         return 'svc_text_gpt54mini';
+      case 'gpt-5.4-nano':
+        return 'svc_text_gpt54nano';
       default:
         throw new Error('Unsupported model');
     }
   },
+  providerHeaders,
 }), async (req, res) => {
   const text = await runProviderLogic(req.body.message);
   res.json({ text, model: req.body.model });
 });
 ```
 
-### Signing facilitator report requests
-
-Use `providerHeaders` when your provider app needs to sign `/facilitator/report` as the registered provider:
-
-```ts
-import express from 'express';
-import { createActorAuthHeaders, halot } from '@halot/sdk';
-
-const app = express();
-app.use(express.json());
-
-const providerWallet = {
-  address: process.env.PROVIDER_ADDRESS!,
-  signMessage: async (message: string) => signWithWallet(message),
-};
-
-app.post('/text', halot({
-  serviceId: 'svc_text_gpt54',
-  providerHeaders: async (_req, context) => createActorAuthHeaders(providerWallet, {
-    actorId: context.providerId,
-    role: 'provider',
-    method: 'POST',
-    path: '/facilitator/report',
-    timestamp: new Date().toISOString(),
-  }),
-}), async (req, res) => {
-  const text = await runProviderLogic(req.body.message);
-  res.json({ text });
-});
-```
-
 ### Middleware flow
 
 When a requester calls your middleware route:

package/dist/types/verifier.d.ts

@@ -35,12 +35,31 @@ export declare const VerifierConfigSchema: z.ZodObject<{
         computeBudgetPerJob: z.ZodString;
     }, z.core.$strip>;
 }, z.core.$strip>;
+export declare const EvaluationModelConfigSchema: z.ZodPipe<z.ZodObject<{
+    zeroGComputeProviderAddress: z.ZodOptional<z.ZodString>;
+    providerAddress: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodTransform<{
+    model?: string | undefined;
+    zeroGComputeProviderAddress: string;
+}, {
+    zeroGComputeProviderAddress?: string | undefined;
+    providerAddress?: string | undefined;
+    model?: string | undefined;
+}>>;
 export declare const ModelConfigSchema: z.ZodObject<{
-    evaluationModel: z.ZodObject<{
-        providerAddress: z.ZodDefault<z.ZodString>;
-        serviceType: z.ZodDefault<z.ZodString>;
-        verifiability: z.ZodDefault<z.ZodString>;
-    }, z.core.$strip>;
+    evaluationModel: z.ZodPipe<z.ZodObject<{
+        zeroGComputeProviderAddress: z.ZodOptional<z.ZodString>;
+        providerAddress: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodTransform<{
+        model?: string | undefined;
+        zeroGComputeProviderAddress: string;
+    }, {
+        zeroGComputeProviderAddress?: string | undefined;
+        providerAddress?: string | undefined;
+        model?: string | undefined;
+    }>>;
     sdk: z.ZodObject<{
         network: z.ZodString;
         rpcUrl: z.ZodOptional<z.ZodString>;

package/dist/types/verifier.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VerifierStatsSchema = exports.RegisteredVerifierSchema = exports.SpecializationsSchema = exports.InferenceTemplateSchema = exports.ModelConfigSchema = exports.VerifierConfigSchema = void 0;
+exports.VerifierStatsSchema = exports.RegisteredVerifierSchema = exports.SpecializationsSchema = exports.InferenceTemplateSchema = exports.ModelConfigSchema = exports.EvaluationModelConfigSchema = exports.VerifierConfigSchema = void 0;
 const zod_1 = require("zod");
 const common_1 = require("./common");
 exports.VerifierConfigSchema = zod_1.z.object({
@@ -31,12 +31,16 @@ exports.VerifierConfigSchema = zod_1.z.object({
         computeBudgetPerJob: zod_1.z.string(),
     }),
 });
+exports.EvaluationModelConfigSchema = zod_1.z.object({
+    zeroGComputeProviderAddress: zod_1.z.string().optional(),
+    providerAddress: zod_1.z.string().optional(),
+    model: zod_1.z.string().optional(),
+}).transform((config) => ({
+    zeroGComputeProviderAddress: config.zeroGComputeProviderAddress ?? config.providerAddress ?? '',
+    ...(config.model && config.model.trim() ? { model: config.model.trim() } : {}),
+}));
 exports.ModelConfigSchema = zod_1.z.object({
-    evaluationModel: zod_1.z.object({
-        providerAddress: zod_1.z.string().default(''),
-        serviceType: zod_1.z.string().default('chatbot'),
-        verifiability: zod_1.z.string().default('TeeML'),
-    }),
+    evaluationModel: exports.EvaluationModelConfigSchema,
     sdk: zod_1.z.object({
         network: zod_1.z.string(),
         rpcUrl: zod_1.z.string().optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halot/sdk",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Shared Halot protocol SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",