Relic Explorer

Relic Explorer

Table of Contents

UX

https://www.figma.com/design/cZvNoJDEj07F8bkispR0I4/FIO-Relic-Explorer

Shared

Visual

Functionality

Visual

Functionality

Primary Navigation

FIO Relics Base - wo Nav.png
FIO Relics Base - w Nav.png
  • FIO price

    • Obtain from FIO App back-end?

    • Show 4 decimal points

  • Chain ID

    • Mainnet: 21dcae42c0182200e93f954a074011f9048a7624c6fe81d3c9541a614a88bd1c

    • Testnet: b20901380af44ef59c5918439a1f9a41d83669020319a80574b804a5f95cbd7e

  • Links

    • Chain

      • On click

        • Switch FIO Chain node

          • Mainnet

          • Testnet

    • Launch FIO App

    • Transactions

      • On click

        • Display Transaction List Page

    • Blocks

      • On click

        • Display Blocks List Page

    • FIO Handles

      • On click

        • Display FIO Handles List Page

    • Domains

      • On click

        • Display Domains List Page

    • Accounts

      • On click

        • Display Accounts List Page

    • Governance

      • Producers

        • On click

          • Display Producer Page

      • Proxies

        • On click

          • Display Proxies Page

    • Advanced

      • Contracts

        • On click

          • Display Contracts Page

      • Multisigs

        • On click

          • Display Multisigs Page

Footer

Footer.png

Search Bar

Home Page Hero Search

Search Header.png

Sub-Page Header

Top Header.png

Search Error Return

FIO Relics Base - Error.png
  • Displayed on Home Page and Primary Nav of secondary pages

  • Alt text: "Search by Account, Public Key, Handle, Domain, Transaction"

  • Collect value

    • If valid FIO Public Address format

      • Display Account Page

    • If valid FIO Handle format

      • Display FIO Handle Page

    • If alpha only and 12 characters or special account

      • Look-up in accounts table and if exists display Account Page

    • If ^(?!-)[a-zA-Z0-9-]{1,62}(?\<!-)$

      • Look-up in domains table and if exists display Domain Page

    • If alpha-numeric and 64 characters

      • Look-up in transactions table and if exists display Transaction Page

  • Validation

    • If above fails

      • Return error display and messaging stating: Your search <searchentry> - Did not match any records

Paging

First Page

image-20250411-154602.png

Middle Pages

image-20250411-154628.png

Last Page

image-20250411-154654.png

 

  • Links

    • First

      • On click display first page of results

    • Previous

      • On click display previous page of results

    • Next

      • On click display next page of results

    • Last

      • On click display last page of results

 

Home Page

Visual

Functionality

Visual

Functionality

FIO Relics Base.png
  • URL: /

  • FIO Handles Registered: Count of all handles in handles table

  • FIO Domains Registered: Count of all domains in domains table

  • FIO Handles Active: Count of handles in handles table which have status of active

  • FIO Domains Active: Count of handles in domains table which have status of active

  • Latest Block: head_block_num from /get_info

  • Latest Irreversible Block: last_irreversible_block_num from /get_info

  • Chart: Count of transactions in transactions table by day for last 30 days.

  • Latest Transactions

    • See Transaction List Page for definitions

    • Display 25 transactions sorted DESC by pk_transction_id

  • Links

    • View All Transactions

      • On click display Transaction List Page

  • Updates

    • Update all values every 5 seconds

      • FIO Handles Registered

      • FIO Domains Registered

      • FIO Handles Active

      • FIO Domains Active

      • Latest Block

      • Last irreversible block

      • Replace latest transactions with the latest 25

Transactions

Visual

Functionality

Visual

Functionality

Transaction List

FIO Relics Transactions.png
  • URL: /transactions

  • Transactions: Count of transactions in transactions table for last 30 days.

  • Transaction Fees: Sum of fee in transactions table for last 30 days / 1000000000

  • AVG Transaction Fee: [Sum of fee in transactions table for last 30 days] / 1000000000 / [Count of transactions in transactions table with fee > 0 for last 30 days.]

  • Transactions

    • Display 20 transactions sorted DESC by pk_transction_id

    • Transaction ID: transactionstransaction_id shown as 123456…123456 (first 6 and last 6 with …)

    • Account: accountsaccount_name

    • Date: transactionsblock_timestamp

    • Action: see Action Mapping

    • Details/Items: see Action Mapping

    • Fees: transactionfee / 1000000000 FIO

  • Links

    • Paging

    • Transaction ID

      • On click

        • Display Transaction Details Page

    • Account

      • On click

        • Display Account Details Page

Transaction Details

Input

image-20250311-214704.png

Response

image-20250311-214736.png

Traces

image-20250311-214820.png

Raw

image-20250311-214859.png
  • URL: /transactions/transaction_id

  • Generic

    • Transaction ID: transactionstransaction_id

    • Date: transactionsblock_timestamp

    • Block: transactionsfk_block_number

    • Status (green): transactionsstatus

    • Status (yellow):

      • Irreversible: Show if blockspk_block_number <= last_irreversible_block_num from /get_info

      • Pending Irreversibility:

        Show if blockspk_block_number > last_irreversible_block_num from /get_info

    • Action: see Action Mapping

    • Details/Items: see Action Mapping

    • Account: accountsaccount_name

    • Fees: transactionsfee / 1000000000 FIO

  • Input

    • contract: accountsaccount_name for transactionsfk_action_account_id

    • action: transactionsaction_name

    • transactionsrequest_data formatted json with value in bold and nessting indent

  • Response

    • contract: accountsaccount_name for transactionsfk_action_account_id

    • action: transactionsaction_name

    • transactionsresponse_data formatted json with value in bold and nessting indent

  • Traces (for each trace in traces where fk_transaction_id matches

    • contract: accountsaccount_name for tracesfk_action_account_id

    • action: tracesaction_name

    • tracesrequest_data formatted json with value in bold and nessting indent

  • Raw

  • Links

    • Block #

      • On click

        • Display Block Details Page

    • Account

      • On click

        • Display Account Details Page

Blocks

Visual

Functionality

Visual

Functionality

Blocks List

image-20250311-220937.png
  • URL: /blocks

  • Current Block

    • Block Number: blockspk_block_number

    • Producer: blocksproducer_account_name supplemented with information from https://bpmonitor.fio.net/api/producers

      • candidate_name

      • fio_address

    • Transactions: Count of entries in transactions for pk_block_number

    • Date: blocksstamp

    • Block ID: blocksblock_id

  • All Blocks

    • Display 20 blocks sorted DESC by pk_block_number

    • Block Number: blockspk_block_number

    • Block ID: blocksblock_id shown as 123456…123456 (first 6 and last 6 with …)

    • Date: blocksstamp

    • Producer: candidate_name for blocksproducer_account_name from https://bpmonitor.fio.net/api/producers

    • Transactions: Count of entries in transactions for pk_block_number

  • DEV NOTE:

  • Links

    • Paging

    • Block ID

      • On click

        • Display Block Details Page

    • Producer

      • On click

        • Display Account Details Page

Block Details

FIO Relics Block Details.png