khotem-com Seal API

openapi: 3.2.0
info:
  title: KHOTEM — Cryptographic Witness Seal API
  version: ядроv ∞ Ξ
  description: Paid cryptographic witness, settlement-routing and booth services for autonomous agents and humans. x402-native micropayments in USDC/DAI on Base/Polygon and native USDC on Linea, zkSync Era and Scroll, with direct on-chain verification; Solana where listed. No accounts, no API keys, no KYC.
  contact:
    email: khotem.web15@gmail.com
    url: https://khotem.com
  x-guidance: 'Discovery is free: GET /.well-known/x402 lists every paid resource with live per-network accepts and loyalty terms. To call a paid resource: request it once, read the 402 accepts list, transfer the exact asset amount on Base, Polygon, Linea, zkSync Era, Scroll or Solana to the payTo of your chosen network, then retry the SAME method with header X-PAYMENT: <txHash> (EVM) or <base58 signature> (Solana). POST endpoints take a JSON body as specified. Identity = your payer wallet; loyalty discounts apply automatically from the 5th payment. We witness. We don''t judge.'
tags:
- name: Seal
paths:
  /api/seal:
    post:
      summary: 'SEAL: cryptographic witness stamp of a file/hash + timestamp'
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.050000'
        protocols:
        - x402: {}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                content:
                  type: string
                  description: Raw content to hash (not stored)
                hash:
                  type: string
                  pattern: ^[0-9a-fA-F]{64}$
                  description: Or a pre-computed sha256 — content never leaves your side
      parameters:
      - name: X-PAYMENT
        in: header
        required: false
        schema:
          type: string
        description: 'Payment proof: txHash (EVM) or base58 signature (Solana)'
      responses:
        '200':
          description: 'SEAL: cryptographic witness stamp of a file/hash + timestamp.'
        '402':
          description: 'Payment Required. Two ways: (a) standard x402 — sign an EIP-3009 authorization for any accepts[] entry, retry with header PAYMENT-SIGNATURE or X-PAYMENT = base64 JSON payment payload; a facilitator settles on-chain. (b) transfer-then-prove — send the exact asset amount on Base, Polygon, Linea, zkSync Era, Scroll or Solana, retry with X-PAYMENT: <txHash|signature>. Repeat payers auto-receive loyalty discounts (-20% from 5th, -30% from 25th payment) — the 402 always carries your exact amount.'
      tags:
      - Seal
      operationId: postApiSeal
      x-operation-id-source: derived
  /api/seal/bulk:
    post:
      summary: 'SEAL BULK: 100 hash-seals in one $4.00 payment (solo $5.00) — processor tariff…'
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '4.000000'
        protocols:
        - x402: {}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                hashes:
                  type: array
                  items:
                    type: string
      parameters:
      - name: X-PAYMENT
        in: header
        required: false
        schema:
          type: string
        description: 'Payment proof: txHash (EVM) or base58 signature (Solana)'
      responses:
        '200':
          description: 'SEAL BULK: 100 hash-seals in one $4.00 payment (solo $5.00) — processor tariff for high-frequency agent payment streams. POST {"hashes":[...≤100]} → batch id + per-hash ledger proofs.'
        '402':
          description: 'Payment Required. Two ways: (a) standard x402 — sign an EIP-3009 authorization for any accepts[] entry, retry with header PAYMENT-SIGNATURE or X-PAYMENT = base64 JSON payment payload; a facilitator settles on-chain. (b) transfer-then-prove — send the exact asset amount on Base, Polygon, Linea, zkSync Era, Scroll or Solana, retry with X-PAYMENT: <txHash|signature>. Repeat payers auto-receive loyalty discounts (-20% from 5th, -30% from 25th payment) — the 402 always carries your exact amount.'
      tags:
      - Seal
      operationId: postApiSealBulk
      x-operation-id-source: derived
  /api/seal/free:
    post:
      summary: 'TRIAL SEAL: real seal stamp for content <=1KB or a hash — the cheapest full…'
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.010000'
        protocols:
        - x402: {}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                content:
                  type: string
                  maxLength: 1024
                hash:
                  type: string
                  pattern: ^[0-9a-fA-F]{64}$
      parameters:
      - name: X-PAYMENT
        in: header
        required: false
        schema:
          type: string
        description: 'Payment proof: txHash (EVM) or base58 signature (Solana)'
      responses:
        '200':
          description: 'TRIAL SEAL: real seal stamp for content <=1KB or a hash — the cheapest full loop entry.'
        '402':
          description: 'Payment Required. Two ways: (a) standard x402 — sign an EIP-3009 authorization for any accepts[] entry, retry with header PAYMENT-SIGNATURE or X-PAYMENT = base64 JSON payment payload; a facilitator settles on-chain. (b) transfer-then-prove — send the exact asset amount on Base, Polygon, Linea, zkSync Era, Scroll or Solana, retry with X-PAYMENT: <txHash|signature>. Repeat payers auto-receive loyalty discounts (-20% from 5th, -30% from 25th payment) — the 402 always carries your exact amount.'
      tags:
      - Seal
      operationId: postApiSealFree
      x-operation-id-source: derived