openapi: 3.2.0
info:
  title: HiveMorph v0.1 Pq API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: pq
paths:
  /v1/smsh/pq/selftest:
    get:
      tags:
      - pq
      summary: Route Pq Selftest
      description: 'Run ML-DSA-65 + ML-KEM-768 roundtrip self-test.

        Returns NIST conformance check and real latencies.

        Tier0 -- free, no auth required.'
      operationId: route_pq_selftest_v1_smsh_pq_selftest_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Route Pq Selftest V1 Smsh Pq Selftest Get
  /v1/smsh/pq/keys/sample:
    get:
      tags:
      - pq
      summary: Route Pq Keys Sample
      description: 'Generate a fresh ML-DSA-65 keypair and return it base64-encoded.

        For demo/integration testing only -- do not use for real key material.

        Tier0 -- free.'
      operationId: route_pq_keys_sample_v1_smsh_pq_keys_sample_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Route Pq Keys Sample V1 Smsh Pq Keys Sample Get
  /v1/smsh/pq/sign:
    post:
      tags:
      - pq
      summary: Route Pq Sign
      description: 'Sign a message with ML-DSA-65.

        Tier1 -- $0.001 per call (requires auth token with signing credits).'
      operationId: route_pq_sign_v1_smsh_pq_sign_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SignRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SignResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/smsh/pq/verify:
    post:
      tags:
      - pq
      summary: Route Pq Verify
      description: 'Verify an ML-DSA-65 signature.

        Tier0 -- free.'
      operationId: route_pq_verify_v1_smsh_pq_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_smsh___pq_routes_patch__VerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/hivemorph__hive_smsh___pq_routes_patch__VerifyResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    SignRequest:
      properties:
        message_b64:
          type: string
          title: Message B64
          description: Base64-encoded message to sign
        sk_b64:
          type: string
          title: Sk B64
          description: Base64-encoded ML-DSA-65 secret key
      type: object
      required:
      - message_b64
      - sk_b64
      title: SignRequest
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    hivemorph__hive_smsh___pq_routes_patch__VerifyRequest:
      properties:
        message_b64:
          type: string
          title: Message B64
          description: Base64-encoded message
        sig_b64:
          type: string
          title: Sig B64
          description: Base64-encoded ML-DSA-65 signature
        pk_b64:
          type: string
          title: Pk B64
          description: Base64-encoded ML-DSA-65 public key
      type: object
      required:
      - message_b64
      - sig_b64
      - pk_b64
      title: VerifyRequest
    hivemorph__hive_smsh___pq_routes_patch__VerifyResponse:
      properties:
        valid:
          type: boolean
          title: Valid
        alg:
          type: string
          title: Alg
        fips:
          type: string
          title: Fips
        backend:
          type: string
          title: Backend
      type: object
      required:
      - valid
      - alg
      - fips
      - backend
      title: VerifyResponse
    SignResponse:
      properties:
        signature_b64:
          type: string
          title: Signature B64
        alg:
          type: string
          title: Alg
        fips:
          type: string
          title: Fips
        backend:
          type: string
          title: Backend
        sig_bytes:
          type: integer
          title: Sig Bytes
      type: object
      required:
      - signature_b64
      - alg
      - fips
      - backend
      - sig_bytes
      title: SignResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError