Public Explorer Surfaces
Explorers should use public REST and public-safe RPC for blocks, transactions, receipts, logs, address summaries, validators, finalized head, runtime capabilities, runtime readiness, network health, confidence, and watchtower status.
Explorer documentation must not imply private/admin RPC access. Honeytrap status is trusted diagnostics; watchtower status is public-safe in the current contract.
| Route | Method | Public profile behavior | Category | Notes |
|---|---|---|---|---|
/api/v1/address/:addr | GET | Public profile can mask, bound, or deny according to privacy policy. | AddressSensitive | privacy policy can mask or deny |
/api/v1/address/:addr/txs | GET | Public profile can mask, bound, or deny according to privacy policy. | AddressSensitive | privacy policy can mask or deny |
/api/v1/block/hash/:hash | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/block/hash/:hash/txs | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/block/height/:height | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/block/height/:height/txs | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/blocks | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/bootnodes | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/canonical/height/:height | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/checkpoint/history | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/checkpoint/latest | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/confidence | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/fees | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/fees/forecast | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/finality/estimate | POST | Public-safe diagnostic summary; safe mode and quotas still apply. | DiagnosticsSafe | public-safe contract route |
/api/v1/finalized | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/fork/tips | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/forks/height/:height | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/head | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/head/stream | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/health | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/intents/validate | POST | Public-safe diagnostic summary; safe mode and quotas still apply. | DiagnosticsSafe | public-safe contract route |
/api/v1/logs | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/network/health | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/network/risk | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/nodes | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/pq/compliance-report | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/pq/maturity | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/ready | GET | Minimal public status or compatibility surface. | Minimal | local runtime readiness, not release approval |
/api/v1/receipt/:hash | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/receipt/:hash/finality-bundle | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/receipts | POST | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/reorgs | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/reorgs/:id | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/route/hints | POST | Public-safe diagnostic summary; safe mode and quotas still apply. | DiagnosticsSafe | public-safe contract route |
/api/v1/search | GET | Public profile can mask, bound, or deny according to privacy policy. | AddressSensitive | privacy policy can mask or deny |
/api/v1/stats | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/tx/:hash | GET | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/txbundle | POST | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/txs | GET, POST | Public read surface, subject to quotas and runtime safety gates. | PublicChainRead | public-safe contract route |
/api/v1/validators | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |
/api/v1/watchtower/status | GET | Minimal public status or compatibility surface. | Minimal | public-safe contract route |