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+
• Catalyst testnet HTTPS JSON-RPC (TLS) via:
  • https://testnet-eu-rpc.catalystnet.org
  • https://testnet-us-rpc.catalystnet.org
  • https://testnet-asia-rpc.catalystnet.org

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 CATALYST_RPC_URL (default EU) or CATALYST_RPC_URLS for failover.

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