Shard Coordinator

WHAT IT DOES

This tool provides read-only access to shard coordinator contract data on EVM networks. It allows shard chain developers, validators, and researchers to inspect coordinator state, shard information, validator assignments, and cross-shard transaction data. Instead of relying on block explorers or third-party dashboards, you connect directly to the blockchain via your wallet's RPC provider and retrieve raw shard coordinator data. You can view the current epoch, shard count, validator count, individual shard details (roots, heights, assigned validators), validator assignments, and cross-shard transaction events. The tool is designed for sharded blockchain development, monitoring, and research.

HOW TO USE

Connect your wallet using the BGWallet bridge and select your target network. Choose the query type: Coordinator state, Shard information, Validator assignments, or Cross-shard transactions. Enter the shard coordinator contract address. For shard information queries, optionally enter a shard ID to view specific shard details. For validator assignment queries, optionally enter a validator address to check their shard assignment. For cross-shard transaction queries, optionally enter a shard ID to filter transactions by source or destination shard. Click "Query coordinator" to execute the query. Results appear in the results panel with formatted JSON output.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the blockchain via BGWallet's provider. For coordinator state queries, it calls common coordinator methods: owner(), currentEpoch(), shardCount(), validatorCount(), and isPaused(). For shard information queries, it reads shardCount() and getShard(shardId) to retrieve shard roots, heights, and assigned validators. For validator assignment queries, it reads validatorCount(), validators(index), getValidatorShard(address), and isValidator(address). For cross-shard transaction queries, it uses eth_getLogs with automatic chunking and halving on limit errors, searching for CrossShardTransaction, ShardTransaction, and TransactionFinalized events. All BigNumber values are converted to strings for readable output.

WHAT IT CANNOT SEE

This tool cannot verify the validity of shard blocks without access to individual shard node data. It cannot detect if validators are misbehaving or colluding across shards. It cannot verify cross-shard transaction finality without the full transaction history of both shards. It cannot detect data availability issues in individual shards. It cannot prove the correctness of shard state transitions. It cannot determine if a cross-shard transaction was executed correctly without access to the shards' internal state. It cannot detect if shard validators are withholding blocks or acting maliciously. You are responsible for understanding the sharded chain's security model and verifying trust assumptions.

PLEASE NOTE

EVM chains only. Supports Ethereum, Optimism, Arbitrum, Polygon, Base, and other EVM-compatible networks with shard coordinator contracts. Does not support Solana, Tron, Starknet (non-EVM), SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. Requires a wallet connected via BGWallet to provide the RPC provider. The tool is read-only and does not sign any transactions. Always verify contract addresses and shard data independently before relying on the results.