Skip to content

Latest commit

 

History

History

client

README.md

Sui Explorer Frontend

Sui Explorer is a network explorer for the Sui network, similar in functionality to Etherscan or Solana Explorer. Use Sui Explorer to see the latest transactions and objects.

Set Up

Requirements: Node 14.0.0 or later.

Dependencies are managed using pnpm. You can start by installing dependencies in the root of the Sui repository:

$ pnpm install

How to Switch Environment

Connecting to the DevNet Remote Gateway Server

The Sui Explorer frontend will use the DevNet Gateway server by default: https://gateway.devnet.sui.io:443

pnpm dev

Connecting to a Local RPC Server

Refer to Local RPC Server & JSON-RPC API Quick Start on setting up a Local RPC Server. If we wish to locally run the website using a Local RPC Server, then run the following:

pnpm dev:local

Alternatively, having run pnpm dev, click the green button at the top of the page and select the option 'Local'.

Connecting to a Custom RPC URL

First run the following:

pnpm dev

Then, click the green button at the top and select the option 'Custom RPC URL'. Type the Custom RPC URL into the input box that emerges.

Connecting to the Static Data

The Sui Explorer can also connect to a local, static JSON dataset that can be found at ./src/utils/static/mock_data.json and ./src/utils/static/owned_object.json.

For example, suppose we wish to locally run the website using the static JSON dataset and not the API, then we could run the following:

pnpm dev:static

Other pnpm commands

pnpm test

This runs a series of end-to-end browser tests using the website as connected to the static JSON dataset. This command is run by the GitHub checks. The tests must pass before merging a branch into main.

pnpm build

Builds the app for production to the build folder.

It bundles React in production mode and optimizes the build for the best performance.

pnpm lint

Run linting check (prettier/eslint/stylelint).

pnpm lint:fix

Run linting check but also try to fix any issues.

Features

Currently the Explorer supports

  • Landing page with latest transactions
  • Transaction details page
  • Object details page
  • Address page with owned objects
  • Search for transactions, addresses, and Objects by ID

See Experiment with Sui DevNet for use.