Page Comparison

FIO Handle Resolution

Image Added

• Overview

  • When user has the FIO Snap installed, FIO Handles will be resolved inside MetaMask on send.

• Manifest spec - this ensures OnNameLookupHandler receives any data typed for any chain

"endowment:name-lookup": {
  "chains": [
    "eip155:1",
    "eip155:10",
    "eip155:56",
    "eip155:61",
    "eip155:137",
    "eip155:324",
    "eip155:1101",
    "eip155:5000",
    "eip155:8453",
    "eip155:42161",
    "eip155:42220",
    "eip155:43114",
    "eip155:59144",
    "eip155:7777777"
  ]
}

• Look-up logic

  • Verify that the string received matches the FIO Handle format

  • Convert chainId to chain_code and token_code based on the following (chainId, chain_code, token_code)

    Code Block
    eip155:1,ETH,ETH eip155:10,OP,ETH eip155:56,BSC,BNB eip155:61,ETC,ETC eip155:137,POL,POL eip155:324,ZKSYNC,ETH eip155:1101,POLZK,ETH eip155:5000,MNT,MNT eip155:8453,BASE,ETH eip155:42161,ARB,ETH eip155:42220,CELO,CELO eip155:43114,AVAX,AVAX eip155:59144,LINEA,ETH eip155:7777777,ZORA,ETH

  • Execute /get_pub_address

  • Return public address

  • Example OnNameLookupHandler

export const onNameLookup: OnNameLookupHandler = async (request) => {
  const { chainId, address, domain } = request;

  if (domain) {
    const resolvedAddress = '0xc0ffee254729296a45a3885639AC7E10F9d54979';
    return {
      resolvedAddresses: [{
        protocol: 'FIO Handle',
        resolvedAddress: resolvedAddress,
        domainName: domain,
      }]
    };
  }

  return null;
};

DEV NOTE: specification: https://metamask.github.io/SIPs/SIPS/sip-12

SNAP Home Page

No FIO Handle and No FIO Tokens and No Pending FIO Requests

1+ FIO Handles and >0 FIO Tokens and 1+ FIO Requests

• Display SNAP Home Page per SNAP spec

  • FIO Token Balance

    • Fetch balance using /get_fio_balance and FIO Public Key stored in MetaMask

      • Show balance

      • If 0 display “Get FIO”

        • On click

          • Open https://fio.net/token/overview#get-fio

  • FIO Handles

    • Fetch using /get_fio_addresses and FIO Public Key stored in MetaMask

      • If 1 or more returned display first returned handle

      • If more than 1 returned display Display first returned“See more handles”

        • On click

          • Open https://app.fio.net/fio-handles

      • If 0 handles returned display enter a handle text box and button

        • On click

          • Open https://app.fio.net/fio-handles-selection?address=bob where bob was entered

  • Pending FIO Requests

    • Fetch using /get_pending_fio_requests and FIO Public Key stored in MetaMask

      • If 1 or more returned display the section and number of pending FIO Requests and “View requests”

        • On click

          • Open https://app.fio.net/fio-wallet?publicKey=snappubkey where snappubkey is FIO Public Key stored in MetaMask and default to FIO Requests Received tabs

Authenticate

Image Modified

• Set-up SNAP

  • Install FIO SNAP

  • Grant SNAP Permissions

• Sign-in

  • Have user sign nonce with FIO Private Key

    • SNAP Message

      • Title: Sign-in to FIO App

      • Description:
        Please approve this nonce signature to sign-in to the FIO App. Nonce signature proves that you are the owner of the associated FIO Public Key.
        ------------------------------------
        Random nonce: XXX

• If user rejects any of these steps display error message

Sign Transaction

Image Modified

Image Modified

• Trigger transaction sign in Metamask

• SNAP Message

  • Title: Sign FIO Transaction

  • Description:
    Please approve the following transaction.
    Transaction name: trnsfiopubky
    ------------------------------------
    FIO Chain: FIO Mainnet
    ------------------------------------
    Transaction details:
    tpid: dashboard@fiouat
    max_fee: 1500000000000
    amount: 100000000000000
    payee_public_key: FIO68bYHgYTqc17jz9MuprzvUY9D7Ud9UmLzruiNiFGkaHMZNUDv5

Decrypt Content

• When decrypting content of FIO Request or FIO Data, trigger decrypt content transaction in Metamask. If

• SNAP Message

  • Title: Decrypt FIO Data

  • Description:
    Please approve the decryption of FIO Data. For your security and privacy, FIO Data is always encrypted and has to be decrypted before viewing.

Sign out

Image Modified

• Replace Sign out with Disconnect button with icon