Explorer and Analytics APIs¶
The PQWERAI explorer (pqwexplorer) indexes the chain using read-only JSON-RPC, reconciles its totals exactly with
Core, and serves HTML pages plus a read-only JSON API.
| API | GET /api/v1/…, JSON, unauthenticated, read-only — reference |
| Schema | OpenAPI 3.1 · Postman collection |
| Contract test | scripts/devhub/explorer_contract_test.py: 35/35 PASS against a live index of the local testnet |
| Storage | SQLite (tested) or PostgreSQL (implemented, not yet executed) |
| Public endpoint | Not available yet — explorer.pqwerai.com is reserved; run the explorer locally |
Coverage¶
| Data | Endpoint |
|---|---|
| Blocks, transactions (with receipt status and token transfers), accounts | /blocks, /block/{key}, /tx/{hash}, /address/{address} |
| ERC-20 / ERC-721 tokens | /tokens |
| Smartnode validators, finality checkpoints | /validators, /checkpoints |
| Exact supply and per-block issuance (79.2/19.8/1) | /supply, /issuance |
| GhostRider mining statistics | /mining |
| AI-market events (escrow, registry, jobs) | /ai/events |
| Indexer health, freshness, chain identity, alarms | /status |
Semantics (freshness, reorganisations, pagination, errors): Data semantics.
Run it locally¶
pip install -r explorer/requirements.txt
cd explorer
python -m pqwexplorer all --rpc http://127.0.0.1:8545 --db sqlite:explorer.db \
--genesis /etc/pqwerai/network/genesis.json --bind 127.0.0.1 --port 8089
curl -s http://127.0.0.1:8089/api/v1/status
python -m pqwexplorer reconcile --rpc http://127.0.0.1:8545 --db sqlite:explorer.db # exit 0 only if exact
The explorer source is in the PQWERAI-testnet repository (explorer/); it is not yet published separately.
Sources at 72057fe3ec: explorer/README.md · explorer/openapi.yaml · scripts/devhub/explorer_contract_test.py
Found a problem? Report a documentation issue · Build testnet-rc1+72057fe3ec