# Solar Legality Oracle

> Pay-per-call US 50-state plug-in / balcony solar legality for AI agents: per-state legal status,
> utilities, and enacted legislation. Signed responses, x402 on Base (USDC). Data CC BY 4.0 (PlugInSolarHub).

## Endpoints
- GET /solar-legality?state=<slug|name> — paid $0.005 (USDC on Base via x402), signed record + legal_status
- GET /solar-legality/all — paid $0.02, signed full 50-state dataset
- GET /solar-legality/preview?state=<slug> — free, unsigned, rate-limited (state + badge + legal_status)
- GET /health — liveness + states_count + last_updated
- GET /provable/head — hash-chain head + count
- GET /provable/verify — re-hash and verify the whole paid-query chain
- GET /.well-known/x402 — machine-readable manifest

## legal_status enum
legal_signed | passed_pending | gray_area | permissive | other  (kept alongside the verbatim badge)

## Data
- 50 US states; last_updated 2026-07-02; source https://pluginsolarhub.org/state-legality/.
- License CC BY 4.0 — attribution PlugInSolarHub (pluginsolarhub.org). Educational; not legal advice.

## Proof
Every paid query is appended to a tamper-evident sha256 hash chain; walk it from /provable/head and
check each link with /provable/verify. Every paid response carries signed_by + signature.