Skip to content

docs: OpenAPI 3.0 spec for RustChain Node API (Bounty #502)#592

Closed
sososonia-cyber wants to merge 6 commits intoScottcjn:mainfrom
sososonia-cyber:feature/rustchain-openapi-docs
Closed

docs: OpenAPI 3.0 spec for RustChain Node API (Bounty #502)#592
sososonia-cyber wants to merge 6 commits intoScottcjn:mainfrom
sososonia-cyber:feature/rustchain-openapi-docs

Conversation

@sososonia-cyber
Copy link
Copy Markdown
Contributor

Summary

Add OpenAPI 3.0 specification for RustChain Node API.

This PR adds comprehensive API documentation in OpenAPI format covering:

  • All REST endpoints
  • Request/response schemas
  • Authentication requirements
  • Example requests

Bounty

This PR addresses issue #502 - OpenAPI Docs (30 RTC)

sososonia-cyber added 6 commits March 6, 2026 09:12
- Added pip-installable Python SDK
- Supports all node API endpoints: health, miners, balance, epoch, eligibility, attestation, transfer
- Async support with aiohttp
- Type hints throughout
- SSL verification toggle (handles self-signed certs)
- Retry logic with exponential backoff
- CLI tool included

Closes Scottcjn#36
- Command-line wallet management tool
- create: Generate new wallet with Ed25519 keys
- list: List all stored wallets
- balance: Check wallet balance via API
- import: Import from mnemonic phrase
- export: Export wallet info
- Uses rustchain_sdk for API calls

Closes Scottcjn#39
- RustChain node metrics exporter for Prometheus
- Metrics: node health, miners, epoch info, miner details
- Supports Grafana integration
- Run as standalone Python script or Docker

Closes Scottcjn#504
- Document all public API endpoints
- Includes health, epoch, miners, lottery, wallet, attestation
- Ready for Swagger UI integration
- Helps developers build tools on RustChain

Closes Scottcjn#502
@github-actions github-actions bot added documentation Improvements or additions to documentation BCOS-L1 Beacon Certified Open Source tier BCOS-L1 (required for non-doc PRs) size/XL PR: 500+ lines labels Mar 6, 2026
@sososonia-cyber
Copy link
Copy Markdown
Contributor Author

Wallet for bounty reward: RTCa95d28a468dd4ba76367483d338b13bcb20499bd

@Scottcjn Scottcjn closed this Mar 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

BCOS-L1 Beacon Certified Open Source tier BCOS-L1 (required for non-doc PRs) documentation Improvements or additions to documentation size/XL PR: 500+ lines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants