Page Comparison

FIO Handle Resolution

• 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 chainId to chain_code and token_code - DEV NOTE: mapping static file TBD, e.g. eip155:1 is based on the following (chainId, chain_code: ETH, 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