Send using FIO Address

This is the most basic integration option and fits within Send token existing Send Tokens screens. It gives the user the option to use FIO Address as the destination address for the Token Send.

• User

  • Users enters FIO Address as their Send to address for any crypto.

  • User does not need to register a FIO Address inside the wallet for this integration.

• Wallet

  • Fetch public address using /get_pub_address.

  • Rest of flow unchanged.

Example

FIO Address Registration

Each user will need a FIO Address to use remaining FIO Protocol functionality:

• Map Public Addresses to their FIO Address

• Request any token using FIO Request

• Respond to a FIO Requests

DECISION 1

• A. Wallet controls the FIO Address Registration UX

  • User

    • Picks a FIO Address

      • DECISION 2

        • A. Address registration part of on-boarding OR

          • DECISION 3

          • A. A FIO Address can automatically be assigned when a user creates a wallet account OR

          • B. You may use a value already being collected, e.g. user_name@wallet, or

        • B. Address registration as an option

          • Any user may choose to register a FIO Address when they want to access the FIO features.

  • Wallet

    • Foundation-paid FIO Addresses

      • Register FIO Address on chain using /register_fio_address

        • DECISION 4

          • A. You want to keep the domain private. Only the wallet can register FIO Addresses on that domain.

          • Wallet will have to transfer domain ownership to Foundation

          • B. The domain can be public

          • Custom permission set-up will be required.

    • Wallet-paid FO Addresses

      • Register FIO Address on chain using /register_fio_address

        • Register FIO Address on chain using /register_fio_address

Mapping of public addresses to FIO Address

In order to receive crypto sent to a FIO Address, it has to be mapped to public addresses in the wallet.

• User

  • DECISION 5

    • A. User explicitly decided which crypto currencies are mapped to their FIO Address

    • B. The wallet automatically maps all supported crypto currencies to the FIO Address

• Wallet

  • Maps public addresses using /add_pub_address and FIP-15 Standard

Example

Request any token using FIO Request

With this option the the user will be able to request any token from another user using their FIO Address and FIO Request

• User

  • User specifies:

    • Token they want to receive

    • Amount

    • FIO Address of the other party

    • Memo (optional)

• Wallet

  • Sends FIO Request using /new_funds_request with

  • Public address, where funds to be sent for deposit

    • This address can include attached blockchain specific tags or memos, e.g. Destination Tags for Ripple

  • Memo (optional)

Example

Respond to FIO Request

With this option, the user will be able to see any incoming request and respond to it.

• User

  • Reviews FIO Requests and

    • Respond

      • User specifies:

        • Wallet to use as payment source

        • Amount - pre-populated from request, but allowed to be change

        • Memo (optional)

    • Reject

• Wallet

  • Respond

    • Submits original blockchain transaction to public address specified in FIO Request

    • Submits /record_obt_data

  • Reject

    • Submits /reject_funds_request

More examples

https://kb.fioprotocol.io/user-guides/user-guides

Tech docs