Skip to main content
Version: Testnet

Block Explorer

Block explorers are essential tools for blockchain networks, providing users with a way to view and analyze transactions, blocks, and other on-chain data. For RollApp developers on the Dymension network, integrating a block explorer is crucial for transparency and user engagement.

This guide will walk you through the various options available for integrating a block explorer with your RollApp. Whether you choose to run your own explorer or use an external service, you'll find the information you need to get started.

Roller​

Hardware Requirements​

  • A Linux or macOS operating system
  • At least 4GB of RAM
  • At least 10GB of free disk space
  • 1 CPU core
  • At least 10 Mbps bandwidth

Software Requirements​

note

This guide assumes you've already setup your environment and initialized your rollapp.

In order to run the explorer, you will need also to install Docker.

Setup the desired version of docker:

export DOCKER_API_VERSION=1.41

Setup docker repository:

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

Install docker packages:

sudo apt-get -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

give permission to the current user to use the docker daemon:

sudo usermod -aG docker ${USER}

re-login to the user:

newgrp docker

Setup docker repository:

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

Install docker packages:

sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Start docker:

sudo systemctl start docker

give permission to the current user to use the docker daemon:

sudo usermod -aG docker ${USER}

re-login the user:

newgrp docker

Run​

roller block-explorer run

External service providers​

E-scan​

E-scan, the creator of DYM.FYI, offers block explorer services for RollApps. To integrate with E-scan:

  1. Enable the Block Explorer JSON-RPC server in your RollApp configuration:

    • Edit the file: ~/.$ROLLAPP_HOME_DIR/config/be-json-rpc.toml
    • Set the following parameter:
      # Enable the Block Explorer JSON-RPC server
      enable = true

  2. Ensure SSL is configured for your Block Explorer RPC endpoint.

  3. Contact E-scan:

note

The Block Explorer RPC is exposed on port 11100, which is distinct from the standard EVM JSON-RPC port 8545.

RollApp Scan​

RollApp Scan, the creator of NIM network block explorer and more, offers block explorer services for RollApps.

To integrate with RollApp Scan, enter the Telegram group and send a message to get onboarded: https://t.me/orbitcodes_rollappscan

The RollApp explorers are based on indexed data, which make them more performant and more stable. You can also benefit from metrics such as the active accounts evolution, the most used messages and more advanced analytics.