v1.2.4-alpha

OpenScan v1.2.4-alpha Release Notes

What's New

This is one of the most feature-packed releases yet. OpenScan now ships a full TX Analyser with deep transaction introspection across all EVM networks, a completely redesigned Settings page with DevTools-style tabs and config export/import, free AI analysis powered by Groq, EIP-4844 blob metadata display, and a host of quality-of-life improvements across Bitcoin and EVM chains.

---

New Features

TX Analyser — Deep Transaction Introspection

The headline feature of this release. Super User mode unlocks a powerful multi-tab transaction analyser that brings Tenderly/Phalcon-level inspection directly into OpenScan — trustlessly, using only your RPC.

• Call Tree — Full internal call trace visualization with expandable nodes, decoded function signatures, contract name enrichment via Sourcify (with Etherscan fallback), per-call gas usage, and summary stats (total calls, reverts, call-type breakdown)
• State Changes — Balance, nonce, storage slot, and code diffs between pre/post execution states, with contract name resolution
• Gas Profiler — Interactive flame chart showing gas consumption across the entire call tree, with waterfall visualization
• Events Tab — Event logs moved into the analyser with collapsible entries, full address display, and enriched log addresses with proxy ABI resolution
• Input Data Tab — Transaction input data decoded and displayed within the analyser context
• Smart Defaults — All users see Events and Input Data tabs; Super Users unlock Call Tree, State Changes, and Gas Profiler with differentiated tab highlighting
• Collapse/Expand Toggle — One-click collapse/expand all for call trees and state changes
• Network Support — Works across all EVM networks; Arbitrum uses arbtrace_transaction fallback when debug_traceTransaction is unavailable

Settings Page Overhaul

The settings page has been completely redesigned with a modern, DevTools-inspired interface.

• DevTools-Style Tabs — Tabbed navigation (General, Providers, API Keys, Advanced) with URL-synced active tab
• Autosave — Changes auto-save on General, API Keys, and Advanced tabs with visual confirmation
• Manual Save on Providers — Provider configuration requires explicit save to prevent accidental RPC changes
• Export/Import Configuration — Export your entire OpenScan config as JSON and import it on another browser or device
• Super User Toggle — Moved to the Advanced tab for cleaner organization
• Tab Flicker Fix — Eliminated visual flicker when switching tabs

Free AI Analysis via Groq

• Zero-Config AI — AI transaction/block/address analysis now works out of the box with no API key required
• Cloudflare Worker Proxy — Requests routed through a secure Cloudflare Worker with per-IP rate limiting (10 req/min), CORS origin allowlist, and payload validation
• openscan-groq Provider — New first-priority AI provider; users with their own keys can still use OpenAI, Gemini, or Groq directly

EIP-4844 Blob Metadata

• Blob display on blocks and transactions — Shows blob gas used, blob gas price, blob versioned hashes, and blob count for EIP-4844 (Proto-Danksharding) transactions
• Block-level blob stats — Blob gas used and excess blob gas displayed on block detail pages

RPC Management Improvements

• 24-Hour Auto-Sync — RPCs automatically re-sync by latency every 24 hours (previously only on first load)
• Alchemy Bitcoin Endpoints — Added Alchemy as a Bitcoin RPC provider for mainnet and testnet

Transaction Input Data Decoding

• UTF-8 Text Detection — Transaction input data is automatically checked for valid UTF-8 content and displayed as readable text when detected (common in inscription and memo transactions)

Bitcoin Improvements

• OP_RETURN Payload Decoding — OP_RETURN outputs now decode and display the actual payload data, attempting UTF-8 rendering with hex fallback, instead of showing a static label

---

Bug Fixes

• Sourcify V2 Verification — Fixed verified contracts showing as unverified due to incorrect parsing of Sourcify V2 match field
• ENS on Non-EVM Networks — ENS names searched on Bitcoin no longer resolve to invalid Ethereum addresses; shows clear error message instead
• Invalid Network URLs — Routes like /undefined/txs now redirect to home with a warning instead of silently falling back to Ethereum mainnet
• NaN Chain ID — Resolved NaN when networkId is a slug (e.g., eth, base) via new resolveChainId() utility
• Super User Toggle Layout — Fixed button layout shift in navbar when toggling Super User mode
• Notification System — Constrained width, floating over content, duplicate prevention, yellow warning style with rounded borders
• TX Re-fetch Prevention — Toggling Super User mode no longer triggers unnecessary transaction data re-fetches

---

Infrastructure

• CI: Kubo for IPFS Hashing — Replaced Storacha with Kubo (IPFS CLI) for consistent hash generation between local and CI environments
• CI: Stricter Audits — npm audit now fails on moderate+ severity vulnerabilities
• Build Script — IPFS hash generation gracefully skips when Kubo isn't installed

---

Access OpenScan

• ENS Gateway: openscan.eth.link
• GitHub Pages: openscan-explorer.github.io/explorer
• IPFS: Pinned on IPFS for censorship-resistant access

---

Supported Networks

Network	Network ID	Status
Ethereum Mainnet	eip155:1	Supported
Arbitrum One	eip155:42161	Supported
Optimism	eip155:10	Supported
Base	eip155:8453	Supported
Polygon PoS	eip155:137	Supported
BSC (BNB Chain)	eip155:56	Supported
Sepolia Testnet	eip155:11155111	Supported
BSC Testnet	eip155:97	Supported
Localhost (Hardhat/Anvil)	eip155:31337	Supported
Bitcoin Mainnet	bip122:000000000019d6689c085ae165831e93	Supported
Bitcoin Testnet4	bip122:00000000da84f2bafbbc53dee25a72ae	Supported

---

PRs Included

• #281 - feat(tx): TX Analyser — call tree, state changes, and contract enrichment
• #288 - fix: resolve NaN chainId when networkId is a slug
• #302 - fix(search): block ENS resolution on non-EVM networks
• #303 - fix(bitcoin): decode and display OP_RETURN payload in transaction outputs
• #305 - fix(routing): redirect to home with warning for invalid network URLs
• #306 - feat(ai): free Groq AI analysis via Cloudflare Worker proxy
• #307 - fix(nav): Super User toggle button layout shift
• #308 - feat(rpc): auto-sync RPCs every 24h & Alchemy Bitcoin endpoints
• #309 - chore: bump version to 1.2.4-alpha
• #310 - feat(settings): add export/import configuration
• #314 - feat(settings): add DevTools-style config tabs with autosave
• #315 - feat(evm): display EIP-4844 blob metadata
• #316 - fix(address): Sourcify V2 verified contracts shown as not verified
• #317 - fix(ci): fail audit on moderate+ severity
• #318 - v1.2.4-a release PR
• #319 - fix(settings): prevent tab flicker and center advanced tab
• #320 - feat(tx): decode UTF-8 text in transaction input data
• #321 - fix(ci): replace Storacha with Kubo for IPFS hash generation

---

Feedback & Contributions

We welcome your feedback!

• Report Issues: GitHub Issues
• Contribute: Contributing Guide
• Contact: Available via XMTP on the Contact Page

---

The OpenScan Team

v1.2.3-alpha

OpenScan v1.2.3-alpha Release Notes

What's New

This release introduces proxy contract detection, Kleros verified tags, Etherscan as a parallel verification source, auto RPC sync by latency, skeleton loaders, breadcrumb navigation, and a range of accessibility and UX improvements.

---

New Features

Proxy Contract Detection

• EIP-1967, EIP-1822 (UUPS), EIP-1967 Beacon, and EIP-1167 Minimal Proxy — automatically detected via eth_getStorageAt and bytecode pattern matching
• Proxy type and implementation address displayed on contract pages with link and contract name badge
• ABI tab switcher — toggle between Implementation and Proxy ABIs when both are verified
• Warning banner when proxy implementation is not verified on Sourcify
• Sourcify V2 proxy resolution — leverages Sourcify's native proxy resolution for metadata

Kleros Verified Tag

• Live Kleros ATQ integration — address pages on Ethereum mainnet query the Kleros Address Tags registry via The Graph subgraph
• Clickable tag badge with Kleros logo and public name, linking to the Kleros Curate item page
• CDN fallback — falls back to metadata CDN if The Graph query fails
• 1-hour in-memory cache to reduce redundant Graph API calls

Etherscan as Parallel Verification Source

• Parallel Sourcify + Etherscan queries — when an Etherscan API key is set in Settings, both sources are queried simultaneously
• Linked tag badges — verified sources displayed as [Sourcify ↗] and [Etherscan ↗] on the contract status row
• Etherscan V2 API — supports 60+ chains with a single API key
• Opt-in — no behavior change without an API key configured

Auto-Sync RPCs by Latency

• First-load auto-sync — on first visit, all networks with ≥2 RPC endpoints are tested in parallel and reordered by quality (privacy tier + latency) after route settles for 1.5s
• Storage-only writes — sorted RPCs written only to localStorage to avoid triggering data refetches
• Persistent sync flag — subsequent loads skip re-sync unless cache is cleared
• Reset on cache clear — "Clear Cache Data" resets the sync flag so the next load re-syncs

Skeleton Loaders

• Inline skeleton rows across blocks and transactions tables, Bitcoin pages, and dashboard cards
• Card-level skeletons that match the exact structure and height of loaded rows
• Stable layouts — prevent card and row size changes between loading and loaded states
• Pagination buttons remain visible during loading state

Breadcrumb Navigation

• Added to all EVM and Bitcoin detail pages — blocks, transactions, and address pages
• Shows network short name instead of chain ID

CopyButton Component

• Reusable CopyButton integrated into LongString, addresses, and from/to/contract fields on transaction pages

Home Page Redesign

• Featured full-width Ethereum/Bitcoin card at the top of the network list
• Testnet toggle visible only in super user mode
• Network IDs display in super user mode

---

Bug Fixes

• Address type detection — avoid false account fallback when type detection RPC calls fail; export hasContractCode() and reuse in fallback logic
• Display component remount — prevent remount on background re-fetches
• Proxy detection bugs and EOA misclassification — multiple edge cases fixed across all display components
• NaN chainId — resolved NaN when networkId is a slug (e.g. eth, base); added resolveChainId() utility
• EVM Mempool page — replaced debug stub with proper placeholder page
• Search empty state — improved with search bar, guidance, and Go Home button
• Profile error page — user-friendly message and recovery CTAs
• CSS show-mobile-* classes — added missing display: none defaults causing address hash duplication on desktop
• Supporters page — CTA copy clarified; broken /subscriptions links replaced with docs URL

---

Accessibility

• prefers-reduced-motion — background animation respects system setting
• Text contrast — improved to meet WCAG AA (4.5:1 ratio)
• Global :focus-visible outline — keyboard navigation support across all interactive elements
• aria-live + role=alert — loading and timeout states announce changes to screen readers

---

Refactoring

• About, Contact, and Subscriptions pages removed from the app — all content now lives at the docs site; footer links updated accordingly
• hasContractCode() exported and covered with unit tests

---

Infrastructure

• CI: replace Pinata with Storacha — IPFS deployment now uses storacha/add-to-web3@v4; Kubo (IPFS CLI) removed; meta branch badge now shows CIDv1 (bafy...)
• SEO — canonical and alternate links added to index.html for improved AI entity graph indexing

---

Access OpenScan

• ENS Gateway: openscan.eth.link
• GitHub Pages: openscan-explorer.github.io/explorer
• IPFS: Pinned on IPFS for censorship-resistant access

---

Supported Networks

Network	Network ID	Status
Ethereum Mainnet	eip155:1	Supported
Arbitrum One	eip155:42161	Supported
Optimism	eip155:10	Supported
Base	eip155:8453	Supported
Polygon PoS	eip155:137	Supported
BSC (BNB Chain)	eip155:56	Supported
Sepolia Testnet	eip155:11155111	Supported
BSC Testnet	eip155:97	Supported
Localhost (Hardhat/Anvil)	eip155:31337	Supported
Bitcoin Mainnet	bip122:000000000019d6689c085ae165831e93	Supported
Bitcoin Testnet4	bip122:00000000da84f2bafbbc53dee25a72ae	Supported

---

PRs Included

• #272 - fix(address): avoid false account fallback when type detection fails
• #273 - chore: bump version to 1.2.3-alpha
• #277 - feat(address): show Kleros verified tag on address page
• #279 - feat(address): proxy contract detection + Etherscan verification source
• #280 - feat: UX, accessibility, and loading-state improvements
• #282 - feat(seo): add canonical and alternate links
• #284 - fix: pre-release fixes for v1.2.3
• #285 - feat(settings): auto-sync RPCs by latency on first load
• #286 - refactor: remove about/contact/subscriptions pages in favor of docs site
• #287 - v1.2.3-a release PR
• #288 - fix: resolve NaN chainId when networkId is a slug
• #289 - chore(ci): replace Pinata with Storacha for IPFS deployment

---

Feedback & Contributions

We welcome your feedback!

• Report Issues: GitHub Issues
• Contribute: Contributing Guide
• Contact: Available via XMTP on the Contact Page

---

The OpenScan Team

v1.2.2-alpha

OpenScan v1.2.2-alpha Release Notes

What's New

This release introduces RPC endpoint testing and comparison tools, Super User mode and persistent cache improvements, Bitcoin AI analysis expansion, i18n enhancements, UI refinements, and CI stability upgrades.

---

New Features

RPC Endpoint Testing & Comparison

• New RPCs Page (/rpcs) — Dedicated page to test and compare RPC endpoints across EVM and Bitcoin networks
• Sortable RPC Table — Provider, latency, status, block number, and privacy columns
• Re-test & Copy Actions — Re-test individual providers and copy endpoint URLs quickly
• Settings Integration — “Test RPCs” entry point from Settings → RPC Endpoints
• Auto-Test Stability — Improved endpoint testing flow and effect dependencies
• Sensitive URL Redaction — Protected display of RPC URLs containing secrets/tokens
• Non-HTTP Endpoint Handling — Better handling for unsupported/non-HTTP providers during tests

Super User Mode & Caching

• Subdomain Auto-Activation — Super User mode automatically enables via super.* domain
• Persistent Cache (LRU) — LocalStorage-based cache with configurable size limits
• Super User Visual Indicators — Clear navbar/footer styling and active-state cues
• Immutable Data Caching — Integrated cache usage in EVM and Bitcoin block/transaction pages

Bitcoin AI Analysis Improvements

• Bitcoin-Specific AI Types — Dedicated analysis flows for BTC transaction, block, and address pages
• BTC Prompt Templates — UTXO-aware prompts and terminology (sat/vB, fee-rate, coinbase/witness/RBF)
• Bitcoin AI Panel Coverage — AI analysis panel integrated across key Bitcoin detail views
• Network-Aware Cache Keys — Distinct cache scoping between mainnet/testnet contexts

UI/UX Enhancements

• Collapsible Event Logs — Event logs collapsed by default for cleaner transaction pages
• Improved Info Hierarchy — Event logs moved above input data for better readability
• Token Loading Experience — Added OpenScan cube loader usage in token holdings flow
• Notification Consistency — Replaced browser alert() usage with in-app notification system

Internationalization (i18n)

• Language Expansion — Added support updates for Chinese Simplified, Japanese, and Portuguese (BR)
• Terminology Improvements — Better blockchain-specific wording in zh/ja
• RPC Translation Coverage — Added/updated strings for sync RPC and RPC testing pages

---

Bug Fixes

• RPC Testing Edge Cases — Improved behavior for problematic providers and unstable endpoints
• TypeScript Errors — Resolved typecheck issues in AddressTransactionSearch and NavbarLogo flows
• Module Compatibility — Replaced dynamic require() with ES module imports in utilities
• AI Cache Key Consistency — Fixed user-mode cache key handling in AI analysis hooks
• Dependency Correctness — Added missing runtime dependencies and aligned package setup

---

Performance

• Parallelized E2E Shards — Split EVM network test suite into parallel shards for faster feedback
• Improved Endpoint Selection Quality — Better practical sorting/testing workflows for RPC reliability
• Reduced Redundant Calls — Persistent cache integration decreases repeated fetch overhead

---

Infrastructure

CI & Security

• NPM Audit Workflow — Added automated dependency audit checks for PRs
• Node Version Upgrade — CI runtime bumped to Node 24
• Release Pipeline Updates — Version bump and release-branch consolidation improvements

Developer Experience

• Safer AI Key Handling — Improved Gemini key handling patterns
• Dependency & Tooling Cleanup — Connector updates and dev dependency organization improvements

---

Access OpenScan

• ENS Gateway: openscan.eth.link
• • GitHub Pages: openscan-explorer.github.io/explorer
• IPFS: Pinned on IPFS for censorship-resistant access

---

Supported Networks

Network	Network ID	Status
Ethereum Mainnet	eip155:1	Supported
Arbitrum One	eip155:42161	Supported
Optimism	eip155:10	Supported
Base	eip155:8453	Supported
Polygon PoS	eip155:137	Supported
BSC (BNB Chain)	eip155:56	Supported
Sepolia Testnet	eip155:11155111	Supported
BSC Testnet	eip155:97	Supported
Localhost (Hardhat/Anvil)	eip155:31337	Supported
Bitcoin Mainnet	bip122:000000000019d6689c085ae165831e93	Supported
Bitcoin Testnet4	bip122:00000000da84f2bafbbc53dee25a72ae	Supported

---

PRs Included

• #252 - fix local localhost RPCs
• #253 - feat(rpcs): add RPCs page for testing/comparing endpoints
• #254 - feat(i18n): add zh/ja/pt-BR translations
• #255 - chore: no AI attribution workflow rule
• #256 - feat(super-user): auto-activate + persistent cache
• #257 - feat(bitcoin): AI analyzer integration for BTC pages
• #259 - feat/fix: token loading improvements
• #261 - fixes bundle
• #262 - feat(transaction): collapsible event logs
• #263 - fix(types): resolve typecheck issues
• #265 - ci(audit): npm audit workflow + node version update
• #267 - fix(rpcs): redact sensitive URLs + non-HTTP endpoint handling
• #264 - release/v1.2.2-a consolidation
• #268 - v1.2.2-a release PR
• #270 - bump version to 1.2.2-alpha

---

Feedback & Contributions

We welcome your feedback!

• Report Issues: GitHub Issues
• Contribute: Contributing Guide
• Contact: Available via XMTP on the Contact Page

---

The OpenScan Team

v1.2.1-alpha

OpenScan v1.2.1-alpha Release Notes

What's New

This release introduces AI-powered analysis for addresses, transactions, and blocks, optimized transaction search using reth providers, improved UI layouts, a new loading animation, and multiple bug fixes.

---

New Features

AI Analysis

• AI Analysis Panel — Expandable AI analysis panel integrated into address, transaction, and block pages
• Multi-Provider Support — Supports Groq (compound model), Anthropic, Perplexity, and Gemini as AI providers
• ERC-7730 Pre-Analysis — Transaction analysis enriched with human-readable calldata decoding via ClearSigner
• Language-Aware Responses — AI responses match the user's locale setting
• Prompt Versioning — Support for prompt versions and Super User prompts
• Caching — AI analysis results cached to reduce redundant calls
• Settings Integration — Configure AI providers and API keys from Settings page with i18n support

Transaction Search Optimization

• Reth Provider Integration — Uses eth_getTransactionBySenderAndNonce for O(N) sent-tx discovery on Ethereum mainnet
• Dedicated Reth RPCs — 3 public reth RPCs with race strategy for fast lookups
• Nonce Lookup Service — Batched nonce-to-tx lookups with progressive interleaved delivery
• Adaptive Gap Segmentation — Smarter search partitioning for sparse transaction histories

UI Improvements

• Two-Column Transaction Layout — EVM transaction details now displayed in a two-column grid
• Two-Column Block Layout — Block details with two-column layout and block hash display
• Per-Block Pagination — Transactions page uses per-block pagination instead of multi-block ranges
• Bitcoin Pagination — Two-level pagination for BTC transactions page
• OpenScan Cube Loader — New animated loading spinner replaces old loading spinners
• Dynamic Page Titles — Blocks and transactions pages show network name in title

---

Bug Fixes

• App Crash on First Load — Fixed DataService creation before RPC URLs are populated
• Navbar Dropdown Light Mode — Fixed dropdown links not highlighting in light mode
• GitHub Pages Navigation — Fixed OpenScan home link breaking on GitHub Pages deployment
• ENS Lookup — Fixed CAIP-2 key for accessing mainnet RPC URLs in ENS resolution
• Address Receipt Fetching — Use eth_getBlockReceipts for reliable receipt fetching
• Contract Page — Hide nonce display for contract addresses
• RPC Indicator — Use CAIP-2 string format for RPC indicator display
• Address Case Normalization — Consistent cache hits regardless of address casing
• Transaction Search Limit — Fixed auto-search limit and pending status in parallel mode

---

Performance

• Reth-Based Lookups — Near-instant sent transaction discovery on supported networks
• Unified Unit Formatting — Consolidated formatting logic across the codebase
• Modern TS Target — Updated TypeScript target to modern browsers

---

Infrastructure

SEO

• Organization Schema — Added JSON-LD Organization structured data
• Expanded FAQs — Additional FAQ entries for AI disambiguation

CI

• NPM Publish — Fixed missing alpha tag in npm publish config

E2E Tests

• Updated Test Expectations — Tests aligned with new i18n page titles, CAIP-2 format, and URL parameter changes
• Improved Wait Helpers — Collection lookup tests use robust waitForAddressContent helper

---

Access OpenScan

• ENS Gateway: openscan.eth.link
• GitHub Pages: openscan-explorer.github.io/explorer
• IPFS: Pinned on IPFS for censorship-resistant access

---

Supported Networks

Network	Network ID	Status
Ethereum Mainnet	eip155:1	Supported
Arbitrum One	eip155:42161	Supported
Optimism	eip155:10	Supported
Base	eip155:8453	Supported
Polygon PoS	eip155:137	Supported
BSC (BNB Chain)	eip155:56	Supported
Sepolia Testnet	eip155:11155111	Supported
BSC Testnet	eip155:97	Supported
Localhost (Hardhat/Anvil)	eip155:31337	Supported
Bitcoin Mainnet	bip122:000000000019d6689c085ae165831e93	Supported
Bitcoin Testnet4	bip122:00000000da84f2bafbbc53dee25a72ae	Supported

---

PRs Included

• #218 - Feat: AI analysis foundation
• #219 - feat(address): optimize tx search with eth_getTransactionBySenderAndNonce
• #221 - ci(npm): Add missing alpha tag to publish config
• #223 - SEO fixes
• #225 - feat: enhance AI analyzer providers, power user prompt versioning and swapping
• #228 - fix(ens): fix ENS lookup and address transaction receipt fetching
• #229 - feat(metadata): replace Chainlist with metadata RPC directory
• #230 - feat(ui): replace loading animation with OpenScan Cube Loader
• #231 - feat(ui): improve layout and pagination for blocks and transactions pages
• #233 - Release/v1.2.1-a to staging
• #237 - Bump package version to 1.2.1-alpha
• #239 - feat(AI): Use groq/compound model
• #241 - Fix bugs in contract page

---

Feedback & Contributions

We welcome your feedback!

• Report Issues: GitHub Issues
• Contribute: Contributing Guide
• Contact: Available via XMTP on the Contact Page

---

The OpenScan Team

v1.2.0-alpha

OpenScan v1.2.0-alpha Release Notes

What's New

This release introduces Bitcoin network support, internationalization (i18n), auto-search for recent transactions, a structured logging utility, Super User Mode, and SEO improvements.

---

New Features

Bitcoin Network Support

• Bitcoin Mainnet & Testnet4 — Full support for Bitcoin networks via JSON-RPC
• Bitcoin Dashboard — Shows latest blocks, mempool stats, and fee estimates (fast/medium/slow)
• Bitcoin Pages — Block, transaction, and address pages with Bitcoin-specific formatting
• BTC Price — Fetched via WBTC pools on Ethereum for price display

NetworkId Migration (CAIP-2)

• CAIP-2 Format — Migrated from numeric chainId to networkId format (e.g., "eip155:1", "bip122:...")
• RPC Storage V3 — Updated storage schema with networkId-based keys
• Network Slugs — URL-friendly network identifiers for routing

Auto-Search Recent Transactions

• Exponential Search — Galloping algorithm to quickly find the recent activity range
• Rate Limiting — Semaphore-based limiting (max 4 concurrent RPC calls) prevents rate-limiting
• Live Progress — Shows block range indicators during search
• Abort Support — Cancel in-flight requests when navigating away

Internationalization (i18n)

• Multi-Language Support — English and Spanish translations
• react-i18next — Full i18n infrastructure with namespace organization
• Translated Pages — Address, Block, Transaction, Settings, DevTools, Home, Network, and more
• Gas Tracker — Translated gas tracker page

Logger Utility

• Environment-Aware Logging — Different log levels per environment:
  • Development: debug, info, warn, error
  • Staging: info, warn, error
  • Production: warn, error
• Console Migration — All console statements migrated to logger utility
• Build Stripping — console.log stripped in production via Vite pure_funcs

Super User Mode

• Advanced Features Toggle — Show/hide developer tools from Settings
• Terminal Icon — Quick access indicator in navbar

SEO & Metadata

• JSON-LD Structured Data — WebApplication and FAQPage schemas
• Open Graph — Improved social sharing meta tags
• Twitter Cards — Enhanced Twitter preview support
• Manifest Icons — Fixed PWA icon references

---

Performance

• Exponential Range Search — Quickly narrows down recent activity before full search
• Semaphore Rate Limiting — Prevents RPC throttling with controlled concurrency
• Abort Controller — Cancels pending requests on navigation to save resources

---

UI/UX Improvements

• Language Selector — Switch between English and Spanish in Settings
• EVM Page Reorganization — Pages moved to evm/ subfolder for better organization
• Simplified Navbar — Network dropdown for cleaner navigation
• Mobile RPC Badges — Fixed overflow on Settings page for mobile devices
• Removed Static Preload — Cleaned up root div preload content

---

Bug Fixes

• Fixed mobile layout overflow for Settings page RPC badges
• Fixed HTML static preload content in root div
• Fixed manifest.json icon references
• Removed unused i18n translations

---

Infrastructure

E2E Test Improvements

• Test Restructure — Organized into eth-mainnet and evm-networks folders
• Separate CI Workflows — Different test suites run in dedicated workflows
• HashRouter Handling — Fixed URL handling for reliable test execution

Documentation

• i18n Rules — Added comprehensive i18n guidelines to Claude config
• Logger Documentation — Added logger utility usage to patterns.md

---

Access OpenScan

• ENS Gateway: openscan.eth.link
• GitHub Pages: openscan-explorer.github.io/explorer
• IPFS: Pinned on IPFS for censorship-resistant access

---

Supported Networks

Network	Network ID	Status
Ethereum Mainnet	eip155:1	Supported
Arbitrum One	eip155:42161	Supported
Optimism	eip155:10	Supported
Base	eip155:8453	Supported
Polygon PoS	eip155:137	Supported
BSC (BNB Chain)	eip155:56	Supported
Sepolia Testnet	eip155:11155111	Supported
BSC Testnet	eip155:97	Supported
Localhost (Hardhat/Anvil)	eip155:31337	Supported
Bitcoin Mainnet	bip122:000000000019d6689c085ae165831e93	New
Bitcoin Testnet4	bip122:00000000da84f2bafbbc53dee25a72ae	New

---

PRs Included

• #189 - chore: bump version to 1.2.0-alpha
• #190 - feat: add Bitcoin network support and migrate to networkId-based system
• #199 - feat: add Super User Mode to show/hide advanced features
• #200 - fix: mobile layout for Settings page RPC badges overflow
• #203 - test(e2e): restructure e2e tests and fix test reliability
• #204 - feat(meta): improve SEO metadata and fix manifest icons
• #205 - feat(search): auto-search recent transactions with exponential range finder
• #206 - fix(html): remove static preload content from root div
• #207 - feat: implement i18n infrastructure with react-i18next
• #208 - feat: implement logging utility with environment-aware log levels
• #209 - fix(i18n): i18n fixes and gas tracker translations

---

Feedback & Contributions

We welcome your feedback!

• Report Issues: GitHub Issues
• Contribute: Contributing Guide
• Contact: Available via XMTP on the Contact Page

---

The OpenScan Team

v1.1.1-alpha

OpenScan v1.1.1-alpha Release Notes

What's New

This release introduces the Gas Tracker feature, MetaMask integration, enhanced address page with token holdings, performance optimizations, and infrastructure improvements for npm publishing.

---

New Features

Gas Tracker

• Gas Tracker Page — New dedicated page showing current gas prices with L2 support
• L2 Fee Breakdown — Shows L1 and L2 fee components for Arbitrum and OP Stack networks
• Route Access — Available at /:networkId/gastracker

MetaMask Integration

• Default Explorer Button — Set OpenScan as MetaMask's default block explorer from Settings
• Hash Router Support — Proper URL routing for MetaMask's explorer URL format
• MetaMask Icon — Visual indicator in the UI

Token Holdings Display

• ERC20 Token List — Address page now displays token holdings
• Custom Token Lookup — Search and add custom tokens by contract address
• Card-Based Layout — Reorganized address page with improved visual hierarchy

Adaptive Transaction Search

• Smart Branching — Algorithm adjusts search segments based on nonce delta
• Reduced RPC Calls — 25-40% fewer calls while maintaining accuracy
• Batched Requests — Configurable limits to prevent rate limiting

Other Features

• ENS Gateway Subdomains — Support for ENS gateway subdomain detection
• Transaction History — Now enabled for all supported networks
• Dev Mode Artifacts — Auto-inject contract artifacts in development mode

---

Performance

• Route Preloading — All route chunks preloaded after app initialization
• Instant Navigation — Eliminates chunk download delay when switching pages
• Adaptive Search — Smart branching reduces unnecessary RPC calls

---

UI/UX Improvements

• Light Theme — Improved colors and CSS variable usage
• Address Page — Card-based layout with better organization
• Loading States — Fixed address type flickering during load
• EOA Detection — Transaction history only shown for EOA accounts
• ENS Resolution — Smoother visual transitions during ENS lookups

---

Bug Fixes

• Fixed ENS subdomain detection for gateway subdomains
• Fixed RPCUrl badge display on save for Alchemy and Infura
• Added sleep before ignition deploy in dev scripts
• Added accessibility attributes to gas tracker button
• Removed UNSUPPORTED_NETWORKS example value

---

Infrastructure

npm Package Publishing

• Build Scripts — Added build:npm and npm:publish scripts
• CI Workflow — Automated npm release on merge to master via GitHub Actions
• Package Configuration — Ready for npm registry publishing

Documentation

• Issue Templates — Added feature request and general issue templates
• README Updates — Git workflow and Claude Code configuration sections
• Modular Claude Config — Reorganized configuration into modular structure

---

Access OpenScan

• ENS Gateway: openscan.eth.link
• GitHub Pages: openscan-explorer.github.io/explorer
• IPFS: Pinned on IPFS for censorship-resistant access

---

Supported Networks

Network	Chain ID	Status
Ethereum Mainnet	1	Supported
Arbitrum One	42161	Supported
Optimism	10	Supported
Base	8453	Supported
Polygon PoS	137	Supported
BSC (BNB Chain)	56	Supported
Sepolia Testnet	11155111	Supported
BSC Testnet	97	Supported
Localhost (Hardhat/Anvil)	31337	Supported

---

PRs Included

• #169 - fix(subdomain): enable ENS gateway subdomain detection
• #171 - feat: auto-inject contract artifacts in dev mode
• #172 - feat: enable transaction history for all networks
• #175 - feat(gas-tracker): add gas tracker page with L2 support
• #178 - build/ci: add scripts and workflow for npm publish
• #179 - fix(config): display RPCUrl badge on save for Alchemy and Infura
• #180 - refactor: reorganize address displays with card-based layout
• #181 - fix(theme): improve light theme colors and CSS variable usage
• #182 - docs: add Claude configuration and issue templates
• #183 - feat: add MetaMask default explorer button in Settings
• #184 - feat(search): implement adaptive branching for address transaction search
• #185 - perf: preload all route chunks on app load

---

Feedback & Contributions

We welcome your feedback!

• Report Issues: GitHub Issues
• Contribute: Contributing Guide
• Contact: Available via XMTP on the Contact Page

---

The OpenScan Team

v1.1.0-alpha

OpenScan v1.1.0-alpha Release Notes

What's New

This release introduces major infrastructure changes and new features focused on performance, mobile experience, and trustless data fetching.

---

New Features

Network Dashboard

• Native Token Price — Real-time price fetched from on-chain DEX pools (no external APIs)
• Gas Price Display — Current gas price in Gwei
• Latest Blocks Table — Shows last 5 blocks with gas usage and burnt fees
• Latest Transactions — Recent transactions from the network
• Auto-refresh every 10 seconds

Address Transaction Search

• Binary Search Algorithm — Find address transactions without requiring an indexer
• Streaming Results — Transactions display as they are found
• Local Caching — Results cached in localStorage with 1-week expiry
• Search Controls — Configurable limits (5, 10, 50, all transactions)
• Progress Bar — Visual progress with cancel button
• Search Recent — Find new transactions since last search

OpenSearch Support

• Browser Integration — Add OpenScan as a search engine in your browser
• Multi-Network Search — Search across all supported networks from one page

Mobile Responsive Design

• Hamburger Menu — Collapsible navigation for mobile devices
• Responsive Tables — Touch-friendly data tables
• Mobile-First Styles — Optimized layouts for all screen sizes

Settings Improvements

• API Keys Management — Store Infura and Alchemy API keys
• Enhanced UX — Collapsible sections and improved layout
• RPC Indicator Badge — Visual indicator showing current RPC strategy on all pages

---

Infrastructure

Bun Migration

• Bun Package Manager — Replaced npm with Bun for faster installs
• Vite Bundler — Replaced webpack with Vite for faster builds and HMR
• npm audit Script — Security auditing support via audit.sh

---

Access OpenScan

• ENS Gateway: openscan.eth.link
• GitHub Pages: openscan-explorer.github.io/explorer
• IPFS: Pinned on IPFS for censorship-resistant access

---

Supported Networks

Network	Chain ID	Status
Ethereum Mainnet	1	Supported
Arbitrum One	42161	Supported
Optimism	10	Supported
Base	8453	Supported
Polygon PoS	137	Supported
BSC (BNB Chain)	56	Supported
Sepolia Testnet	11155111	Supported
BSC Testnet	97	Supported
Localhost (Hardhat/Anvil)	31337	Supported

---

PRs Included

• #149 - Bun/Vite migration
• #154 - Address transaction search
• #155 - RPC indicator badge
• #158 - Mobile responsive design
• #159 - OpenSearch support
• #160 - Network dashboard
• #162 - Settings improvements

---

Feedback & Contributions

We welcome your feedback!

• Report Issues: GitHub Issues
• Contribute: Contributing Guide
• Contact: Available via XMTP on the Contact Page

---

The OpenScan Team

v1.0.0-alpha

OpenScan v1.0.0-alpha Release Notes

Announcing OpenScan Alpha

We're excited to announce the first public alpha release of OpenScan — a trustless, open-source blockchain explorer for Ethereum and Layer 2 networks.

We choose to build trustless systems even when it is harder.
We pay the cost of openness over the convenience of control.

Alpha Status

This is an alpha release and is not production ready. The purpose of this release is to:

• Test the basic and initial features of the explorer
• Gather community feedback on functionality and user experience
• Identify bugs and edge cases across different networks
• Validate our trustless, RPC-first architecture

Our goal is to iterate based on feedback and deliver a production-ready explorer for all supported networks in future releases.

---

Access OpenScan

• ENS Gateway: openscan.eth.link
• GitHub Pages: openscan-explorer.github.io/explorer
• IPFS: Pinned on IPFS for censorship-resistant access

---

Supported Networks

Network	Chain ID	Status
Ethereum Mainnet	1	Supported
Arbitrum One	42161	Supported
Optimism	10	Supported
Base	8453	Supported
Polygon PoS	137	Supported
BSC (BNB Chain)	56	Supported
Sepolia Testnet	11155111	Supported
BSC Testnet	97	Supported
Localhost (Hardhat/Anvil)	31337	Supported

---

Features

Core Explorer Functionality

• Block Explorer — View detailed block information including transactions, gas usage, and timestamps
• Transaction Details — Inspect transaction data, receipts, logs, and execution traces
• Address Lookup — Check balances, transaction history, and contract code
• Network Statistics — Track chain metrics, gas prices, and block times

Smart Contract Interaction

• Verified Contract Support — Read from and write to verified smart contracts
• ABI Import — Import contract ABIs for unverified contracts
• Hardhat 3 Ignition Support — Import and interact with local deployments

Layer 2 Support

• Arbitrum — L1 block numbers, send counts, request IDs
• Optimism/Base — L1 fee breakdown (l1Fee, l1GasPrice, l1GasUsed)

RPC Strategy Options

• Fallback Mode — Sequential RPC calls with automatic failover
• Parallel Mode — Query multiple providers simultaneously for comparison and reliability

Developer Tools

• Hex Encoder/Decoder — Convert between hex and text formats
• Unit Converter — Convert between Wei, Gwei, and ETH
• Custom RPC Support — Configure your own RPC endpoints per network
• Transaction Builder — Construct and simulate transactions

User Experience

• Dark/Light Mode — Toggle between themes
• Responsive Design — Mobile-friendly interface
• ENS Resolution — Display ENS names for addresses
• IPFS/ENS Hosting — Fully decentralized deployment

---

Known Limitations

As an alpha release, please be aware of:

• Some RPC providers may have rate limits or occasional downtime
• Contract verification relies on Sourcify; not all contracts may be verified
• Performance may vary depending on network congestion and RPC response times
• Some edge cases in transaction decoding may not be fully handled

---

Feedback & Contributions

We welcome your feedback! This alpha release is about learning and improving together.

• Report Issues: GitHub Issues
• Contribute: Contributing Guide
• Contact: Available via XMTP on the Contact Page

---

What's Next

Our roadmap toward a stable v1.0.0 release includes:

• Stability improvements and bug fixes based on community feedback
• Enhanced error handling and loading states
• Performance optimizations
• Additional network support
• Improved contract interaction UX

---

Thank you for being part of the OpenScan journey. Together, we're building a more open and trustless blockchain infrastructure.

The OpenScan Team