@fluxpointstudios/orynq-sdk-midnight-prover 0.1.0

package/dist/midnight/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/midnight/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAWH,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAe9B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAY5B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC"}

package/dist/midnight/proof-server-client.d.ts

@@ -0,0 +1,236 @@
+/**
+ * @fileoverview Midnight proof server client for ZK proof generation.
+ *
+ * Location: packages/midnight-prover/src/midnight/proof-server-client.ts
+ *
+ * Summary:
+ * This module implements the ProofServerClient class which handles communication
+ * with the Midnight proof server for ZK proof generation. It manages connection
+ * lifecycle, proof submission, and result retrieval.
+ *
+ * Usage:
+ * - Used by the DefaultMidnightProver to generate proofs
+ * - Handles connection management and request/response serialization
+ * - Current implementation is a mock for testing; real Midnight integration TBD
+ *
+ * @example
+ * ```typescript
+ * import { ProofServerClient } from './proof-server-client.js';
+ *
+ * const client = new ProofServerClient();
+ * await client.connect(config);
+ *
+ * const result = await client.submitProof('hash-chain', witness, publicInputs);
+ * console.log('Proof generated:', result.proofId);
+ *
+ * await client.disconnect();
+ * ```
+ */
+import type { ProofServerConfig } from "../types.js";
+/**
+ * Result of proof generation from the server.
+ */
+export interface ProofResult {
+    /**
+     * Unique proof identifier.
+     */
+    proofId: string;
+    /**
+     * The generated proof bytes.
+     */
+    proof: Uint8Array;
+    /**
+     * Time taken to generate the proof in milliseconds.
+     */
+    provingTimeMs: number;
+    /**
+     * Size of the proof in bytes.
+     */
+    proofSizeBytes: number;
+    /**
+     * Circuit name used for proof generation.
+     */
+    circuit: string;
+    /**
+     * Server-side metadata.
+     */
+    serverMetadata: {
+        serverId: string;
+        circuitVersion: string;
+        computeTimeMs: number;
+    };
+}
+/**
+ * Circuit information from the server.
+ */
+export interface CircuitInfo {
+    name: string;
+    version: string;
+    constraintCount: number;
+    publicInputCount: number;
+    available: boolean;
+}
+/**
+ * Options for the ProofServerClient.
+ */
+export interface ProofServerClientOptions {
+    /**
+     * Enable debug logging.
+     */
+    debug?: boolean;
+    /**
+     * Simulated proof generation time in milliseconds.
+     * Default: 50ms for fast testing.
+     */
+    simulatedProvingTimeMs?: number;
+}
+/**
+ * ProofServerClient handles communication with the Midnight proof server.
+ *
+ * This class provides:
+ * - Connection management to the proof server
+ * - Proof submission with witness and public inputs
+ * - Circuit information queries
+ *
+ * Current implementation is a mock that simulates proof server behavior.
+ * Real Midnight integration will be added when the Compact runtime is available.
+ *
+ * @example
+ * ```typescript
+ * const client = new ProofServerClient({ debug: true });
+ *
+ * await client.connect({
+ *   proofServerUrl: 'https://proof.midnight.network',
+ *   timeout: 300000,
+ *   retries: 3,
+ * });
+ *
+ * const result = await client.submitProof('hash-chain', witness, publicInputs);
+ * console.log('Generated proof:', result.proofId);
+ *
+ * await client.disconnect();
+ * ```
+ */
+export declare class ProofServerClient {
+    private readonly options;
+    private config;
+    private connected;
+    private serverId;
+    /**
+     * Create a new ProofServerClient instance.
+     *
+     * @param options - Configuration options
+     */
+    constructor(options?: ProofServerClientOptions);
+    /**
+     * Connect to the Midnight proof server.
+     *
+     * @param config - Proof server configuration
+     * @throws MidnightProverException on connection failure
+     */
+    connect(config: ProofServerConfig): Promise<void>;
+    /**
+     * Disconnect from the proof server.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if connected to the proof server.
+     */
+    isConnected(): boolean;
+    /**
+     * Get the current configuration.
+     */
+    getConfig(): ProofServerConfig | undefined;
+    /**
+     * Submit a proof request to the server.
+     *
+     * This method:
+     * 1. Validates the circuit and inputs
+     * 2. Serializes the witness and public inputs
+     * 3. Submits to the proof server
+     * 4. Returns the generated proof
+     *
+     * @param circuit - Circuit name (e.g., "hash-chain", "policy-compliance")
+     * @param witness - Private witness data for the proof
+     * @param publicInputs - Public inputs for the proof
+     * @returns Promise resolving to the proof result
+     * @throws MidnightProverException on failure
+     */
+    submitProof(circuit: string, witness: unknown, publicInputs: unknown): Promise<ProofResult>;
+    /**
+     * Get information about a circuit.
+     *
+     * @param circuitName - Name of the circuit
+     * @returns Circuit information
+     */
+    getCircuitInfo(circuitName: string): Promise<CircuitInfo>;
+    /**
+     * List all available circuits.
+     *
+     * @returns Array of circuit names
+     */
+    listCircuits(): Promise<string[]>;
+    /**
+     * Check if a circuit is available.
+     *
+     * @param circuit - Circuit name or proof type
+     * @returns True if the circuit is available
+     */
+    isCircuitAvailable(circuit: string): Promise<boolean>;
+    /**
+     * Ensure connected before operations.
+     */
+    private ensureConnected;
+    /**
+     * Validate server configuration.
+     */
+    private validateConfig;
+    /**
+     * Resolve circuit name from proof type or direct name.
+     */
+    private resolveCircuitName;
+    /**
+     * Serialize input data for transmission.
+     */
+    private serializeInput;
+    /**
+     * Simulate proof generation delay.
+     */
+    private simulateProofGeneration;
+    /**
+     * Generate a mock proof.
+     */
+    private generateMockProof;
+    /**
+     * Generate a proof ID.
+     */
+    private generateProofId;
+    /**
+     * Hash bytes to hex string.
+     */
+    private hashBytes;
+    /**
+     * Convert hex string to bytes.
+     */
+    private hexToBytes;
+    /**
+     * Simulate network delay.
+     */
+    private simulateNetworkDelay;
+    /**
+     * Delay helper.
+     */
+    private delay;
+    /**
+     * Debug logging helper.
+     */
+    private debug;
+}
+/**
+ * Create a new ProofServerClient instance.
+ *
+ * @param options - Configuration options
+ * @returns New ProofServerClient instance
+ */
+export declare function createProofServerClient(options?: ProofServerClientOptions): ProofServerClient;
+//# sourceMappingURL=proof-server-client.d.ts.map

package/dist/midnight/proof-server-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proof-server-client.d.ts","sourceRoot":"","sources":["../../src/midnight/proof-server-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAa,MAAM,aAAa,CAAC;AAahE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAE,UAAU,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAiBD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAqB;IAErC;;;;OAIG;gBACS,OAAO,GAAE,wBAA6B;IAOlD;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCvD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,SAAS,IAAI,iBAAiB,GAAG,SAAS;IAI1C;;;;;;;;;;;;;;OAcG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,WAAW,CAAC;IAoEvB;;;;;OAKG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA+C/D;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQvC;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU3D;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;YACW,uBAAuB;IAOrC;;OAEG;YACW,iBAAiB;IA0C/B;;OAEG;YACW,eAAe;IAK7B;;OAEG;YACW,SAAS;IAWvB;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;YACW,oBAAoB;IAKlC;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,KAAK;CAKd;AAMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,CAAC,EAAE,wBAAwB,GACjC,iBAAiB,CAEnB"}

package/dist/midnight/proof-server-client.js

@@ -0,0 +1,422 @@
+/**
+ * @fileoverview Midnight proof server client for ZK proof generation.
+ *
+ * Location: packages/midnight-prover/src/midnight/proof-server-client.ts
+ *
+ * Summary:
+ * This module implements the ProofServerClient class which handles communication
+ * with the Midnight proof server for ZK proof generation. It manages connection
+ * lifecycle, proof submission, and result retrieval.
+ *
+ * Usage:
+ * - Used by the DefaultMidnightProver to generate proofs
+ * - Handles connection management and request/response serialization
+ * - Current implementation is a mock for testing; real Midnight integration TBD
+ *
+ * @example
+ * ```typescript
+ * import { ProofServerClient } from './proof-server-client.js';
+ *
+ * const client = new ProofServerClient();
+ * await client.connect(config);
+ *
+ * const result = await client.submitProof('hash-chain', witness, publicInputs);
+ * console.log('Proof generated:', result.proofId);
+ *
+ * await client.disconnect();
+ * ```
+ */
+import { MidnightProverError, MidnightProverException, } from "../types.js";
+import { sha256StringHex, canonicalize } from "@fluxpointstudios/orynq-sdk-core/utils";
+/**
+ * Circuit names for different proof types.
+ */
+const CIRCUIT_NAMES = {
+    "hash-chain": "poi_hash_chain_v1",
+    "policy-compliance": "poi_policy_compliance_v1",
+    "attestation-valid": "poi_attestation_v1",
+    "selective-disclosure": "poi_disclosure_v1",
+    "zkml-inference": "poi_inference_v1",
+};
+// =============================================================================
+// PROOF SERVER CLIENT
+// =============================================================================
+/**
+ * ProofServerClient handles communication with the Midnight proof server.
+ *
+ * This class provides:
+ * - Connection management to the proof server
+ * - Proof submission with witness and public inputs
+ * - Circuit information queries
+ *
+ * Current implementation is a mock that simulates proof server behavior.
+ * Real Midnight integration will be added when the Compact runtime is available.
+ *
+ * @example
+ * ```typescript
+ * const client = new ProofServerClient({ debug: true });
+ *
+ * await client.connect({
+ *   proofServerUrl: 'https://proof.midnight.network',
+ *   timeout: 300000,
+ *   retries: 3,
+ * });
+ *
+ * const result = await client.submitProof('hash-chain', witness, publicInputs);
+ * console.log('Generated proof:', result.proofId);
+ *
+ * await client.disconnect();
+ * ```
+ */
+export class ProofServerClient {
+    options;
+    config;
+    connected = false;
+    serverId;
+    /**
+     * Create a new ProofServerClient instance.
+     *
+     * @param options - Configuration options
+     */
+    constructor(options = {}) {
+        this.options = {
+            debug: options.debug ?? false,
+            simulatedProvingTimeMs: options.simulatedProvingTimeMs ?? 50,
+        };
+    }
+    /**
+     * Connect to the Midnight proof server.
+     *
+     * @param config - Proof server configuration
+     * @throws MidnightProverException on connection failure
+     */
+    async connect(config) {
+        this.debug(`Connecting to proof server at ${config.proofServerUrl}...`);
+        try {
+            // Validate configuration
+            this.validateConfig(config);
+            // Simulate connection establishment
+            await this.simulateNetworkDelay(30);
+            // In production, this would establish a WebSocket or HTTP connection
+            // and perform any necessary handshaking/authentication
+            if (config.apiKey) {
+                this.debug("Authenticating with API key...");
+                await this.simulateNetworkDelay(20);
+            }
+            // Generate a mock server ID
+            this.serverId = `server-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+            this.config = config;
+            this.connected = true;
+            this.debug(`Connected to proof server (serverId: ${this.serverId})`);
+        }
+        catch (error) {
+            if (error instanceof MidnightProverException) {
+                throw error;
+            }
+            throw new MidnightProverException(MidnightProverError.CONNECTION_FAILED, `Failed to connect to proof server: ${String(error)}`, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Disconnect from the proof server.
+     */
+    async disconnect() {
+        if (this.connected) {
+            this.debug("Disconnecting from proof server...");
+            await this.simulateNetworkDelay(10);
+            this.connected = false;
+            this.config = undefined;
+            this.serverId = undefined;
+            this.debug("Disconnected");
+        }
+    }
+    /**
+     * Check if connected to the proof server.
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Get the current configuration.
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Submit a proof request to the server.
+     *
+     * This method:
+     * 1. Validates the circuit and inputs
+     * 2. Serializes the witness and public inputs
+     * 3. Submits to the proof server
+     * 4. Returns the generated proof
+     *
+     * @param circuit - Circuit name (e.g., "hash-chain", "policy-compliance")
+     * @param witness - Private witness data for the proof
+     * @param publicInputs - Public inputs for the proof
+     * @returns Promise resolving to the proof result
+     * @throws MidnightProverException on failure
+     */
+    async submitProof(circuit, witness, publicInputs) {
+        this.ensureConnected();
+        const circuitName = this.resolveCircuitName(circuit);
+        this.debug(`Submitting proof request for circuit: ${circuitName}`);
+        const startTime = Date.now();
+        try {
+            // Validate circuit exists
+            const circuitInfo = await this.getCircuitInfo(circuitName);
+            if (!circuitInfo.available) {
+                throw new MidnightProverException(MidnightProverError.CIRCUIT_NOT_FOUND, `Circuit '${circuitName}' is not available`);
+            }
+            // Serialize inputs
+            const serializedWitness = this.serializeInput(witness);
+            const serializedPublicInputs = this.serializeInput(publicInputs);
+            this.debug(`Witness size: ${serializedWitness.length} bytes`);
+            this.debug(`Public inputs size: ${serializedPublicInputs.length} bytes`);
+            // Simulate proof generation
+            await this.simulateProofGeneration();
+            // Generate mock proof
+            const proof = await this.generateMockProof(circuitName, serializedWitness, serializedPublicInputs);
+            const provingTimeMs = Date.now() - startTime;
+            // Generate proof ID
+            const proofId = await this.generateProofId(proof);
+            const result = {
+                proofId,
+                proof,
+                provingTimeMs,
+                proofSizeBytes: proof.length,
+                circuit: circuitName,
+                serverMetadata: {
+                    serverId: this.serverId ?? "unknown",
+                    circuitVersion: circuitInfo.version,
+                    computeTimeMs: this.options.simulatedProvingTimeMs,
+                },
+            };
+            this.debug(`Proof generated: ${proofId} (${provingTimeMs}ms)`);
+            return result;
+        }
+        catch (error) {
+            if (error instanceof MidnightProverException) {
+                throw error;
+            }
+            throw new MidnightProverException(MidnightProverError.PROOF_GENERATION_FAILED, `Proof generation failed: ${String(error)}`, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Get information about a circuit.
+     *
+     * @param circuitName - Name of the circuit
+     * @returns Circuit information
+     */
+    async getCircuitInfo(circuitName) {
+        this.ensureConnected();
+        await this.simulateNetworkDelay(20);
+        // Mock circuit information
+        const baseCircuitInfo = {
+            version: "1.0.0",
+            constraintCount: 1000000,
+            publicInputCount: 10,
+            available: true,
+        };
+        // Circuit-specific information
+        const circuitConfigs = {
+            poi_hash_chain_v1: {
+                constraintCount: 500000,
+                publicInputCount: 3,
+            },
+            poi_policy_compliance_v1: {
+                constraintCount: 750000,
+                publicInputCount: 5,
+            },
+            poi_attestation_v1: {
+                constraintCount: 600000,
+                publicInputCount: 4,
+            },
+            poi_disclosure_v1: {
+                constraintCount: 400000,
+                publicInputCount: 3,
+            },
+            poi_inference_v1: {
+                constraintCount: 10000000, // Very large for zkML
+                publicInputCount: 5,
+                available: false, // Mark as unavailable by default
+            },
+        };
+        const specificConfig = circuitConfigs[circuitName] ?? {};
+        return {
+            name: circuitName,
+            ...baseCircuitInfo,
+            ...specificConfig,
+        };
+    }
+    /**
+     * List all available circuits.
+     *
+     * @returns Array of circuit names
+     */
+    async listCircuits() {
+        this.ensureConnected();
+        await this.simulateNetworkDelay(15);
+        return Object.values(CIRCUIT_NAMES);
+    }
+    /**
+     * Check if a circuit is available.
+     *
+     * @param circuit - Circuit name or proof type
+     * @returns True if the circuit is available
+     */
+    async isCircuitAvailable(circuit) {
+        const circuitName = this.resolveCircuitName(circuit);
+        const info = await this.getCircuitInfo(circuitName);
+        return info.available;
+    }
+    // ===========================================================================
+    // PRIVATE METHODS
+    // ===========================================================================
+    /**
+     * Ensure connected before operations.
+     */
+    ensureConnected() {
+        if (!this.connected) {
+            throw new MidnightProverException(MidnightProverError.CONNECTION_FAILED, "Not connected to proof server. Call connect() first.");
+        }
+    }
+    /**
+     * Validate server configuration.
+     */
+    validateConfig(config) {
+        if (!config.proofServerUrl) {
+            throw new MidnightProverException(MidnightProverError.INVALID_INPUT, "Proof server URL is required");
+        }
+        if (config.timeout !== undefined && config.timeout <= 0) {
+            throw new MidnightProverException(MidnightProverError.INVALID_INPUT, "Timeout must be positive");
+        }
+        if (config.retries !== undefined && config.retries < 0) {
+            throw new MidnightProverException(MidnightProverError.INVALID_INPUT, "Retries must be non-negative");
+        }
+    }
+    /**
+     * Resolve circuit name from proof type or direct name.
+     */
+    resolveCircuitName(circuit) {
+        // Check if it's a proof type
+        const proofType = circuit;
+        if (proofType in CIRCUIT_NAMES) {
+            return CIRCUIT_NAMES[proofType];
+        }
+        // Assume it's already a circuit name
+        return circuit;
+    }
+    /**
+     * Serialize input data for transmission.
+     */
+    serializeInput(input) {
+        const jsonString = canonicalize(input);
+        return new TextEncoder().encode(jsonString);
+    }
+    /**
+     * Simulate proof generation delay.
+     */
+    async simulateProofGeneration() {
+        // Add some variance to simulate real proof generation
+        const variance = Math.random() * 0.2 - 0.1; // +/- 10%
+        const delay = this.options.simulatedProvingTimeMs * (1 + variance);
+        await this.delay(delay);
+    }
+    /**
+     * Generate a mock proof.
+     */
+    async generateMockProof(circuitName, witness, publicInputs) {
+        // Create a deterministic mock proof based on inputs
+        const witnessHash = await this.hashBytes(witness);
+        const publicInputsHash = await this.hashBytes(publicInputs);
+        // Mock proof structure:
+        // - Magic header (16 bytes): "MOCK-MIDNIGHT-V1"
+        // - Circuit name hash (32 bytes)
+        // - Witness commitment (32 bytes)
+        // - Public inputs commitment (32 bytes)
+        // - Random padding (144 bytes)
+        // Total: 256 bytes
+        const proof = new Uint8Array(256);
+        const header = new TextEncoder().encode("MOCK-MIDNIGHT-V1");
+        proof.set(header, 0);
+        // Circuit name hash
+        const circuitHash = await sha256StringHex(circuitName);
+        const circuitHashBytes = this.hexToBytes(circuitHash);
+        proof.set(circuitHashBytes, 16);
+        // Witness commitment
+        const witnessBytes = this.hexToBytes(witnessHash);
+        proof.set(witnessBytes, 48);
+        // Public inputs commitment
+        const publicInputsBytes = this.hexToBytes(publicInputsHash);
+        proof.set(publicInputsBytes, 80);
+        // Random padding
+        const randomPadding = new Uint8Array(144);
+        crypto.getRandomValues(randomPadding);
+        proof.set(randomPadding, 112);
+        return proof;
+    }
+    /**
+     * Generate a proof ID.
+     */
+    async generateProofId(proof) {
+        const hash = await this.hashBytes(proof);
+        return `proof-${hash.slice(0, 16)}`;
+    }
+    /**
+     * Hash bytes to hex string.
+     */
+    async hashBytes(data) {
+        // Create a copy to ensure ArrayBuffer type compatibility
+        const buffer = new ArrayBuffer(data.length);
+        new Uint8Array(buffer).set(data);
+        const hashBuffer = await crypto.subtle.digest("SHA-256", buffer);
+        const hashArray = new Uint8Array(hashBuffer);
+        return Array.from(hashArray)
+            .map((b) => b.toString(16).padStart(2, "0"))
+            .join("");
+    }
+    /**
+     * Convert hex string to bytes.
+     */
+    hexToBytes(hex) {
+        const bytes = new Uint8Array(hex.length / 2);
+        for (let i = 0; i < hex.length; i += 2) {
+            bytes[i / 2] = parseInt(hex.slice(i, i + 2), 16);
+        }
+        return bytes;
+    }
+    /**
+     * Simulate network delay.
+     */
+    async simulateNetworkDelay(baseMs) {
+        const jitter = Math.random() * baseMs * 0.2;
+        await this.delay(baseMs + jitter);
+    }
+    /**
+     * Delay helper.
+     */
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Debug logging helper.
+     */
+    debug(message) {
+        if (this.options.debug) {
+            console.log(`[ProofServerClient] ${message}`);
+        }
+    }
+}
+// =============================================================================
+// FACTORY FUNCTION
+// =============================================================================
+/**
+ * Create a new ProofServerClient instance.
+ *
+ * @param options - Configuration options
+ * @returns New ProofServerClient instance
+ */
+export function createProofServerClient(options) {
+    return new ProofServerClient(options);
+}
+//# sourceMappingURL=proof-server-client.js.map

package/dist/midnight/proof-server-client.js.map

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