What it shows
The explorer is a read-only page with recent blocks and transactions from the public devnet.
- Status row. Network (Live or Paused), tip slot, finalized slot, block height, average slot time, the number of active validators, and when the feed was last updated.
- Latest blocks. Slot, blockhash, age, number of transactions and number of non-vote transactions.
- Latest transactions. Signature, slot, age, result, fee in ZOL, and kind. The kind is either Vote or Program.
- Search. A slot number, or at least four characters from the start of a blockhash or signature.
A shielded payment appears as an ordinary Program transaction with its signature, slot, result and fee. The page states the rest itself: “Private payment amounts and participants are not public.”
Live and Paused
The page shows Live only when the feed reports the network as live and the feed is at most 30 seconds old. Otherwise it shows Paused and keeps the last recorded blocks, with the notice “The network is paused between windows. Showing the last recorded blocks.”
If the page cannot refresh its data it says so instead: “Explorer data could not be refreshed. Showing the last recorded blocks.”
The recent-window limit
The explorer covers only a recent window: at most 120 blocks and 200 transactions. There is no deep history, and search only looks inside that window. Full history search is in progress.
Vote transactions are listed only while fewer than 20 non-vote transactions are in the window.
A search that finds nothing answers “No matching block or transaction. Only the recent window is searchable for now.” That means the item is not in the window, not that it does not exist on chain.
How the signed feed works
The page never queries a validator. It reads one JSON file from its own origin. That file is produced and moved by two small services in the repository:
- The feed service runs next to the validators. It polls a fixed allowlist of read-only RPC methods (
getGenesisHash,getSlot,getBlockHeight,getBlocks,getBlock,getVoteAccounts,getHealth) and keeps a rolling window. It writesfeed.jsonandfeed.sig, an HMAC-SHA256 signature over the exact bytes of the feed, and serves the two files only to an allowlisted address. - The puller runs on the web host. It fetches both files, checks the signature with the shared key, validates the document strictly against the feed format, and only then publishes the verified bytes with an atomic rename. It never publishes an older feed over a newer one, and any failure leaves the published file untouched.
- The page reads the published file every five seconds, validates every value again before use, and shows Live or Paused from the feed’s age.
The feed format is named zolana-explorer-feed-v0. It contains block and transaction metadata only: slots, hashes, times, counts, signatures, results, fees, and for validators an identity, a vote account and a last vote. It carries no transaction contents.
Why it never talks to validators directly
- Validator RPC is not public. The feed exists, in the words of its README, to let “a static web page show recent blocks from the public devnet without exposing validator RPC”.
- The site forbids it. This site’s content security policy allows scripts and network requests to its own origin only. The page cannot call another host.
- A small, fixed surface. The feed service can only call the seven read-only methods above. Nothing a visitor types reaches a validator.
What the feed does not prove
The signature protects one hop: it shows the web host received the bytes that the feed service produced. The key is shared between two hosts run by the project, so a visitor cannot check the signature, and it is not a proof of consensus. The explorer is the project’s own view of its network.
Source and tests
The services are in tools/devnet_explorer and the page in clients/devnet-explorer. Their tests run without a network:
cd tools/devnet_explorer
python3 -B -m unittest test_explorer_feed_v0 test_rpc_env
python3 -B test_explorer_pull_v0.py
cd ../../clients/devnet-explorer
node explorer_logic_test.js