proof-server:proof-server-api

What problem does it solve?

This Skill provides a clear, developer-focused HTTP API reference for the Midnight proof server, removing ambiguity around endpoints, binary serialization, readiness semantics, and error handling so integrators can call proving endpoints reliably.

Core Features & Use Cases

• Endpoint Reference: Detailed descriptions for /, /health, /ready, /version, /proof-versions, /prove, /prove-tx (deprecated), /check, /k, and /fetch-params including methods, request and response formats, and expected status codes.
• Binary Serialization & Error Handling: Explains the midnight-serialize tagged binary format used by proving endpoints, plain text versus JSON responses, error codes (400, 429, 500), and CORS policy considerations.
• Operational Guidance: Readiness metrics, worker utilization, job queue capacity semantics, and parameter pre-warming workflows for production and development deployments.
• Use Case: Integrate the proof server with a DApp or wallet SDK to generate ZK proofs, validate preimages, pre-warm public parameters for specific k-values, and implement load-balancing health checks.

Quick Start

Show me how to call the proof server /prove endpoint with a serialized proof preimage to generate a ZK proof and interpret the binary response.