Skip to content

feat: add OpenAPI 3.0 spec for miner HTTP endpoints#35

Open
pvbang wants to merge 1 commit into
Dipraise1:mainfrom
pvbang:feat/openapi-spec-issue-23
Open

feat: add OpenAPI 3.0 spec for miner HTTP endpoints#35
pvbang wants to merge 1 commit into
Dipraise1:mainfrom
pvbang:feat/openapi-spec-issue-23

Conversation

@pvbang

@pvbang pvbang commented Jun 13, 2026

Copy link
Copy Markdown

Summary

This PR adds a comprehensive OpenAPI 3.0.3 specification for all 24 miner HTTP endpoints, addressing issue #23.

Changes

docs/openapi.yaml — Full OpenAPI 3.0.3 Specification

  • Documents all 24 HTTP routes registered in neurons/miner.py
  • Includes request/response schemas with field descriptions
  • Documents sr25519 signature-based authentication scheme

docs/index.html — Redoc Rendered Documentation

  • Single-page HTML that renders the spec using Redoc

scripts/check_openapi_sync.py — CI Sync Check

  • Parses neurons/miner.py to extract all app.router.add_*() routes
  • Compares against paths in docs/openapi.yaml
  • Exits non-zero if any route is undocumented

Closes #23

- Add comprehensive OpenAPI 3.0.3 spec covering all 24 miner HTTP routes
- Include auth scheme docs (sr25519 signed-challenge headers)
- Add Redoc page under docs/ for rendered API documentation
- Add CI sync check script (scripts/check_openapi_sync.py)

Covers: IngestSynapse, QuerySynapse, ChallengeSynapse, RepairSynapse,
KeyShareSynapse, KeyShareRetrieve, namespace management, attestation,
chat history, conversations, memory CRUD, wallet stats, metagraph,
metrics, commitment, and prove-memory endpoints.

Closes Dipraise1#23
@vercel

vercel Bot commented Jun 13, 2026

Copy link
Copy Markdown

Someone is attempting to deploy a commit to the praise's projects Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[docs] OpenAPI spec for miner HTTP endpoints

1 participant