@querais/shared 0.2.0

package/dist/messages.d.ts

@@ -0,0 +1,448 @@
+import { z } from 'zod';
+/**
+ * Gateway ↔ node wire protocol (JSON over WebSocket). Two discriminated unions:
+ * messages a node sends to the gateway, and messages the gateway sends to a node.
+ *
+ * Auth handshake: node connects → gateway sends `challenge` → node replies with
+ * `hello` containing a signature over the nonce (proving wallet control) → gateway
+ * verifies + checks the on-chain registry → `hello_ack`.
+ */
+export declare const nodeModelOfferSchema: z.ZodObject<{
+    model: z.ZodString;
+    pricePerTokenWei: z.ZodString;
+    tokensPerSecond: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    model: string;
+    pricePerTokenWei: string;
+    tokensPerSecond: number;
+}, {
+    model: string;
+    pricePerTokenWei: string;
+    tokensPerSecond: number;
+}>;
+export type NodeModelOffer = z.infer<typeof nodeModelOfferSchema>;
+export declare const challengeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"challenge">;
+    nonce: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    nonce: string;
+    type: "challenge";
+}, {
+    nonce: string;
+    type: "challenge";
+}>;
+export declare const helloAckSchema: z.ZodObject<{
+    type: z.ZodLiteral<"hello_ack">;
+    ok: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "hello_ack";
+    ok: boolean;
+    reason?: string | undefined;
+}, {
+    type: "hello_ack";
+    ok: boolean;
+    reason?: string | undefined;
+}>;
+export declare const jobAssignmentSchema: z.ZodObject<{
+    type: z.ZodLiteral<"job_assignment">;
+    spec: z.ZodObject<{
+        model: z.ZodString;
+        messages: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<["system", "user", "assistant"]>;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }, {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }>, "many">;
+        maxTokens: z.ZodNumber;
+        temperature: z.ZodNumber;
+        stream: z.ZodBoolean;
+        requesterWallet: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+        maxPricePerTokenWei: z.ZodString;
+        minReputation: z.ZodNumber;
+        createdAt: z.ZodNumber;
+        deadline: z.ZodNumber;
+    } & {
+        jobId: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+    }, "strip", z.ZodTypeAny, {
+        model: string;
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+        temperature: number;
+        stream: boolean;
+        maxTokens: number;
+        requesterWallet: `0x${string}`;
+        maxPricePerTokenWei: string;
+        minReputation: number;
+        createdAt: number;
+        deadline: number;
+        jobId: `0x${string}`;
+    }, {
+        model: string;
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+        temperature: number;
+        stream: boolean;
+        maxTokens: number;
+        requesterWallet: string;
+        maxPricePerTokenWei: string;
+        minReputation: number;
+        createdAt: number;
+        deadline: number;
+        jobId: string;
+    }>;
+    agreedPricePerTokenWei: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "job_assignment";
+    spec: {
+        model: string;
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+        temperature: number;
+        stream: boolean;
+        maxTokens: number;
+        requesterWallet: `0x${string}`;
+        maxPricePerTokenWei: string;
+        minReputation: number;
+        createdAt: number;
+        deadline: number;
+        jobId: `0x${string}`;
+    };
+    agreedPricePerTokenWei: string;
+}, {
+    type: "job_assignment";
+    spec: {
+        model: string;
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+        temperature: number;
+        stream: boolean;
+        maxTokens: number;
+        requesterWallet: string;
+        maxPricePerTokenWei: string;
+        minReputation: number;
+        createdAt: number;
+        deadline: number;
+        jobId: string;
+    };
+    agreedPricePerTokenWei: string;
+}>;
+export declare const gatewayToNodeSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"challenge">;
+    nonce: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    nonce: string;
+    type: "challenge";
+}, {
+    nonce: string;
+    type: "challenge";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"hello_ack">;
+    ok: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "hello_ack";
+    ok: boolean;
+    reason?: string | undefined;
+}, {
+    type: "hello_ack";
+    ok: boolean;
+    reason?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"job_assignment">;
+    spec: z.ZodObject<{
+        model: z.ZodString;
+        messages: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<["system", "user", "assistant"]>;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }, {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }>, "many">;
+        maxTokens: z.ZodNumber;
+        temperature: z.ZodNumber;
+        stream: z.ZodBoolean;
+        requesterWallet: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+        maxPricePerTokenWei: z.ZodString;
+        minReputation: z.ZodNumber;
+        createdAt: z.ZodNumber;
+        deadline: z.ZodNumber;
+    } & {
+        jobId: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+    }, "strip", z.ZodTypeAny, {
+        model: string;
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+        temperature: number;
+        stream: boolean;
+        maxTokens: number;
+        requesterWallet: `0x${string}`;
+        maxPricePerTokenWei: string;
+        minReputation: number;
+        createdAt: number;
+        deadline: number;
+        jobId: `0x${string}`;
+    }, {
+        model: string;
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+        temperature: number;
+        stream: boolean;
+        maxTokens: number;
+        requesterWallet: string;
+        maxPricePerTokenWei: string;
+        minReputation: number;
+        createdAt: number;
+        deadline: number;
+        jobId: string;
+    }>;
+    agreedPricePerTokenWei: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "job_assignment";
+    spec: {
+        model: string;
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+        temperature: number;
+        stream: boolean;
+        maxTokens: number;
+        requesterWallet: `0x${string}`;
+        maxPricePerTokenWei: string;
+        minReputation: number;
+        createdAt: number;
+        deadline: number;
+        jobId: `0x${string}`;
+    };
+    agreedPricePerTokenWei: string;
+}, {
+    type: "job_assignment";
+    spec: {
+        model: string;
+        messages: {
+            role: "system" | "user" | "assistant";
+            content: string;
+        }[];
+        temperature: number;
+        stream: boolean;
+        maxTokens: number;
+        requesterWallet: string;
+        maxPricePerTokenWei: string;
+        minReputation: number;
+        createdAt: number;
+        deadline: number;
+        jobId: string;
+    };
+    agreedPricePerTokenWei: string;
+}>]>;
+export type GatewayToNode = z.infer<typeof gatewayToNodeSchema>;
+export declare const nodeHelloSchema: z.ZodObject<{
+    type: z.ZodLiteral<"hello">;
+    nodeId: z.ZodString;
+    wallet: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+    nonce: z.ZodString;
+    signature: z.ZodString;
+    models: z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        pricePerTokenWei: z.ZodString;
+        tokensPerSecond: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        model: string;
+        pricePerTokenWei: string;
+        tokensPerSecond: number;
+    }, {
+        model: string;
+        pricePerTokenWei: string;
+        tokensPerSecond: number;
+    }>, "many">;
+    /** Slice 9 (additive): model → blob digest, so a manifest-enforcing gateway can
+     *  verify offers at handshake. Absent on pre-Slice-9 daemons — those still join,
+     *  but any model the manifest pins is dropped from their offers. */
+    modelDigests: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    nonce: string;
+    type: "hello";
+    signature: string;
+    models: {
+        model: string;
+        pricePerTokenWei: string;
+        tokensPerSecond: number;
+    }[];
+    nodeId: string;
+    wallet: `0x${string}`;
+    modelDigests?: Record<string, string> | undefined;
+}, {
+    nonce: string;
+    type: "hello";
+    signature: string;
+    models: {
+        model: string;
+        pricePerTokenWei: string;
+        tokensPerSecond: number;
+    }[];
+    nodeId: string;
+    wallet: string;
+    modelDigests?: Record<string, string> | undefined;
+}>;
+export declare const tokenChunkSchema: z.ZodObject<{
+    type: z.ZodLiteral<"token">;
+    jobId: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "token";
+    content: string;
+    jobId: `0x${string}`;
+}, {
+    type: "token";
+    content: string;
+    jobId: string;
+}>;
+export declare const completionReportSchema: z.ZodObject<{
+    type: z.ZodLiteral<"completion">;
+    jobId: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+    tokenCount: z.ZodNumber;
+    finishReason: z.ZodEnum<["stop", "length", "error"]>;
+    resultHash: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+}, "strip", z.ZodTypeAny, {
+    type: "completion";
+    jobId: `0x${string}`;
+    tokenCount: number;
+    finishReason: "length" | "stop" | "error";
+    resultHash: `0x${string}`;
+}, {
+    type: "completion";
+    jobId: string;
+    tokenCount: number;
+    finishReason: "length" | "stop" | "error";
+    resultHash: string;
+}>;
+export declare const jobErrorSchema: z.ZodObject<{
+    type: z.ZodLiteral<"job_error">;
+    jobId: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "job_error";
+    message: string;
+    jobId: `0x${string}`;
+}, {
+    type: "job_error";
+    message: string;
+    jobId: string;
+}>;
+export declare const nodeToGatewaySchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"hello">;
+    nodeId: z.ZodString;
+    wallet: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+    nonce: z.ZodString;
+    signature: z.ZodString;
+    models: z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        pricePerTokenWei: z.ZodString;
+        tokensPerSecond: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        model: string;
+        pricePerTokenWei: string;
+        tokensPerSecond: number;
+    }, {
+        model: string;
+        pricePerTokenWei: string;
+        tokensPerSecond: number;
+    }>, "many">;
+    /** Slice 9 (additive): model → blob digest, so a manifest-enforcing gateway can
+     *  verify offers at handshake. Absent on pre-Slice-9 daemons — those still join,
+     *  but any model the manifest pins is dropped from their offers. */
+    modelDigests: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    nonce: string;
+    type: "hello";
+    signature: string;
+    models: {
+        model: string;
+        pricePerTokenWei: string;
+        tokensPerSecond: number;
+    }[];
+    nodeId: string;
+    wallet: `0x${string}`;
+    modelDigests?: Record<string, string> | undefined;
+}, {
+    nonce: string;
+    type: "hello";
+    signature: string;
+    models: {
+        model: string;
+        pricePerTokenWei: string;
+        tokensPerSecond: number;
+    }[];
+    nodeId: string;
+    wallet: string;
+    modelDigests?: Record<string, string> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"token">;
+    jobId: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "token";
+    content: string;
+    jobId: `0x${string}`;
+}, {
+    type: "token";
+    content: string;
+    jobId: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"completion">;
+    jobId: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+    tokenCount: z.ZodNumber;
+    finishReason: z.ZodEnum<["stop", "length", "error"]>;
+    resultHash: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+}, "strip", z.ZodTypeAny, {
+    type: "completion";
+    jobId: `0x${string}`;
+    tokenCount: number;
+    finishReason: "length" | "stop" | "error";
+    resultHash: `0x${string}`;
+}, {
+    type: "completion";
+    jobId: string;
+    tokenCount: number;
+    finishReason: "length" | "stop" | "error";
+    resultHash: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"job_error">;
+    jobId: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "job_error";
+    message: string;
+    jobId: `0x${string}`;
+}, {
+    type: "job_error";
+    message: string;
+    jobId: string;
+}>]>;
+export type NodeToGateway = z.infer<typeof nodeToGatewaySchema>;
+export type NodeHello = z.infer<typeof nodeHelloSchema>;
+export type JobAssignment = z.infer<typeof jobAssignmentSchema>;
+export type TokenChunk = z.infer<typeof tokenChunkSchema>;
+export type CompletionReport = z.infer<typeof completionReportSchema>;
+export type JobErrorMessage = z.infer<typeof jobErrorSchema>;
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB;;;;;;;GAOG;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,eAAe;;;;;;;;;EAG1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;EAIzB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI9B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAI9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;IAO1B;;wEAEoE;;;;;;;;;;;;;;;;;;;;;;;;;;EAEpE,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;EAIzB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;IA1B9B;;wEAEoE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6BpE,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/messages.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { addressSchema, bytes32Schema, decimalStringSchema, identifiedJobSpecSchema, } from './jobspec.js';
+import { MODEL_DIGEST_REGEX } from './model-manifest.js';
+/**
+ * Gateway ↔ node wire protocol (JSON over WebSocket). Two discriminated unions:
+ * messages a node sends to the gateway, and messages the gateway sends to a node.
+ *
+ * Auth handshake: node connects → gateway sends `challenge` → node replies with
+ * `hello` containing a signature over the nonce (proving wallet control) → gateway
+ * verifies + checks the on-chain registry → `hello_ack`.
+ */
+export const nodeModelOfferSchema = z.object({
+    model: z.string().min(1),
+    pricePerTokenWei: decimalStringSchema,
+    tokensPerSecond: z.number().nonnegative(),
+});
+// ── Gateway → Node ─────────────────────────────────────────────────────────────
+export const challengeSchema = z.object({
+    type: z.literal('challenge'),
+    nonce: z.string().min(1),
+});
+export const helloAckSchema = z.object({
+    type: z.literal('hello_ack'),
+    ok: z.boolean(),
+    reason: z.string().optional(),
+});
+export const jobAssignmentSchema = z.object({
+    type: z.literal('job_assignment'),
+    spec: identifiedJobSpecSchema,
+    agreedPricePerTokenWei: decimalStringSchema,
+});
+export const gatewayToNodeSchema = z.discriminatedUnion('type', [
+    challengeSchema,
+    helloAckSchema,
+    jobAssignmentSchema,
+]);
+// ── Node → Gateway ───────────────────────────────────────────────────────────
+export const nodeHelloSchema = z.object({
+    type: z.literal('hello'),
+    nodeId: z.string().min(1),
+    wallet: addressSchema,
+    nonce: z.string().min(1),
+    signature: z.string().min(1),
+    models: z.array(nodeModelOfferSchema).min(1),
+    /** Slice 9 (additive): model → blob digest, so a manifest-enforcing gateway can
+     *  verify offers at handshake. Absent on pre-Slice-9 daemons — those still join,
+     *  but any model the manifest pins is dropped from their offers. */
+    modelDigests: z.record(z.string().min(1), z.string().regex(MODEL_DIGEST_REGEX)).optional(),
+});
+export const tokenChunkSchema = z.object({
+    type: z.literal('token'),
+    jobId: bytes32Schema,
+    content: z.string(),
+});
+export const completionReportSchema = z.object({
+    type: z.literal('completion'),
+    jobId: bytes32Schema,
+    tokenCount: z.number().int().nonnegative(),
+    finishReason: z.enum(['stop', 'length', 'error']),
+    resultHash: bytes32Schema,
+});
+export const jobErrorSchema = z.object({
+    type: z.literal('job_error'),
+    jobId: bytes32Schema,
+    message: z.string(),
+});
+export const nodeToGatewaySchema = z.discriminatedUnion('type', [
+    nodeHelloSchema,
+    tokenChunkSchema,
+    completionReportSchema,
+    jobErrorSchema,
+]);
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"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"}

package/dist/model-manifest.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Signed model manifest — the operator's off-chain statement of which model
+ * binaries (by Ollama sha256 digest) count as "the real model" on this network.
+ *
+ * Lives in shared because both sides of the trust relationship consume it:
+ * the gateway loads + signs the manifest at boot and enforces it at node
+ * handshake; the node daemon fetches it from `GET /v1/models/manifest` and
+ * verifies the signature against the gateway's settler address (which it
+ * already learns from `/v1/credit/info`) before trusting the digests.
+ *
+ * Signing is EIP-191 (`personal_sign`) over a canonical JSON form — model keys
+ * sorted, entry fields in fixed order — so any holder of the manifest can
+ * re-derive the exact signed bytes and verify offline. No contract involved
+ * (Slice 9 decision: exclusion, not punishment — a mismatched model is simply
+ * not served; slashing stays with the dispute system).
+ */
+import { type Address, type Hex } from 'viem';
+import { z } from 'zod';
+/** Ollama-style digest of the model blob: "sha256:" + 64 lowercase hex chars. */
+export declare const MODEL_DIGEST_REGEX: RegExp;
+export declare const modelManifestEntrySchema: z.ZodObject<{
+    digest: z.ZodString;
+    /** Free-form operator note ("gemma3:4b pulled 2026-06-01"); not enforced. */
+    note: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    digest: string;
+    note?: string | undefined;
+}, {
+    digest: string;
+    note?: string | undefined;
+}>;
+export type ModelManifestEntry = z.infer<typeof modelManifestEntrySchema>;
+/** The unsigned manifest body — what the operator authors as a JSON file. */
+export declare const modelManifestSchema: z.ZodObject<{
+    models: z.ZodRecord<z.ZodString, z.ZodObject<{
+        digest: z.ZodString;
+        /** Free-form operator note ("gemma3:4b pulled 2026-06-01"); not enforced. */
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        digest: string;
+        note?: string | undefined;
+    }, {
+        digest: string;
+        note?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    models: Record<string, {
+        digest: string;
+        note?: string | undefined;
+    }>;
+}, {
+    models: Record<string, {
+        digest: string;
+        note?: string | undefined;
+    }>;
+}>;
+export type ModelManifest = z.infer<typeof modelManifestSchema>;
+/** Wire form served by `GET /v1/models/manifest` (and verified by daemons). */
+export declare const signedModelManifestSchema: z.ZodObject<{
+    models: z.ZodRecord<z.ZodString, z.ZodObject<{
+        digest: z.ZodString;
+        /** Free-form operator note ("gemma3:4b pulled 2026-06-01"); not enforced. */
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        digest: string;
+        note?: string | undefined;
+    }, {
+        digest: string;
+        note?: string | undefined;
+    }>>;
+    signer: z.ZodString;
+    signature: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    signature: string;
+    models: Record<string, {
+        digest: string;
+        note?: string | undefined;
+    }>;
+    signer: string;
+}, {
+    signature: string;
+    models: Record<string, {
+        digest: string;
+        note?: string | undefined;
+    }>;
+    signer: string;
+}>;
+export interface SignedModelManifest {
+    models: Record<string, ModelManifestEntry>;
+    /** The gateway wallet that signed — daemons check it equals the settler. */
+    signer: Address;
+    /** EIP-191 signature over `canonicalModelManifestJson(models)`. */
+    signature: Hex;
+}
+/**
+ * The exact byte string that gets signed: `{"models":{...}}` with model keys
+ * sorted and entry fields in fixed (digest, note) order. Deterministic across
+ * runtimes, so gateway and daemon always derive identical bytes.
+ */
+export declare function canonicalModelManifestJson(models: Record<string, ModelManifestEntry>): string;
+/** Minimal signer shape — viem LocalAccount and (account-bound) WalletClient both satisfy it. */
+export interface ManifestSigner {
+    signMessage(args: {
+        message: string;
+    }): Promise<Hex>;
+}
+/** Sign the manifest with the gateway key (done once at boot). */
+export declare function signModelManifest(signer: ManifestSigner, signerAddress: Address, models: Record<string, ModelManifestEntry>): Promise<SignedModelManifest>;
+/**
+ * Verify a fetched manifest: recover the EIP-191 signer from the canonical
+ * JSON and compare to the claimed `signer`. Pure (no RPC); returns false on
+ * any malformed input rather than throwing.
+ */
+export declare function verifyModelManifest(manifest: SignedModelManifest): Promise<boolean>;
+//# sourceMappingURL=model-manifest.d.ts.map

package/dist/model-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-manifest.d.ts","sourceRoot":"","sources":["../src/model-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAyB,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AACrE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,QAA0B,CAAC;AAE1D,eAAO,MAAM,wBAAwB;;IAEnC,6EAA6E;;;;;;;;EAE7E,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB;;;QAP9B,6EAA6E;;;;;;;;;;;;;;;;;;;EAWpE,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,+EAA+E;AAC/E,eAAO,MAAM,yBAAyB;;;QAlBpC,6EAA6E;;;;;;;;;;;;;;;;;;;;;;;;;EAsB7E,CAAC;AAEH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC3C,4EAA4E;IAC5E,MAAM,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,SAAS,EAAE,GAAG,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,MAAM,CAU7F;AAED,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACtD;AAED,kEAAkE;AAClE,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,OAAO,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GACzC,OAAO,CAAC,mBAAmB,CAAC,CAG9B;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAUzF"}