Catalyst Block Explorer (new)

Modern replacement explorer + indexer for the Catalyst V2 node (Rust).

This repo is designed to be compatible with the current testnet RPC surface described in:

• catalyst-node-rust/docs/explorer-handoff.md
• catalyst-node-rust/crates/catalyst-rpc/src/lib.rs

Quick start

Prereqs

• Node.js 22+
• A running Catalyst node with HTTP JSON-RPC (e.g. http://127.0.0.1:8545)

Install

npm install

Configure

Copy env examples:

cp apps/indexer/.env.example apps/indexer/.env
cp apps/web/.env.example apps/web/.env

Edit apps/indexer/.env and set RPC_URL to your node.

Run (indexer + web)

npm run dev

• Indexer/API: http://localhost:4040
• Web UI: http://localhost:5173

What’s included (MVP)

• Latest blocks (consensus cycles), block detail, tx detail, address detail
• SQLite-backed indexing loop using catalyst_getBlocksByNumberRange + catalyst_getTransactionReceipt
• Rate-limit backoff support for RPC error code -32029