Blockscout
SupportWebsiteGithubDiscord
  • Blockscout Open-Source Explorer
  • 💡About BlockScout
    • Features
      • Ethereum Bytecode Database Microservice
      • Blockscout Redesign
    • Chains Using Blockscout
    • Partners & Integrations
      • RaaS Providers
      • Vera: Verifier Alliance
        • Adding your chain to the Vera database
        • Programmatic verification via the API
    • News & Media
      • Newsletter & Blog
    • Funding
      • L2 Funding Proposal
        • Aux Funding Images
    • Roadmap
  • 🙎Using Blockscout
    • Getting Started
      • Glossary of Terms
      • Main Menu
      • Blocks
      • Transaction Types
      • Beacon Chain Withdrawal Views
    • My Account
      • Watch list
      • Private tags
      • Public tags
      • API keys
      • Custom ABI
      • Verified addresses
        • Copy and Sign Message
      • For developers
    • Dappscout Apps Marketplace
      • DApp Integration
    • Swapscout
      • Earn Merits when using Swapscout
    • Revokescout
    • Autoscout Explorer Launchpad
    • CSV Exports
    • Token Support
      • ERC-1155 Support
    • Merits
      • Streak rewards
      • Activity Pass
      • Leaderboard
      • Badges
      • FAQs
  • 👩‍💻Developer Support
    • For Web3 Developers
    • Link to Blockscout
    • Blockscout APIs
      • Requests & Limits
      • REST API Endpoints
        • Stats API
        • Interpreter API
      • JSON RPC & ETH Compatible RPC Endpoints
        • Account
        • Block
        • Contract
        • Logs
        • Stats
        • Token
        • Transaction
        • ETH RPC API
      • GraphQL in Blockscout
    • Smart Contract Verification
      • Blockscout UI
      • Blockscout smart-contract verification API
      • Hardhat Verification Plugin
        • Sourcify Plugin for Hardhat
      • Foundry Verification
      • Sourcify Verification
      • OpenZeppelin Contract Verification
      • Automate verifications with Catapulta
      • Verification via thirdweb
      • Interacting with Smart Contracts
    • Integrate Merits
    • Chainscout chains list
  • 🏃‍♂️Setup and Run Blockscout
    • General Overview
      • Separate Indexer, Web App, and API
      • Umbrella Project Organization
      • Indexer Architecture Overview
      • ShareLock
      • EVM Version Information
    • Requirements
      • General Backend Requirements / Blockscout Backend Prerequisites
      • Backend/Frontend Compatibility Matrix
      • Hardware & Hosting Requirements
      • Database Storage Requirements
      • Client Setting Requirements
      • Node Tracing / JSON RPC Requirements
      • L2 -> L1 JSON-RPC Method Requests
    • ☑️ENV Variables
      • Backend ENVs: Common
      • Backend ENVs: Chain-Specific
      • Backend ENVs: Integrations
      • Frontend ENVs: Common
        • ENVs
        • Deprecated ENVs
      • Deprecated Backend ENVs
        • Previous ENV Variable Home Page
    • Deployment
      • ⭐Manual Deployment Guide
        • Ubuntu Setup
        • MacOS setup
      • ⭐Docker-compose Deployment
      • ⭐Kubernetes Deployment
      • Rollup Deployment
      • 🌟Cosmos-based chains
      • 🍀Upgrade Guide (v7.0 & v8.0)
      • Frontend Migration
        • All-In-One Container
        • Separate Frontend
        • Customized Backend
        • Proxy Setup
        • FAQs
      • Manual Deployment (backend + old UI)
        • Manual cleaning an instance from the previous deployment
      • Terraform Deployment
      • Ansible Deployment (AWS Cloud)
        • Overview
        • Prerequisites
        • AWS Permissions & Settings
          • Creating a Secret Key Pair
          • Login with AWS CLI
          • Creating an AWS certificate for SSL
          • Manually Cleaning Terraform Related Instances
        • Variables
        • Deploying the Blockscout Infrastructure
        • Deploying Blockscout
        • Destroying Provisioned Infrastructure
        • Common Additional Tasks
        • Common Errors and Questions
        • AWS Marketplace (deprecated)
          • Overview
          • CloudFormation Template
          • Prerequisites & Install Parameters
          • Install from AWS Marketplace
          • AWS EC2 archive node setup with OpenEthereum (formerly Parity)
          • Updating & Redeploying in AWS
          • Customizing CSS
    • Microservices
      • Blockscout ENS (BENS) Name Service Integration
      • Smart Contract Verification
    • Configuration Options
      • Automating Restarts
      • Branding Configs
      • Circle CI Updates
      • Charts and Stats
      • CSS Configuration & Presets
      • Exchange Rates
      • Front-end Config Files
      • haproxy Settings for Blockscout.com
      • Internationalization
      • Logger Configs
      • Memory Usage
      • Metrics
      • My Account Settings
      • Sorting and Pagination
      • Tracing
      • Reown Project ID for contract Read/Write
    • Indexing
      • How do I fix indexer timeouts?
      • How do I update memory consumption to fix indexer memory errors?
    • Testing
    • DB schema
  • FAQs
    • User FAQs
    • Developer FAQs
  • 🧩Resources
    • EaaS: Hosting with Blockscout
    • Contributing to Blockscout
    • Bug Bounty Program
    • Media kit
    • Release Notes
      • v5.3.0: 10/23/23
      • v5.2.0: 6/20/23
      • v5.1.0: 2/13/23
      • v5.0.0: 1/11/23
    • Discord Channel
    • Discussion
    • GitHub Repo
Powered by GitBook
LogoLogo

Privacy and Terms

  • Privacy Notice
  • Terms and Conditions

Copyright © Blockscout Limited 2023-2024

On this page
  • Replace the primary explorer link
  • UTM tags
  • Common chain replacements
  • Exceptions
  • Replace the API link
  • API Exceptions
  • Replace your wallet block explorer link

Was this helpful?

Export as PDF
  1. Developer Support

Link to Blockscout

Easily replace your current explorer links with Blockscout explorer links

Last updated 1 month ago

Was this helpful?

Replace the primary explorer link

In most cases simply replacing the first part of the url is all that is needed to replace Etherscan with Blockscout.

For example, replace with in your code and the corresponding links to blocks, transactions, etc will be mapped to Blockscout rather than Etherscan.

😢 Tx before replacement 😁 Tx after replacement

Blockscout linking architecture follows standardization for the following routes:

  • Blocks <BLOCK_EXPLORER_URL>/block/<BLOCK_HASH_OR_HEIGHT>

  • Transactions <BLOCK_EXPLORER_URL>/tx/<TX_HASH>

  • Accounts <BLOCK_EXPLORER_URL>/address/<ACCOUNT_ADDRESS>

  • Tokens <BLOCK_EXPLORER_URL>/token/<TOKEN_ADDRESS>

UTM tags

We encourage adding UTM tags with your project information to Blockscout links. This helps us track referrals and improve our overall performance via metrics. Simply append ?utm_source=<your_project_name> to the end of any links pointing to Blockscout. For example

Common chain replacements

Replace the Etherscan url in your code with the Blockscout url for a seamless transition. All chains supported by Etherscan are also supported by Blockscout (along with many additional Blockscout chains). Some examples are below. For additional Blockscout chains see the page or the .

Chain
Etherscan ❌
Blockscout ✅

Ethereum

Ethereum Sepolia

Optimism

Optimism Sepolia

Base

Base Sepolia

Arbitrum

Arbitrum Sepolia

Polygon

Gnosis

Celo

Unichain

Exceptions

Some newer operations without standards are still handled differently by different explorers. For example:

Replace the API link

API Exceptions

Replace your wallet block explorer link

Every wallet handles the explorer link differently, but typically wallets ship with Etherscan links by default. To change, simply go to settings and replace the Etherscan link with the Blockscout one. Here's how you do it in MetaMask.

  1. Open MetaMask, click the dots to open the menu, and select Settings

  2. Select Networks

  3. Select the network where you want to change the explorer link

Repeat this process for all networks from the Networks screen.

Blobs on Blockscout are accessed in different ways depending on the route. For example via the ?tab=blob_txs query string following a block () or the ?tab=blobs query string following a transaction. Blobs on Etherscan are accessed via #blobinfo query string following a block (ie ).

User Operations (EIP-4337) are displayed on Blockscout via the url. On Etherscan there is currently no defined route, but User Operations can be viewed with the Handle Ops filter applied to the senders address (ie )

Standard Blockscout RPC calls do not need an API key (Etherscan calls always require one). You can remove the &apikey=YourApiKeyToken query string at the end of the url with no problem or keep it as any string value and Blockscout will process. If you want to increase your limits, you can also and use it to access 10 RPS limits.

Etherscan uses a subdomain link for api access. For example, the Ethereum explorer the api link is followed by your query, or for Optimism it is followed by your query.

To replace, simply use the regular blockscout url for the instance, for example for Ethereum or for Optimism.

😢 API call before replacement (doesn't work without API key)

😁 API call after replacement (works without API key)

Standard API routes on Etherscan work for your queries on Blockscout. We've structured our data calls to be consistent with Etherscan whenever possible. You can see supported calls in the .

If you require more varied or richer datasets consider replacing your JSON RPC calls with the . This free API features additional metadata, stats data, human readable transactions and more.

Blockscout does not currently support most queries.

The 10 RPS limits can be increased further via the .

Find the block explorer url (ie ).

Change the url to blockscout (ie ) and Save.

👩‍💻
https://etherscan.com/
https://eth.blockscout.com/
https://etherscan.io/tx/0x3e8c3aad50b2f8471400e3fe6b812f20c332846064dff8c25fadf783eefa68df
https://eth.blockscout.com/tx/0x3e8c3aad50b2f8471400e3fe6b812f20c332846064dff8c25fadf783eefa68df
EIP-3091
https://eth.blockscout.com/?utm_source=tenderly
chains and projects
chainscout json file which includes chainids
https://eth.blockscout.com/block/20822532?tab=blob_txs
https://etherscan.io/block/20822532#blobinfo
https://eth.blockscout.com/ops
https://etherscan.io/advanced-filter?fadd=0x20e9695f25413f14e5807b530D0698bd4F155074&mtd=0x1fad948c~Handle+Ops&ps=10&p=8
sign up for a free Blockscout API key
https://api.etherscan.io/
https://api-optimistic.etherscan.io/
https://eth.blockscout.com/
https://optimism.blockscout.com/
https://api.etherscan.io/api?module=account&action=balance&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae&tag=latest&apikey=YourApiKeyToken
https://eth.blockscout.com/api?module=account&action=balance&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae&tag=latest
JSON RPC & ETH Compatible RPC endpoints section
REST API from Blockscout
Etherscan API PRO
Quicknode marketplace add-on
https://optimistic.etherscan.io/
https://optimism.blockscout.com/
https://etherscan.io/
https://eth.blockscout.com/
https://sepolia.etherscan.io/
https://eth-sepolia.blockscout.com/
https://optimistic.etherscan.io/
https://optimism.blockscout.com/
https://sepolia-optimism.etherscan.io/
https://optimism-sepolia.blockscout.com/
https://basescan.org/
https://base.blockscout.com/
https://sepolia.basescan.org/
https://base-sepolia.blockscout.com/
https://arbiscan.io/
https://arbitrum.blockscout.com/
https://sepolia.arbiscan.io/
https://arbitrum-sepolia.blockscout.com/
https://polygonscan.com/
https://polygon.blockscout.com/
https://gnosisscan.io/
https://gnosis.blockscout.com/
https://celoscan.io/
https://celo.blockscout.com/
https://uniscan.xyz/
https://unichain.blockscout.com/