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
image-20250311-223149.png

 

 

  • URL: /blocks/pk_block_number

  • Block Number: blockspk_block_number

  • Block ID: blocksblock_id

  • Date: blocksstamp

  • Status

    • 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

  • Previous Block: blockspk_block_number - 1

  • Next Block: blockspk_block_number + 1

  • 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

  • Block Details: all Transactions in block based on transactionsfk_block_number

    • Transaction ID: transactionstransaction_id

    • Account: accountsaccount_name

    • Action: see Action Mapping

    • Details/Items: see Action Mapping

    • Fees: transactionsfee / 1000000000 FIO

  • Links

    • Previous Block

      • On click

        • Display Block Details Page

    • Next Block

      • On click

        • Display Block Details Page

    • Transaction ID

      • On click

        • Display Transaction Details Page

    • Account

      • On click

        • Display Account Details Page

FIO Handles

Visual

Functionality

Visual

Functionality

FIO Handles List

FIO Relics Handles.png
  • URL: /handles

  • Registered Handles: Count of all handles in handles table

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

  • All Handles

    • Display 20 handles sorted DESC by pk_handle_id

    • Handle: handleshandle

    • Domain: domainsdomain for handlesfk_domain_id

    • Account: accountsacount_name for handlesfk_owner_account_is

    • Status: handlesstatus

  • Links

    • Paging

    • Handle

      • On click

        • Display Handle Details Page

    • Domain

      • On click

        • Display Domain Details Page

    • Account

      • On click

        • Display Account Details Page

FIO Handle Details

Transactions

image-20250312-193018.png

Mapped Public Addresses

image-20250312-194507.png

Signed NFTs

image-20250312-194950.png
  • URL: /handles/handle

  • If handlesstatus == active fetch FIO Handle data from State using /get_table_rows

    • Response shown as rows below

  • FIO Handle: handleshandle

  • Create Date: first handleactivitiesblock_timestamp for handlespk_handle_is sorted ASC by pk_handle_activity_id

  • If handlesstatus == active show Bundled Transactions: rows[0]bundleeligiblecountdown

  • Account: rows[0]owner_account

  • Domain: domainsdomain for handlesfk_domain_id

  • Status: handlesstatus

  • Handle Details

    • Transactions

      • Display 20 handleactivities sorted ASC by pk_handle_activity_id

      • Transaction ID: transactionstransaction_id for handleactivitiesfk_transaction_id

        shown as 123456…123456 (first 6 and last 6 with …)

      • Account: accountsaccount_name for transactionsfk_account_id for handleactivitiesfk_transaction_id

      • Date: handleactivitiesblock_timestamp

      • Action: transactionsaction_name for handleactivitiesfk_transaction_id see Action Mapping

      • Fee: transactionsfee / 1000000000 FIO for handleactivitiesfk_transaction_id

      • Links

        • Paging

        • Transaction ID

          • On click

            • Display Transaction Details Page

        • Account

          • On click

            • Display Account Details Page

    • If handlesstatus == active show Mapped Public Addresses / Social Media Links

    • If handlesstatus == active show Signed NFTs

FIO Domains

Visual

Functionality

Visual

Functionality

FIO Domains List

FIO Relics Domains.png
  • URL: /domains

  • Registered Domains: Count of all domains in domains table

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

  • All Domains

    • Display 20 domains where status == active sorted

      • Default Most Recent: DESC by pk_domain_id

      • Most Handles: count of handles where fk_domain_id == domainspk_domain_id DESC

      • Closest to expiration: domainsexpiration_timestamp ASC

    • Domain: domainsdomain

    • Account: accountsacount_name for domainsfk_owner_account_is

    • Public: domainsis_public

    • Registered Handles: count of handles where fk_domain_id == domainspk_domain_id

    • Status: domainsstatus

    • Domains Expiration: domainsexpiration_timestamp

  • Links

    • Paging

    • Domain

      • On click

        • Display Domain Details Page

    • Account

      • On click

        • Display Account Details Page

    • Only Show Public Domain

      • Default: selected

      • When unselected

        • Display 20 domains sorted DESC by pk_domain_id

      • When selected

        • Display 20 domains where status == active sorted DESC by pk_domain_id

    • Sort - Allow the user to sort 3 parameters with the default being the standard display state.

      • Default: Most Recent

      • Sort by upcoming expiration (burn date)

      • Sory by domains with most handles

  • Updates

    • Update all values every 5 seconds

FIO Domain Details

Transactions

image-20250312-203312.png

Registered FIO Handles

image-20250312-203907.png
  • URL: /domains/domain

  • FIO Domain: domainsdomain

  • Expiration Date: domainsexpiration_timestamp

  • Account: rows[0]owner_account

  • If domainsstatus == active show Public: `domains`is_public (true = Yes, false = No)

  • Status: domainsstatus

  • Domain Details

    • Transactions

      • Display 20 domainactivities sorted ASC by pk_domain_activity_id

      • Transaction ID: transactionstransaction_id for domainactivitiesfk_transaction_id

        shown as 123456…123456 (first 6 and last 6 with …)

      • Account: accountsaccount_name for transactionsfk_account_id for domainactivitiesfk_transaction_id

      • Date: domainactivitiesblock_timestamp

      • Action: transactionsaction_name for domainactivitiesfk_transaction_id see Action Mapping

      • Fee: transactionsfee / 1000000000 FIO for domainactivitiesfk_transaction_id

      • Links

        • Transaction ID

          • On click

            • Display Transaction Details Page

        • Account

          • On click

            • Display Account Details Page

    • If domainsstatus == active show Registered FIO Handles

      • Handle: handleshandle where fk_domain_id == domainspk_domain_id

      • Account: accountsaccount_name for handlesfk_owner_account_id

        where fk_domain_id == domainspk_domain_id

      • Status: handlesstatus where fk_domain_id == domainspk_domain_id

      • Links

        • Paging

        • Handle

          • On click

            • Display Handle Details Page

        • Account

          • On click