Token and Domain Unwrapping

Owned by George Worrell
Last updated: Sept 29, 2023 by Pawel Mastalerz
4 min read

Table of Contents

UX

https://www.figma.com/file/G0oXoslgcfP7OvjSEXxkWT/Token-%26-Domain-Unwrapping-Standalone?type=design&node-id=12-1907&mode=design

https://www.figma.com/file/G0oXoslgcfP7OvjSEXxkWT/Token-%26-Domain-Unwrapping-Standalone?type=design&node-id=21-4225&mode=design

Unwrap Fee Estimation

General Requirements

View

Requirements

View

Requirements

Landing Page

 

Wallet Connect Page

 

  • Links

    • MetaMask Wallet Connection

      • On click

        • Connect to the users browser based MetaMask Wallet for signin

    • Close

      • On Click

        • Closes wallet connection modal

Unwrap FIO Tokens

 

Unwrap FIO Tokens

  • Collect

    • FIO Handle

    • Amount of FIO tokens to unwrap

  • Display

    • Current wrapped network (Ethereum)

    • Unwrap network (FIO)

    • Links

      • Edit Fees

        • On click

          • Trigger the fee modal with both basic and advanced fee settings based on current network fees

      • Max

        • On click

          • Prepopulates maximum available FIO

    • Transaction cost

      • Fee cost - Fees are determined by the network

    • Unwrap

      • On click

        • Trigger MetaMask wallet transaction signing and display Unwrap FIO Tokens Confirmation Page

  • Validate

    • wFIO Wrapped Amount

      • Validate onfocusout

        • On validation error

          • Display error message:

            • Please enter valid wFIO amount

      • Validation rules

        • Valid amount of SUFs to unwrap

    • FIO Handle

      • Validate onfocusout

        • On validation error

          • Display error message:

            • Please enter valid FIO Crypto Handle

      • Validation rules

        • Valid FIO Address where domain should be delivered

    • Wallet Network

      • Validate correct network for action

        • On validation error

          • Display error message:

            • Network! - The connected network <NETWORK>, is not valid for unwrapping domains

Unwrap FIO Domain

 

 

  • Collect

    • FIO Handle

    • FIO Domain for unwrapping

      • Select domain from list returned from connected wallet

  • Display

    • Current wrapped network (Polygon)

    • Unwrap network (FIO)

    • Links

      • Unwrap wFIO Domain

        • On click

          • Trigger MetaMask wallet transaction signing and display Unwrap FIO Domain Confirmation Page

      • Edit Fees

        • On click

          • Trigger the fee modal with both basic and advanced fee settings based on current network fees

    • Transaction cost

      • Fee cost - Fees are determined by the network

  • Validate

    • wFIO Wrapped Domain

      • Validate onfocusout

        • On validation error

          • Display error message:

            • Please enter valid wFIO domain

      • Validation rules

        • Valid and unexpired FIO Domain

    • FIO Handle

      • Validate onfocusout

        • On validation error

          • Display error message:

            • Please enter valid FIO Crypto Handle

      • Validation rules

        • Valid FIO Address where domain should be delivered

    • Wallet Network

      • Validate correct network for action

        • On validation error

          • Display error message:

            • Network! - The connected network <NETWORK>, is not valid for unwrapping domains

Edit Fees

 

  • Overall

    • Links

      • Close

        • On Click

          • Returns the user to the main unwrap view

      • Cancel

        • On Click

          • Cancels the view

      • Advance

        • On Click

          • Displays the advanced fee view to the user

      • Basic

        • On Click

          • Displays the basic fee view to the user

  • Basic

    • Display available tiers of network fees

      • Use 60,000 gas limit and gas price from Etherscan API

    • Links

      • Tier Selection

        • On Click

          • Selects the fee tier the user wishes to use

  • Advanced

    • Collect

      • Gas Limit and Gas Price

        • Defaults

          • Use 60,000 gas limit and gas price from Etherscan API for high

        • On Entry

          • Allows the user to set fee amount for both gas limit and gas price

          • Return the potential transaction time

        • Validation rules

          • If the user enters in an amount lower than the low threshold, an error state is triggered and the user notified that the transaction could fee with fees being unrecoverable

FIO Tokens Unwrap Confirmation

 

  • Display

    • Unwrapping Transaction Information

      • Unwrap Chain - chain_code

      • Public Address - public_address

      • Receiving FIO Handle - fio_address

      • Tokens Unwrapped - amount

      • Blockchain Transaction ID - obt_id

    • Links

      • Close and X

        • On click

          • Display Landing Page

FIO Domain Unwrap Confirmation

 

  • Display

    • Wrapping Transaction Information

      • Unwrap Chain - chain_code

      • Public Address - public_address

      • Receiving FIO Crypto Handle - fio_address

      • Domain Wrapped - fio_domain

      • Blockchain Transaction ID - obt_id

    • Links

      • Close and X

        • On click

          • Display Landing Page