Skip to main content

Introduction

This module focuses on blockchain explorers and blockchain indexers for Tezos, how they work and how to use them. More precisely, it will be explained how to observe the different information (storage, entrypoint, bigmap, etc.) of a smart contract deployed on the Tezos blockchain.

Public blockchains like Tezos are meant to be transparent, meaning that everyone has access to the information. However, the accessibility and readability of its information are not always easy and intuitive. The block explorer was designed to remedy this problem.

What is a blockchain explorer?

A blockchain explorer, also known as a block explorer, is an app tracking activity on the blockchain. All transactions ever performed on a network can be viewed using such a tool.

Blockchain explorers are like search engines for blockchains.
You can think of it as a window into the blockchain world, allowing you to observe what's happening in it.

Cryptocurrency users and developers use such a tool to view the status of past or pending transactions.

Some of the most basic information available on blockchain explorers includes (but are not limited to):

  • Block feeds: This allows you to view all the latest baked and pending blocks on the blockchain.

    Pending block are the blocks awaiting approval of the 32 attestation slots. Check out Baking module to understand more about baking process.

  • Transaction feeds: The transaction feed displays all the most recent and upcoming transactions.
  • Sending and receiving addresses: Each transaction can be viewed individually to reveal the public addresses of the sending and receiving parties.
  • Wallet history: All past and pending transactions of a wallet address.

    Note that for Tezos there are two main types of addresses: kt1 and tz1 addresses.
    tz1 and kt1 addresses have the same functionality in terms of transactions. However, there is one difference, kt1 accounts have smart contract functionality and tz1 does not. This means that with the kt1 address you can observe on the explorer, the entrypoints, storage, etc. of the associated smart contract.

Blockchain explorer use cases

  • casual users check if their coins are still safe.
  • delegators verify that their baker is not cheating with their earnings.
  • users of smart contrats, who wants to take a look at the code, storage and history.
  • blockchain engineers who develop and debug new features on a test network (e.g. new blockchain consensus).
  • DApp developers who need debugging tools and more visibility into the current and past state of their contracts running on internal testnets and on the mainnet.
  • bakers and staking services who need reliable data about delegation and earnings history to calculate correct payouts, plan their bond pools, and execute operations.
  • less technical user groups like auditors and regulators with strict requirements for the data quality, as they need to access a trusted copy of the full on-chain history in a format that's easy to digest for their spreadsheets and compliance tools.

Public networks / test networks / DApps, audits and compliance / analytics and research

FIGURE 1: Typical use cases of a block explorer

What is an indexer ?

A block explorer is typically made of:

  • an indexer that is a node operator that extracts the on-chain data and stores it into a database
  • an API that queries the database
  • a frontend that displays the data

Since the on-chain data is already in the database of the node itself why an indexer is needed ? The indexer is relevant because it optimizes the way a node stores data. The purpose is to provide very quick access to blockchain data according to some specific criteria related to a given address.

So, the indexer is the part of the explorer that fetches the raw data from the node, then processes it and stores it in the database in an efficient way.

Next chapter will describe how an indexer works.