feat: add Bitcoin network support and migrate to networkId-based system#190
Merged
AugustoL merged 22 commits intoopenscan-explorer:release/v1.2.0-afrom Feb 5, 2026
Conversation
- Add Bitcoin network integration (Phase 1 - Dashboard only)
- New BitcoinAdapter for JSON-RPC communication
- Bitcoin dashboard with network stats and recent blocks
- useBitcoinDashboard hook with 60s refresh interval
- NetworkRouter component for network type routing
- Migrate from chainId to networkId (CAIP-2 format)
- RPC storage now uses networkId as keys (e.g., "eip155:1")
- Add networkResolver utility for network resolution
- Extract chainId from networkId for EVM networks
- Update settings page to use networkId-based storage
- Bump RPC storage version to V3
- Add NetworkType and slug support
- Networks now have "type" field ("evm" | "bitcoin")
- Add "slug" field for URL routing (e.g., "btc", "eth")
- getNetworkUrlPath prefers chainId for EVMs, slug for others
- Update all components to use networkId for RPC lookups
- Address pages, token displays, contract interactions
- Network dashboard, block indicator, devtools
|
🚀 Preview: https://pr-190--openscan.netlify.app |
- Add BitcoinBlockDisplay/Page with navigation, stats, and tx list - Add BitcoinTransactionDisplay/Page with inputs/outputs two-column layout - Add BitcoinAddressDisplay/Page with balance and UTXO display - Add BTC price fetching via WBTC pools on Ethereum - Add fee estimates (fast/medium/slow) to dashboard - Add USD values alongside BTC values in transaction display - Add mempool transaction support with multiple RPC fallbacks - Add Bitcoin address/txid pattern recognition in search - Update navbar to hide blocks/txs links on Bitcoin networks - Center search bar in navbar using absolute positioning - Simplify dashboard stats to show only price, mempool, and fees - Unify Bitcoin page styling with EVM pages (block-display-card)
- Add network dropdown for all networks (including Bitcoin) with links to network home, blocks, transactions, and OpenScan home - Remove BLOCKS and TRANSACTIONS links from navbar (now in dropdown) - Move search bar to left side next to network logo - Move search button inside input with smaller icon - Fix dropdown hover gap issue with padding approach - Clean up duplicate CSS styles and unused code
- Add BitcoinBlocksPage for /btc/blocks route with pagination - Add BitcoinTransactionsPage for /btc/txs route showing recent txs - Add BlocksPageRouter and TxsPageRouter for network-aware routing - Fix navbar dropdown links to use getNetworkUrlPath for correct URLs
- Create bitcoinFormatters.ts with formatting functions - Create bitcoinUtils.ts with business logic functions - Create bitcoinConstants.ts with shared constants - Update all Bitcoin components to use shared utilities - Remove ~230 lines of duplicated code
- Add explicit /btc/* routes before :networkId catch-all - Remove NetworkRouter component (no longer needed) - EVM routes use LazyChain directly
- Add Bitcoin Testnet4 network configuration (slug: tbtc) - Add /tbtc/* routes for testnet4 pages - Update Bitcoin page components to extract network slug from URL path instead of useParams (required since routes don't have :networkId param) - Add Mempool link to navbar dropdown for Bitcoin networks
- Add BitcoinMempoolPage component showing pending transactions - Add getMempoolSummary and getMempoolTransactions methods to BitcoinAdapter - Paginate by 100 transactions per page for faster loading - Fetch transaction details in parallel for current page only - Show page indicator in header and clean pagination controls - Auto-refresh every 30 seconds - Add pagination-info CSS class
- Fix NetworkAwareRouters to extract network from URL path segment instead of only useParams (which was undefined for /btc/* routes) - Fetch block header in parallel with block data for reliable nTx count - Use header's nTx as primary source with fallbacks
…utes - Remove NetworkAwareRouters.tsx - no longer needed - Use lazy components directly in App.tsx routes - Bitcoin routes (btc/*, tbtc/*) use Bitcoin-specific components - EVM routes (:networkId/*) use EVM components - Simpler and more explicit routing
- Move EVM-specific pages to pages/evm/: address, block, blocks, tx, txs, network, gastracker, tokenDetails, mempool - Update all imports in LazyComponents.tsx - Fix relative imports in moved files - Keep shared pages (about, contact, home, etc.) at pages/ root - Mirrors existing pages/bitcoin/ organization
- Add fixture data with real mainnet blocks, transactions, and addresses - Test different eras: Genesis, SegWit (481824), Taproot (709632) - Test all address types: Legacy (P2PKH), P2SH, SegWit (P2WPKH), Taproot (P2TR) - Test transaction types: coinbase, legacy, SegWit, Taproot, OP_RETURN - Add page object models for Bitcoin block, transaction, and address pages - Add wait helpers for Bitcoin page content
- Create e2e-bitcoin.yml to run Bitcoin tests independently - Update e2e.yml to exclude Bitcoin tests (--ignore-pattern)
Prevents 'No transactions found' flash while transactions are still loading
Update all Bitcoin pages to use truncateBlockHash for block hashes
Collaborator
Author
|
@MatiasOS ready for review |
MatiasOS
approved these changes
Feb 4, 2026
| ├── services/ # Blockchain data services | ||
| │ ├── adapters # General reusable adapters | ||
| │ ├── adapters/ # General reusable adapters | ||
| │ │ └── BitcoinAdapter/ # Bitcoin network adapter |
Member
There was a problem hiding this comment.
Not sure if this is a typo. But Bitcoion should be at same level as EVM right?
MatiasOS
approved these changes
Feb 4, 2026
Resolve merge conflicts in package.json (bump @openscan/network-connectors to ^1.3.0) and bun.lock.
Resolve merge conflict in navbar imports (keep Link and useSettings).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Add Bitcoin network support including mainnet (
/btc) and Testnet4 (/tbtc), with full page implementations for blocks, transactions, addresses, and mempool. Also includes architecture improvements, code reorganization, and comprehensive e2e tests.Related Issue
Type of Change
Changes Made
pages/evm/subfolderE2E Test Coverage
24 new tests in separate workflow (
e2e-bitcoin.yml):Screenshots (if applicable)
Checklist
npm run format:fixandnpm run lint:fixnpm run typecheckwith no errorsnpm run test:runAdditional Notes