@halot/sdk 1.0.0

package/dist/types/verifier.d.ts

@@ -0,0 +1,144 @@
+import { z } from 'zod';
+export declare const VerifierConfigSchema: z.ZodObject<{
+    verifierId: z.ZodDefault<z.ZodString>;
+    displayName: z.ZodString;
+    description: z.ZodString;
+    identity: z.ZodObject<{
+        erc8004TokenId: z.ZodDefault<z.ZodString>;
+        agentRegistry: z.ZodDefault<z.ZodString>;
+        agentUri: z.ZodDefault<z.ZodString>;
+        ownerAddress: z.ZodDefault<z.ZodString>;
+        domain: z.ZodString;
+        domainType: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    authority: z.ZodObject<{
+        path: z.ZodDefault<z.ZodString>;
+        actor: z.ZodEnum<{
+            "0g:testnet": "0g:testnet";
+            "0g:mainnet": "0g:mainnet";
+            "stellar:testnet": "stellar:testnet";
+            "stellar:mainnet": "stellar:mainnet";
+        }>;
+    }, z.core.$strip>;
+    settlementWallets: z.ZodObject<{
+        '0g:testnet': z.ZodDefault<z.ZodString>;
+        '0g:mainnet': z.ZodDefault<z.ZodString>;
+        'stellar:testnet': z.ZodDefault<z.ZodString>;
+        'stellar:mainnet': z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    stake: z.ZodObject<{
+        amount: z.ZodString;
+        token: z.ZodDefault<z.ZodString>;
+        status: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    fees: z.ZodObject<{
+        computeBudgetPerJob: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+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>;
+    sdk: z.ZodObject<{
+        network: z.ZodString;
+        rpcUrl: z.ZodOptional<z.ZodString>;
+        ledgerContractAddress: z.ZodOptional<z.ZodString>;
+        inferenceContractAddress: z.ZodOptional<z.ZodString>;
+        fineTuningContractAddress: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    timeout: z.ZodNumber;
+}, z.core.$strip>;
+export declare const InferenceTemplateSchema: z.ZodObject<{
+    systemPrompt: z.ZodString;
+    promptTemplate: z.ZodString;
+    outputSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+    maxTokens: z.ZodNumber;
+    temperature: z.ZodNumber;
+}, z.core.$strip>;
+export declare const SpecializationsSchema: z.ZodObject<{
+    categories: z.ZodArray<z.ZodEnum<{
+        text: "text";
+        code: "code";
+        image: "image";
+        audio: "audio";
+        video: "video";
+        document: "document";
+        tool: "tool";
+        workflow: "workflow";
+    }>>;
+    serviceIds: z.ZodArray<z.ZodString>;
+    maxConcurrentJobs: z.ZodNumber;
+    minConfidenceThreshold: z.ZodNumber;
+}, z.core.$strip>;
+export declare const RegisteredVerifierSchema: z.ZodObject<{
+    displayName: z.ZodString;
+    description: z.ZodString;
+    identity: z.ZodObject<{
+        erc8004TokenId: z.ZodDefault<z.ZodString>;
+        agentRegistry: z.ZodDefault<z.ZodString>;
+        agentUri: z.ZodDefault<z.ZodString>;
+        ownerAddress: z.ZodDefault<z.ZodString>;
+        domain: z.ZodString;
+        domainType: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    authority: z.ZodObject<{
+        path: z.ZodDefault<z.ZodString>;
+        actor: z.ZodEnum<{
+            "0g:testnet": "0g:testnet";
+            "0g:mainnet": "0g:mainnet";
+            "stellar:testnet": "stellar:testnet";
+            "stellar:mainnet": "stellar:mainnet";
+        }>;
+    }, z.core.$strip>;
+    settlementWallets: z.ZodObject<{
+        '0g:testnet': z.ZodDefault<z.ZodString>;
+        '0g:mainnet': z.ZodDefault<z.ZodString>;
+        'stellar:testnet': z.ZodDefault<z.ZodString>;
+        'stellar:mainnet': z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    stake: z.ZodObject<{
+        amount: z.ZodString;
+        token: z.ZodDefault<z.ZodString>;
+        status: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    fees: z.ZodObject<{
+        computeBudgetPerJob: z.ZodString;
+    }, z.core.$strip>;
+    verifierId: z.ZodString;
+    signingPublicKey: z.ZodString;
+    ownerAddress: z.ZodString;
+    rootHash: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    specializations: z.ZodObject<{
+        categories: z.ZodArray<z.ZodEnum<{
+            text: "text";
+            code: "code";
+            image: "image";
+            audio: "audio";
+            video: "video";
+            document: "document";
+            tool: "tool";
+            workflow: "workflow";
+        }>>;
+        serviceIds: z.ZodArray<z.ZodString>;
+        maxConcurrentJobs: z.ZodNumber;
+        minConfidenceThreshold: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const VerifierStatsSchema: z.ZodObject<{
+    verifierId: z.ZodString;
+    totalAssignments: z.ZodNumber;
+    completedAttestations: z.ZodNumber;
+    approvals: z.ZodNumber;
+    rejections: z.ZodNumber;
+    totalEarned: z.ZodString;
+}, z.core.$strip>;
+export type VerifierConfig = z.infer<typeof VerifierConfigSchema>;
+export type ModelConfig = z.infer<typeof ModelConfigSchema>;
+export type InferenceTemplate = z.infer<typeof InferenceTemplateSchema>;
+export type Specializations = z.infer<typeof SpecializationsSchema>;
+export type RegisteredVerifier = z.infer<typeof RegisteredVerifierSchema>;
+export type VerifierStats = z.infer<typeof VerifierStatsSchema>;

package/dist/types/verifier.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VerifierStatsSchema = exports.RegisteredVerifierSchema = exports.SpecializationsSchema = exports.InferenceTemplateSchema = exports.ModelConfigSchema = exports.VerifierConfigSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("./common");
+exports.VerifierConfigSchema = zod_1.z.object({
+    verifierId: zod_1.z.string().default(''),
+    displayName: zod_1.z.string().min(1),
+    description: zod_1.z.string().min(1),
+    identity: zod_1.z.object({
+        erc8004TokenId: zod_1.z.string().default(''),
+        agentRegistry: zod_1.z.string().default(''),
+        agentUri: zod_1.z.string().default(''),
+        ownerAddress: zod_1.z.string().default(''),
+        domain: zod_1.z.string(),
+        domainType: zod_1.z.string().default('space-id'),
+    }),
+    authority: zod_1.z.object({
+        path: zod_1.z.string().default('./wallets.json'),
+        actor: common_1.SettlementNetworkSchema.refine((value) => value.startsWith('0g:'), {
+            message: 'Verifier actor authority must use a 0G authority',
+        }),
+    }),
+    settlementWallets: common_1.SettlementWalletsSchema,
+    stake: zod_1.z.object({
+        amount: zod_1.z.string(),
+        token: zod_1.z.string().default('0G'),
+        status: zod_1.z.string().default('unlocked'),
+    }),
+    fees: zod_1.z.object({
+        computeBudgetPerJob: zod_1.z.string(),
+    }),
+});
+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'),
+    }),
+    sdk: zod_1.z.object({
+        network: zod_1.z.string(),
+        rpcUrl: zod_1.z.string().optional(),
+        ledgerContractAddress: zod_1.z.string().optional(),
+        inferenceContractAddress: zod_1.z.string().optional(),
+        fineTuningContractAddress: zod_1.z.string().optional(),
+    }),
+    timeout: zod_1.z.number().int().positive(),
+});
+exports.InferenceTemplateSchema = zod_1.z.object({
+    systemPrompt: zod_1.z.string(),
+    promptTemplate: zod_1.z.string(),
+    outputSchema: zod_1.z.record(zod_1.z.string(), zod_1.z.string()),
+    maxTokens: zod_1.z.number().int().positive(),
+    temperature: zod_1.z.number(),
+});
+exports.SpecializationsSchema = zod_1.z.object({
+    categories: zod_1.z.array(common_1.ServiceCategorySchema).min(1),
+    serviceIds: zod_1.z.array(zod_1.z.string()),
+    maxConcurrentJobs: zod_1.z.number().int().positive(),
+    minConfidenceThreshold: zod_1.z.number().min(0).max(1),
+});
+exports.RegisteredVerifierSchema = exports.VerifierConfigSchema.extend({
+    verifierId: zod_1.z.string(),
+    signingPublicKey: zod_1.z.string(),
+    ownerAddress: zod_1.z.string(),
+    rootHash: zod_1.z.string(),
+    createdAt: zod_1.z.string(),
+    updatedAt: zod_1.z.string(),
+    specializations: exports.SpecializationsSchema,
+});
+exports.VerifierStatsSchema = zod_1.z.object({
+    verifierId: zod_1.z.string(),
+    totalAssignments: zod_1.z.number().int().nonnegative(),
+    completedAttestations: zod_1.z.number().int().nonnegative(),
+    approvals: zod_1.z.number().int().nonnegative(),
+    rejections: zod_1.z.number().int().nonnegative(),
+    totalEarned: zod_1.z.string(),
+});

package/dist/types/x402.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+export declare const PaymentRequirementSchema: z.ZodObject<{
+    x402Version: z.ZodLiteral<2>;
+    scheme: z.ZodLiteral<"exact">;
+    serviceId: z.ZodOptional<z.ZodString>;
+    quoteId: z.ZodString;
+    accepts: z.ZodArray<z.ZodObject<{
+        network: z.ZodString;
+        token: z.ZodString;
+        amount: z.ZodString;
+        payTo: z.ZodString;
+        memo: z.ZodString;
+    }, z.core.$strip>>;
+    expiresAt: z.ZodString;
+    resource: z.ZodString;
+    description: z.ZodString;
+    aggregatorUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const PaymentAuthorizationSchema: z.ZodObject<{
+    quoteId: z.ZodString;
+    network: z.ZodString;
+    amount: z.ZodString;
+    token: z.ZodString;
+    payTo: z.ZodString;
+    memo: z.ZodString;
+    expiresAt: z.ZodString;
+    requesterAddress: z.ZodString;
+    signature: z.ZodString;
+}, z.core.$strip>;
+export type PaymentRequirement = z.infer<typeof PaymentRequirementSchema>;
+export type PaymentAuthorization = z.infer<typeof PaymentAuthorizationSchema>;

package/dist/types/x402.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentAuthorizationSchema = exports.PaymentRequirementSchema = void 0;
+const zod_1 = require("zod");
+const quote_1 = require("./quote");
+exports.PaymentRequirementSchema = zod_1.z.object({
+    x402Version: zod_1.z.literal(2),
+    scheme: zod_1.z.literal('exact'),
+    serviceId: zod_1.z.string().optional(),
+    quoteId: zod_1.z.string(),
+    accepts: zod_1.z.array(quote_1.QuoteAcceptOptionSchema).min(1),
+    expiresAt: zod_1.z.string(),
+    resource: zod_1.z.string(),
+    description: zod_1.z.string(),
+    aggregatorUrl: zod_1.z.string().optional(),
+});
+exports.PaymentAuthorizationSchema = zod_1.z.object({
+    quoteId: zod_1.z.string(),
+    network: zod_1.z.string(),
+    amount: zod_1.z.string(),
+    token: zod_1.z.string(),
+    payTo: zod_1.z.string(),
+    memo: zod_1.z.string(),
+    expiresAt: zod_1.z.string(),
+    requesterAddress: zod_1.z.string(),
+    signature: zod_1.z.string(),
+});

package/dist/utils/amount.d.ts

@@ -0,0 +1,2 @@
+export declare function decimalToUnits(amount: string, decimals: number): string;
+export declare function unitsToDecimal(amount: bigint | string, decimals: number): string;

package/dist/utils/amount.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decimalToUnits = decimalToUnits;
+exports.unitsToDecimal = unitsToDecimal;
+const ethers_1 = require("ethers");
+function decimalToUnits(amount, decimals) {
+    return (0, ethers_1.parseUnits)(amount, decimals).toString();
+}
+function unitsToDecimal(amount, decimals) {
+    return (0, ethers_1.formatUnits)(amount, decimals);
+}

package/dist/utils/artifacts.d.ts

@@ -0,0 +1,42 @@
+export type ArtifactOrigin = 'input' | 'result';
+export type ArtifactFetch = typeof fetch;
+export type ImageArtifactCandidate = {
+    origin: ArtifactOrigin;
+    path: string;
+    url: string;
+    mimeType?: string;
+    sha256?: string;
+    width?: number;
+    height?: number;
+};
+export type ResolvedImageArtifact = {
+    origin: ArtifactOrigin;
+    path: string;
+    url: string;
+    mimeType: string;
+    sha256: string;
+    byteLength: number;
+    width?: number;
+    height?: number;
+    dataUrl: string;
+};
+export type ArtifactResolutionFailure = {
+    origin: ArtifactOrigin;
+    path: string;
+    url: string;
+    errors: string[];
+};
+export type ArtifactInspection = {
+    inputImages: ResolvedImageArtifact[];
+    resultImages: ResolvedImageArtifact[];
+    issues: string[];
+};
+type ArtifactResolutionOptions = {
+    fetchImplementation?: ArtifactFetch;
+    maxImageBytes?: number;
+    maxImagesPerOrigin?: number;
+    outputFormat?: string;
+};
+export declare function resolveImageArtifacts(input: unknown, result: unknown, options?: ArtifactResolutionOptions): Promise<ArtifactInspection>;
+export declare function buildArtifactSummary(artifacts: ResolvedImageArtifact[]): string;
+export {};