Profile Look-up

FCH Not Found

• Collect

  • FIO Crypto Handle

• Validate

  • FIO Crypto Handle

    • Validate on Look It Up click

      • On validation error

        • Display FCH Not Found error

    • Validation rules

      • Format: See validation rules

      • Existence: avail_check

• Display

  • Links

    • Look It Up

      • On click

        • Validate FCH

        • Display

Profile - Payments

• Display

  • FIO Crypto Handle

  • Payments option

    • Obtained from /get_pub_address

    • Elements

      • Token Logo - corresponds to token_code, show specific for:

        • TBD

      • Token name - use https://github.com/fioprotocol/fips/blob/master/data/tokens.md

        • If not available display code as CODE (CODE)

      • Chain name - use https://github.com/fioprotocol/fips/blob/master/data/chains.md

        • Do not show if token_code and chain_code are the same

  • Links

    • Look One Up

      • On click

        • Display Profile Look-up Page

    • Payment option

      • On click

        • Display Profile - Payment Details Page

    • Profile tabs

      • Payments

        • On click display Profile - Payments Page

      • NFT Signatures

        • On click display Profile - NFT Signatures Page

      • Socials

        • On click display Profile - Socials Page

Profile - Payment Details

• Display

  • Elements as defined on Profile - Payments Page

  • Disclaimer - only show if token_code and chain_code are not the same

  • FIO Crypto Handle

  • Public address as obtained from /get_pub_address

  • Public address QR code

  • Links

    • X

      • On click

        • Close pop-up

    • Copy

      • On click

        • Copy public address to clipboard

Profile - NFT Signatures

• Display

  • FIO Crypto Handle

  • NFT Signatures option

    • Obtained from /get_nfts_fio_address

    • Elements

      • See NFT Metadata

  • Links

    • Look One Up

      • On click

        • Display Profile Look-up Page

    • NFT Image

      • On click

        • Display Profile - NFT Signature Details Page

    • Profile tabs

      • Payments

        • On click display Profile - Payments Page

      • NFT Signatures

        • On click display Profile - NFT Signatures Page

      • Socials

        • On click display Profile - Socials Page

Token wildcard

• It’s possible that token_id returned is a wildcard (“*”). If so no metadata is returned and “Multiple Signatures” variant is shown.

Fetching NFT Metadata

• Get data from both

  • /get_nfts_fio_address

  • Infura NFT API spec

Combine Metadata

• From /get_nfts_fio_address

  • NFT Hash

  • Creator URL

• From Infura NFT API

  • NFT Name

  • NFT Description

  • External URL

• Conditional

  • NFT Image

    • hostname rewrite

      • If NFT Image hostname is ipfs.infura.io change to fio.infura-ipfs.io

    • Source priority

      • Use if present in /get_nfts_fio_address and is image

      • Else

      • Use if present in Infura NFT API and is image

      • Else

      • Show “No image” variant

API spec

https://developers.fioprotocol.io/pages/api/fio-api/#post-/get_nfts_fio_address

Request Parameters

• fio_address - FCH of profile

• limit - 100

• offset - 0

Response

• url - NFT Image

• hash - NFT Hash

• metadata → creator_url - Creator URL

• more - If more > 0 submit another request with offset set to total number of results returned

Authentication

• In order to not expose API key, make calls server side

• API key/secret to be provided

Endpoint

https://nft.api.infura.io/networks/{chainId}/nfts/{tokenAddress}/tokens/{tokenId}

API spec

https://docs.infura.io/infura/infura-expansion-apis/nft-api/rest-apis/api-reference/metadata

Request Parameters

• chain_code to chainId mapping

  • ETH = 1

  • MATIC = 137

  • ARB1 = 42161

  • BSC = 56

  • AVAX = 43114

  • FTM = 250

• tokenAddress - contract_address returned by /get_nfts_fio_address

• tokenId - token_id returned by /get_nfts_fio_address

Response

• metadata -> name - NFT Name

• metadata -> image - NFT Image

• metadata -> description- NFT Description

• metadata -> external_url - External URL