1 Table of Contents
2 High-level Specification
- 2.1 FIO App Account Types
- 2.2 Alternative Account
- 2.3 Sign-in
- 2.4 Sign Transaction
3 Metamask SNAP
- 3.1 Overview
- 3.2 Sign-in Flow
- 3.3 Sign Transaction Flow
- 3.4 Inside SNAP Functionality
  - 3.4.1 FIO Handle Resolution
  - 3.4.2 SNAP Home Page
    - 3.4.2.1 No FIO Handle and No FIO Tokens and No Pending FIO Requests
    - 3.4.2.2 1+ FIO Handles and >0 FIO Tokens and 1+ FIO Requests
- 3.5 Inside FIO App Functionality
  - 3.5.1 Authenticate
  - 3.5.2 Sign Transaction
  - 3.5.3 Decrypt Content
  - 3.5.4 Sign out

High-level Specification

Functionality	Details

Functionality	Details
FIO App Account Types	Standard Keys are stored on EDGE Key Storage. Alternative Keys are stored in another Wallet Metemask
Alternative Account	Alternative Account should only contain FIO Public Key Account Type Primary Alternative Alternative Account Always contain FIO Public Key for index 0 Will not initially contain Email address, but it may be added later Will never contain Password PIN 2FA Password Recovery See Settings \| Main Settings FIO Public Key in Account Conflict Resolution The same FIO Public Key could exist in Primary account and Alternative account and those would be considered separate accounts Example: User A creates Primary Account using email and password User A imports seed phrase ABC User A connects to FIO App using Metamask which has seed phrase ABC installed User A has 2 different accounts: Primary Account Key generated by EDGE Key imported using seed phrase ABC (Account index 0) Alternative Account Key imported using seed phrase ABC (Account index 0) Multiple Wallets For Alternative Accounts, users can Create New Wallets. When they do each additional Wallet is the next index in the derivation path (same as for Dashboard Ledger Wallet) For Alternative Accounts, users can add a Ledger Wallet.
Sign-in	The Sign-in and Account creation process is transparent to the user Process User signs a nonce using FIO Public Key for index 0 FIO App fetch FIO Public Key for index 0 Create Account - if FIO Public Key is not associated to an account, create account Log user in
Sign Transaction	Transaction signing occurs in specific wallet Transaction json should be shown

Metamask SNAP

Overview

Metamask Snap is an extension of Metamask browser plug-in, which allows for new functionality, e.g. ability to sign transactions on a non-EVM chain.

The FIO Snap allows Metamask users to gain access to the FIO App and execute transactions without having to create an account, which requires email and password.

Sign-in Flow

Sign Transaction Flow

Inside SNAP Functionality

Visual	Functionality

Visual

Functionality

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 to chain_code and token_code based on the following (chainId, chain_code, token_code)
  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

Inside FIO App Functionality

Visual	Functionality

Visual	Functionality
Authenticate	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	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	Replace Sign out with Disconnect button with icon

Contributors DAO

MetaMask Snap

Table of Contents

High-level Specification

FIO App Account Types

Alternative Account

Sign-in

Sign Transaction