# RigGrade

> Independent grading of rented or hosted GPU rigs. A free one-minute preflight check, and a paid grade (x402, USDC on Base) measured against published bars for the GPU's peer class. Measured, not promised.

Sale: on. Prices: 3 USDC per workload class for consumer cards, 5 USDC for data-centre cards, paid by x402 (USDC on Base) from the buyer's own wallet. While a GPU class has no reference yet (fewer than 5 rigs), each rig's first session there is free.

## Endpoints
- Service descriptor (JSON, includes reasons the sale is off and which products are on): https://riggrade-674098696181.us-central1.run.app/riggrade/v1
- Host fix-it report, 2 USDC: POST https://riggrade-674098696181.us-central1.run.app/riggrade/v1/fixit with {preflight_report}
- Cluster acceptance certificate, 25 USDC: POST https://riggrade-674098696181.us-central1.run.app/riggrade/v1/cluster/acceptance with {evidence_pack}
- Browser checkout for people (the same routes, paid from your own wallet): https://riggrade-674098696181.us-central1.run.app/riggrade/v1/checkout
- Rental check, free: POST https://riggrade-674098696181.us-central1.run.app/riggrade/v1/rental/plan before renting, then run the preflight and POST its report to https://riggrade-674098696181.us-central1.run.app/riggrade/v1/rental/check for keep, keep with warnings or cancel
- Free GPU price index (latest listed on-demand price per class, weekly): GET https://riggrade-674098696181.us-central1.run.app/riggrade/v1/index
- Pooled preflight results per class (opt in with --share; aggregates at GET https://riggrade-674098696181.us-central1.run.app/riggrade/v1/index/quality once published)
- OpenAPI: https://riggrade-674098696181.us-central1.run.app/riggrade/v1/openapi.json
- Agent card: https://riggrade-674098696181.us-central1.run.app/.well-known/agent.json
- Certificate signing keys (Ed25519, verify offline): https://riggrade-674098696181.us-central1.run.app/.well-known/riggrade-keys.json

## Code and docs
- Repository (Apache-2.0): https://github.com/nnyycc77-ship-it/riggrade
- Grading spec: https://github.com/nnyycc77-ship-it/riggrade/blob/main/docs/grading-spec.md
- Payments: https://github.com/nnyycc77-ship-it/riggrade/blob/main/docs/payments.md
- Benchmark container: ghcr.io/nnyycc77-ship-it/riggrade-bench (run by digest; see container/bench-image.env)
- Install: pip install riggrade (PyPI); commands riggrade-preflight, riggrade-mcp, riggrade-verify
- MCP server (stdio): riggrade-mcp (python3 -m riggrade.mcp), tools gpu_preflight, gpu_price_index, verify_certificate and riggrade_service_info