Zircuit Explorer

This project is a production-ready Blockscout instance that indexes the Zircuit Mainnet and provides an explorer UI and API for users and developers. It displays blocks, transactions, token transfers, account balances, token pages, charts, and offers comprehensive REST and RPC API documentation. The instance is deployed on the Autoscout cloud, making it publicly accessible as a live explorer.

CORE CAPABILITIES

→ Real-time block and transaction feed with panels for the latest blocks and transactions.

→ Detailed block pages that show block number, size, validator, gas used, reward, base fee, and a list of transactions.

→ Transaction pages with information on sender, recipient, value, fee, status, trace links, and direct links to token transfers and related logs.

→ A comprehensive account list and top accounts displaying balances and transaction counts.

→ A token registry that includes token pages showing contract holders, transfers, and token types such as ERC-20 and ERC-721.

→ A distinct listing for token transfers separate from general transactions for quick analysis of token movements.

→ A dashboard with charts and statistics on the number of accounts, transactions, gas usage, network utilization, and other time series data.

→ A section for verified contracts, ready for contract source verification and display.

→ A main search bar that allows users to search by address, transaction hash, block, or token.

→ A wallet connect feature that enables users to connect their MetaMask or other wallets to the Zircuit Mainnet.

→ API documentation pages that expose REST API, RPC API endpoints, and GraphQL endpoints for programmatic access.

→ Plugin installation capabilities, including a Charts and Stats plugin to produce dashboards.

→ Branding customization options, such as a gradient header and dark mode theme.

→ Indexer logs and instance monitoring available through the Autoscout dashboard, providing indexing progress status and health information.

ARCHITECTURE AND DATA FLOW

◉ Zircuit RPC node endpoints serve as the primary data source. The explorer interacts with the RPC to fetch blocks, transactions, traces, receipts, and internal transactions.

◉ The Blockscout indexer ingests the RPC stream and writes parsed data into a PostgreSQL database, preparing materialized views for dashboards.

◉ Blockscout web frontend queries the database and indexer for real-time UI and chart updates.

◉ The API endpoint layer provides access to the same indexed data via REST and GraphQL.

◉ Optional plugins, like Charts and Stats, can make additional queries to derive aggregate metrics.

KEY METRICS VISIBLE IN THE UI

• Total blocks and a real-time block feed.

• Total transactions and daily transaction counts.

• Average block time and gas tracker.

• Number of addresses and top account balances.

• Counts of tokens, holders, and transfers for major tokens like ZRC, WETH, USDT, and others.

• Charts illustrating account growth, new accounts, transaction fees, gas usage, and other time series metrics.

WHO IT SERVES

• Developers needing transparent on-chain data for debugging and verifying contract behavior.

• Auditors and security teams requiring block-level evidence and transaction traces.

• Token projects and teams seeking token pages, holder distributions, and transfer analytics.

• Researchers and data scientists who need API access to historical and live metrics.

• Community members and power users looking for a user-friendly block explorer to inspect wallets and transactions.

CURRENT STATUS

✓ The instance is live and serves UI pages for blocks, transactions, tokens, accounts, and charts.

✓ Indexing is ongoing, with 50% completed, and the UI displays many blocks and transactions that have already been indexed.

✓ The token list is populated and shows ZRC as well as many other tokens.

✓ An API documentation page is available.

WHY THIS PROJECT MATTERS

Zircuit is an emerging EVM-compatible Layer 2 solution with innovative security features. A reliable public explorer is crucial for transparency, user trust, and developer tooling. By providing a dedicated Blockscout explorer for the Zircuit Mainnet, this project enhances accessibility for audits, token projects, dApp debugging, and data analysis.rojects dapp debugging, and indexing data analysis.

We developed our Zircuit Mainnet explorer using Blockscout Autoscout, a cloud-based deployment tool that simplifies the hosting and maintenance of EVM-compatible blockchain explorers. Autoscout enabled us to configure, index, and host the entire Blockscout stack without the need to manually set up infrastructure.

Core Technologies Used

• Blockscout Autoscout: This managed deployment layer automated the provisioning of the explorer, indexer, and database. Autoscout also provided access to logs, metrics, and configuration options (Info, Branding, Indexer, Plugins, and Rollup configuration).

• PostgreSQL: The database where all indexed blockchain data is stored, including blocks, transactions, tokens, and contract information.

• Elixir / Phoenix Framework: The backend engine of Blockscout, written in Elixir. It handles data ingestion, API endpoints, and the live UI.

• Zircuit RPC Node: This serves as the data source for all blockchain information. We connected Blockscout to https://mainnet.zircuit.com/ through the HTTP and WebSocket RPC endpoints to fetch blocks, transactions, logs, and receipts.

• Frontend Stack: The explorer's user interface, built into Blockscout’s web layer, dynamically fetches indexed data and displays dashboards for transactions, accounts, tokens, and charts.

• Autoscout Cloud Dashboard: This dashboard provides real-time monitoring, error logs, and allows for configuration changes without needing to redeploy from scratch.

How These Components Work Together

The Autoscout layer provisions and manages the Blockscout stack. After selecting the instance size and filling in the chain parameters (chain name, ID 48900, gas token ETH, node type Geth), Autoscout automatically launched the explorer.

The Indexer connects to the Zircuit RPC endpoint and continuously pulls blockchain data into PostgreSQL.

The backend (Elixir application) reads from the database and exposes REST, RPC, and GraphQL APIs.

The frontend (React UI) consumes these APIs to render blocks, transactions, and token data.

Plugins, such as “Charts & Stats,” are enabled to visualize metrics like daily transactions, gas usage, and network utilization.

Branding customization—including colors, logos, and banners—was applied through the Branding tab in Autoscout, creating a unique Zircuit-branded appearance.

Partner Technology Benefits

Blockscout’s Autoscout drastically reduced deployment complexity. Traditionally, running Blockscout requires setting up Docker, configuring Postgres, and manual indexing. Autoscout streamlined this process with a guided UI deployment.

Integration with Zircuit RPC endpoints allowed for the real-time indexing of a live L2 network without the need for our own node.

The Charts and Stats plugin transformed raw data into readable analytics, ideal for public explorers and dashboards.

Built-in API documentation provided developers with immediate access to block and transaction data, enhancing the utility for the Zircuit ecosystem.

Notable Solutions and Challenges

Initially, deployment failed due to an incorrect Chain ID and rollup configuration mismatch. Autoscout expected a zksync_l1_rpc field when “rollup mode” was enabled, leading to configuration validation errors. We debugged this by comparing Autoscout logs and identified that Zircuit functions as a standard EVM (not a zkSync rollup). We then switched the chain type to “default” with the correct chain ID (48900).

We manually adjusted the Indexer's batch size and recheck intervals to stabilize database connections and avoid spikes in DBConnection.ConnectionError. This helped reduce queue drops and improved synchronization speed.