# ARIA Explorer

> ARIA Explorer is the official block explorer for the ARIAX network — an EVM-compatible chain (chain ID 134235). It lets anyone browse blocks, transactions and addresses, view the rich list and live network metrics, follow recent large transfers, and consume a public read-only JSON API. ARIA / ARIAX is the network's native coin.

ARIA Explorer is a server-rendered PHP application (no SPA framework): every page works without JavaScript, which then progressively enhances it with live feeds, charts and search autocomplete. The explorer is read-only and indexes on-chain data from an ARIAX node over JSON-RPC.

Key facts:
- Native coin: ARIAX (symbol `ARIAX`), max supply 200,000,000.
- Chain ID: 134235 · Network: "ARIAX Mainnet" · Public RPC: https://rpc.ariaexp.com/
- Scope: blocks, transactions, and native-coin transfers/balances only. There are intentionally NO smart-contract, ERC-20 token, or NFT pages.
- Honest data freshness: when the indexer lags the chain tip, the dashboard shows a "Delayed" state with indexed vs. RPC block heights; sections with no data show explicit empty states rather than fabricated values.

## Pages

- [Dashboard](/): network overview panel, one primary activity chart (transactions / active addresses / volume × 24H/7D/30D/90D), latest blocks & transactions, recent large transfers, rich-list preview.
- [Blocks](/blocks): paginated list of blocks.
- [Block detail](/block/{height-or-hash}): a single block and the transactions it contains.
- [Transactions](/txs): paginated list of transactions.
- [Transaction detail](/tx/{hash}): a single transaction (value, fee, from/to, timestamp).
- [Accounts / rich list](/accounts): top holders ranked by balance, with supply-concentration summary (tracked holders, top-10 / top-50 share).
- [Address detail](/address/{address}): balance, activity summary (received/sent/net flow/fees), reconstructed balance history, frequent counterparties, and full transaction history.
- [Search](/search?q={query}): resolves an address, transaction hash or block number to its page.
- [Status](/status): database, indexer and RPC health.
- [API Reference](/api): human-readable documentation of the JSON API.

## JSON API (read-only, public)

Responses are `application/json` with `ETag` / `Cache-Control`; `/api/*` is rate-limited to 120 requests per 60s per IP. List endpoints use keyset paging via `?before=`.

- [GET /api/blocks](/api/blocks): latest blocks (`?before={height}` for older).
- [GET /api/txs](/api/txs): latest transactions (`?before={id}` for older).
- [GET /api/block/{id}](/api/block/1): a single block by height or hash, with its transactions.
- [GET /api/tx/{hash}](/api/tx/0x0): a single transaction.
- [GET /api/address/{address}](/api/address/0x0): address balance and sent/received aggregates.
- [GET /api/address/{address}/balance-history](/api/address/0x0/balance-history?period=30d): daily balance reconstructed from transfers (`period=7d|30d|90d|all`).
- [GET /api/search](/api/search?q=0x): autocomplete suggestions (`q`, minimum 2 chars).
- [GET /api/stats](/api/stats): latest block, totals, live price and market cap.
- [GET /api/network-activity](/api/network-activity?metric=transactions&period=7d): one activity series (`metric=transactions|addresses|volume`, `period=24h|7d|30d|90d`).
- [GET /api/large-transfers](/api/large-transfers): recent native transfers at or above the configured threshold.
- [GET /api/price](/api/price): live ARIAX price and market cap.
- [GET /health](/health): service health — database status, indexer freshness, RPC head/lag, and last finalized/safe blocks.

## Data exports

- [GET /blocks.csv](/blocks.csv): blocks as CSV.
- [GET /address/{address}/txs.csv](/address/0x0/txs.csv): an address's transactions as CSV.

## Documentation

- [RPC API reference (PDF)](/docs/api-documentation): the ARIAX node JSON-RPC reference.
- [Node setup guide (PDF)](/docs/node-setup): running an ARIAX node.